{ "openapi": "3.1.0", "info": { "title": "CalculatorX Calculation API (Core Capabilities)", "version": "1.0.0", "description": "Deterministic calculation API for humans and AI agents. Computational verification is defined by CVP; Review-policy tiers (engine_tested / expert_verified) are supplemental. Prefer CVP Verified capabilities with CURRENT production attestation. Rate limits: REST POST /api/v1/calc/* ≈60/min/IP; MCP RPC ≈120/min; execute_calculation ≈30/min. Exceeded → 429 + Retry-After.", "contact": { "url": "https://www.calculatorx.com" } }, "servers": [ { "url": "https://www.calculatorx.com" } ], "tags": [ { "name": "Catalog" }, { "name": "CoreCapabilities", "description": "Core capability templates. Computational verification: CVP. Supplemental Review-policy tiers: candidate, engine_tested, internally_reviewed, expert_verified. Catalog token verified is L3 (expert_verified) only." }, { "name": "MCP", "description": "Remote MCP JSON-RPC at /mcp" } ], "paths": { "/api/v1/calc": { "get": { "operationId": "listCalculationEngines", "summary": "List calculation engines", "tags": [ "Catalog" ], "responses": { "200": { "description": "Engine catalog", "content": { "application/json": { "schema": { "type": "object" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } } } } }, "/mcp": { "get": { "operationId": "mcpDiscoverHttp", "summary": "MCP discovery (CalculatorX custom GET)", "tags": [ "MCP" ], "responses": { "200": { "description": "Server info and tool names", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "post": { "operationId": "mcpJsonRpc", "summary": "MCP JSON-RPC (search / inspect / execute)", "description": "Dual-track: `2024-11-05` (optional initialize) and `2026-07-28` (require `Mcp-Method` / `Mcp-Name`). Tools: search_capabilities, inspect_capability, execute_calculation (free), compute_paid (Stage 0.5 opt-in, not live charging).", "tags": [ "MCP" ], "parameters": [ { "name": "MCP-Protocol-Version", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "2026-07-28", "2024-11-05" ] }, "description": "Defaults to 2024-11-05 when omitted (legacy). Prefer 2026-07-28." }, { "name": "Mcp-Method", "in": "header", "required": false, "schema": { "type": "string" }, "description": "Required for 2026-07-28; must match JSON-RPC method" }, { "name": "Mcp-Name", "in": "header", "required": false, "schema": { "type": "string" }, "description": "Required for tools/call under 2026-07-28; must match params.name" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "JSON-RPC response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } } } } }, "/api/v1/calc/amps-to-va": { "post": { "operationId": "calculate_electrical_apparent_power", "summary": "Electrical apparent power", "description": "Single-phase or balanced sinusoidal three-phase (L-L) AC apparent power: amps↔VA and amps→kVA. (calculation_version 1.4.3)\n\nSemantic capability: `electrical.apparent_power`.\n\nCalculation version: `1.4.3`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not for DC systems\n\nLimitation: Not for unbalanced or nonsinusoidal three-phase; √3 formula assumes balanced sinusoidal V_LL = √3 V_LN and equal line currents\n\nLimitation: Not for line-to-neutral three-phase mode\n\nLimitation: Not for equipment protection or conductor sizing\n\nLimitation: When power_factor is supplied, REST/MCP include derived.estimated_real_power; omitted when λ is absent", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.3" ] }, "description": "Pin calculation_version (published: 1.4.3); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.apparent_power.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.3", "examples": [ "1.4.3" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.apparent_power.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ohms-law": { "post": { "operationId": "calculate_electrical_ohms_law", "summary": "Ohm's law", "description": "Solve any two of V, I, R, P for resistive DC / AC RMS circuits. (calculation_version 1.5.1)\n\nSemantic capability: `electrical.ohms_law`.\n\nCalculation version: `1.5.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Resistive model only\n\nLimitation: Not for reactive impedance networks\n\nLimitation: Fewer than two inputs → NEEDS_TWO_INPUTS; non-finite → INVALID_NUMBER\n\nLimitation: Zero divisors yield 0 for dependents (soft boundary)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.5.1" ] }, "description": "Pin calculation_version (published: 1.5.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.ohms_law.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.5.1", "examples": [ "1.5.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.5.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.ohms_law.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/watts-to-amps": { "post": { "operationId": "calculate_electrical_watts_amps", "summary": "Watts ↔ amps", "description": "Convert real power and current for DC, single-phase, or three-phase with power factor. (calculation_version 1.4.1)\n\nSemantic capability: `electrical.watts_amps`.\n\nCalculation version: `1.4.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not for unbalanced three-phase\n\nLimitation: Not for line-to-neutral three-phase as a separate mode\n\nLimitation: Not a substitute for breaker or conductor sizing", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.1" ] }, "description": "Pin calculation_version (published: 1.4.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_amps.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.1", "examples": [ "1.4.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_amps.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/power-factor": { "post": { "operationId": "calculate_electrical_power_factor", "summary": "Power factor", "description": "Compute apparent power S, power factor λ, and reactive power Q from RMS V, I, and real power P for 1φ or balanced 3φ. (calculation_version 1.5.1)\n\nSemantic capability: `electrical.power_factor`.\n\nCalculation version: `1.5.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Correction capacitor estimate is UI-only (not part of the API result)\n\nLimitation: Not for harmonic-rich or engineered bank design\n\nLimitation: When P > S, PF is capped at 1 and Q = 0 (soft clamp)\n\nLimitation: Voltage must be > 0 (VOLTAGE_MUST_BE_POSITIVE); zero volts is not a valid S=0 shortcut", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.5.1" ] }, "description": "Pin calculation_version (published: 1.5.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.power_factor.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.5.1", "examples": [ "1.5.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.5.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.power_factor.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/voltage-drop": { "post": { "operationId": "calculate_electrical_voltage_drop", "summary": "Voltage drop", "description": "Estimate conductor voltage drop from current, one-way length, and Ω/km for DC / resistive 1φ or balanced 3φ (resistance-only, PF≈1). Always returns conductor I²R loss P_loss. Optional V_system adds percent drop and estimated load voltage; optional u_* compose expanded uncertainty on V_drop via Uncertainty Engine. (calculation_version 1.5.2)\n\nSemantic capability: `electrical.voltage_drop`.\n\nCalculation version: `1.5.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Resistance-only estimate — AC reactance neglected; AC modes assume PF ≈ 1\n\nLimitation: Not a substitute for code-compliant cable sizing or ampacity\n\nLimitation: 3φ V_system is line-to-line; percent_drop and V_load use that same basis\n\nLimitation: Zero I/length/R → 0 V (valid); negatives → VALUE_MUST_BE_NON_NEGATIVE\n\nLimitation: mode must be dc or three (INVALID_MODE otherwise); REST/UI default dc if omitted\n\nLimitation: V_system if set must be > 0 (VALUE_MUST_BE_POSITIVE); omit it to return volts only\n\nLimitation: Optional u_* use GUM sensitivity only; empty u_* still returns { V_drop, R_one_way, P_loss, … } without uncertainty\n\nLimitation: Engine tested, source checked, evidence published (L1). Named expert review is a higher assurance tier (L3), not required for engine-tested status. Not a code-compliance certification.", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.5.2" ] }, "description": "Pin calculation_version (published: 1.5.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.voltage_drop.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.5.2", "examples": [ "1.5.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.5.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.voltage_drop.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/voltage-divider": { "post": { "operationId": "calculate_electrical_voltage_divider", "summary": "Voltage divider", "description": "Solve unloaded two-resistor divider networks from exactly three of Vin, R1, R2, Vout; also returns series current, resistor power, divider ratio, and Thevenin output resistance Rth. (calculation_version 1.5.1)\n\nSemantic capability: `electrical.voltage_divider`.\n\nCalculation version: `1.5.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Unloaded two-resistor divider only\n\nLimitation: Canonical input is exactly three of Vin, R1, R2, Vout\n\nLimitation: Fewer than three inputs → NEEDS_THREE_INPUTS\n\nLimitation: All four inputs → TOO_MANY_INPUTS (not a consistency check)\n\nLimitation: Solving R1/R2 requires Vin > Vout > 0 (INVALID_DIVIDER_VOLTAGES otherwise)\n\nLimitation: R1+R2=0 when solving Vout → RESISTANCE_MUST_BE_POSITIVE\n\nLimitation: Not for loaded dividers, AC reactive dividers, or RF", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.5.1" ] }, "description": "Pin calculation_version (published: 1.5.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.voltage_divider.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.5.1", "examples": [ "1.5.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.5.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.voltage_divider.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/energy-consumption": { "post": { "operationId": "calculate_electrical_energy_consumption", "summary": "Energy consumption", "description": "Convert watts and hours to kilowatt-hours. (calculation_version 1.4.2)\n\nSemantic capability: `electrical.energy_consumption`.\n\nCalculation version: `1.4.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Assumes constant power over the stated hours\n\nLimitation: W and hours must be ≥ 0 (VALUE_MUST_BE_NON_NEGATIVE)\n\nLimitation: UI daily month/year projections are presentation-only; engine returns period kWh", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.2" ] }, "description": "Pin calculation_version (published: 1.4.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.energy_consumption.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.2", "examples": [ "1.4.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.energy_consumption.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/energy-cost": { "post": { "operationId": "calculate_electrical_energy_cost", "summary": "Energy cost", "description": "Estimate electricity cost from watts/hours or kWh and a unit rate. (calculation_version 1.4.2)\n\nSemantic capability: `electrical.energy_cost`.\n\nCalculation version: `1.4.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Usage cost only — standing charge and tax not included\n\nLimitation: W, hours, days, kWh, and rate must be ≥ 0\n\nLimitation: Hours per day must be ≤ 24 (HOURS_PER_DAY_OUT_OF_RANGE)\n\nLimitation: Zero W/hours/days/kWh/rate → 0", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.2" ] }, "description": "Pin calculation_version (published: 1.4.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.energy_cost.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.2", "examples": [ "1.4.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.energy_cost.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ev-to-volts": { "post": { "operationId": "calculate_electrical_ev_voltage", "summary": "eV to Volts", "description": "Relate electronvolt energy to electric potential difference through E = qV using charge magnitude and the exact SI elementary charge. (calculation_version 1.3.0)\n\nSemantic capability: `electrical.ev_voltage`.\n\nCalculation version: `1.3.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Charge is magnitude only — electron (−e) vs proton (+e) sign is not modeled\n\nLimitation: Q = 0 when solving for voltage → ZERO_CHARGE (not 0 V)\n\nLimitation: Uses exact SI e = 1.602176634×10⁻¹⁹ C\n\nLimitation: Not a pure eV↔V unit conversion; ΔE = qΔV", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.0" ] }, "description": "Pin calculation_version (published: 1.3.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.ev_voltage.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.0", "examples": [ "1.3.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.ev_voltage.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/volts-to-ev": { "post": { "operationId": "calculate_electrical_ev_voltage_alias_volts_to_ev", "summary": "eV to Volts (volts-to-ev page alias)", "description": "Relate electronvolt energy to electric potential difference through E = qV using charge magnitude and the exact SI elementary charge. (calculation_version 1.3.0)\n\nSemantic capability: `electrical.ev_voltage`.\n\nCalculation version: `1.3.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Charge is magnitude only — electron (−e) vs proton (+e) sign is not modeled\n\nLimitation: Q = 0 when solving for voltage → ZERO_CHARGE (not 0 V)\n\nLimitation: Uses exact SI e = 1.602176634×10⁻¹⁹ C\n\nLimitation: Not a pure eV↔V unit conversion; ΔE = qΔV", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.0" ] }, "description": "Pin calculation_version (published: 1.3.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.ev_voltage.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.0", "examples": [ "1.3.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.ev_voltage.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/watt-volt-amp": { "post": { "operationId": "calculate_electrical_watt_volt_amp", "summary": "Watt / volt / amp", "description": "Solve any two of P, V, I, R for simple resistive power relationships. (calculation_version 1.5.1)\n\nSemantic capability: `electrical.watt_volt_amp`.\n\nCalculation version: `1.5.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Resistive model only\n\nLimitation: Fewer than two inputs throws; zero divisors yield 0 for dependents", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.5.1" ] }, "description": "Pin calculation_version (published: 1.5.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.watt_volt_amp.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.5.1", "examples": [ "1.5.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.5.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.watt_volt_amp.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/power": { "post": { "operationId": "calculate_electrical_power", "summary": "Electric power", "description": "Real power in watts from V×I×PF (DC / 1φ / balanced 3φ L-L), from I²R, or average power E/Δt. PF=0 is valid (P=0); blank PF defaults to 1. Δt=0 is INVALID_TIME_INTERVAL. (calculation_version 1.3.0)\n\nSemantic capability: `electrical.power`.\n\nCalculation version: `1.3.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: V×I path is real power P, not apparent power S (use amps-to-va)\n\nLimitation: Three-phase is balanced sinusoidal L-L only\n\nLimitation: I²R tab is I+R only; V²/R is Ohm’s law, not a third tab\n\nLimitation: PF blank → 1; PF=0 → P=0; PF outside [0,1] → INVALID_POWER_FACTOR\n\nLimitation: Δt ≤ 0 → INVALID_TIME_INTERVAL (not a soft 0 W)\n\nLimitation: Sinusoidal PF teaching model; true PF with harmonics is not computed", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.0" ] }, "description": "Pin calculation_version (published: 1.3.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.power.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.0", "examples": [ "1.3.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.power.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/electricity": { "post": { "operationId": "calculate_electrical_electricity_bill", "summary": "Electricity bill", "description": "Estimate a simple electricity bill from kWh or meter readings plus rates and fees. (calculation_version 1.3.1)\n\nSemantic capability: `electrical.electricity_bill`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not for TOU / slab tariffs / export credits\n\nLimitation: Current meter reading must be ≥ previous reading; otherwise METER_READING_DECREASED is returned\n\nLimitation: Fee is a lump sum only; percentage and per-kWh taxes are not calculated", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.electricity_bill.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.electricity_bill.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/amps-to-kw": { "post": { "operationId": "calculate_electrical_amps_to_kw", "summary": "Amps to kW", "description": "Convert current and voltage to real power in kW (or reverse) for DC, single-phase AC, and balanced three-phase L-L. (calculation_version 1.4.3)\n\nSemantic capability: `electrical.amps_to_kw`.\n\nCalculation version: `1.4.3`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: DC, single-phase AC, or balanced three-phase L-L only\n\nLimitation: DC payloads must omit power_factor\n\nLimitation: Not for unbalanced three-phase\n\nLimitation: Not for line-to-neutral three-phase as a selectable mode\n\nLimitation: AC power_factor must be in (0, 1] — no soft coerce\n\nLimitation: V ≤ 0 → VOLTAGE_MUST_BE_POSITIVE\n\nLimitation: factor is an implementation constant (0.001) and is not an Agent input", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.3" ] }, "description": "Pin calculation_version (published: 1.4.3); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.amps_to_kw.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.3", "examples": [ "1.4.3" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.amps_to_kw.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/amps-to-volts": { "post": { "operationId": "calculate_electrical_amps_to_volts", "summary": "Amps to volts", "description": "Solve voltage from current plus resistance or power, and reverse to current. Watts paths cover DC, AC single-phase, and balanced three-phase L-L. (calculation_version 1.4.2)\n\nSemantic capability: `electrical.amps_to_volts`.\n\nCalculation version: `1.4.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Composite page: ohms path is V=IR; watts path is P/(I·PF) with optional √3\n\nLimitation: Not for converting amps to volts from current alone\n\nLimitation: JSON Schema is a callable-input envelope (types/required/enums). Zeros, negatives, and PF outside (0,1] may be schema-valid; the engine returns stable error codes\n\nLimitation: DC payloads must omit power_factor. REST may still send PF on DC: ignored with POWER_FACTOR_IGNORED\n\nLimitation: AC watts paths require power_factor in (0, 1]. UI initializes AC PF to 1.0; Agent/API clients must send it. Explicit PF=0 is POWER_FACTOR_OUT_OF_RANGE, not a silent 1\n\nLimitation: P>0 with I=0 → CURRENT_MUST_BE_NONZERO; V≠0 with R=0 → RESISTANCE_MUST_BE_NONZERO; 0/0 → UNDEFINED\n\nLimitation: IEEE-754 binary64; non-finite results → NON_FINITE_RESULT\n\nLimitation: Not for unbalanced three-phase", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.2" ] }, "description": "Pin calculation_version (published: 1.4.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.amps_to_volts.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.2", "examples": [ "1.4.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.amps_to_volts.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/kva-to-amps": { "post": { "operationId": "calculate_electrical_kva_to_amps", "summary": "kVA to amps", "description": "Convert apparent power in kVA to line current for single- or three-phase systems. (calculation_version 1.4.1)\n\nSemantic capability: `electrical.kva_to_amps`.\n\nCalculation version: `1.4.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not for unbalanced three-phase\n\nLimitation: Not for line-to-neutral as a separate UI mode\n\nLimitation: No power factor on apparent path\n\nLimitation: V>0 hard — VOLTAGE_MUST_BE_POSITIVE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.1" ] }, "description": "Pin calculation_version (published: 1.4.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.kva_to_amps.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.1", "examples": [ "1.4.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.kva_to_amps.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/va-to-kva": { "post": { "operationId": "calculate_electrical_va_to_kva", "summary": "VA to kVA", "description": "Scale volt-amperes to kilovolt-amperes (÷1000) or reverse (×1000). (calculation_version 1.3.1)\n\nSemantic capability: `electrical.va_to_kva`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not a watts/kW conversion — power factor is not used\n\nLimitation: Physical use assumes non-negative apparent power", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.va_to_kva.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.va_to_kva.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/kva-to-kw": { "post": { "operationId": "calculate_electrical_kva_to_kw", "summary": "kVA to kW", "description": "Convert apparent power to real power using power factor: kW = kVA × PF. (calculation_version 1.4.1)\n\nSemantic capability: `electrical.kva_to_kw`.\n\nCalculation version: `1.4.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: PF ∈ (0,1] hard\n\nLimitation: No voltage/phase required", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.1" ] }, "description": "Pin calculation_version (published: 1.4.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.kva_to_kw.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.1", "examples": [ "1.4.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.kva_to_kw.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/kw-to-va": { "post": { "operationId": "calculate_electrical_kw_to_va", "summary": "kW to VA", "description": "Estimate apparent power in VA from real power and power factor. (calculation_version 1.3.1)\n\nSemantic capability: `electrical.kw_to_va`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: PF ∈ (0,1] hard\n\nLimitation: Built-in kW↔VA scale ×1000", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.kw_to_va.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.kw_to_va.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/watts-to-va": { "post": { "operationId": "calculate_electrical_watts_to_va", "summary": "Watts to VA", "description": "Convert real power (W) and apparent power (VA) using power factor — PF required (electrical.active_power_from_apparent_power / apparent_from_P_pf). (calculation_version 1.3.1)\n\nSemantic capability: `electrical.watts_to_va`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not for voltage/current→VA (use amps-to-va)\n\nLimitation: PF must be in (0, 1] — PF=0 → POWER_FACTOR_OUT_OF_RANGE (not a soft zero)\n\nLimitation: Roadmap model op: real_from_S_pf / apparent_from_P_pf", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_to_va.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_to_va.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/watts-to-kva": { "post": { "operationId": "calculate_electrical_watts_to_kva", "summary": "Watts to kVA", "description": "Convert real power in watts to apparent power in kVA using power factor: kVA = W ÷ (1000 × PF). Same PF rule as Watts to VA, scaled to kilovolt-amperes. (calculation_version 1.3.1)\n\nSemantic capability: `electrical.watts_to_kva`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: PF ∈ (0,1] hard\n\nLimitation: No voltage/phase required\n\nLimitation: Shares the scale-quotient helper with kWh→W; contracts are distinct (PF vs time)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_to_kva.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_to_kva.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/kwh-to-watts": { "post": { "operationId": "calculate_electrical_kwh_to_watts", "summary": "kWh to Watts", "description": "Convert energy in kWh and a time period into average power in watts: W = 1000 × kWh ÷ h. Reverse: kWh = W × h ÷ 1000. (calculation_version 1.2.1)\n\nSemantic capability: `electrical.kwh_to_watts`.\n\nCalculation version: `1.2.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Average power over the interval — not instantaneous peak\n\nLimitation: Time must be in hours\n\nLimitation: Shares the scale-quotient helper with W→kVA; contracts are distinct (time vs PF)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.1" ] }, "description": "Pin calculation_version (published: 1.2.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.kwh_to_watts.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.1", "examples": [ "1.2.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.kwh_to_watts.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/volts-to-joules": { "post": { "operationId": "calculate_electrical_volts_to_joules", "summary": "Volts to Joules", "description": "Relate voltage and charge to energy: E = V × Q (1 V = 1 J/C). Reverse: V = E ÷ Q. (calculation_version 1.2.0)\n\nSemantic capability: `electrical.volts_to_joules`.\n\nCalculation version: `1.2.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Cannot convert volts to joules without a charge (or equivalent)\n\nLimitation: Shares the product helper with W→J; contracts are distinct (Q vs t)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.0" ] }, "description": "Pin calculation_version (published: 1.2.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.volts_to_joules.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.0", "examples": [ "1.2.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.volts_to_joules.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/watts-to-joules": { "post": { "operationId": "calculate_electrical_watts_to_joules", "summary": "Watts to Joules", "description": "Convert power and time to energy: E(J) = P(W) × t(s). Reverse: P = E ÷ t. 1 W = 1 J/s. (calculation_version 1.2.1)\n\nSemantic capability: `electrical.watts_to_joules`.\n\nCalculation version: `1.2.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Cannot convert watts to joules without a duration\n\nLimitation: Shares the product helper with V→J; contracts are distinct (t vs Q)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.1" ] }, "description": "Pin calculation_version (published: 1.2.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_to_joules.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.1", "examples": [ "1.2.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.watts_to_joules.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/volts-to-kw": { "post": { "operationId": "calculate_electrical_volts_to_kw", "summary": "Volts to kW", "description": "Estimate real power from voltage, current, phase, and power factor. (calculation_version 1.3.1)\n\nSemantic capability: `electrical.volts_to_kw`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: PF ∈ (0,1] hard — FRACTION_OUT_OF_RANGE\n\nLimitation: V>0 on forward; I>0 on reverse", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.volts_to_kw.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.volts_to_kw.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/awg-to-mm": { "post": { "operationId": "calculate_electrical_awg_to_mm", "summary": "AWG to mm / mm²", "description": "Look up American Wire Gauge geometry: unrounded ASTM B258 geometric progression (primary) plus Table 1 SI standard nominals for integer 4/0–56; copper resistance at 20 °C; educational NFPA 70–style ampacity reference (edition not pinned). Accepts 12, 1/0, 4/0, or legacy −3…0. (calculation_version 1.5.0)\n\nSemantic capability: `electrical.awg_to_mm`.\n\nCalculation version: `1.5.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Solid round conductor geometric model (ASTM B258-18(2026); 2026 reapproval of B258-18)\n\nLimitation: Primary geometry is unrounded geometric progression (formula_derived); ASTM Table 1 SI nominals are a separate standard_nominal track for integer 4/0–56\n\nLimitation: Not stranded equivalent area or insulated OD\n\nLimitation: Copper Ω/km is a 20 °C material model, not AWG geometry\n\nLimitation: Ampacity is an educational NFPA 70–style thermal reference (table-like 310.16, edition not pinned); copper 14–4/0 include 60/75/90 °C; 16 AWG and finer not tabulated; not jurisdiction-usable and not a branch-circuit rating\n\nLimitation: CVP numeric goldens cover AWG diameter/area geometry; resistance is a 20 °C IACS material model; ampacity is dataset-integrity only, not NEC compliance\n\nLimitation: Integer 4/0 (−3) through 56 = standard_range + formula_derived (+ standard_nominal); non-integer n in that span → AWG_NONSTANDARD_GAUGE + formula_interpolation; n outside the span → AWG_OUTSIDE_STANDARD_RANGE + formula_extrapolation\n\nLimitation: Missing/empty awg → MISSING_REQUIRED_INPUT (empty is not AWG 0 / 1/0)\n\nLimitation: Unparseable awg → INVALID_NUMBER; field not mm|mm2 → INVALID_MODE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.5.0" ] }, "description": "Pin calculation_version (published: 1.5.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.awg_to_mm.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.5.0", "examples": [ "1.5.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.5.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.awg_to_mm.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/wire-gauge-chart": { "post": { "operationId": "calculate_electrical_awg_to_mm_alias_wire_gauge_chart", "summary": "AWG to mm / mm² (wire-gauge-chart page alias)", "description": "Look up American Wire Gauge geometry: unrounded ASTM B258 geometric progression (primary) plus Table 1 SI standard nominals for integer 4/0–56; copper resistance at 20 °C; educational NFPA 70–style ampacity reference (edition not pinned). Accepts 12, 1/0, 4/0, or legacy −3…0. (calculation_version 1.5.0)\n\nSemantic capability: `electrical.awg_to_mm`.\n\nCalculation version: `1.5.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Solid round conductor geometric model (ASTM B258-18(2026); 2026 reapproval of B258-18)\n\nLimitation: Primary geometry is unrounded geometric progression (formula_derived); ASTM Table 1 SI nominals are a separate standard_nominal track for integer 4/0–56\n\nLimitation: Not stranded equivalent area or insulated OD\n\nLimitation: Copper Ω/km is a 20 °C material model, not AWG geometry\n\nLimitation: Ampacity is an educational NFPA 70–style thermal reference (table-like 310.16, edition not pinned); copper 14–4/0 include 60/75/90 °C; 16 AWG and finer not tabulated; not jurisdiction-usable and not a branch-circuit rating\n\nLimitation: CVP numeric goldens cover AWG diameter/area geometry; resistance is a 20 °C IACS material model; ampacity is dataset-integrity only, not NEC compliance\n\nLimitation: Integer 4/0 (−3) through 56 = standard_range + formula_derived (+ standard_nominal); non-integer n in that span → AWG_NONSTANDARD_GAUGE + formula_interpolation; n outside the span → AWG_OUTSIDE_STANDARD_RANGE + formula_extrapolation\n\nLimitation: Missing/empty awg → MISSING_REQUIRED_INPUT (empty is not AWG 0 / 1/0)\n\nLimitation: Unparseable awg → INVALID_NUMBER; field not mm|mm2 → INVALID_MODE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.5.0" ] }, "description": "Pin calculation_version (published: 1.5.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.awg_to_mm.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.5.0", "examples": [ "1.5.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.5.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.awg_to_mm.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/swg-to-mm": { "post": { "operationId": "calculate_electrical_swg_to_mm", "summary": "SWG to mm / mm²", "description": "Convert Standard Wire Gauge to diameter (mm) or cross-section (mm²). (calculation_version 1.3.1)\n\nSemantic capability: `electrical.swg_to_mm`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Lookup table only for integer SWG 7/0 (−6) through 50\n\nLimitation: Out-of-range → SWG_OUT_OF_RANGE (not 0 mm)\n\nLimitation: Non-integer → SWG_NOT_INTEGER (not Math.round)\n\nLimitation: Canonical diameter is inch; mm = inch × 25.4 (exact); area uses that mm\n\nLimitation: SWG ≠ AWG; same number different diameter", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.swg_to_mm.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.swg_to_mm.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mah-to-wh": { "post": { "operationId": "calculate_electrical_mah_to_wh", "summary": "mAh to Wh", "description": "Convert battery capacity in milliamp-hours and voltage to watt-hours. (calculation_version 1.3.1)\n\nSemantic capability: `electrical.mah_to_wh`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ignores charge/discharge efficiency and Peukert effects\n\nLimitation: V ≤ 0 → VOLTAGE_MUST_BE_POSITIVE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.mah_to_wh.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.mah_to_wh.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/battery-runtime": { "post": { "operationId": "calculate_electrical_battery_runtime", "summary": "Battery runtime", "description": "Estimate constant-load battery runtime from capacity, voltage, load (W load-side or A battery-side), DoD, and load-side efficiency (watts mode); optional u_* compose expanded uncertainty on t_h via Uncertainty Engine. (calculation_version 1.2.1)\n\nSemantic capability: `electrical.battery_runtime`.\n\nCalculation version: `1.2.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Constant-load idealization only — not Peukert, temperature, or BMS cutoffs\n\nLimitation: Not a substitute for manufacturer runtime curves or pack design\n\nLimitation: Amps mode = battery-side discharge current; η does not enter runtime\n\nLimitation: capacity_Ah XOR capacity_mAh; both → INVALID_INPUT\n\nLimitation: Missing capacity → MISSING_REQUIRED_INPUT; P_W/I_A ≤ 0 → LOAD_MUST_BE_POSITIVE\n\nLimitation: dod/eta outside (0,1] → FRACTION_OUT_OF_RANGE\n\nLimitation: mode=watts requires P_W; mode=amps requires I_A\n\nLimitation: Optional u_* use GUM sensitivity only (no MC/ρ/νeff UI); empty u_* preserves nominal-only result\n\nLimitation: Response inputs[] is mode-canonical (capacity_Ah only; amps omits eta)\n\nLimitation: Basic frozen at calculation_version 1.2.1 — Agent schema requires u_* when uncertainty_k/confidence is set; do not stack Peukert/temperature/duty-cycle into this capability", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.1" ] }, "description": "Pin calculation_version (published: 1.2.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery_runtime.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.1", "examples": [ "1.2.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery_runtime.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/rc-time-constant": { "post": { "operationId": "calculate_electrical_rc_time_constant", "summary": "RC time constant", "description": "Solve series RC time constant τ = R·C from any two of R, C, tau; also returns −3 dB frequency and common timing multiples. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rc_time_constant`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Series first-order RC only — not parallel networks or distributed RC\n\nLimitation: f_c is the ideal LPF −3 dB corner; not a filter design tool\n\nLimitation: Fewer than two inputs → NEEDS_TWO_INPUTS; non-positive → VALUE_MUST_BE_POSITIVE\n\nLimitation: When R and C are both provided, tau is recomputed from R·C", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rc_time_constant.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rc_time_constant.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/rlc-resonance": { "post": { "operationId": "calculate_electrical_rlc_resonance", "summary": "RLC resonance", "description": "Compute ideal series or parallel RLC resonant frequency, Q, bandwidth, and reactance at resonance from L, C, and R. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rlc_resonance`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal lumped RLC only — not coupled coils, transmission lines, or crystal models\n\nLimitation: Parallel mode assumes ideal parallel R with L and C (no ESR/ESL)\n\nLimitation: Missing/non-positive L/C/R → MISSING_REQUIRED_INPUT / VALUE_MUST_BE_POSITIVE\n\nLimitation: Unknown mode → INVALID_MODE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rlc_resonance.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rlc_resonance.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mosfet-conduction-loss": { "post": { "operationId": "calculate_electrical_mosfet_conduction_loss", "summary": "MOSFET conduction loss", "description": "Compute MOSFET conduction loss from I, Rds(on), current_basis (dc / on-interval RMS / full-cycle MOSFET RMS), and optional Rds(Tj) via linear α or datasheet ratio. (calculation_version 1.2.2)\n\nSemantic capability: `electrical.mosfet.conduction_loss`.\n\nCalculation version: `1.2.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Conduction loss only — not switching, reverse recovery, or gate drive\n\nLimitation: Rds(Tj) is optional first-order linear or datasheet-ratio — not a physics compact model\n\nLimitation: Default α = 0.006 /°C is a Si MOSFET planning default, not manufacturer validated\n\nLimitation: current_basis selects the I definition; mixing full-cycle RMS with D double-counts duty\n\nLimitation: V_drop is I·Rds_Tj at the entered current, not a measured VDS(on) waveform point\n\nLimitation: Missing/non-positive I/Rds → MISSING_REQUIRED_INPUT / VALUE_MUST_BE_POSITIVE; D outside (0,1] → FRACTION_OUT_OF_RANGE; unknown current_basis or temperature_model → INVALID_MODE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.2" ] }, "description": "Pin calculation_version (published: 1.2.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.conduction_loss.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.2", "examples": [ "1.2.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.conduction_loss.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/uncertainty-propagate": { "post": { "operationId": "calculate_engineering_uncertainty_propagate", "summary": "Uncertainty propagation", "description": "Propagate standard uncertainties: GUM linear (binary/sensitivity/RSS/budget) or Monte Carlo (JCGM 101); optional correlations, contributions, νeff, Student-t/percentile coverage → U. (calculation_version 1.9.8)\n\nSemantic capability: `engineering.uncertainty.propagate`.\n\nCalculation version: `1.9.8`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Linear GUM (binary/sensitivity/RSS/budget) or Monte Carlo (JCGM 101) with normal/rectangular draws; not adaptive/MCMC\n\nLimitation: MC: N in 100…100000 (default 10000), deterministic Mulberry32 seed; confidence → empirical percentiles; k → U=k·u_c\n\nLimitation: budget/sensitivity Type A/B + distributions are metadata (except MC uses distribution for draws); u is standard uncertainty\n\nLimitation: contributions are diagonal (c·u)² fractions for linear modes; with correlations percents may not sum to 100%\n\nLimitation: Product/quotient use absolute first-order forms in linear mode; MC quotient rejects >5% near-zero denominator draws (MONTECARLO_UNSTABLE)\n\nLimitation: n×n correlation matrix not positive semidefinite → CORRELATION_MATRIX_NOT_PSD (singular PSD allowed); duplicate unordered pair → DUPLICATE_CORRELATION; conflicting ρ for the same pair → CONFLICTING_CORRELATION\n\nLimitation: Optional Quantity Engine v1.1: SI-prefix conversion + electrical derived rewrites (1000 mV + 2 V → 3 V; V/A → Ω; A·Ω → V; V×A → VA); different additive dimensions → UNIT_MISMATCH; not full SI algebra\n\nLimitation: Unknown mode → INVALID_MODE; k and confidence together → INVALID_INPUT\n\nLimitation: confidence with nonzero ρ/correlations → CORRELATED_DOF_NOT_SUPPORTED (use fixed k)\n\nLimitation: MC rectangular + correlation → CORRELATED_NON_NORMAL_MC_NOT_SUPPORTED (normal marginals only)\n\nLimitation: Public Agent schema uses canonical field names only (components.u/c/x; correlations i/j as index or name). Runtime still accepts legacy aliases (ua/uncertainty/sensitivity/value) for compatibility.", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.9.8" ] }, "description": "Pin calculation_version (published: 1.9.8); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.propagate.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.9.8", "examples": [ "1.9.8" ] } } }, "example": { "inputs": {}, "calculation_version": "1.9.8" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.propagate.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pcb-trace-width": { "post": { "operationId": "calculate_electrical_pcb_trace_width", "summary": "PCB trace width", "description": "Size PCB copper traces or check ampacity with the IPC-2221 I = k·ΔT^0.44·A^0.725 relation for external and internal layers; optional u_* compose expanded uncertainty on width or I via Uncertainty Engine. (calculation_version 1.1.1)\n\nSemantic capability: `electrical.pcb.trace_width`.\n\nCalculation version: `1.1.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: IPC-2221 closed form only — not IPC-2152 chart interpolation\n\nLimitation: 1 oz/ft² modeled as 1.378 mil thickness\n\nLimitation: Bad mode/layer → INVALID_MODE; non-positive → VALUE_MUST_BE_POSITIVE\n\nLimitation: Optional u_* use GUM sensitivity on the primary result only; uncertainty_k is coverage (not IPC k)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.1" ] }, "description": "Pin calculation_version (published: 1.1.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.trace_width.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.1", "examples": [ "1.1.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.trace_width.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/lpf": { "post": { "operationId": "calculate_electrical_lpf", "summary": "Low-pass filter", "description": "Solve first-order RC LPF cutoff fc = 1/(2πRC) from any two of R, C, fc; optional magnitude |H(f)| in linear and dB. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.lpf`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: First-order passive RC LPF only\n\nLimitation: Fewer than two of R/C/fc → NEEDS_TWO_INPUTS\n\nLimitation: When R and C both provided, fc is recomputed", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.lpf.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.lpf.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/fspl": { "post": { "operationId": "calculate_electrical_rf_fspl", "summary": "Free-space path loss", "description": "Compute Friis free-space path loss from distance and frequency, with optional antenna gains Gt/Gr in dBi. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rf.fspl`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal free-space only — no atmosphere, multipath, or cable loss\n\nLimitation: d_m/f_Hz ≤ 0 → VALUE_MUST_BE_POSITIVE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.fspl.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.fspl.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mosfet-switching-loss": { "post": { "operationId": "calculate_electrical_mosfet_switching_loss", "summary": "MOSFET switching loss", "description": "First-order hard-switching overlap loss P_sw = ½·Vds·Id·(tr+tf)·f_sw and optional gate-drive power Qg·Vdrive·f_sw. Not a full MOSFET loss stack. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.mosfet.switching_loss`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Hard-switching linear transition only — not soft-switching or Eon/Eoff tables\n\nLimitation: Qg and Vdrive must both be present or both omitted (else NEEDS_TWO_INPUTS)\n\nLimitation: Conduction loss is a separate capability\n\nLimitation: P_gate is gate-drive power — not necessarily dissipated entirely in the MOSFET junction", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.switching_loss.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.switching_loss.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mosfet-total-loss": { "post": { "operationId": "calculate_electrical_mosfet_total_loss", "summary": "MOSFET total loss", "description": "Compose MOSFET loss workspace: device dissipation (conduction + hard-switching + optional Coss/Eoss) plus optional gate-drive and Qrr commutation, with optional Tj = Ta + P_device·Rth. Omitted optional terms are not treated as 0 W. (calculation_version 1.1.2)\n\nSemantic capability: `electrical.mosfet.total_loss`.\n\nCalculation version: `1.1.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: First-order hard-switching workspace — not Eon/Eoff tables, Qoss(V) curves, or compact models\n\nLimitation: Conduction uses electrical.mosfet.conduction_loss; switching/gate use electrical.mosfet.switching_loss\n\nLimitation: Default α = 0.006 /°C is a Si planning default, not manufacturer validated\n\nLimitation: P_coss from ½·Coss·V²·f is a lumped equivalent — prefer datasheet Eoss at Vds\n\nLimitation: Overlap P_sw plus P_coss may overestimate due to double counting; first-order only — validate against measured Eon/Eoff\n\nLimitation: P_rr = Qrr·Vds·f is recovered-charge commutation loss, usually attributed to the complementary switch — not this die\n\nLimitation: P_gate is gate-drive power (driver + Rg + Rg,int) — not MOSFET junction dissipation; Tj_est uses P_device only\n\nLimitation: Tj_est is steady-state RthJA only — not Zth or CFD\n\nLimitation: Numeric 0 on omitted P_gate/P_coss/P_rr means not included (see terms_omitted), not a measured zero\n\nLimitation: Optional Qg/Coss/Eoss/Qrr if present must be > 0; explicit 0 is not yet a supported known-zero state\n\nLimitation: Qg and Vdrive must both be present or both omitted (else NEEDS_TWO_INPUTS)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.2" ] }, "description": "Pin calculation_version (published: 1.1.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.total_loss.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.2", "examples": [ "1.1.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.total_loss.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/battery-runtime-temp": { "post": { "operationId": "calculate_electrical_battery_runtime_temp", "summary": "Battery runtime with temperature", "description": "Constant-load battery runtime with a generic cold-derating temperature capacity factor about 25 °C (extends Battery Runtime base: watts load-side / amps battery-side). Planning model — not chemistry. (calculation_version 1.2.1)\n\nSemantic capability: `electrical.battery.runtime_temp`.\n\nCalculation version: `1.2.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Generic cold-derating planning model by default — not Peukert, Arrhenius, or manufacturer curves\n\nLimitation: Default k_T=0.006 is a planning default (parameter_validated=false), not a validated chemistry coefficient\n\nLimitation: Clamp is a numerical safeguard, not an operating-temperature envelope\n\nLimitation: T≥25 °C under generic_cold_derating does not increase capacity (no high-temp bonus)\n\nLimitation: custom_symmetric_linear is advanced opt-in and still a first-order heuristic\n\nLimitation: Amps mode = battery-side current; η does not enter runtime\n\nLimitation: capacity_Ah XOR capacity_mAh; both → INVALID_INPUT\n\nLimitation: k_T < 0 → VALUE_MUST_BE_NON_NEGATIVE\n\nLimitation: Intermediate layer toward chemistry/manufacturer profile runtime — not a Battery Simulator", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.1" ] }, "description": "Pin calculation_version (published: 1.2.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery.runtime_temp.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.1", "examples": [ "1.2.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery.runtime_temp.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/parallel-resistor": { "post": { "operationId": "calculate_electrical_parallel_resistor", "summary": "Parallel resistor", "description": "Equivalent resistance of N≥2 parallel resistors: 1/Req = Σ 1/Ri. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.parallel_resistor`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Parallel only\n\nLimitation: N<2 → NEEDS_TWO_INPUTS", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.parallel_resistor.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.parallel_resistor.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pcb-microstrip": { "post": { "operationId": "calculate_electrical_pcb_microstrip", "summary": "Microstrip impedance", "description": "IPC-2141 / Hammerstad zero-thickness microstrip Z0 or width synthesis. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.pcb.microstrip`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Zero thickness; no soldermask\n\nLimitation: er≤1 → ER_MUST_BE_GT_1", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.microstrip.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.microstrip.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pcb-via-current": { "post": { "operationId": "calculate_electrical_pcb_via_current", "summary": "Via current capacity", "description": "IPC-2221 via ampacity from plating cross-section A=πt(d−t). (calculation_version 1.0.0)\n\nSemantic capability: `electrical.pcb.via_current`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: IPC-2221 closed form\n\nLimitation: t≥d/2 → PLATING_TOO_THICK", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.via_current.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.via_current.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/rf-link-budget": { "post": { "operationId": "calculate_electrical_rf_link_budget", "summary": "RF link budget", "description": "Friis FSPL link budget with gains, misc loss, received power, and optional margin; optional u_* compose expanded uncertainty on Pr_dBm via Uncertainty Engine. (calculation_version 1.1.1)\n\nSemantic capability: `electrical.rf.link_budget`.\n\nCalculation version: `1.1.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal free space only\n\nLimitation: Extends electrical.rf.fspl\n\nLimitation: Optional u_* use GUM sensitivity on Pr only (no MC/ρ/νeff UI); empty u_* preserves 1.0.0 fields", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.1" ] }, "description": "Pin calculation_version (published: 1.1.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.link_budget.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.1", "examples": [ "1.1.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.link_budget.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/battery-pack-sizing": { "post": { "operationId": "calculate_electrical_battery_pack_sizing", "summary": "Battery pack sizing", "description": "Invert BatteryRuntimeBaseInput constant-load model to size Ah from runtime/load (watts load-side / amps battery-side); optional nominal Ns/Np packing estimate. (calculation_version 1.2.0)\n\nSemantic capability: `electrical.battery.pack_sizing`.\n\nCalculation version: `1.2.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Constant-load inverse of BatteryRuntimeBaseInput / battery_runtime 1.2+\n\nLimitation: Amps mode = battery-side current; η does not enter Ah\n\nLimitation: Cell Ns/Np use ceil — nominal packing estimate only, not BMS / chemistry pack design\n\nLimitation: When V_pack ≠ V_target the result includes warning PACK_VOLTAGE_DIFFERS_FROM_TARGET\n\nLimitation: mode=watts requires P_W; mode=amps requires I_A\n\nLimitation: V_cell XOR incomplete pair → NEEDS_TWO_INPUTS (both or neither)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.0" ] }, "description": "Pin calculation_version (published: 1.2.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery.pack_sizing.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.0", "examples": [ "1.2.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery.pack_sizing.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/wheatstone-bridge": { "post": { "operationId": "calculate_electrical_wheatstone", "summary": "Wheatstone bridge", "description": "Four-arm Wheatstone bridge Vout and balance from Vin and R1…R4. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.wheatstone`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Unloaded ideal bridge only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.wheatstone.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.wheatstone.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/kirchhoff": { "post": { "operationId": "calculate_electrical_kirchhoff", "summary": "Kirchhoff's laws", "description": "Series KVL loop or parallel KCL node with N resistors. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.kirchhoff`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Single loop/node demo only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.kirchhoff.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.kirchhoff.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/led-resistor": { "post": { "operationId": "calculate_electrical_led_resistor", "summary": "LED resistor", "description": "Series LED current-limit resistor R=(Vs−n·Vf)/If. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.led_resistor`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Vs ≤ n·Vf → SUPPLY_TOO_LOW", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.led_resistor.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.led_resistor.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mosfet-tj": { "post": { "operationId": "calculate_electrical_mosfet_tj", "summary": "MOSFET junction temperature", "description": "Steady-state Tj = Ta + P·Rth. Effective RθJA, or case/heatsink-dominant RθJC+RθCA (not equivalent models). Mixing both paths is CONFLICTING_INPUTS. (calculation_version 1.1.2)\n\nSemantic capability: `electrical.mosfet.tj`.\n\nCalculation version: `1.1.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Steady-state only; not Zth or CFD\n\nLimitation: Rth_JA is effective/application RθJA for the user's PCB and cooling environment, not a universal JEDEC package constant\n\nLimitation: JC+CA is a case/heatsink-dominant lumped single-path approximation; it is not a universal equivalent of RθJA and ignores parallel PCB/package heat flow\n\nLimitation: Rth_JA and Rth_JC or Rth_CA together is schema-invalid and CONFLICTING_INPUTS", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.2" ] }, "description": "Pin calculation_version (published: 1.1.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.tj.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.2", "examples": [ "1.1.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.tj.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/cascaded-nf": { "post": { "operationId": "calculate_electrical_rf_cascaded_nf", "summary": "Cascaded noise figure", "description": "Friis cascaded NF and total gain from stage NF/G in dB. (calculation_version 1.1.1)\n\nSemantic capability: `electrical.rf.cascaded_nf`.\n\nCalculation version: `1.1.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Mismatch effects are not modeled\n\nLimitation: Image-noise / special mixer sideband behavior is not modeled\n\nLimitation: REST/MCP arrays NF_dB[]/G_dB[] are limited to 64 stages (TOO_MANY_STAGES); field encoding NF1…NF8 is limited to 8\n\nLimitation: Field encoding and array encoding are mutually exclusive (MIXED_INPUT_ENCODING); field stages must be contiguous from stage 1 (NONCONTIGUOUS_STAGES)\n\nLimitation: When 10^(G_tot_dB/10) overflows IEEE-754 binary64, G_tot_lin is null and LINEAR_GAIN_OVERFLOW is returned; G_tot_dB remains finite", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.1" ] }, "description": "Pin calculation_version (published: 1.1.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.cascaded_nf.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.1", "examples": [ "1.1.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.cascaded_nf.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/current-divider": { "post": { "operationId": "calculate_electrical_current_divider", "summary": "Current divider", "description": "Two-branch parallel current divider. Web UI: It, R1, R2 → I1, I2, V. API also solves selected inverse combinations (not arbitrary any-three; It+I1+I2 is underdetermined). (calculation_version 1.0.2)\n\nSemantic capability: `electrical.current_divider`.\n\nCalculation version: `1.0.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Exactly two ideal resistive parallel branches; no additional branch or load\n\nLimitation: Currents are non-negative magnitudes\n\nLimitation: Web UI is It+R1+R2 only\n\nLimitation: API supported combinations: It+R1+R2, R1+R2+I1, R1+R2+I2, It+I1+R1, It+I1+R2\n\nLimitation: It+I1+I2 is underdetermined → UNSUPPORTED_COMBINATION\n\nLimitation: Inverse It+I1+R1/R2 requires 0 < I1 < It for a finite R>0; I1=0 or I1=It → CURRENT_SPLIT_INVALID\n\nLimitation: It=0 and I1=0 with R1 or R2 is underdetermined → UNSUPPORTED_COMBINATION\n\nLimitation: <3 inputs → NEEDS_THREE_INPUTS", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.2" ] }, "description": "Pin calculation_version (published: 1.0.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.current_divider.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.2", "examples": [ "1.0.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.current_divider.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/hpf": { "post": { "operationId": "calculate_electrical_hpf", "summary": "High-pass filter", "description": "First-order RC HPF cutoff and optional |H(f)|. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.hpf`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: First-order RC only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.hpf.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.hpf.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/vswr": { "post": { "operationId": "calculate_electrical_rf_vswr", "summary": "VSWR", "description": "Convert |Γ|, VSWR, and return loss (plus mismatch loss). (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rf.vswr`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Scalar |Γ| only\n\nLimitation: |Γ|≥1 → GAMMA_OUT_OF_RANGE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.vswr.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.vswr.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/tolerance-stackup": { "post": { "operationId": "calculate_engineering_tolerance_stackup", "summary": "Tolerance stack-up", "description": "1-D RSS or worst-case tolerance stack — Basic tol list or Engineering dimensions (nominal, ±tol, direction). (calculation_version 1.4.0)\n\nSemantic capability: `engineering.tolerance.stackup`.\n\nCalculation version: `1.4.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: 1-D linear stack only — not geometric GD&T or Monte Carlo\n\nLimitation: Basic inputs are treated as comparable tolerance magnitudes, not automatically as 1σ / 3σ / drawing limits\n\nLimitation: RSS is a statistical estimate under independence; it is not a guaranteed assembly limit\n\nLimitation: Engineering statistical_basis: magnitude (default, no coverage) and 1sigma use a; 3sigma uses a/3; uniform uses a/√3\n\nLimitation: Uniform asymmetric ±tol shifts statistical center to interval midpoint (NIST Type B rectangular); stack_nom stays drawing nominal\n\nLimitation: Legacy distribution=normal→1sigma, unknown→magnitude, uniform→uniform\n\nLimitation: stack_half_range is not a hard worst-case bound when +Tol/−Tol are asymmetric about nominal — use stack_worst_plus / stack_worst_minus", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.4.0" ] }, "description": "Pin calculation_version (published: 1.4.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.tolerance.stackup.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.4.0", "examples": [ "1.4.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.4.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.tolerance.stackup.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/opamp-error-budget": { "post": { "operationId": "calculate_electrical_opamp_error_budget", "summary": "Op-amp error budget", "description": "DC Vos/Ib/Ios error budget with Rf/Rg (RSS or worst-case). (calculation_version 1.0.0)\n\nSemantic capability: `electrical.opamp.error_budget`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: DC Vos/Ib/Ios only — not noise/CMRR/PSRR", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.opamp.error_budget.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.opamp.error_budget.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/opamp-gain": { "post": { "operationId": "calculate_electrical_opamp_gain", "summary": "Op-amp gain", "description": "Closed-loop non-inverting / inverting gain from Rf and Rg. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.opamp_gain`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal DC closed-loop only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.opamp_gain.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.opamp_gain.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/antenna-length": { "post": { "operationId": "calculate_electrical_rf_antenna_length", "summary": "Antenna length", "description": "λ/2 dipole total length · λ/4 monopole radiator · corrected 1λ (k·λ₀) from frequency and empirical length factor k. (calculation_version 1.0.3)\n\nSemantic capability: `electrical.rf.antenna_length`.\n\nCalculation version: `1.0.3`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not a full antenna model — no ground, diameter, end-effect, loading coils, or NEC geometry.", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.3" ] }, "description": "Pin calculation_version (published: 1.0.3); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.antenna_length.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.3", "examples": [ "1.0.3" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.antenna_length.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ac-dc-rectifier": { "post": { "operationId": "calculate_electrical_ac_dc_rectifier", "summary": "AC↔DC rectifier", "description": "Ideal half/full-wave rectified waveform (Vpeak/Vavg/Vrms) or capacitor-smoothed DC estimate — two circuit models. (calculation_version 1.1.2)\n\nSemantic capability: `electrical.ac_dc_rectifier`.\n\nCalculation version: `1.1.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal diodes (0 V drop); not SCR/thyristor or active PFC\n\nLimitation: Vavg is the unfiltered rectified-sine average, not capacitor-smoothed DC bus voltage\n\nLimitation: Capacitor model uses continuous-discharge ΔV≈I/(f_ripple·C); when ΔV≥Vpeak, Vdc_est and Vmin are withheld (model_validity.valid=false)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.2" ] }, "description": "Pin calculation_version (published: 1.1.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.ac_dc_rectifier.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.2", "examples": [ "1.1.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.ac_dc_rectifier.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/adc-error-budget": { "post": { "operationId": "calculate_electrical_adc_error_budget", "summary": "ADC error budget", "description": "Combine gain/offset/INL/DNL into LSB, volts, and %FS. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.adc.error_budget`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Static DC errors only.\n\nLimitation: Quantization ±0.5 LSB is separate unless included in the INL/DNL terms you enter.\n\nLimitation: CalculatorX includes DNL as a separate RSS/worst-case contributor. Some ADC datasheets define TUE using gain, offset, and INL only.", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.adc.error_budget.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.adc.error_budget.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pcb-diff-impedance": { "post": { "operationId": "calculate_electrical_pcb_diff_impedance", "summary": "Differential impedance", "description": "Edge-coupled microstrip Zdiff from W, H, S, εr. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.pcb.diff_impedance`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Zero copper thickness (T=0); homogeneous dielectric; no soldermask\n\nLimitation: S_m is edge-to-edge gap, not center-to-center\n\nLimitation: Not a field solver; omits dielectric dispersion, copper roughness, and weave", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.diff_impedance.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.diff_impedance.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/capacitance": { "post": { "operationId": "calculate_electrical_capacitance", "summary": "Capacitance", "description": "Parallel-plate and series/parallel capacitance. (calculation_version 1.1.0)\n\nSemantic capability: `electrical.capacitance`.\n\nCalculation version: `1.1.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal parallel plates; homogeneous isotropic dielectric fully filling the gap; fringing, frequency dependence, dielectric loss, leakage, ESR/ESL and parasitics neglected", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.0" ] }, "description": "Pin calculation_version (published: 1.1.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.capacitance.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.0", "examples": [ "1.1.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.capacitance.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/transformer-sizing": { "post": { "operationId": "calculate_electrical_transformer_sizing", "summary": "Transformer sizing", "description": "Ideal transformer ratio, current, and VA. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.transformer_sizing`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal lossless single-phase", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.transformer_sizing.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.transformer_sizing.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/diode-equation": { "post": { "operationId": "calculate_electrical_diode_equation", "summary": "Diode equation", "description": "Shockley diode Id↔Vd. Canonical T_K; UI/query alias T_C. Defaults: mode=id, n=1, T_K=300. Inverse domain Id > -Is. (calculation_version 1.1.0)\n\nSemantic capability: `electrical.diode.equation`.\n\nCalculation version: `1.1.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal Shockley; no Rs/breakdown/high-injection\n\nLimitation: Is is specified at T; Is(T) is not derived\n\nLimitation: mode=vd requires Id > -Is\n\nLimitation: binary64 overflow → NUMERIC_OVERFLOW", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.0" ] }, "description": "Pin calculation_version (published: 1.1.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.diode.equation.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.0", "examples": [ "1.1.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.diode.equation.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/adc-snr": { "post": { "operationId": "calculate_electrical_adc_snr", "summary": "ADC SNR / ENOB", "description": "Ideal quantization SNR and ENOB from measured SINAD. (calculation_version 1.1.0)\n\nSemantic capability: `electrical.adc.snr`.\n\nCalculation version: `1.1.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal quantization only. ENOB from measured SINAD, not SNR.", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.0" ] }, "description": "Pin calculation_version (published: 1.1.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.adc.snr.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.0", "examples": [ "1.1.0" ] } } }, "example": { "inputs": { "mode": "snr", "n_bits": 12 }, "calculation_version": "1.1.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.adc.snr.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pcb-stripline": { "post": { "operationId": "calculate_electrical_pcb_stripline", "summary": "Stripline impedance", "description": "Symmetric stripline Z0 from W, b, εr. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.pcb.stripline`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Zero thickness approximation", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.stripline.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.stripline.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/dbm-watt": { "post": { "operationId": "calculate_units_rf_dbm_watts", "summary": "dBm to Watts", "description": "Convert dBm ↔ watts / milliwatts using log power ratios. (calculation_version 1.3.1)\n\nSemantic capability: `units.rf.dbm_watts`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: W/mW must be >0 for reverse log\n\nLimitation: Hard INVALID_MODE\n\nLimitation: IEEE-754 binary64 overflow → NUMERIC_OVERFLOW\n\nLimitation: IEEE-754 binary64 underflow to 0 → NUMERIC_UNDERFLOW", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.rf.dbm_watts.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": { "mode": "dbm-w", "value": 30 }, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.rf.dbm_watts.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/worst-case-analysis": { "post": { "operationId": "calculate_engineering_tolerance_worst_case", "summary": "Worst-Case Tolerance Analysis", "description": "1-D linear worst-case tolerance magnitude stack Σ|tol| with RSS comparison (|cᵢ|=1). (calculation_version 1.3.0)\n\nSemantic capability: `engineering.tolerance.worst_case`.\n\nCalculation version: `1.3.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: 1-D linear magnitude stack only — not a full nominal min/max dimensional chain\n\nLimitation: RSS comparison assumes consistent statistical basis and independence\n\nLimitation: MCP/agent input schema is canonical (tolerances[] ≥ 0); REST still accepts tol[] / tol1…tol8\n\nLimitation: Canonical/UI magnitudes must be ≥ 0 (NEGATIVE_TOLERANCE_MAGNITUDE). REST signed values ignore sign (SIGN_IGNORED_FOR_TOLERANCE_MAGNITUDE)\n\nLimitation: Unit is a shared label; all contributors must already use the same unit — no conversion", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.0" ] }, "description": "Pin calculation_version (published: 1.3.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.tolerance.worst_case.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.0", "examples": [ "1.3.0" ] } } }, "example": { "inputs": { "tolerances": [ 0.1, 0.2, 0.1 ], "unit": "mm" }, "calculation_version": "1.3.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.tolerance.worst_case.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/series-capacitor": { "post": { "operationId": "calculate_electrical_series_capacitor", "summary": "Series Capacitor", "description": "Series equivalent capacitance 1/C=Σ1/Ci. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.series_capacitor`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal capacitors", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.series_capacitor.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.series_capacitor.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/timer-555": { "post": { "operationId": "calculate_electrical_timer_555", "summary": "555 Timer", "description": "Astable frequency/duty/timing and monostable pulse width for the classic 555 using ln(2)-canonical NE555 timing (TI 0.693/1.44 are documented rounded aliases). (calculation_version 1.2.0)\n\nSemantic capability: `electrical.timer_555`.\n\nCalculation version: `1.2.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Classic NE555 ideal timing — astable uses ln(2) canonical model; TI 0.693/1.44 are rounded aliases\n\nLimitation: Device families differ in timing accuracy, leakage, output/discharge characteristics and usable frequency range; verify the selected device datasheet\n\nLimitation: Standard astable wiring always yields duty > 50%; diode-across-R2 <50% trick is not modeled\n\nLimitation: f > 100 kHz → NE555_HIGH_FREQUENCY warning (NE555 distortion guidance)\n\nLimitation: Monostable pulse_width < ~10 µs → MONOSTABLE_SHORT_PULSE warning\n\nLimitation: mode-discriminated oneOf: astable requires R1,R2,C; monostable requires R,C\n\nLimitation: Frozen at calculation_version 1.2.0 for forward timing — Designer / E-series / tolerance are separate surfaces", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.2.0" ] }, "description": "Pin calculation_version (published: 1.2.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.timer_555.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.2.0", "examples": [ "1.2.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.2.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.timer_555.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/skin-depth": { "post": { "operationId": "calculate_electrical_rf_skin_depth", "summary": "Skin Depth", "description": "Electromagnetic skin depth δ=√(ρ/(πfμ)). (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rf.skin_depth`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Good-conductor approximation", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.skin_depth.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.skin_depth.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/process-capability": { "post": { "operationId": "calculate_engineering_process_capability", "summary": "Process Capability (Cp/Cpk)", "description": "Design-stage Cp/Cpk from μ, σ, LSL, USL. Not in-control SPC and not Monte Carlo simulated indices. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.process.capability`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Design-stage indices from μ and σ — not measured in-control SPC\n\nLimitation: Not Monte Carlo simulated Cp/Cpk\n\nLimitation: Two-sided LSL/USL required; USL must be greater than LSL", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.capability.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "lsl": 0, "usl": 12, "mu": 6, "sigma": 1 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.capability.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/cpm": { "post": { "operationId": "calculate_engineering_process_cpm", "summary": "Process capability (Cpm)", "description": "Taguchi Cpm = (USL−LSL)/(6√(σ²+(μ−target)²)) from stated μ, σ, LSL, USL, and a target. Not Cp/Cpk, not Pp/Ppk, and not a Cpm≥1.33 verdict. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.process.cpm`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Design-stage from stated μ and σ — not measured in-control SPC\n\nLimitation: Not Cp/Cpk (those ignore the target in the denominator)\n\nLimitation: Not Pp/Ppk (those use sample s and have no target)\n\nLimitation: This page does not issue a Cpm≥1.33 verdict", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpm.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "lsl": 0, "usl": 12, "mu": 6, "sigma": 1, "target": 6 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpm.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/cpm-performance": { "post": { "operationId": "calculate_engineering_process_cpm_performance", "summary": "Process performance (Ppm)", "description": "Overall Taguchi Ppm = (USL−LSL)/(6√(s²+(x̄−target)²)) from a sample. Not design-stage Cpm, not Pp/Ppk, and not a Ppm≥1.33 verdict. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.process.cpm_performance`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Overall sample s — not design-stage Cpm from a stated σ\n\nLimitation: Not Pp/Ppk (those have no target in the denominator)\n\nLimitation: This page does not issue a Ppm≥1.33 verdict", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpm_performance.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "values": [ 4, 6, 8 ], "lsl": 0, "usl": 12, "target": 6 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpm_performance.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/cpmk": { "post": { "operationId": "calculate_engineering_process_cpmk", "summary": "Process capability (Cpmk)", "description": "Taguchi Cpmk = min(USL−μ, μ−LSL)/(3√(σ²+(μ−target)²)) from stated μ, σ, LSL, USL, and a target. Not Cpm, not Cpk, not Ppm, and not a Cpmk≥1.33 verdict. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.process.cpmk`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Design-stage from stated μ and σ — not measured in-control SPC\n\nLimitation: Not Cpm (that uses the two-sided span USL−LSL)\n\nLimitation: Not Cpk (Cpk has no target in the denominator)\n\nLimitation: Not Ppm (that uses sample s)\n\nLimitation: This page does not issue a Cpmk≥1.33 verdict", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpmk.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "lsl": 0, "usl": 12, "mu": 6, "sigma": 1, "target": 6 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpmk.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/cpmk-performance": { "post": { "operationId": "calculate_engineering_process_cpmk_performance", "summary": "Process performance (Ppmk)", "description": "Overall Taguchi Ppmk = min(USL−x̄, x̄−LSL)/(3√(s²+(x̄−target)²)) from a sample. Not Cpmk, not Ppk, not Ppm, and not a Ppmk≥1.33 verdict. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.process.cpmk_performance`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Overall sample s — not design-stage Cpmk from a stated σ\n\nLimitation: Not Ppk (Ppk has no target in the denominator)\n\nLimitation: Not Ppm (that uses the two-sided span USL−LSL)\n\nLimitation: This page does not issue a Ppmk≥1.33 verdict", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpmk_performance.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "values": [ 4, 6, 8 ], "lsl": 0, "usl": 12, "target": 6 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.cpmk_performance.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/process-performance": { "post": { "operationId": "calculate_engineering_process_performance", "summary": "Process performance (Pp/Ppk)", "description": "Overall Pp/Ppk from a sample of process observations. σ is the overall sample s (ddof=1). Not design-stage Cp/Cpk, not Type A u_A, and not Monte Carlo simulated indices. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.process.performance`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Overall sample s — not a stated design σ and not within-subgroup SPC\n\nLimitation: Not design-stage Cp/Cpk and not Type A u_A = s/√n\n\nLimitation: Not Monte Carlo simulated indices\n\nLimitation: Two-sided LSL/USL required; USL must be greater than LSL", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.performance.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "values": [ 4, 6, 8 ], "lsl": 0, "usl": 12 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.performance.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/guard-band": { "post": { "operationId": "calculate_engineering_process_guard_band", "summary": "Guard Band", "description": "Simple guard band GB=k·u with optional acceptance limits. Not ILAC G8 / JCGM 106 risk-based decision rules. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.process.guard_band`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: GB = k·u with k default 2 — not ILAC G8 / JCGM 106 risk-based rules\n\nLimitation: USL and LSL optional; omitted limits skip that acceptance output\n\nLimitation: Not Cp/Cpk and not Monte Carlo", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.guard_band.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "u": 0.5, "k": 2, "lsl": 0, "usl": 12 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.process.guard_band.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/type-a": { "post": { "operationId": "calculate_engineering_uncertainty_type_a", "summary": "Type A Uncertainty", "description": "Type A standard uncertainty u_A = s/√n from repeated observations. Not GUM combination and not Monte Carlo. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.type_a`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Type A from a sample — not GUM RSS of several uᵢ\n\nLimitation: Not Monte Carlo\n\nLimitation: ddof=1 requires n≥2", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.type_a.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "values": [ 1, 2, 3 ], "ddof": 1 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.type_a.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/type-b": { "post": { "operationId": "calculate_engineering_uncertainty_type_b", "summary": "Type B Uncertainty", "description": "Type B standard uncertainty from a half-width a. Rectangular u_B=a/√3, triangular u_B=a/√6. Not GUM combination and not Monte Carlo. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.type_b`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: One Type B component from a half-width — not GUM RSS of several uᵢ\n\nLimitation: Not Monte Carlo\n\nLimitation: Seeded distributions: rectangular and triangular only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.type_b.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "a": 3, "distribution": "rectangular" }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.type_b.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/type-b-nu": { "post": { "operationId": "calculate_engineering_uncertainty_type_b_nu", "summary": "Type B degrees of freedom", "description": "GUM G.4.2 Type B degrees of freedom: ν = ½(u/σ(u))². σ(u)=0 → ν is infinite. Not Type B u_B from a half-width, not Welch ν_eff, and not U = k·u_c. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.type_b_nu`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: GUM G.4.2 ν from stated u and σ(u) — not Type B u_B = a/√3\n\nLimitation: Not Welch–Satterthwaite ν_eff from several u_i, ν_i\n\nLimitation: Not expanded U = k·u_c\n\nLimitation: Does not take half-width a", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.type_b_nu.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "u": 2, "sigma_u": 0.5 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.type_b_nu.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/welch-satterthwaite": { "post": { "operationId": "calculate_engineering_uncertainty_welch_satterthwaite", "summary": "Welch–Satterthwaite ν_eff", "description": "Effective degrees of freedom ν_eff = u_c⁴ / Σ (u_i⁴ / ν_i) (GUM G.4). If uc is omitted, u_c is the uncorrelated RSS of u_i. Not combined RSS as a product page and not expanded U = k·u_c. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.welch_satterthwaite`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Does not combine a measurement model (use Uncertainty propagate)\n\nLimitation: Does not look up coverage factor k from a t-table\n\nLimitation: Does not compute expanded U = k·u_c\n\nLimitation: Uncorrelated RSS only when uc is omitted", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.welch_satterthwaite.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "u": [ 1, 1 ], "nu": [ 8, 8 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.welch_satterthwaite.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/weighted-mean": { "post": { "operationId": "calculate_engineering_uncertainty_weighted_mean", "summary": "Inverse-variance weighted mean", "description": "GUM H.3 inverse-variance weighted mean of independent results of the same measurand: x_w = Σ(x_i/u_i²)/Σ(1/u_i²), u_w = 1/√Σ(1/u_i²). Not combined RSS, not Type A u_A = s/√n, and not GUM propagate. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.weighted_mean`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Independent uncorrelated results of the same measurand — not RSS of a measurement model\n\nLimitation: Does not compute Type A u_A = s/√n from repeats without individual u_i\n\nLimitation: Does not compute expanded U = k·u_w\n\nLimitation: χ² / Birge are diagnostics, not a pass/fail verdict", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.weighted_mean.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "x": [ 2, 4, 6, 8 ], "u": [ 1, 1, 1, 1 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.weighted_mean.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/coverage-factor": { "post": { "operationId": "calculate_engineering_uncertainty_coverage_factor", "summary": "Coverage factor k", "description": "Two-sided coverage factor k = t_{(1+p)/2}(ν) from degrees of freedom and confidence (GUM G.3 / G.4). Infinite ν uses the normal quantile. Not expanded U = k·u_c and not GUM propagate. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.coverage_factor`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Does not compute expanded U = k·u_c (use Uncertainty propagate)\n\nLimitation: Does not combine a measurement model\n\nLimitation: Does not look up ν_eff (use Welch–Satterthwaite)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.coverage_factor.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "nu": 8, "confidence": 0.95 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.coverage_factor.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/tur": { "post": { "operationId": "calculate_engineering_uncertainty_tur", "summary": "Test uncertainty ratio TUR", "description": "Two-sided TUR = (USL−LSL)/(2U) from an already-expanded U (ANSI/NCSL Z540.3). Spec via lsl+usl, T, or half-width tol. Not pass/fail, not guard band, and not combined RSS. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.tur`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: U is already expanded — this page does not compute U = k·u_c\n\nLimitation: Does not combine a measurement model or RSS of u_i\n\nLimitation: Does not issue a TUR≥4 pass/fail or an ILAC G8 decision\n\nLimitation: Not a guard band and not Cp/Cpk", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.tur.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "U": 0.5, "lsl": 0, "usl": 4 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.tur.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/decision-rule": { "post": { "operationId": "calculate_engineering_conformity_decision_rule", "summary": "Conformity decision rule", "description": "Binary ILAC G8-style decision on a measured y: simple acceptance (w=0) or guarded acceptance (LSL+w ≤ y ≤ USL−w). The guard-band zone is fail, not conditional. Not JCGM 106 risk, not TUR, and not GB-only. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.conformity.decision_rule`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Binary pass/fail only — the guard-band zone is fail, not conditional\n\nLimitation: Does not compute ILAC G8 / JCGM 106 consumer or producer risk\n\nLimitation: Does not compute TUR or GB = k·u as a product (use those pages)\n\nLimitation: U or w is the already-stated band; this page does not expand u_c", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.decision_rule.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "y": 6, "lsl": 0, "usl": 12, "rule": "simple" }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.decision_rule.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mpe": { "post": { "operationId": "calculate_engineering_conformity_mpe", "summary": "Maximum permissible error MPE", "description": "VIM MPE: pass iff |ylab−xref| ≤ MPE. ratio = |ε|/MPE. Equality is pass. Not an ILAC G8 spec decision on y, not En (no U), and not ε without a limit. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.conformity.mpe`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Binary |ε| ≤ MPE — equality is pass\n\nLimitation: Does not compare y to LSL/USL (use the decision-rule page)\n\nLimitation: Does not divide by U (that is En) and does not report ε without a limit\n\nLimitation: U, Ulab, and T are not aliases for MPE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.mpe.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "ylab": 2.5, "xref": 2, "MPE": 1 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.mpe.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/normalized-error": { "post": { "operationId": "calculate_engineering_conformity_normalized_error", "summary": "Normalized error En", "description": "Proficiency-testing En = (ylab−xref)/√(Ulab²+Uref²). |En| ≤ 1 is pass (ISO 13528 / ISO/IEC 17043). Ulab and Uref are already expanded. Not zeta, not TUR, and not an ILAC G8 spec decision. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.conformity.normalized_error`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ulab and Uref are already expanded — this page does not compute U = k·u\n\nLimitation: Not the zeta-score (that uses standard u, not U)\n\nLimitation: Not TUR and not an ILAC G8 specification decision on y\n\nLimitation: |En| ≤ 1 is pass; the test does not add a warning zone", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.normalized_error.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "ylab": 2.5, "xref": 0, "Ulab": 3, "Uref": 4 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.normalized_error.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/zeta-score": { "post": { "operationId": "calculate_engineering_conformity_zeta_score", "summary": "Zeta-score", "description": "Proficiency-testing zeta-score ζ = (ylab−xref)/√(ulab²+uref²). ulab and uref are standard uncertainties (ISO 13528). |ζ| ≤ 2 pass, 2 < |ζ| < 3 warning, |ζ| ≥ 3 fail. Not En, not TUR, and not an ILAC G8 spec decision. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.conformity.zeta_score`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: ulab and uref are standard uncertainties — this page does not compute U = k·u or En\n\nLimitation: Not the normalized error En (that uses already-expanded U)\n\nLimitation: Not TUR and not an ILAC G8 specification decision on y\n\nLimitation: |ζ| ≤ 2 is pass; 2 < |ζ| < 3 is warning; |ζ| ≥ 3 is fail", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.zeta_score.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "ylab": 2.5, "xref": 0, "ulab": 3, "uref": 4 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.zeta_score.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/z-score": { "post": { "operationId": "calculate_engineering_conformity_z_score", "summary": "Proficiency-testing z-score", "description": "ISO 13528 z-score z = (ylab−xref)/σ_pt. σ_pt is the scheme standard deviation for proficiency assessment (SDPA), not laboratory u and not expanded U. |z| ≤ 2 pass, 2 < |z| < 3 warning, |z| ≥ 3 fail. Not zeta, not En, and not an ILAC G8 spec decision. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.conformity.z_score`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: σ_pt is the scheme SDPA — this page does not compute lab u or U = k·u\n\nLimitation: Not the zeta-score (that uses √(ulab²+uref²))\n\nLimitation: Not the normalized error En (that uses already-expanded U)\n\nLimitation: Not TUR and not an ILAC G8 specification decision on y\n\nLimitation: |z| ≤ 2 is pass; 2 < |z| < 3 is warning; |z| ≥ 3 is fail", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.z_score.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "ylab": 2.5, "xref": 0, "sigma": 5 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.z_score.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/z-prime": { "post": { "operationId": "calculate_engineering_conformity_z_prime", "summary": "Proficiency-testing z′", "description": "ISO 13528 z′ = (ylab−xref)/√(σ_pt²+u(x_pt)²). σ_pt and u(x_pt) must both be > 0 so this cannot wrap z-score. |z′| ≤ 2 pass, 2 < |z′| < 3 warning, |z′| ≥ 3 fail. Not z-score, not zeta, and not En. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.conformity.z_prime`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Requires σ_pt > 0 and u(x_pt) > 0 — this page does not wrap z-score\n\nLimitation: Not the z-score (that divides by σ_pt alone)\n\nLimitation: Not the zeta-score (that uses √(ulab²+uref²))\n\nLimitation: Not the normalized error En (that uses already-expanded U)\n\nLimitation: Not TUR and not an ILAC G8 specification decision on y", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.z_prime.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "ylab": 5, "xref": 0, "sigma": 3, "u_xref": 4 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.conformity.z_prime.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/measurement-error": { "post": { "operationId": "calculate_engineering_measurement_error", "summary": "Measurement error", "description": "VIM measurement error ε = ylab − xref (signed). Relative error is ε/xref when xref ≠ 0. Not percent error (×100), not En, not zeta, and not a z-score. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.measurement.error`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Signed error — this page does not multiply by 100 (that is percent error)\n\nLimitation: Not En, zeta, or z-score (those divide by U, u, or σ_pt)\n\nLimitation: Not an ILAC G8 specification decision\n\nLimitation: Relative error is undefined when xref = 0", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.error.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "ylab": 2.5, "xref": 2 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.error.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/accuracy": { "post": { "operationId": "calculate_engineering_measurement_accuracy", "summary": "Measurement bias (trueness)", "description": "VIM trueness: signed bias = x̄ − xm from repeats on a master. s may be zero. Not a single-shot measurement error, not Type A u_A, and not Type-1 Cg (no T). (calculation_version 1.0.0)\n\nSemantic capability: `engineering.measurement.accuracy`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Signed bias from a sample mean — not a single-shot measurement error ε\n\nLimitation: Does not report Type A u_A = s/√n\n\nLimitation: Does not need a tolerance T (that is Type-1 Cg/Cgk)\n\nLimitation: s = 0 is valid; n = 1 with ddof = 1 is VALUE_OUT_OF_RANGE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.accuracy.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "values": [ 6, 7, 8 ], "xm": 8 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.accuracy.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/precision": { "post": { "operationId": "calculate_engineering_measurement_precision", "summary": "Measurement precision (repeatability)", "description": "ISO 5725 repeatability from a sample: s, CV = s/|x̄| when x̄ ≠ 0, and r = 2.8·s. Not Type A u_A, not Gauge R&R EV, and not percent CV (×100). (calculation_version 1.0.0)\n\nSemantic capability: `engineering.measurement.precision`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: r = 2.8·s is the ISO 5725 conventional repeatability limit, not coverage factor k\n\nLimitation: Does not report Type A u_A = s/√n\n\nLimitation: Not Gauge R&R repeatability (EV)\n\nLimitation: CV is not multiplied by 100; CV is undefined when x̄ = 0", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.precision.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "values": [ 7, 8, 9 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.precision.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/reproducibility": { "post": { "operationId": "calculate_engineering_measurement_reproducibility", "summary": "ISO 5725 reproducibility limit", "description": "ISO 5725 reproducibility from stated components: s_R = √(s_r²+s_L²), R = 2.8·s_R. Not r = 2.8·s from a sample, not AIAG GRR, and not combined RSS of a measurement model. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.measurement.reproducibility`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Takes stated s_r and s_L — not a sample and not a single s_R wrap\n\nLimitation: Not ISO 5725 r = 2.8·s from repeats\n\nLimitation: Not AIAG Gauge R&R AV / GRR\n\nLimitation: Not combined RSS of a measurement model", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.reproducibility.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "s_r": 3, "s_L": 4 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.reproducibility.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/precision-uncertainty": { "post": { "operationId": "calculate_engineering_uncertainty_precision_mean", "summary": "Uncertainty of a mean from precision", "description": "ISO 21748 u = √(s_L²+s_r²/n) of a mean of n≥2 replicates from stated precision components. Not R = 2.8·s_R, not Type A from a sample, and not U = k·u. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.precision_mean`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Takes stated s_r, s_L, and n≥2 — not a sample of observations\n\nLimitation: n=1 is rejected so this cannot wrap s_R\n\nLimitation: Not ISO 5725 R = 2.8·s_R and not Type A u_A = s/√n from values\n\nLimitation: Does not compute expanded U = k·u", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.precision_mean.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "s_r": 8, "s_L": 3, "n": 4 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.precision_mean.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pooled-sd": { "post": { "operationId": "calculate_engineering_uncertainty_pooled_sd", "summary": "Pooled standard deviation", "description": "Pooled s_p = √(Σ ν_i s_i² / Σ ν_i) from k≥2 stated sample standard deviations and their degrees of freedom. Not Type A from one sample, not Welch–Satterthwaite ν_eff, and not ISO 21748 u of a mean. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.uncertainty.pooled_sd`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Takes stated s_i and ν_i — not a single sample of observations\n\nLimitation: k=1 is rejected so this cannot wrap Type A / identity s\n\nLimitation: Does not compute Welch–Satterthwaite ν_eff\n\nLimitation: Does not compute ISO 21748 u of a mean", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.pooled_sd.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "s": [ 1, 7 ], "nu": [ 1, 1 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.uncertainty.pooled_sd.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/duplicate-sd": { "post": { "operationId": "calculate_engineering_measurement_duplicate_sd", "summary": "Repeatability from duplicates", "description": "ISO 5725 repeatability s_r = √(Σ d_i² / (2m)) from m≥2 duplicate differences. Not Type A from a sample of observations, not r = 2.8·s, and not AIAG GRR EV = R̄/d2. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.measurement.duplicate_sd`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Takes duplicate differences — not a sample of observations\n\nLimitation: m=1 is rejected so this cannot wrap |d|/√2\n\nLimitation: Does not report r = 2.8·s_r\n\nLimitation: Not AIAG GRR EV = R̄/d2", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.duplicate_sd.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "d": [ 6, 8 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.duplicate_sd.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/cochran": { "post": { "operationId": "calculate_engineering_measurement_cochran", "summary": "Cochran's C", "description": "ISO 5725-2 Cochran C = s_max² / Σ s_i² from k≥2 stated laboratory sample standard deviations. Not pooled s_p, not Hartley's F_max, and not a tabulated Ccrit pass/fail. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.measurement.cochran`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Takes stated laboratory s_i — not a sample of observations\n\nLimitation: k=1 is rejected so this cannot wrap identity C=1\n\nLimitation: All-zero s is rejected (Σ s² must be > 0)\n\nLimitation: Does not compare C to a tabulated Ccrit(p, n, α)\n\nLimitation: Not pooled s_p and not Hartley's F_max", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.cochran.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "s": [ 3, 4, 5 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.measurement.cochran.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/gauge-capability": { "post": { "operationId": "calculate_engineering_msa_gauge_capability", "summary": "Gauge capability (Cg/Cgk)", "description": "Type-1 Cg/Cgk from repeats on a master: Cg=(frac·T)/(6s), Cgk=(frac·T/2−|x̄−xm|)/(3s). frac defaults to 0.2 (Bosch / VDA 5). Not AIAG GRR, not Cp/Cpk, and not a Cg≥1.33 verdict. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.msa.gauge_capability`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Type-1 study on a master — not AIAG GRR compose (EV/AV/PV)\n\nLimitation: Not process Cp/Cpk or Pp/Ppk\n\nLimitation: Does not issue a Cg≥1.33 pass/fail\n\nLimitation: frac is a tolerance fraction (default 0.2), not coverage factor k", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.gauge_capability.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "values": [ 7, 8, 9 ], "xm": 8, "T": 30 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.gauge_capability.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/linearity": { "post": { "operationId": "calculate_engineering_msa_linearity", "summary": "MSA linearity", "description": "OLS of measurement error ε = ylab − xref versus xref: slope = dε/d(xref). n≥3 paired points. Not a single-master bias, not Type-1 Cg, and not a %Linearity pass/fail. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.msa.linearity`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ordinary least squares of ε versus xref — not a %Linearity / process-variation verdict\n\nLimitation: Not a single-master bias (Accuracy) and not Type-1 Cg/Cgk\n\nLimitation: Does not take T and does not issue pass/fail\n\nLimitation: n≥3 paired points; xref must not all be equal", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.linearity.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "xref": [ 0, 2, 4 ], "ylab": [ 0, 3, 6 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.linearity.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/hysteresis": { "post": { "operationId": "calculate_engineering_msa_hysteresis", "summary": "MSA hysteresis", "description": "VIM / MSA hysteresis: H = max |y_up − y_down| at index-paired stations. n≥2. Not OLS linearity, not a %Hysteresis pass/fail, and not AIAG GRR. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.msa.hysteresis`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Maximum paired |y_up − y_down| — not a %Hysteresis / process-variation verdict\n\nLimitation: Not OLS of ε versus xref (Linearity) and not a single-shot measurement error\n\nLimitation: Does not take T and does not issue pass/fail\n\nLimitation: n≥2 index-paired points; not AIAG GRR", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.hysteresis.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "y_up": [ 0, 2, 4 ], "y_down": [ 0, 1, 4 ] }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.hysteresis.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/gauge-rr": { "post": { "operationId": "calculate_engineering_msa_gauge_rr", "summary": "Gauge R&R", "description": "AIAG Gauge R&R compose: GRR=√(EV²+AV²), TV=√(GRR²+PV²), %GRR, ndc. Optional range-method EV=R̄/d2. Not a full ANOVA study. (calculation_version 1.0.0)\n\nSemantic capability: `engineering.msa.gauge_rr`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: AIAG compose of stated EV, AV, PV — not a full ANOVA Gauge R&R\n\nLimitation: Range-method EV uses d2 default 1.128 (n=2)\n\nLimitation: GRR must be > 0 for ndc", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.gauge_rr.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "ev": 3, "av": 4, "pv": 12 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.msa.gauge_rr.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/monte-carlo-tolerance": { "post": { "operationId": "calculate_engineering_tolerance_monte_carlo", "summary": "1-D Tolerance Analysis Workspace", "description": "1-D Tolerance Analysis Workspace — dimensional Monte Carlo with asymmetric ±tol, correlations (normal or NORTA), Spearman/Pearson/Sobol/Shapley sensitivity, σ convergence, LSL/USL yield, simulated capability, fingerprint, and snapshots. (calculation_version 1.12.0)\n\nSemantic capability: `engineering.tolerance.monte_carlo`.\n\nCalculation version: `1.12.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: 1-D stack; correlations use joint normal (all-normal) or Gaussian-copula NORTA (non-normal marginals)\n\nLimitation: Asymmetric normal uses two-piece scaling; uniform/triangular use [-tol_minus,+tol_plus]\n\nLimitation: Cp/Cpk/Ppk are simulated design-stage indices from overall MC mean/σ — not measured in-control SPC\n\nLimitation: Sobol requires independent inputs; for this linear stack Si=STi=analytic variance shares\n\nLimitation: Shapley variance attribution supports correlation; exact for d≤12, permutation estimate for d>12\n\nLimitation: Under NORTA, analytic σ uses Cov≈ρ·σi·σj (latent ρ); prefer Monte Carlo σ\n\nLimitation: Shared query must encode noms/sense; legacy tol1/tol2 alone is error-only (nominals 0)\n\nLimitation: Not full GD&T / 3-D geometry\n\nLimitation: MCP/agent input schema is canonical (no legacy field aliases); REST still accepts aliases\n\nLimitation: calculation_fingerprint is SHA-256; calculation_short_id is FNV-1a32 for UI only\n\nLimitation: MCP execute/inspect default detail_level=summary; pass full for histogram/Sobol/Shapley/contributors\n\nLimitation: Agent correlations use named pairs {a,b,rho} only (no i/j indexes)\n\nLimitation: Agent tolerances: half_tolerance OR both tol_plus+tol_minus (no single-sided agent form)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.12.0" ] }, "description": "Pin calculation_version (published: 1.12.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/engineering.tolerance.monte_carlo.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.12.0", "examples": [ "1.12.0" ] } } }, "example": { "inputs": { "tolerances": [ { "name": "A", "nominal": 10, "tol_plus": 0.1, "tol_minus": 0.05, "coefficient": 1, "distribution": "normal" }, { "name": "B", "nominal": 5, "half_tolerance": 0.2, "coefficient": -1, "distribution": "normal" } ], "sensitivity_method": "spearman", "LSL": 4.8, "USL": 5.2, "unit": "mm", "N": 20000, "seed": 42, "k_sigma": 3 }, "calculation_version": "1.12.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/engineering.tolerance.monte_carlo.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/opamp-noise": { "post": { "operationId": "calculate_electrical_opamp_noise", "summary": "Op-amp Noise", "description": "Flat-band op-amp output noise from en, gain, and bandwidth. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.opamp.noise`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Flat-band only; no 1/f", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.opamp.noise.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.opamp.noise.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/heatsink-rth": { "post": { "operationId": "calculate_electrical_thermal_heatsink_rth", "summary": "Heatsink Thermal Resistance", "description": "Junction temperature from effective θJA or θJC+θCS+θSA, or required heatsink θSA,max = (Tj,max−Ta)/P − θJC − θCS. (calculation_version 1.1.0)\n\nSemantic capability: `electrical.thermal.heatsink_rth`.\n\nCalculation version: `1.1.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Steady-state lumped Rθ only; not Zth(t) or CFD\n\nLimitation: θJA and θJC+θCS+θSA are exclusive models — mixing them is CONFLICTING_INPUTS\n\nLimitation: Required mode reports θSA,max, not total θJA\n\nLimitation: θCA / Rth_HS are rejected: θCA already includes the ambient-side path\n\nLimitation: Parallel PCB/package heat-flow paths are ignored on the explicit stack\n\nLimitation: P is device dissipation converted to heat, not load or output power\n\nLimitation: θSA,max ≤ 0 returns HEATSINK_INFEASIBLE and is not a purchasable heatsink", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.0" ] }, "description": "Pin calculation_version (published: 1.1.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.thermal.heatsink_rth.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.0", "examples": [ "1.1.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.thermal.heatsink_rth.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pcb-trace-thermal": { "post": { "operationId": "calculate_electrical_pcb_trace_thermal", "summary": "PCB Trace Thermal", "description": "Copper trace I²R power and temperature rise with board Rth. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.pcb.trace_thermal`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Uniform copper; lumped board Rth", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.trace_thermal.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.pcb.trace_thermal.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/rectifier-ripple-cap": { "post": { "operationId": "calculate_electrical_rectifier_ripple_cap", "summary": "Rectifier Ripple Capacitor", "description": "Filter C or Vripple for half/full-wave capacitor-input rectifiers. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rectifier.ripple_cap`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Constant load current; ideal diodes", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rectifier.ripple_cap.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rectifier.ripple_cap.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/coulomb": { "post": { "operationId": "calculate_physics_em_coulomb", "summary": "Coulomb's Law", "description": "Electrostatic force F = k·|q1·q2|/r² between point charges. (calculation_version 1.0.0)\n\nSemantic capability: `physics.em.coulomb`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Point charges; εr=1", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.em.coulomb.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.em.coulomb.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/logic-gate": { "post": { "operationId": "calculate_electrical_digital_logic_gate", "summary": "Logic Gate", "description": "Basic Boolean gate outputs from binary inputs. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.digital.logic_gate`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Combinational Boolean only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.digital.logic_gate.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.digital.logic_gate.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/battery-aging": { "post": { "operationId": "calculate_electrical_battery_aging", "summary": "Linear Battery Aging", "description": "Linear capacity fade from independent cycle and calendar aging. Default k_cycle=0.0002/cycle and k_cal=0.02/year are illustrative. (calculation_version 1.0.2)\n\nSemantic capability: `electrical.battery.aging`.\n\nCalculation version: `1.0.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Linear independent cycle+calendar fade — not temperature, SOC, DoD, C-rate, or chemistry aware\n\nLimitation: Default k_cycle=0.0002/cycle and k_cal=0.02/year are illustrative\n\nLimitation: fade_frac is unclamped exposure and may exceed 1; SOH and capacity_Ah are clamped at 0", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.2" ] }, "description": "Pin calculation_version (published: 1.0.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery.aging.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.2", "examples": [ "1.0.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.battery.aging.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/buck-ripple": { "post": { "operationId": "calculate_electrical_buck_ripple", "summary": "Buck Converter Ripple", "description": "Assumed-CCM buck peak-to-peak inductor ripple ΔI_L,pp and optional capacitor-only ΔV_C,pp (ESR=0). (calculation_version 1.1.0)\n\nSemantic capability: `electrical.buck.ripple`.\n\nCalculation version: `1.1.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal CCM is assumed, not measured — no Iout, so CCM/DCM is not certified\n\nLimitation: ΔI_L_A and ΔV_out_V are peak-to-peak, not RMS or amplitude\n\nLimitation: ΔV_out_V is capacitor-only (ESR=0); ESR and switching transients are neglected\n\nLimitation: DCM, current-mode control dynamics, and non-ideal switch/diode drops are out of scope", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.0" ] }, "description": "Pin calculation_version (published: 1.1.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.buck.ripple.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.0", "examples": [ "1.1.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.buck.ripple.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/celsius-kelvin": { "post": { "operationId": "calculate_units_temperature_celsius_kelvin", "summary": "Celsius ↔ Kelvin", "description": "Affine °C↔K with absolute-zero guards. (calculation_version 1.0.0)\n\nSemantic capability: `units.temperature.celsius_kelvin`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not Fahrenheit/Rankine", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.temperature.celsius_kelvin.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.temperature.celsius_kelvin.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/psi-bar": { "post": { "operationId": "calculate_units_pressure_psi_bar", "summary": "PSI ↔ Bar", "description": "Pressure conversion with 1 bar = 14.503773773 psi. (calculation_version 1.0.0)\n\nSemantic capability: `units.pressure.psi_bar`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Magnitude only; not gauge→absolute", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.pressure.psi_bar.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.pressure.psi_bar.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mosfet-vth": { "post": { "operationId": "calculate_electrical_mosfet_vth", "summary": "MOSFET Threshold / Overdrive", "description": "Overdrive, square-law Id (cutoff / linear / saturation), or solve model Vth, with optional linear Vth(Tj). Vth is the long-channel square-law parameter, not datasheet VGS(th). (calculation_version 1.3.1)\n\nSemantic capability: `electrical.mosfet.vth`.\n\nCalculation version: `1.3.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Long-channel square-law only — not BSIM, velocity saturation, or short-channel\n\nLimitation: Vth is the model threshold parameter, not datasheet VGS(th) and not recommended gate drive\n\nLimitation: kn = μn·Cox·W/L such that Id_sat = ½·kn·Vod²; the ½ is not included in kn\n\nLimitation: Without Vds, Id uses the saturation equation; with Vds, region is cutoff / linear / saturation\n\nLimitation: Cutoff returns Id = 0 A; subthreshold leakage is not modeled\n\nLimitation: Linear Vth(Tj) does not scale kn / μ(T); default α = −0.002 V/°C is a Si planning value, not datasheet TCV", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.1" ] }, "description": "Pin calculation_version (published: 1.3.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.vth.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.1", "examples": [ "1.3.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.mosfet.vth.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ideal-gas": { "post": { "operationId": "calculate_physics_thermo_ideal_gas", "summary": "Ideal Gas Law", "description": "PV=nRT solve for P|V|n|T in SI units. (calculation_version 1.0.0)\n\nSemantic capability: `physics.thermo.ideal_gas`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal gas; SI R default", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.ideal_gas.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.ideal_gas.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/heat-transfer": { "post": { "operationId": "calculate_physics_thermo_heat_transfer", "summary": "Heat Transfer", "description": "1-D conduction or convection heat rate. (calculation_version 1.0.0)\n\nSemantic capability: `physics.thermo.heat_transfer`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: No radiation / CFD", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.heat_transfer.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.heat_transfer.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/receiver-sensitivity": { "post": { "operationId": "calculate_electrical_rf_receiver_sensitivity", "summary": "Receiver Sensitivity", "description": "MDS from NF, BW, and SNR_min at T0=290 K. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rf.receiver_sensitivity`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Flat NF; kT0=−174 dBm/Hz", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.receiver_sensitivity.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.receiver_sensitivity.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ldo-thermal": { "post": { "operationId": "calculate_electrical_ldo_thermal", "summary": "LDO Thermal", "description": "LDO dissipation and junction temperature from Rth. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.ldo.thermal`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Steady-state lumped Rth", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.ldo.thermal.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.ldo.thermal.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/hz-rads": { "post": { "operationId": "calculate_units_frequency_hz_rads", "summary": "Hz ↔ rad/s", "description": "Angular frequency ω = 2πf with positive-frequency guards. (calculation_version 1.0.0)\n\nSemantic capability: `units.frequency.hz_rads`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not deg/s or rpm", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.frequency.hz_rads.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.frequency.hz_rads.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/tesla-gauss": { "post": { "operationId": "calculate_units_magnetic_tesla_gauss", "summary": "Tesla ↔ Gauss", "description": "Magnetic flux density with 1 T = 10000 G. (calculation_version 1.0.0)\n\nSemantic capability: `units.magnetic.tesla_gauss`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Non-negative B only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.magnetic.tesla_gauss.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.magnetic.tesla_gauss.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/wavelength": { "post": { "operationId": "calculate_electrical_rf_wavelength", "summary": "Wavelength", "description": "λ = c·VF/f in vacuum or dielectric (VF or εr). (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rf.wavelength`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Mode lambda needs f_Hz; mode freq needs lambda_m\n\nLimitation: Non-dispersive VF; no waveguide cutoff", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.wavelength.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.wavelength.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/coax-impedance": { "post": { "operationId": "calculate_electrical_rf_coax", "summary": "Coax Impedance", "description": "Z0 of coaxial line from shield inner diameter D, center-conductor diameter d, and εr. Omitted εr defaults to 1.0. (calculation_version 1.0.1)\n\nSemantic capability: `electrical.rf.coax`.\n\nCalculation version: `1.0.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Does not model conductor loss\n\nLimitation: Does not model dielectric loss / tanδ\n\nLimitation: Does not model dispersion\n\nLimitation: Does not model connectors or discontinuities\n\nLimitation: Does not model higher-order modes", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.1" ] }, "description": "Pin calculation_version (published: 1.0.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.coax.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.1", "examples": [ "1.0.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.coax.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/lc-match": { "post": { "operationId": "calculate_electrical_rf_lc_match", "summary": "L-section LC Match", "description": "Narrowband real RL→Z0 L-section dual solutions. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rf.lc_match`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Real ZL only; narrowband; no stub match", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.lc_match.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.lc_match.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/smith-chart": { "post": { "operationId": "calculate_electrical_rf_smith", "summary": "Smith Chart (Impedance Matching)", "description": "RF Smith Chart & Matching Workspace: mode-discriminated Agent API, strict match-steps, Touchstone S11, auto-match, SVG overlays. (calculation_version 1.6.3)\n\nSemantic capability: `electrical.rf.smith`.\n\nCalculation version: `1.6.3`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: No multi-section Chebyshev / broadband optimizer\n\nLimitation: Full bilateral gain redesign with S12 feedback not supported\n\nLimitation: Drag-to-tune and S21/stability overlays are UI-side (API returns numerical modes)\n\nLimitation: Noise circles require Touchstone noise params (NFmin, Γopt, Rn); not inferred from S alone\n\nLimitation: Passive Z↔Γ / matching: R≥0 and |Γ|≤1; active overlay circles may extend outside the unit circle", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.6.3" ] }, "description": "Pin calculation_version (published: 1.6.3); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.smith.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.6.3", "examples": [ "1.6.3" ] } } }, "example": { "inputs": {}, "calculation_version": "1.6.3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.smith.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/gamma-z": { "post": { "operationId": "calculate_electrical_rf_gamma_z", "summary": "Γ ↔ Z (Complex)", "description": "Complex reflection coefficient ↔ normalized impedance with VSWR/RL. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.rf.gamma_z`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Normalized z; |Γ|≤1 for passive", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.gamma_z.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.rf.gamma_z.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/kwh-joule": { "post": { "operationId": "calculate_units_energy_kwh_joule", "summary": "kWh ↔ Joule", "description": "Energy conversion with 1 kWh = 3.6 MJ. (calculation_version 1.0.0)\n\nSemantic capability: `units.energy.kwh_joule`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Exact SI factor 3.6e6 only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.energy.kwh_joule.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.energy.kwh_joule.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/watt-hp": { "post": { "operationId": "calculate_units_power_watt_hp", "summary": "Watt ↔ Horsepower", "description": "Mechanical horsepower: 1 hp = 745.6998715822702 W. (calculation_version 1.0.0)\n\nSemantic capability: `units.power.watt_hp`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Mechanical hp only (not metric PS)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.power.watt_hp.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.power.watt_hp.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/projectile": { "post": { "operationId": "calculate_physics_kinematics_projectile", "summary": "Projectile Motion", "description": "Flat-ground projectile range, apex, and flight time (no drag). (calculation_version 1.0.0)\n\nSemantic capability: `physics.kinematics.projectile`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: No drag; flat ground; angle in (0,90)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.projectile.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.projectile.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/force": { "post": { "operationId": "calculate_physics_dynamics_force", "summary": "Force (F=ma)", "description": "Newton second law solve for F, a, or m. (calculation_version 1.0.0)\n\nSemantic capability: `physics.dynamics.force`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Point-mass Newtonian; no relativity", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.force.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.force.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/reynolds": { "post": { "operationId": "calculate_physics_fluid_reynolds", "summary": "Reynolds Number", "description": "Re = ρvL/μ with laminar/turbulent pipe guidance bands. (calculation_version 1.0.0)\n\nSemantic capability: `physics.fluid.reynolds`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Pipe guidance bands 2300/4000; not a stability proof", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.reynolds.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.reynolds.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/colebrook": { "post": { "operationId": "calculate_physics_fluid_colebrook", "summary": "Colebrook Friction Factor", "description": "Colebrook–White Darcy friction factor f from Re and ε/D. Turbulent pipes Re≥4000. Not laminar 64/Re. (calculation_version 1.0.0)\n\nSemantic capability: `physics.fluid.colebrook`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Turbulent pipes Re ≥ 4000 — not laminar f=64/Re\n\nLimitation: Not a Moody-chart lookup\n\nLimitation: Does not compose Darcy–Weisbach head loss", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.colebrook.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "Re": 100000, "rel_roughness": 0.0002 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.colebrook.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/darcy-weisbach": { "post": { "operationId": "calculate_physics_fluid_darcy_weisbach", "summary": "Darcy–Weisbach", "description": "Pipe head loss hf = f L v²/(2 g D) and Δp = ρ g hf from a given Darcy friction factor. Does not solve Colebrook for f. (calculation_version 1.0.0)\n\nSemantic capability: `physics.fluid.darcy_weisbach`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Incompressible; constant Darcy friction factor; circular pipe\n\nLimitation: Does not solve Colebrook for f\n\nLimitation: Not Hazen–Williams, not minor-loss K v²/2g\n\nLimitation: Not volumetric flow Q=Av", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.darcy_weisbach.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "f": 0.02, "L": 10, "v": 2, "D": 0.1, "rho": 1000 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.darcy_weisbach.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/henderson-hasselbalch": { "post": { "operationId": "calculate_chemistry_acid_base_henderson_hasselbalch", "summary": "Henderson–Hasselbalch", "description": "Buffer pH = pKa + log10([A−]/[HA]). Accepts pKa or Ka. Not ICE and not pH = −log10[H+]. (calculation_version 1.0.0)\n\nSemantic capability: `chemistry.acid_base.henderson_hasselbalch`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Monoprotic buffer pair as given — not ICE equilibrium\n\nLimitation: Not pH = −log10[H+]\n\nLimitation: Not activity coefficients or polyprotic", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/chemistry.acid_base.henderson_hasselbalch.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "pKa": 5, "HA": 0.1, "A": 0.2 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/chemistry.acid_base.henderson_hasselbalch.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mole": { "post": { "operationId": "calculate_chemistry_mole_amount", "summary": "Mole", "description": "Amount n = m/M and N = n·N_A. N_A is CODATA 2018 exact. Not molarity and not Henderson–Hasselbalch. (calculation_version 1.0.0)\n\nSemantic capability: `chemistry.mole.amount`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Lab units g, g/mol, mol\n\nLimitation: Not molarity c=n/V or dilution C1V1=C2V2\n\nLimitation: Not ICE or Henderson–Hasselbalch\n\nLimitation: Does not rewrite /convert/chemistry pair pages", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/chemistry.mole.amount.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "mode": "from_mass", "mass": 36.03, "molar_mass": 18.015 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/chemistry.mole.amount.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/molarity": { "post": { "operationId": "calculate_chemistry_solution_molarity", "summary": "Molarity", "description": "Molarity c = n/V and dilution C1·V1 = C2·V2. Lab units mol, L, mol/L. Not mole n=m/M and not Henderson–Hasselbalch. (calculation_version 1.0.0)\n\nSemantic capability: `chemistry.solution.molarity`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Lab units mol, L, mol/L\n\nLimitation: Not mole n=m/M or Avogadro\n\nLimitation: Not ICE or Henderson–Hasselbalch\n\nLimitation: Dilution needs exactly one of c1, v1, c2, v2 omitted", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/chemistry.solution.molarity.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "mode": "molarity", "amount": 0.5, "volume": 0.25 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/chemistry.solution.molarity.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ph": { "post": { "operationId": "calculate_chemistry_acid_base_ph", "summary": "pH", "description": "Water-ion pH and pOH identities at 25 °C: pH = −log10[H+], pOH = −log10[OH−], pH + pOH = 14. Not Henderson–Hasselbalch and not ICE. (calculation_version 1.0.0)\n\nSemantic capability: `chemistry.acid_base.ph`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Kw = 1e-14 at 25 °C (not temperature-dependent)\n\nLimitation: Not Henderson–Hasselbalch buffer pH\n\nLimitation: Not ICE, activity coefficients, or polyprotic", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/chemistry.acid_base.ph.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "mode": "ph_from_h", "h": 0.001 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/chemistry.acid_base.ph.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/stefan-boltzmann": { "post": { "operationId": "calculate_physics_thermo_stefan_boltzmann", "summary": "Stefan–Boltzmann", "description": "Net gray-body flux q = εσ(Th⁴−Tc⁴). Optional Q = A·q. Not Fourier/Newton heat-transfer and not a view-factor solver. (calculation_version 1.0.0)\n\nSemantic capability: `physics.thermo.stefan_boltzmann`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Gray body; no view factor (F=1)\n\nLimitation: T in kelvin\n\nLimitation: Not conduction/convection heat-transfer\n\nLimitation: Not heatsink Rth or steam", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.stefan_boltzmann.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": { "Th": 400, "Tc": 300, "epsilon": 1 }, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.stefan_boltzmann.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/bernoulli": { "post": { "operationId": "calculate_physics_fluid_bernoulli", "summary": "Bernoulli's Equation", "description": "Incompressible Bernoulli along a streamline: solve P2, v2, or h2. (calculation_version 1.0.0)\n\nSemantic capability: `physics.fluid.bernoulli`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Incompressible; inviscid; steady streamline; no losses", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.bernoulli.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.bernoulli.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/specific-heat": { "post": { "operationId": "calculate_physics_thermo_specific_heat", "summary": "Specific Heat Capacity", "description": "Q = m c ΔT solve for Q, m, c, or ΔT. (calculation_version 1.0.0)\n\nSemantic capability: `physics.thermo.specific_heat`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Constant c; no phase change", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.specific_heat.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.specific_heat.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/newton-lbf": { "post": { "operationId": "calculate_units_force_newton_lbf", "summary": "Newton ↔ lbf", "description": "Force conversion with 1 lbf = 4.4482216152605 N. (calculation_version 1.0.0)\n\nSemantic capability: `units.force.newton_lbf`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Exact NIST factor", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.force.newton_lbf.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.force.newton_lbf.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/mps-kmh": { "post": { "operationId": "calculate_units_speed_mps_kmh", "summary": "m/s ↔ km/h", "description": "Speed conversion with factor 3.6. (calculation_version 1.0.0)\n\nSemantic capability: `units.speed.mps_kmh`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Non-negative speed", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.speed.mps_kmh.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.speed.mps_kmh.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/suvat": { "post": { "operationId": "calculate_physics_kinematics_suvat", "summary": "SUVAT Calculator", "description": "Constant-acceleration kinematics (SUVAT). (calculation_version 1.0.0)\n\nSemantic capability: `physics.kinematics.suvat`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Constant a; 1D", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.suvat.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.suvat.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/torque": { "post": { "operationId": "calculate_physics_dynamics_torque", "summary": "Torque Calculator", "description": "τ = r F sinθ. (calculation_version 1.0.0)\n\nSemantic capability: `physics.dynamics.torque`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Single force; planar", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.torque.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.torque.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/free-fall": { "post": { "operationId": "calculate_physics_kinematics_free_fall", "summary": "Free Fall Calculator", "description": "Free fall under constant g (optional initial velocity). (calculation_version 1.0.0)\n\nSemantic capability: `physics.kinematics.free_fall`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: No drag; constant g", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.free_fall.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.free_fall.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/work-power": { "post": { "operationId": "calculate_physics_dynamics_work_power", "summary": "Work and Power Calculator", "description": "W=Fs cosθ and P=W/t or Fv. (calculation_version 1.0.0)\n\nSemantic capability: `physics.dynamics.work_power`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Constant force; no variable systems", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.work_power.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.work_power.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/flow-rate": { "post": { "operationId": "calculate_physics_fluid_flow_rate", "summary": "Flow Rate Calculator", "description": "Volumetric flow Q=A·v (optional pipe diameter). (calculation_version 1.0.0)\n\nSemantic capability: `physics.fluid.flow_rate`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Incompressible continuum; uniform velocity", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.flow_rate.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.flow_rate.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/joule-ev": { "post": { "operationId": "calculate_units_energy_joule_ev", "summary": "Joule ↔ Electronvolt", "description": "Energy conversion with 1 eV = 1.602176634×10⁻¹⁹ J (exact). (calculation_version 1.0.0)\n\nSemantic capability: `units.energy.joule_ev`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Exact SI factor; no relativistic frames", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.energy.joule_ev.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.energy.joule_ev.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/binary-hex": { "post": { "operationId": "calculate_units_digital_binary_hex", "summary": "Binary ↔ Hexadecimal", "description": "Integer base-2 ↔ base-16 conversion (optional 0b/0x prefixes). (calculation_version 1.0.0)\n\nSemantic capability: `units.digital.binary_hex`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Unsigned integers only; no fractional digits", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/units.digital.binary_hex.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/units.digital.binary_hex.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/velocity": { "post": { "operationId": "calculate_physics_kinematics_velocity", "summary": "Velocity Calculator", "description": "Average velocity v = s/t (solve v, s, or t). (calculation_version 1.0.0)\n\nSemantic capability: `physics.kinematics.velocity`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Average speed along path; 1D", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.velocity.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.velocity.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/momentum": { "post": { "operationId": "calculate_physics_dynamics_momentum", "summary": "Momentum Calculator", "description": "Linear momentum p = m·v (solve p, m, or v). (calculation_version 1.0.0)\n\nSemantic capability: `physics.dynamics.momentum`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Non-relativistic; single particle", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.momentum.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.momentum.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/acceleration": { "post": { "operationId": "calculate_physics_kinematics_acceleration", "summary": "Acceleration Calculator", "description": "Constant acceleration a = (v − u)/t. (calculation_version 1.0.0)\n\nSemantic capability: `physics.kinematics.acceleration`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Constant a; 1D", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.acceleration.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.acceleration.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/half-life": { "post": { "operationId": "calculate_physics_modern_half_life", "summary": "Half-Life Calculator", "description": "Radioactive decay N = N₀ · 2^(−t/T½). (calculation_version 1.0.0)\n\nSemantic capability: `physics.modern.half_life`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Single exponential; no branching ratios", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.modern.half_life.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.modern.half_life.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/efficiency": { "post": { "operationId": "calculate_physics_energy_efficiency", "summary": "Efficiency Calculator", "description": "η = Pout/Pin as fraction and percent. (calculation_version 1.0.0)\n\nSemantic capability: `physics.energy.efficiency`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: η ≤ 1; no heat-engine Carnot bound", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.energy.efficiency.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.energy.efficiency.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/boyle": { "post": { "operationId": "calculate_physics_thermo_boyle", "summary": "Boyle's Law Calculator", "description": "Isothermal Boyle relation P1·V1 = P2·V2. (calculation_version 1.0.0)\n\nSemantic capability: `physics.thermo.boyle`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Isothermal only; use Ideal Gas when T changes", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.boyle.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.boyle.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/kinetic": { "post": { "operationId": "calculate_physics_energy_kinetic", "summary": "Kinetic Energy Calculator", "description": "KE = ½mv² (solve KE, m, or v). (calculation_version 1.0.0)\n\nSemantic capability: `physics.energy.kinetic`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Classical; no relativistic KE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.energy.kinetic.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.energy.kinetic.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/potential": { "post": { "operationId": "calculate_physics_energy_potential", "summary": "Potential Energy Calculator", "description": "Gravitational PE = mgh (default g=9.80665). (calculation_version 1.0.0)\n\nSemantic capability: `physics.energy.potential`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Gravitational PE near Earth; not elastic", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.energy.potential.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.energy.potential.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/friction": { "post": { "operationId": "calculate_physics_dynamics_friction", "summary": "Friction Calculator", "description": "F = μN; optional incline N = mg cosθ. (calculation_version 1.0.0)\n\nSemantic capability: `physics.dynamics.friction`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Coulomb model; static vs kinetic μ not distinguished beyond input", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.friction.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.friction.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/doppler": { "post": { "operationId": "calculate_physics_acoustics_doppler", "summary": "Doppler Effect Calculator", "description": "1D acoustic Doppler f′ = f(v±vo)/(v±vs). (calculation_version 1.0.0)\n\nSemantic capability: `physics.acoustics.doppler`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: 1D classical; default air speed 343 m/s", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.acoustics.doppler.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.acoustics.doppler.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/snell": { "post": { "operationId": "calculate_physics_optics_snell", "summary": "Snell's Law Calculator", "description": "n1 sinθ1 = n2 sinθ2 plus critical angle. (calculation_version 1.0.0)\n\nSemantic capability: `physics.optics.snell`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Geometric optics; TIR flagged as error in refraction modes", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.optics.snell.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.optics.snell.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/resistor-color": { "post": { "operationId": "calculate_electrical_resistor_color_code", "summary": "Resistor Color Code Calculator", "description": "IEC 60062 3–6 band decode to ohms, tolerance, TCR. (calculation_version 1.0.0)\n\nSemantic capability: `electrical.resistor_color_code`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Through-hole IEC 60062 colors; not SMD codes", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/electrical.resistor_color_code.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/electrical.resistor_color_code.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/charles": { "post": { "operationId": "calculate_physics_thermo_charles", "summary": "Charles's Law Calculator", "description": "Isobaric Charles relation V1/T1 = V2/T2 (T in kelvin). (calculation_version 1.0.0)\n\nSemantic capability: `physics.thermo.charles`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Isobaric only; temperatures must be absolute (K)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.charles.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.thermo.charles.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/sound-level": { "post": { "operationId": "calculate_physics_acoustics_sound_level", "summary": "Sound Level Calculator", "description": "Intensity and pressure sound levels in dB; incoherent level combination. (calculation_version 1.0.0)\n\nSemantic capability: `physics.acoustics.sound_level`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: I0=1e-12 W/m², p0=20 µPa; no A-weighting", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.acoustics.sound_level.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.acoustics.sound_level.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/trajectory": { "post": { "operationId": "calculate_physics_kinematics_trajectory", "summary": "Projectile Trajectory Calculator", "description": "Flat-ground trajectory: range/height/time, position at t, or solve angle. (calculation_version 1.0.0)\n\nSemantic capability: `physics.kinematics.trajectory`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: No drag; level ground", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.trajectory.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.trajectory.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/centripetal": { "post": { "operationId": "calculate_physics_dynamics_centripetal", "summary": "Centripetal Force Calculator", "description": "Fc = mv²/r and a = v²/r. (calculation_version 1.0.0)\n\nSemantic capability: `physics.dynamics.centripetal`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Uniform circular motion; no banked-curve friction", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.centripetal.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.centripetal.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/electric-field": { "post": { "operationId": "calculate_physics_em_electric_field", "summary": "Electric Field Calculator", "description": "Point-charge E, force on q, and potential. (calculation_version 1.0.0)\n\nSemantic capability: `physics.em.electric_field`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Point charge in vacuum; k default 8.9875517923e9", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.em.electric_field.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.em.electric_field.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/faraday": { "post": { "operationId": "calculate_physics_em_faraday", "summary": "Faraday's Law Calculator", "description": "Induced emf magnitude from flux change or B·A. (calculation_version 1.0.0)\n\nSemantic capability: `physics.em.faraday`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Magnitude only (Lenz sign omitted); uniform B over area", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.em.faraday.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.em.faraday.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/lens-maker": { "post": { "operationId": "calculate_physics_optics_lens_maker", "summary": "Lens Maker Calculator", "description": "Lensmaker equation and thin-lens conjugates. (calculation_version 1.0.0)\n\nSemantic capability: `physics.optics.lens_maker`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Thin lens in air; Cartesian sign convention for R", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.optics.lens_maker.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.optics.lens_maker.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/impulse": { "post": { "operationId": "calculate_physics_dynamics_impulse", "summary": "Impulse Calculator", "description": "Impulse J = FΔt = Δp. (calculation_version 1.0.0)\n\nSemantic capability: `physics.dynamics.impulse`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Average force / constant F over Δt", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.impulse.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.dynamics.impulse.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/viscosity": { "post": { "operationId": "calculate_physics_fluid_viscosity", "summary": "Viscosity Calculator", "description": "Dynamic viscosity from shear; kinematic ν = η/ρ. (calculation_version 1.0.0)\n\nSemantic capability: `physics.fluid.viscosity`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Newtonian fluid; constant η", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.viscosity.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.viscosity.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/displacement": { "post": { "operationId": "calculate_physics_kinematics_displacement", "summary": "Displacement Calculator", "description": "1D Δx and 2D displacement magnitude. (calculation_version 1.0.0)\n\nSemantic capability: `physics.kinematics.displacement`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Position change, not path length", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.displacement.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.kinematics.displacement.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/drag": { "post": { "operationId": "calculate_physics_fluid_drag", "summary": "Drag Force Calculator", "description": "Quadratic drag Fd = ½ρv²CdA. (calculation_version 1.0.0)\n\nSemantic capability: `physics.fluid.drag`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Quadratic drag model; Cd treated as constant", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.drag.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.fluid.drag.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/magnetic-field": { "post": { "operationId": "calculate_physics_em_magnetic_field", "summary": "Magnetic Field Calculator", "description": "B for long wire and long solenoid. (calculation_version 1.0.0)\n\nSemantic capability: `physics.em.magnetic_field`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ideal infinite wire / long solenoid", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.em.magnetic_field.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.em.magnetic_field.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/time-dilation": { "post": { "operationId": "calculate_physics_modern_time_dilation", "summary": "Time Dilation Calculator", "description": "Special-relativistic Δt = γΔτ. (calculation_version 1.0.0)\n\nSemantic capability: `physics.modern.time_dilation`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Special relativity only; v < c", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.modern.time_dilation.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.modern.time_dilation.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/youngs": { "post": { "operationId": "calculate_physics_materials_youngs", "summary": "Young's Modulus Calculator", "description": "Y = stress/strain for uniaxial elasticity. (calculation_version 1.0.0)\n\nSemantic capability: `physics.materials.youngs`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Linear elastic regime; isotropic", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/physics.materials.youngs.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/physics.materials.youngs.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/final-grade": { "post": { "operationId": "calculate_education_final_grade", "summary": "Final grade", "description": "Need-on-final, overall after the exam, weighted categories, and points-to-weight for a fixed final exam share. (calculation_version 1.1.1)\n\nSemantic capability: `education.final_grade`.\n\nCalculation version: `1.1.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Need on final / Overall: Current must exclude the final (pre-final grade). Do not enter an LMS current that already counts the final as 0%.\n\nLimitation: Weighted: enter category grades and weights as they actually appear for completed work; remaining weight is optional.\n\nLimitation: W is percent (40); w = W/100 is the fraction form. Do not mix W and w in one expression.\n\nLimitation: Need on final with W = 0 → status invalid, code WEIGHT_REQUIRED (not a number).\n\nLimitation: Points mode total ≤ 0 → TOTAL_POINTS_REQUIRED. Final points > total still computes and warns POINTS_EXCEED_TOTAL.\n\nLimitation: Letter cutoffs / GPA points are a reference example, not part of the calculation model.\n\nLimitation: Planning estimate only — not an official transcript. No curve, drop-lowest, or extra credit unless you adjust inputs.\n\nLimitation: Engine aliases current/goal/W/finalScore/totalPoints are accepted at runtime; prefer share-URL field names in schemas.", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.1" ] }, "description": "Pin calculation_version (published: 1.1.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/education.final_grade.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.1", "examples": [ "1.1.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/education.final_grade.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/gpa-to-letter": { "post": { "operationId": "calculate_education_gpa_letter", "summary": "GPA ↔ letter grade", "description": "Approximate GPA↔letter lookup on plus/minus 4.33, flat 4.0, or linear 5.0 normalization. One table, two SEO entries (GPA→letter and letter→GPA). (calculation_version 1.1.2)\n\nSemantic capability: `education.gpa_letter`.\n\nCalculation version: `1.1.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Interpretation of a numeric GPA or a single letter — not a registrar conversion\n\nLimitation: Not a term or cumulative GPA from a course list (use the GPA calculator)\n\nLimitation: Example percentage bands are syllabus conventions, not derived from GPA", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.2" ] }, "description": "Pin calculation_version (published: 1.1.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/education.gpa_letter.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.2", "examples": [ "1.1.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/education.gpa_letter.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/letter-grade-to-gpa": { "post": { "operationId": "calculate_education_gpa_letter_alias_letter_grade_to_gpa", "summary": "GPA ↔ letter grade (letter-grade-to-gpa page alias)", "description": "Approximate GPA↔letter lookup on plus/minus 4.33, flat 4.0, or linear 5.0 normalization. One table, two SEO entries (GPA→letter and letter→GPA). (calculation_version 1.1.2)\n\nSemantic capability: `education.gpa_letter`.\n\nCalculation version: `1.1.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Interpretation of a numeric GPA or a single letter — not a registrar conversion\n\nLimitation: Not a term or cumulative GPA from a course list (use the GPA calculator)\n\nLimitation: Example percentage bands are syllabus conventions, not derived from GPA", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.2" ] }, "description": "Pin calculation_version (published: 1.1.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/education.gpa_letter.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.2", "examples": [ "1.1.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/education.gpa_letter.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/vat": { "post": { "operationId": "calculate_finance_vat", "summary": "VAT / GST", "description": "Add or remove a single-rate consumption tax (VAT or GST labeling). Gross = Net × (1 + rate/100); Net = Gross × 100 / (100 + rate). (calculation_version 1.3.0)\n\nSemantic capability: `finance.vat`.\n\nCalculation version: `1.3.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Single flat rate on the entered amount\n\nLimitation: No multi-rate baskets, exemptions, or input-tax credits\n\nLimitation: GST page is an SEO entry of this capability — same engine, GST labeling", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.0" ] }, "description": "Pin calculation_version (published: 1.3.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/finance.vat.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.0", "examples": [ "1.3.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/finance.vat.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/gst": { "post": { "operationId": "calculate_finance_vat_alias_gst", "summary": "VAT / GST (gst page alias)", "description": "Add or remove a single-rate consumption tax (VAT or GST labeling). Gross = Net × (1 + rate/100); Net = Gross × 100 / (100 + rate). (calculation_version 1.3.0)\n\nSemantic capability: `finance.vat`.\n\nCalculation version: `1.3.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Single flat rate on the entered amount\n\nLimitation: No multi-rate baskets, exemptions, or input-tax credits\n\nLimitation: GST page is an SEO entry of this capability — same engine, GST labeling", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.3.0" ] }, "description": "Pin calculation_version (published: 1.3.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/finance.vat.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.3.0", "examples": [ "1.3.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.3.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/finance.vat.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/factorial": { "post": { "operationId": "calculate_math_factorial", "summary": "Ordinary factorial", "description": "Exact n! for integers 0 ≤ n ≤ 5000 via BigInt arithmetic, with product expansion, digit count, and scientific notation for long integers. (calculation_version 1.0.2)\n\nSemantic capability: `math.factorial`.\n\nCalculation version: `1.0.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Ordinary (single) factorial only — not multifactorial and not Γ(n+1) for non-integers\n\nLimitation: Domain is 0 ≤ n ≤ 5000 (product/resource bound, not a mathematical bound)\n\nLimitation: Missing n → MISSING_REQUIRED_INPUT\n\nLimitation: Non-numeric or non-integer n → INVALID_NUMBER\n\nLimitation: n < 0 → VALUE_MUST_BE_NON_NEGATIVE\n\nLimitation: n > 5000 → VALUE_ABOVE_MAX", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.2" ] }, "description": "Pin calculation_version (published: 1.0.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.factorial.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.2", "examples": [ "1.0.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.factorial.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/fractions": { "post": { "operationId": "calculate_math_fractions", "summary": "Fractions", "description": "Add, subtract, multiply, and divide fractions and mixed numbers using LCD/LCM for add/subtract, GCF reduction, and reciprocal division. Also simplifies and converts between fractions and decimals. (calculation_version 1.0.5)\n\nSemantic capability: `math.fractions`.\n\nCalculation version: `1.0.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Integer numerators and denominators only (optional mixed-number whole)\n\nLimitation: Denominator 0 → DENOMINATOR_MUST_BE_NONZERO\n\nLimitation: Division by 0/n → DIVISION_BY_ZERO\n\nLimitation: Add/subtract use LCD = LCM(b, d); (ad ± bc)/bd is an equivalent check only\n\nLimitation: Negative sign is normalized onto the numerator after reduction\n\nLimitation: Expert review pending — L1 engine-tested / source-checked", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.5" ] }, "description": "Pin calculation_version (published: 1.0.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.fractions.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.5", "examples": [ "1.0.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.fractions.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/gcf": { "post": { "operationId": "calculate_math_gcf", "summary": "Greatest common factor", "description": "Exact GCF/GCD/HCF of two or more integers via BigInt pairwise Euclidean fold, with factor and prime independent checks when values are small enough to list. (calculation_version 1.0.2)\n\nSemantic capability: `math.gcf`.\n\nCalculation version: `1.0.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Integers only; negatives treated by absolute value\n\nLimitation: Each integer ≤ 48 decimal digits (product bound, not a mathematical bound)\n\nLimitation: Zeros are ignored unless every input is 0 (then UNDEFINED)\n\nLimitation: Need at least two numbers → NEED_TWO_NUMBERS\n\nLimitation: Non-integers → INVALID_NUMBER\n\nLimitation: Integers beyond MAX_SAFE_INTEGER must be decimal strings in JSON", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.2" ] }, "description": "Pin calculation_version (published: 1.0.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.gcf.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.2", "examples": [ "1.0.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.gcf.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/lcm": { "post": { "operationId": "calculate_math_lcm", "summary": "Least common multiple", "description": "Exact LCM of two or more integers via BigInt pairwise GCF-identity fold, with listing and prime independent checks when values are small enough to list. (calculation_version 1.0.3)\n\nSemantic capability: `math.lcm`.\n\nCalculation version: `1.0.3`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Integers only; negatives treated by absolute value\n\nLimitation: Each integer ≤ 48 decimal digits (product bound, not a mathematical bound)\n\nLimitation: If any input is 0, LCM = 0. LCM(0,0)=0 is a CalculatorX/Python convention (not a GCF-identity derivation)\n\nLimitation: Need at least two numbers → NEED_TWO_NUMBERS\n\nLimitation: Non-integers → INVALID_NUMBER\n\nLimitation: Integers beyond MAX_SAFE_INTEGER must be decimal strings in JSON", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.3" ] }, "description": "Pin calculation_version (published: 1.0.3); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.lcm.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.3", "examples": [ "1.0.3" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.lcm.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ratio": { "post": { "operationId": "calculate_math_ratio", "summary": "Ratio", "description": "Simplify, scale, and compare ratios; solve proportions; split a total; convert part-to-part ratios to fraction, decimal, and part-of-whole percent using exact rationals. (calculation_version 1.0.2)\n\nSemantic capability: `math.ratio`.\n\nCalculation version: `1.0.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Integers, terminating decimals, and simple a/b fractions only (no mixed numbers or scientific notation)\n\nLimitation: Each term ≤ 48 decimal digits\n\nLimitation: Simplify / proportion / compare allow negative terms\n\nLimitation: Split requires every term ≥ 0 and Σ terms > 0 → SPLIT_NEGATIVE_TERM / SPLIT_ZERO_SUM\n\nLimitation: All-zero simplify → ALL_ZERO\n\nLimitation: Proportion needs exactly one blank among A,B,C,D → PROPORTION_ONE_BLANK\n\nLimitation: Expert review pending — L1 engine-tested / source-checked", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.2" ] }, "description": "Pin calculation_version (published: 1.0.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.ratio.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.2", "examples": [ "1.0.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.ratio.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/log": { "post": { "operationId": "calculate_math_log", "summary": "Logarithm", "description": "Common, natural, and arbitrary-base real logarithms; solve for y, x, or b with change-of-base. (calculation_version 1.1.5)\n\nSemantic capability: `math.log`.\n\nCalculation version: `1.1.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Real logarithm only: x > 0; b > 0 and b ≠ 1 (including 0 < b < 1)\n\nLimitation: Missing scalar → MISSING_REQUIRED_INPUT / INVALID_NUMBER\n\nLimitation: Invalid base → INVALID_BASE; x ≤ 0 → INVALID_ARGUMENT\n\nLimitation: Solve-for-b edge cases → NON_UNIQUE_BASE / NO_REAL_SOLUTION / RESULT_OVERFLOW", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.5" ] }, "description": "Pin calculation_version (published: 1.1.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.log.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.5", "examples": [ "1.1.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.log.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/quadratic": { "post": { "operationId": "calculate_math_quadratic", "summary": "Quadratic formula", "description": "Solve ax² + bx + c = 0 with the quadratic formula; real or complex roots from discriminant Δ. (calculation_version 1.0.4)\n\nSemantic capability: `math.quadratic`.\n\nCalculation version: `1.0.4`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: a = 0 → NOT_QUADRATIC\n\nLimitation: Missing coefficient → MISSING_REQUIRED_INPUT\n\nLimitation: Δ < 0 yields complex conjugate roots {real, imag}", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.4" ] }, "description": "Pin calculation_version (published: 1.0.4); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.quadratic.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.4", "examples": [ "1.0.4" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.4" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.quadratic.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/percentage": { "post": { "operationId": "calculate_math_percentage", "summary": "Percentage", "description": "Phrase modes: P% of X, what percent, of-what, percent change, adjust ±P%, and percentage difference. (calculation_version 1.1.1)\n\nSemantic capability: `math.percentage`.\n\nCalculation version: `1.1.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Percent change uses |old| denominator; old = 0 undefined\n\nLimitation: Percentage difference requires non-negative a, b → VALUE_MUST_BE_NON_NEGATIVE\n\nLimitation: Missing fields → MISSING_REQUIRED_INPUT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.1" ] }, "description": "Pin calculation_version (published: 1.1.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.percentage.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.1", "examples": [ "1.1.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.percentage.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/percent-change": { "post": { "operationId": "calculate_math_percent_change", "summary": "Percentage change", "description": "Signed percent change (V₂ − V₁)/|V₁|×100% with reverse solve for V₁ or V₂. (calculation_version 1.1.0)\n\nSemantic capability: `math.percent_change`.\n\nCalculation version: `1.1.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: V₁ = 0 → INITIAL_VALUE_ZERO\n\nLimitation: Invalid reverse solve → NO_REAL_SOLUTION; some cases INFINITELY_MANY", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.0" ] }, "description": "Pin calculation_version (published: 1.1.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.percent_change.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.0", "examples": [ "1.1.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.percent_change.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/percent-error": { "post": { "operationId": "calculate_math_percent_error", "summary": "Percent error", "description": "Laboratory percent error |O − T|/|T|×100% (signed opt-in) with reverse solve for O or T. (calculation_version 1.1.4)\n\nSemantic capability: `math.percent_error`.\n\nCalculation version: `1.1.4`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: T = 0 → TRUE_VALUE_ZERO\n\nLimitation: Inconsistent triples may return status inconsistent\n\nLimitation: Reverse solve edge cases → NO_REAL_SOLUTION / INFINITELY_MANY", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.4" ] }, "description": "Pin calculation_version (published: 1.1.4); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.percent_error.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.4", "examples": [ "1.1.4" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.4" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.percent_error.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/pythagorean": { "post": { "operationId": "calculate_math_pythagorean", "summary": "Pythagorean theorem", "description": "Right-triangle solve a² + b² = c² for a missing side, plus area and perimeter; verify mode when all three sides given. (calculation_version 1.1.1)\n\nSemantic capability: `math.pythagorean`.\n\nCalculation version: `1.1.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Sides must be positive → SIDE_NOT_POSITIVE\n\nLimitation: Need two of a,b,c (or verify with three) → MISSING_REQUIRED_INPUT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.1" ] }, "description": "Pin calculation_version (published: 1.1.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.pythagorean.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.1", "examples": [ "1.1.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.pythagorean.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/ln": { "post": { "operationId": "calculate_math_ln", "summary": "Natural logarithm", "description": "Natural logarithm y = ln(x) = log_e(x) for real x > 0, with exp(result) verification. (calculation_version 1.0.4)\n\nSemantic capability: `math.ln`.\n\nCalculation version: `1.0.4`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Real ln only: x > 0 → INVALID_ARGUMENT when x ≤ 0\n\nLimitation: Missing x → MISSING_REQUIRED_INPUT; non-finite → INVALID_NUMBER", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.4" ] }, "description": "Pin calculation_version (published: 1.0.4); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.ln.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.4", "examples": [ "1.0.4" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.4" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.ln.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/square-root": { "post": { "operationId": "calculate_math_square_root", "summary": "Square root", "description": "Principal square root of x; non-negative returns real principal, negative returns principal imaginary √|x| i. (calculation_version 1.0.3)\n\nSemantic capability: `math.square_root`.\n\nCalculation version: `1.0.3`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: x ≥ 0 → principal = √x, imag = 0\n\nLimitation: x < 0 → real = 0, imag = √|x|, principal = null (unlike math.root NOT_REAL)\n\nLimitation: Missing x → MISSING_REQUIRED_INPUT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.3" ] }, "description": "Pin calculation_version (published: 1.0.3); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.square_root.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.3", "examples": [ "1.0.3" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.square_root.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/anti-log": { "post": { "operationId": "calculate_math_antilog", "summary": "Antilogarithm", "description": "Inverse of log: x = b^y (common, natural, binary, or custom base). (calculation_version 1.0.5)\n\nSemantic capability: `math.antilog`.\n\nCalculation version: `1.0.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Base must be > 0 and ≠ 1 → INVALID_BASE\n\nLimitation: Missing y → MISSING_REQUIRED_INPUT; overflow/underflow → RESULT_OVERFLOW / RESULT_UNDERFLOW", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.5" ] }, "description": "Pin calculation_version (published: 1.0.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.antilog.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.5", "examples": [ "1.0.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.antilog.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/root": { "post": { "operationId": "calculate_math_root", "summary": "Nth root", "description": "Principal real nth root of a with positive safe-integer index n (default 2). (calculation_version 1.0.5)\n\nSemantic capability: `math.root`.\n\nCalculation version: `1.0.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: n must be a positive safe integer → INVALID_INDEX\n\nLimitation: Even roots of a < 0 → NOT_REAL (unlike square-root imaginary)\n\nLimitation: Missing a → MISSING_REQUIRED_INPUT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.5" ] }, "description": "Pin calculation_version (published: 1.0.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.root.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.5", "examples": [ "1.0.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.root.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/exponent": { "post": { "operationId": "calculate_math_exponent", "summary": "Exponentiation", "description": "Real power y = aⁿ with solve_for y (default scalar), a, or n. (calculation_version 1.0.4)\n\nSemantic capability: `math.exponent`.\n\nCalculation version: `1.0.4`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: 0⁰ and 0^(negative) → UNDEFINED_POWER\n\nLimitation: Negative base with non-integer exponent → NOT_REAL\n\nLimitation: Forward solve_for=y returns a scalar; inverse returns a structured object", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.4" ] }, "description": "Pin calculation_version (published: 1.0.4); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.exponent.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.4", "examples": [ "1.0.4" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.4" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.exponent.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/sin": { "post": { "operationId": "calculate_math_sin", "summary": "Sine", "description": "sin(θ) in degrees (default) or radians, with algebraic snap for textbook angles. (calculation_version 1.0.5)\n\nSemantic capability: `math.sin`.\n\nCalculation version: `1.0.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Missing theta → MISSING_REQUIRED_INPUT\n\nLimitation: unit must be deg|rad → INVALID_UNIT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.5" ] }, "description": "Pin calculation_version (published: 1.0.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.sin.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.5", "examples": [ "1.0.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.sin.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/cos": { "post": { "operationId": "calculate_math_cos", "summary": "Cosine", "description": "cos(θ) in degrees (default) or radians, with algebraic snap for textbook angles. (calculation_version 1.0.5)\n\nSemantic capability: `math.cos`.\n\nCalculation version: `1.0.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Missing theta → MISSING_REQUIRED_INPUT\n\nLimitation: unit must be deg|rad → INVALID_UNIT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.5" ] }, "description": "Pin calculation_version (published: 1.0.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.cos.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.5", "examples": [ "1.0.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.cos.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/tan": { "post": { "operationId": "calculate_math_tan", "summary": "Tangent", "description": "tan(θ) in degrees (default) or radians; exact odd multiples of 90° are UNDEFINED; near-pole returns finite with NEAR_SINGULARITY. (calculation_version 1.0.4)\n\nSemantic capability: `math.tan`.\n\nCalculation version: `1.0.4`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Exact poles (90° + 180°k) → UNDEFINED\n\nLimitation: Within 0.01° of a pole → finite value with warnings NEAR_SINGULARITY\n\nLimitation: Missing theta → MISSING_REQUIRED_INPUT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.4" ] }, "description": "Pin calculation_version (published: 1.0.4); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.tan.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.4", "examples": [ "1.0.4" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.4" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.tan.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/arcsin": { "post": { "operationId": "calculate_math_arcsin", "summary": "Arcsine", "description": "Principal arcsin(x) for x ∈ [−1, 1], returning degrees and radians with verification. (calculation_version 1.0.5)\n\nSemantic capability: `math.arcsin`.\n\nCalculation version: `1.0.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: x outside [−1, 1] → NOT_REAL\n\nLimitation: Missing x → MISSING_REQUIRED_INPUT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.5" ] }, "description": "Pin calculation_version (published: 1.0.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.arcsin.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.5", "examples": [ "1.0.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.arcsin.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/arccos": { "post": { "operationId": "calculate_math_arccos", "summary": "Arccosine", "description": "Principal arccos(x) for x ∈ [−1, 1], returning degrees and radians with verification. (calculation_version 1.0.4)\n\nSemantic capability: `math.arccos`.\n\nCalculation version: `1.0.4`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: x outside [−1, 1] → NOT_REAL\n\nLimitation: Missing x → MISSING_REQUIRED_INPUT", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.4" ] }, "description": "Pin calculation_version (published: 1.0.4); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.arccos.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.4", "examples": [ "1.0.4" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.4" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.arccos.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/arctan": { "post": { "operationId": "calculate_math_arctan", "summary": "Arctangent", "description": "Principal arctan(x) for any finite real x, returning degrees and radians with verification. (calculation_version 1.0.7)\n\nSemantic capability: `math.arctan`.\n\nCalculation version: `1.0.7`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Missing x → MISSING_REQUIRED_INPUT\n\nLimitation: Non-finite → INVALID_NUMBER", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.7" ] }, "description": "Pin calculation_version (published: 1.0.7); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.arctan.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.7", "examples": [ "1.0.7" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.7" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.arctan.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/add": { "post": { "operationId": "calculate_math_sum", "summary": "Sum / addition", "description": "Exact decimal sum of a list of values (comma/space/newline separated), with optional long-addition work. (calculation_version 1.0.2)\n\nSemantic capability: `math.sum`.\n\nCalculation version: `1.0.2`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Missing values → MISSING_REQUIRED_INPUT\n\nLimitation: Long mode requires non-negative decimals without scientific notation\n\nLimitation: Too many values → TOO_MANY_VALUES", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.2" ] }, "description": "Pin calculation_version (published: 1.0.2); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.sum.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.2", "examples": [ "1.0.2" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.2" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.sum.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/subtraction": { "post": { "operationId": "calculate_math_subtraction", "summary": "Subtraction", "description": "Difference a − b with solve-for any missing term, plus optional long subtraction. (calculation_version 1.0.1)\n\nSemantic capability: `math.subtraction`.\n\nCalculation version: `1.0.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Need any two of minuend/subtrahend/difference → MISSING_REQUIRED_INPUT\n\nLimitation: Long mode: non-negative decimals; scientific notation not supported", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.1" ] }, "description": "Pin calculation_version (published: 1.0.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.subtraction.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.1", "examples": [ "1.0.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.subtraction.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/division": { "post": { "operationId": "calculate_math_divide", "summary": "Division", "description": "Quotient a ÷ b with optional decimal places, plus long-division work for integers. (calculation_version 1.0.5)\n\nSemantic capability: `math.divide`.\n\nCalculation version: `1.0.5`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: b = 0 → DIVISION_BY_ZERO\n\nLimitation: Long mode uses BigInt integers only", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.5" ] }, "description": "Pin calculation_version (published: 1.0.5); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.divide.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.5", "examples": [ "1.0.5" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.5" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.divide.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/exponential-growth": { "post": { "operationId": "calculate_math_exponential_growth", "summary": "Exponential growth / decay", "description": "Periodic x₀(1+r/100)^t or continuous x₀e^(kt) growth and decay. Any three of x₀, r/k, t, x(t) solve the fourth; all four verify displayed-precision consistency. (calculation_version 1.0.7)\n\nSemantic capability: `math.exponential_growth`.\n\nCalculation version: `1.0.7`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Periodic model requires r > −100% → RATE_MUST_BE_GT_MINUS_100\n\nLimitation: Non-finite inputs → INVALID_NUMBER", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.7" ] }, "description": "Pin calculation_version (published: 1.0.7); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.exponential_growth.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.7", "examples": [ "1.0.7" ] } } }, "example": { "inputs": { "x0": 50, "ratePct": 4, "t": 90 }, "calculation_version": "1.0.7" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.exponential_growth.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/scientific-notation": { "post": { "operationId": "calculate_math_scientific_notation", "summary": "Scientific notation", "description": "Convert between decimal and scientific/engineering notation; normalize and operate on A×10ⁿ forms. (calculation_version 1.1.1)\n\nSemantic capability: `math.scientific_notation`.\n\nCalculation version: `1.1.1`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Missing/invalid numbers → INVALID_NUMBER / MISSING_REQUIRED_INPUT\n\nLimitation: Division by zero in operate → DIVISION_BY_ZERO", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.1.1" ] }, "description": "Pin calculation_version (published: 1.1.1); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.scientific_notation.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.1.1", "examples": [ "1.1.1" ] } } }, "example": { "inputs": {}, "calculation_version": "1.1.1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.scientific_notation.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/multiplication": { "post": { "operationId": "calculate_math_multiplication", "summary": "Multiplication", "description": "Exact decimal product of multiplicand × multiplier, with optional long-multiplication work. (calculation_version 1.0.3)\n\nSemantic capability: `math.multiplication`.\n\nCalculation version: `1.0.3`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Missing a or b → INVALID_INPUT\n\nLimitation: Product and long modes share exact decimal mantissa × BigInt arithmetic\n\nLimitation: Very wide long grids may set LONG_GRID_TRUNCATED", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.3" ] }, "description": "Pin calculation_version (published: 1.0.3); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.multiplication.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.3", "examples": [ "1.0.3" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.multiplication.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/combinatorics": { "post": { "operationId": "calculate_math_combinatorics", "summary": "Permutations and combinations", "description": "Exact P(n,k) and C(n,k) for integers 0 ≤ k ≤ n ≤ 1000 via the multiplicative formula. Not a factorial product page. (calculation_version 1.0.0)\n\nSemantic capability: `math.combinatorics`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not the factorial product page — use /calc/math/factorial for n!\n\nLimitation: Not multinomial coefficients and not with-replacement selections\n\nLimitation: Domain 0 ≤ k ≤ n ≤ 1000\n\nLimitation: k > n → INVALID_INPUT\n\nLimitation: unknown mode → INVALID_MODE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.combinatorics.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.combinatorics.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/modulo": { "post": { "operationId": "calculate_math_modulo", "summary": "Euclidean remainder", "description": "Integer remainder with a = q·m + r and 0 ≤ r < |m|. Not JavaScript truncated %. (calculation_version 1.0.0)\n\nSemantic capability: `math.modulo`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Euclidean remainder, not truncated or floored remainder toward −∞ of the quotient only\n\nLimitation: Not IEEE remainder or floating-point fmod\n\nLimitation: modulus = 0 → DIVISION_BY_ZERO\n\nLimitation: Share URLs use modulus, not m (m is reserved elsewhere)", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.modulo.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.modulo.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/prime-factorization": { "post": { "operationId": "calculate_math_prime_factorization", "summary": "Prime factorization", "description": "Trial-division factorization and primality for integers 1 ≤ n ≤ 10^12. One capability, two modes — not two engines. (calculation_version 1.0.0)\n\nSemantic capability: `math.prime_factorization`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Trial division only — not a primality-proving sieve for cryptographic sizes\n\nLimitation: n = 1 is neither prime nor composite (empty factorization)\n\nLimitation: Domain 1 ≤ n ≤ 10^12\n\nLimitation: n < 1 → VALUE_MUST_BE_POSITIVE\n\nLimitation: unknown mode → INVALID_MODE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.prime_factorization.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.prime_factorization.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/linear-equation": { "post": { "operationId": "calculate_math_algebra_linear_equation", "summary": "Linear equation", "description": "Solve ax + b = rhs for x. a = 0 is identity or inconsistent. Not the quadratic formula. (calculation_version 1.0.0)\n\nSemantic capability: `math.algebra.linear_equation`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not ax² + bx + c = 0 — use /calc/math/quadratic\n\nLimitation: a = 0 and b = rhs → infinite\n\nLimitation: a = 0 and b ≠ rhs → inconsistent", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.algebra.linear_equation.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.algebra.linear_equation.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/triangle-solver": { "post": { "operationId": "calculate_math_geometry_triangle", "summary": "Triangle solver", "description": "Solve a Euclidean triangle from SSS, SAS, ASA, AAS, or SSA (ambiguous). Not the Pythagorean-only page. (calculation_version 1.0.0)\n\nSemantic capability: `math.geometry.triangle`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not the right-triangle Pythagorean calculator — use /calc/math/pythagorean\n\nLimitation: SSS failing triangle inequality → INVALID_INPUT\n\nLimitation: SSA may return status multiple_solutions\n\nLimitation: Spherical / spherical excess is out of scope", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.geometry.triangle.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.geometry.triangle.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/complex": { "post": { "operationId": "calculate_math_complex", "summary": "Complex numbers", "description": "Rectangular and polar complex arithmetic: add, subtract, multiply, divide, conjugate, modulus. Not a CAS. (calculation_version 1.0.0)\n\nSemantic capability: `math.complex`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not symbolic simplify or complex analysis\n\nLimitation: Division by 0+0i → DIVISION_BY_ZERO\n\nLimitation: Argument uses atan2, degrees", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.complex.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.complex.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/circle": { "post": { "operationId": "calculate_math_geometry_circle", "summary": "Circle", "description": "Radius, diameter, circumference, area, arc length, and sector area of a Euclidean circle. Not the Pythagorean page. (calculation_version 1.0.0)\n\nSemantic capability: `math.geometry.circle`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not a²+b²=c² — use /calc/math/pythagorean\n\nLimitation: r ≤ 0 → VALUE_MUST_BE_POSITIVE\n\nLimitation: Spherical geometry is out of scope", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.geometry.circle.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.geometry.circle.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/coordinate-geometry": { "post": { "operationId": "calculate_math_geometry_coordinate", "summary": "Coordinate geometry", "description": "Distance, midpoint, and slope of two points in the plane. Slope is not share-key m. (calculation_version 1.0.0)\n\nSemantic capability: `math.geometry.coordinate`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not the Pythagorean-only calculator — distance of (0,0) to (3,4) is the same 5 as 3-4-5, but this page is coordinates\n\nLimitation: Vertical line → slope null, vertical true\n\nLimitation: Share URLs use slope as output, not query key m", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.geometry.coordinate.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.geometry.coordinate.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/linear-system": { "post": { "operationId": "calculate_math_linear_algebra", "summary": "Linear system / small matrix", "description": "Solve Ax=b for order 2–4, plus det, inverse, multiply, transpose. Same engine as /workspace/matrix. Not a CAS. (calculation_version 1.0.0)\n\nSemantic capability: `math.linear_algebra`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Order ≤ 4 (local small-matrix seed)\n\nLimitation: Singular inverse → SINGULAR_MATRIX\n\nLimitation: Not eigenvalue / SVD / large-matrix server compute", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.linear_algebra.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.linear_algebra.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/numerical-root": { "post": { "operationId": "calculate_math_numerical_root", "summary": "Numerical root", "description": "Newton, bisection, or secant for a real polynomial root (degree ≤ 8). One capability, three methods. Not the nth-root page. (calculation_version 1.0.0)\n\nSemantic capability: `math.numerical.root`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not ⁿ√a — that remains /calc/math/root\n\nLimitation: Not three independent Newton/bisection/secant product pages\n\nLimitation: Degree > 8 → INVALID_INPUT\n\nLimitation: No convergence → NO_CONVERGENCE", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.numerical.root.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.numerical.root.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/calc/definite-integral": { "post": { "operationId": "calculate_math_numerical_definite_integral", "summary": "Definite integral", "description": "Composite trapezoid or Simpson 1/3 of a polynomial, sin, or exp on [a, b]. Not indefinite symbolic integrate. (calculation_version 1.0.0)\n\nSemantic capability: `math.numerical.definite_integral`.\n\nCalculation version: `1.0.0`.\n\nPin with body `calculation_version` or header `CalculatorX-Spec-Version`.\n\nLimitation: Not indefinite / symbolic CAS integrate\n\nLimitation: n panels 2–10000; Simpson n forced even\n\nLimitation: Polynomial degree ≤ 8", "tags": [ "CoreCapabilities" ], "parameters": [ { "name": "CalculatorX-Spec-Version", "in": "header", "required": false, "schema": { "type": "string", "examples": [ "1.0.0" ] }, "description": "Pin calculation_version (published: 1.0.0); mismatch returns 409" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "inputs" ], "properties": { "inputs": { "$ref": "https://www.calculatorx.com/schemas/math.numerical.definite_integral.input.json" }, "calculation_version": { "type": "string", "description": "Optional pin; published version is 1.0.0", "examples": [ "1.0.0" ] } } }, "example": { "inputs": {}, "calculation_version": "1.0.0" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "https://www.calculatorx.com/schemas/math.numerical.definite_integral.output.json" } } } }, "400": { "description": "Invalid or incomplete inputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Unknown engine or capability", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "VERSION_MISMATCH — pinned calculation_version unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "415": { "description": "Unsupported Content-Type (use application/json)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "RATE_LIMITED", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitError" } } } }, "500": { "description": "Unexpected server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } } }, "components": { "schemas": { "ApiError": { "type": "object", "required": [ "status", "code", "error" ], "additionalProperties": true, "properties": { "type": { "type": "string", "format": "uri", "description": "Problem type URI, e.g. https://www.calculatorx.com/problems/voltage-must-be-positive" }, "title": { "type": "string" }, "status": { "oneOf": [ { "const": "error" }, { "type": "integer" } ], "description": "Either the string \"error\" or HTTP status code" }, "code": { "type": "string", "description": "Machine code such as VOLTAGE_MUST_BE_POSITIVE or VERSION_MISMATCH" }, "error": { "type": "string", "description": "Human-readable detail" }, "detail": { "type": "string" }, "field": { "type": [ "string", "null" ] }, "invalid_parameters": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "received": {}, "constraint": { "type": "string" } } } }, "recoverable": { "type": "boolean" }, "suggestion": { "type": "string" }, "published_version": { "type": "string" }, "received": {} } }, "RateLimitError": { "allOf": [ { "$ref": "#/components/schemas/ApiError" }, { "type": "object", "properties": { "code": { "const": "RATE_LIMITED" }, "retry_after_seconds": { "type": "integer", "minimum": 1 }, "limit": { "type": "integer" } } } ] } }, "parameters": {} }, "externalDocs": { "description": "Capability templates", "url": "https://www.calculatorx.com/.well-known/calculatorx-capabilities.json" } }