calculators

Get the input and output schema for a calculator, generated from its reviewed contract: parameter types, units, allowed dropdown values and definitional bounds, plus outputs keyed by named range (including the status output). Table inputs carry a 'grid' block giving the exact number of rows to send, the column layout, which columns are editable, and how to shape a row; a table whose 'grid' block says writable=false cannot be supplied at all. Schema 0.18 exposes required and omitted declarations plus version-bound visibility tables; older versions require every input while awaiting metadata migration. Optionally resolves one immutable platform version. Returns trust metadata for the resolved version.

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "The calculator slug, e.g. 'steel-column-capacity-calculator'."}, 'platform_version': {'type': ['integer', 'null'], 'default': None, 'description': 'Optional positive platform version number. Omit for the current published version.'}}}

Run a calculator with the given inputs. Inputs are validated against the resolved version's reviewed contract and computed by SpreadsheetWeb through the same proxy as the web channel. An optional platform_version pins both validation and computation to that immutable version. Returns outputs keyed by named range (including the status output) and trust metadata with a citation URL, resolvedInputs, and warnings for omitted inputs. Missing or blank visible required inputs are refused before computation; inspect get_calculator_schema and the complete error detail. For schema 0.18, optional omissions are sent explicitly as declared blank or standing default and disclosed with their values and sources. Older pinned contracts require all inputs during migration. Visibility follows version-bound dropdown truth tables; a missing controller makes its dependents indeterminate until it is supplied. A hidden controller is ignored only when all of its option branches have the same remaining visibility subtree; otherwise its dependents stay hidden. Hidden omissions use explicit blank/default values; supplied hidden inputs are retained with a not-applicable warning. Always read Model_Status and status outputs; CHECK and STOP are load-bearing verdicts about the result's validity. Results are informational and not professional advice; the applicable notice is returned in the trust block.

{'type': 'object', 'required': ['slug', 'inputs'], 'properties': {'slug': {'type': 'string', 'description': 'The calculator slug.'}, 'inputs': {'type': 'object', 'description': "Input name/value pairs matching the calculator schema (from get_calculator_schema). A table input takes a list of rows matching its 'grid' block exactly; a table of the wrong extent or shape is refused rather than partially applied."}, 'platform_version': {'type': ['integer', 'null'], 'default': None, 'description': 'Optional positive platform version number. Omit for the current published version.'}}}

Search the LogicCommons calculator catalog by keyword and optional category. Returns matching published calculators with slug, name, summary, category, a citation URL, and trust metadata.

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Free-text query matched against calculator name, summary and category. Empty returns the catalog.'}, 'category': {'type': ['string', 'null'], 'default': None, 'description': "Optional category slug to filter by, e.g. 'structural-civil'."}}}