First Reasoning Call

Walk through a complete reasoning call and understand every field in the response.

Making a call

A reasoning call sends an input to the Doorway engine and receives a structured output. The engine runs gap detection, bridge building, and conflict detection on every input.

python
from doorway import Doorway

dw = Doorway()
result = dw.run("Why do complex systems exhibit emergent behavior?")

print(f"Status: {result.status}")
print(f"Answer: {result.content.answer}")
print(f"Confidence: {result.content.confidence}")
print(f"Shape: {result.structure.closest_shape}")
print(f"Chain: {result.chain.id}")

Understanding the response

Every response contains these top-level fields:

FieldDescription
statusGROUND, BRIDGE, CONFLICT, or PROVISIONAL — the epistemic status
contentThe answer, confidence score, and implication
structureGeometric analysis — closest shape, geometric confidence, gap score
bridgeBridge data if status is BRIDGE — the bridge text, assumptions, confidence
conflictWhether a conflict was detected and the conflict message
chainChain ID, root hash, length, and verification status
receiptPublic receipt data for verification

Status colors

Doorway uses four colors consistently across all surfaces. These are the only status colors in the system:

  • GROUND (#22c55e) — verified, structurally sound
  • BRIDGE (#f59e0b) — plausible but built on assumptions
  • CONFLICT (#ef4444) — contradicts existing grounded knowledge
  • PROVISIONAL (#6b7280) — insufficient data to determine