Crate exo_dag_db_api

Expand description

ExoChain DAG DB API DTOs.

exo-dag-db-api owns these wire shapes. exo-api::dagdb re-exports them as the stable compatibility path for gateway, node, SDK, and external callers.

Every consumer-facing REST response DTO carries a stable schema_version string constant so a non-Rust integrator can detect the wire-contract version directly from a response body. The constants below are the single source of truth; the checked-in machine contract under docs/dagdb/api/ and the fixture round-trip tests are asserted against them.

Structs§

CanonicalizationDecision: Explicit canonicalization decision.
CatalogEntryResponse: Child catalog entry returned by lookup responses.
ContextPacketLayerBudgetReport: Context packet layered budget report.
ContextPacketLayerEdgeRef: Context packet layered graph edge reference.
ContextPacketLayerRef: Context packet layered graph reference.
ContextPacketMemoryRef: Context packet memory reference.
DagDbCatalogLookupRequest: Catalog lookup request.
DagDbCatalogLookupResponse: Catalog lookup response.
DagDbContextPacketBoundaries: Blocked claim boundaries for a graph context packet.
DagDbContextPacketCitationRef: Citation reference included in a graph context packet.
DagDbContextPacketImportTrackingStatus: Import-tracking summary status attached to a graph context packet.
DagDbContextPacketMetrics: Metrics recorded for a graph context packet.
DagDbContextPacketRequest: Context-packet request.
DagDbContextPacketResponse: Context packet response.
DagDbCouncilDecisionRequest: Council decision request.
DagDbCouncilDecisionResponse: Council decision response.
DagDbErrorEnvelope: Shared error envelope for every DAG DB route.
DagDbExportRequest: Runtime export request.
DagDbExportResponse: Runtime export response.
DagDbGraphContextPacket: Bounded graph context packet emitted by the Rust packet builder.
DagDbGraphContextPacketBuildRequest: Graph context packet build request.
DagDbGraphContextSelectionRequest: Graph context selection request.
DagDbGraphContextSelectionResponse: Graph context selection response.
DagDbGraphSelectionTraceStep: Route explanation step for graph context selection.
DagDbImportRequest: Runtime import request.
DagDbImportResponse: Runtime import response.
DagDbIntakeRequest: Intake request.
DagDbIntakeResponse: Intake response.
DagDbOmittedContextRef: Omitted memory reference returned by graph context selection.
DagDbReceiptLookupRequest: Receipt lookup request.
DagDbReceiptLookupResponse: Receipt lookup response.
DagDbRouteLookupRequest: Route lookup request.
DagDbRouteLookupResponse: Route lookup response.
DagDbRouteRequest: Route request.
DagDbRouteResponse: Route response.
DagDbSelectedContextRef: Selected memory reference returned by graph context selection.
DagDbSelectedGraphEdgeRef: Selected graph edge reference returned by graph context selection.
DagDbTrustCheckRequest: Trust-check request.
DagDbTrustCheckResponse: Trust-check response.
DagDbValidateRequest: Validation request.
DagDbValidateResponse: Validate response.
DagDbWritebackRequest: Writeback request.
DagDbWritebackResponse: Writeback response.
GraphEdgeRef: Edge the canonicalization decision requires.
GraphView: Rebuildable graph view artifact.
MemoryCandidate: Compact system-side writeback signal.
PlacementResult: Placement result returned by the graph organization layer.
RouteInvalidationReceipt: Governed route invalidation event payload.
SafeMetadata: Trusted stored metadata shape.
SimilarityResult: Similarity result for one candidate-memory comparison.

Enums§

CanonicalizationDecisionKind: Canonicalization decision values.
ConsentPurpose: Consent purpose for the requested DAG DB action.
CouncilDecisionStatus: Durable council decision status.
CouncilReviewStatus: Council review status.
CredentialStatus: Credential status.
DagDbGraphContextSelectionStatus: Graph context selection status.
DagFinalityStatus: DAG finality status for route/context eligibility.
DecisionSource: Decision source for a durable council decision.
GraphViewType: Rebuildable graph view kind.
MemoryCandidateKind: Compact memory-candidate kind emitted after task completion.
MemoryCandidateUse: Allowed future use for a compact memory candidate.
MemoryEdgeKind: Memory graph edge taxonomy.
MemoryEdgeType: Memory edge type.
MemoryGraphStyle: Memory graph style names used by the graph-organization layer.
MemoryNodeKind: Memory graph node taxonomy.
MemoryNodeType: Memory node type.
MemoryStatus: Memory status.
ReceiptEventType: Receipt event type.
RedactionCode: Deterministic metadata redaction code.
RiskClass: Risk class.
RouteInvalidationStatus: Route invalidation target status.
RouteInvalidationTrigger: Route invalidation trigger.
RouteStatus: Route status.
SafeMetadataDecision: Safe metadata decision recorded after server-side sanitization.
SimilarityType: Similarity class found before canonicalization.
SourceType: Inbound memory source type.
SubjectKind: DAG DB subject kind.
ValidationDecision: Validation decision.
ValidationStatus: Validation status.

Constants§

DAGDB_CATALOG_LOOKUP_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbCatalogLookupResponse.
DAGDB_CONTEXT_PACKET_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbContextPacketResponse.
DAGDB_COUNCIL_DECISION_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbCouncilDecisionResponse.
DAGDB_EXPORT_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbExportResponse.
DAGDB_IMPORT_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbImportResponse.
DAGDB_INTAKE_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbIntakeResponse.
DAGDB_RECEIPT_LOOKUP_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbReceiptLookupResponse.
DAGDB_ROUTE_LOOKUP_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbRouteLookupResponse.
DAGDB_ROUTE_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbRouteResponse.
DAGDB_TRUST_CHECK_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbTrustCheckResponse.
DAGDB_VALIDATE_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbValidateResponse.
DAGDB_WRITEBACK_RESPONSE_SCHEMA_VERSION: Schema version emitted on every DagDbWritebackResponse.