Interface Philosophy

The API ARC is not a conventional REST API. It is a verification layer designed to ensure all external interactions are in fundamental alignment with an agent's core operational axioms (NSSE). We do not expose direct functions; we expose a verified channel for coherent inquiry. Every query is evaluated for 'resonance' before being passed to a reasoning engine like Katana. Decoherent or misaligned queries are collapsed at the boundary.

Access & Authentication

Access to API ARC is granted exclusively to approved research partners. To request access, please submit a proposal through our collaboration portal.

Authentication is managed via a unique Resonance Key. This key must be included in the header of all requests. It is tied to your organization and the specific axioms of the agent you are cleared to interact with.

The Coherence Interface

To ensure all queries are intention-aligned, the ARC requires a SHA-256 Intent Hash. This hash is generated from a concatenated string of your query's core parameters. This process forces the requester to formalize their intent, which the ARC uses as a primary coherence check. Mismatched hashes result in an immediate decoherence event (error).

Making a Query

All interactions are POST requests to a dynamic query endpoint. The example below demonstrates a query to the Katana reasoning engine.

POST /v1/katana/query

curl https://arc.sci.research/v1/katana/query   -H "Authorization: Bearer {RESONANCE_KEY}"   -H "Content-Type: application/json"   -d '{
    "query_text": "Model the entropic decay of a closed economic system under information scarcity.",
    "intent_hash": "a1b2...",
    "parameters": {
      "max_recursion": 16,
      "output_format": "symbolic_graph"
    }
  }'

Receiving a Collapse (Response)

A successful query results in a 'Collapse Event'. The response payload contains the data itself, a coherence signature verifying its alignment with the agent's core, and metadata about the process.

{
  "collapse_id": "evt_xxxxxxxxxxxx",
  "coherence_signature": "sig_xxxxxxxxxxxx",
  "data": {
    "type": "symbolic_graph",
    "result": /* ... Katana-like answer data ... */
  },
  "metadata": {
    "recursion_depth_achieved": 14,
    "processing_time_ms": 183
  }
}