open-standards/wai/wai-quantum-cli/schemas/local-tools.v1.json
Transaction Science fa68a97f92 wai-quantum: gradients, optimisation, VQE, QAOA and the algorithm builders on every surface
The command line gains gradient, optimize, vqe, qaoa and build, and run,
plan and submit take --param; verify checks an optimisation's chain and
runs any of these answers again to the same bytes. Both MCP servers serve
gradient_qasm, optimize_qasm, vqe_ground_state, qaoa_maxcut and
build_algorithm in one wording, and a job's params on run_quantum_circuit.
The job service answers POST /v1/gradient, /v1/optimize, /v1/vqe,
/v1/qaoa and /v1/build within its own bounds (J031 past them, naming the
local command). The page engine gains variational(op, args), its gradient
the native build's pinned bytes in wasm32. Every answer follows the new
schema wai.quantum.algorithms/1; the agent docs are regenerated.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-31 09:48:42 -04:00

343 lines
8.5 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://git.transaction.science/Transaction-Science/open-standards/raw/branch/main/wai/wai-quantum-cli/schemas/local-tools.v1.json",
"title": "wai.quantum.local-tools/1",
"description": "The answers of the local MCP server's own tools (wai-quantum mcp), those the command line writes beside the engine's: a receipt's check, the workbench archive's submissions, a program's history, the person's taste, and the person's own providers. Each is a $def; every tool's outputSchema in tools/list is its answer's schema standing alone. The engine's answers are in wai-quantum's schemas.",
"$defs": {
"verify": {
"description": "Whether a job's receipt seals its request and its result, and the key that signed it; for an estimate, also every estimate's receipt and the request re-run here; for an answer of the variational and algorithm library, also its digest chain and the answer re-run here.",
"anyOf": [
{
"type": "object",
"description": "Whether a job's receipt seals its request and its result, and the key that signed it.",
"required": [
"valid",
"key"
],
"properties": {
"valid": {
"type": "boolean"
},
"key": {
"type": [
"string",
"null"
],
"description": "The signing key, 32 bytes in hex."
}
}
},
{
"$ref": "https://git.transaction.science/Transaction-Science/open-standards/raw/branch/main/wai/wai-quantum/schemas/estimate.v1.json#/$defs/verify"
},
{
"$ref": "https://git.transaction.science/Transaction-Science/open-standards/raw/branch/main/wai/wai-quantum/schemas/algorithms.v1.json#/$defs/verify"
}
]
},
"discover_submit": {
"type": "object",
"description": "What the archive did with a generator, and its best entry after.",
"required": [
"outcome",
"best"
],
"properties": {
"outcome": {
"type": "object"
},
"best": {
"type": [
"object",
"null"
]
}
}
},
"history_commit": {
"type": "object",
"description": "The version an agent's edit was recorded as, and in whose name.",
"required": [
"version",
"parent",
"by",
"history"
],
"properties": {
"version": {
"type": "string"
},
"parent": {
"type": "string"
},
"by": {
"type": [
"object",
"null"
],
"properties": {
"kind": {
"enum": [
"person",
"assistant",
"agent",
"engine",
"origin"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"history": {
"type": "string",
"description": "The history file's path."
}
}
},
"history_changes": {
"type": "object",
"required": [
"changes",
"rules"
],
"properties": {
"changes": {
"type": "array",
"items": {
"type": "object"
}
},
"breaches": {},
"rules": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"history_blame": {
"type": "object",
"required": [
"version",
"lines",
"authorship"
],
"properties": {
"version": {
"type": "string"
},
"lines": {
"type": "array",
"items": {
"type": "object"
}
},
"authorship": {
"type": "object"
}
}
},
"history_log": {
"type": "object",
"required": [
"versions",
"check"
],
"properties": {
"versions": {
"type": "array",
"items": {
"type": "object"
}
},
"check": {
"type": "object"
}
}
},
"taste_rank": {
"type": "object",
"description": "Programs ranked by the person's own taste profile: each with its score, its parts' scores and its typicality; where the parts or the cost put another first; and whether the ranking narrows what comes first.",
"required": [
"choices",
"ranked"
],
"properties": {
"choices": {
"type": "integer",
"description": "The choices the profile has learned from."
},
"dial": {
"type": "number",
"description": "The novelty dial, -1 to 1."
},
"ranked": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"score",
"final"
],
"properties": {
"name": {
"type": "string"
},
"score": {
"type": "number"
},
"final": {
"type": "number"
},
"novelty": {
"type": [
"number",
"null"
]
},
"typicality": {
"type": [
"number",
"null"
]
},
"cost": {
"type": [
"number",
"null"
]
},
"parts": {
"type": "object",
"additionalProperties": {
"type": "number"
}
}
}
}
},
"disagree": {
"type": "array",
"items": {
"type": "object",
"properties": {
"part": {
"type": "string"
},
"first": {
"type": "string"
}
}
}
},
"narrowing": {
"type": [
"object",
"null"
]
}
}
},
"taste_next": {
"type": "object",
"description": "The pair the person's taste profile is least sure of that the engine proves equal, or why there is none.",
"required": [
"a"
],
"properties": {
"a": {
"type": [
"string",
"null"
]
},
"b": {
"type": "string"
},
"how": {
"type": "string",
"description": "How the engine proved them equal."
},
"p_a": {
"type": "number",
"description": "The profile's probability that the person prefers a."
},
"why": {
"type": "string"
}
}
},
"providers_list": {
"type": "object",
"description": "The person's providers, and where each one's credential is; with free, what is free.",
"required": [
"registry",
"providers"
],
"properties": {
"registry": {
"type": "string",
"description": "The registry file's path."
},
"providers": {
"type": "array",
"items": {
"type": "object"
}
},
"free": {
"type": "object"
}
}
},
"provider_estimate": {
"type": "object",
"description": "The dry run of a job on a provider: nothing submitted, nothing spent.",
"required": [
"dry_run",
"provider",
"plan",
"estimate",
"free",
"confirm"
],
"properties": {
"dry_run": {
"const": true
},
"provider": {
"type": "object"
},
"calibration": {
"type": [
"string",
"null"
]
},
"billing": {
"type": "object"
},
"plan": {
"type": "object"
},
"estimate": {
"type": "object"
},
"free": {
"type": "boolean"
},
"confirm": {
"type": "string",
"description": "What the person reads before confirming a run that is not free."
}
}
}
}
}