Discover mathematical capabilities
capability.describeDiscover installed mathematical outcomes by query or inspect a capability contract for its input schema, runtime identity, and verified examples before invoking.
Instructions
Discover installed mathematical outcomes or inspect one exact capability contract.
Use this first when a task may benefit from exact computation, structural analysis, transformation, bounded search, counterexample generation, formal-environment inspection, or independent checking. You do not need to know a capability ID.
Discovery:
Pass
queryto rank compact installed outcomes by mathematical intent.Optionally filter with
domainandmode;limitis between 1 and 20 and defaults to 5.Omit all arguments to browse a compact installed catalog.
When
next_cursoris present, pass it back with the same filters and limit to continue without loading the complete catalog.Ranking is deterministic retrieval over published IDs, titles, descriptions, and tags. Match fields and terms are returned; results are candidates, not recommendations.
Once a domain-owned match fits the required outcome, inspect only the strongest one or two candidates. Search again when none fits. Invoke a producer before looking for its checker, then follow the checker, certificate, and verification fields in the producer result instead of guessing a generic verifier.
Compose capabilities as the investigation requires; Jacobian does not prescribe a mathematical workflow.
Exact inspection:
Pass
capability_idfor the small default SUMMARY projection when judging fit.Request
view="CONTRACT"once a capability fits and before invoking it. CONTRACT adds the validation-equivalent input schema, runtime identity, related operations, and validated invocation examples.Add
view="FULL"only when complete output schema, provider configuration, licensing, or audit metadata is needed.Every exact response states the scope rule: repeated bounded invocations remain finite evidence and do not establish an all-orders or all-parameters conclusion.
Examples:
{"query":"find a counterexample to associativity","domain":"universal_algebra","mode":"EXPLORE","limit":5}{"query":"verify a polynomial identity","mode":"VERIFY","limit":5}{"capability_id":"polynomial.compute.gcd"}{"capability_id":"polynomial.compute.gcd","view":"CONTRACT"}{"capability_id":"polynomial.compute.gcd","view":"FULL"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Optional EXPLORE or VERIFY capability filter. | |
| view | No | Exact-lookup projection. SUMMARY is the small agent-facing default for judging fit. CONTRACT adds the validation-equivalent input schema, runtime identity, related operations, and validated invocation examples; request it before invoking. FULL returns the complete installed descriptor for audit or client generation. Omit for discovery. | SUMMARY |
| limit | No | Maximum compact discovery matches; defaults to 5. Start with 5 and inspect only the strongest one or two candidates. | |
| query | No | Mathematical outcome to find; no capability ID is required. | |
| cursor | No | Opaque continuation ID from next_cursor. Reuse the same query, domain, mode, input kind, artifact type, and limit. | |
| domain | No | Optional domain tag filter, such as universal_algebra, graph, polynomial, or lean. | |
| input_kind | No | Input boundary used to reject incompatible routes. | |
| artifact_type | No | Exact schema_uri from the stored artifact manifest; requires TYPED_ARTIFACT. | |
| capability_id | No | Exact installed ID; cannot be combined with discovery filters. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||