mirror of
https://github.com/bckelley/cgm-remote-monitor.git
synced 2026-08-24 03:14:12 -05:00
bewestandBen West
12c90cfc63
Create a new RFC document and associated JSON schemas defining an agentic control plane for automated insulin delivery systems, including event envelopes, capabilities models, delivery tracking, and conflict rules. Replit-Commit-Author: Agent Replit-Commit-Session-Id: 06715f81-f852-4156-8ab0-cf9e0aa3564d Replit-Commit-Checkpoint-Type: intermediate_checkpoint Replit-Commit-Event-Id: 010cdc4a-2c86-4d2e-9768-bf2769a89953 Replit-Helium-Checkpoint-Created: true
118 lines
3.4 KiB
JSON
118 lines
3.4 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://nightscout.github.io/schemas/reconciliation.schema.json",
|
|
"title": "Reconciliation",
|
|
"description": "Matching of DeliveryRequest to DeliveryObservation - intent vs reality",
|
|
"type": "object",
|
|
"required": ["reconciliationId", "outcome", "reconciledAt"],
|
|
"properties": {
|
|
"reconciliationId": {
|
|
"type": "string",
|
|
"format": "uuid",
|
|
"description": "Unique identifier for this reconciliation"
|
|
},
|
|
"requestId": {
|
|
"type": ["string", "null"],
|
|
"format": "uuid",
|
|
"description": "The DeliveryRequest being reconciled (null for spontaneous observations)"
|
|
},
|
|
"observationId": {
|
|
"type": ["string", "null"],
|
|
"format": "uuid",
|
|
"description": "The DeliveryObservation (null for unobserved requests)"
|
|
},
|
|
"outcome": {
|
|
"type": "string",
|
|
"enum": ["matched", "partial", "blocked", "failed", "expired", "unknown", "spontaneous"],
|
|
"description": "Result of reconciliation"
|
|
},
|
|
"discrepancy": {
|
|
"type": "object",
|
|
"description": "Details of any mismatch between request and observation",
|
|
"properties": {
|
|
"requestedUnits": {
|
|
"type": "number",
|
|
"description": "What was requested"
|
|
},
|
|
"deliveredUnits": {
|
|
"type": "number",
|
|
"description": "What was actually delivered"
|
|
},
|
|
"delta": {
|
|
"type": "number",
|
|
"description": "Difference (delivered - requested)"
|
|
},
|
|
"requestedRate": {
|
|
"type": "number",
|
|
"description": "Requested rate for temp basal"
|
|
},
|
|
"deliveredRate": {
|
|
"type": "number",
|
|
"description": "Actual rate delivered"
|
|
},
|
|
"requestedDuration": {
|
|
"type": "integer",
|
|
"description": "Requested duration in seconds"
|
|
},
|
|
"actualDuration": {
|
|
"type": "integer",
|
|
"description": "Actual duration in seconds"
|
|
},
|
|
"reason": {
|
|
"type": "string",
|
|
"enum": [
|
|
"capped_by_max_basal",
|
|
"capped_by_max_iob",
|
|
"capped_by_max_bolus",
|
|
"comm_failure",
|
|
"pump_error",
|
|
"user_canceled",
|
|
"pump_busy",
|
|
"reservoir_low",
|
|
"battery_low",
|
|
"occlusion",
|
|
"expired",
|
|
"unknown"
|
|
],
|
|
"description": "Reason for discrepancy"
|
|
},
|
|
"reasonDetails": {
|
|
"type": "string",
|
|
"description": "Additional details about the discrepancy"
|
|
}
|
|
}
|
|
},
|
|
"reconciledAt": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "When this reconciliation was performed"
|
|
},
|
|
"reconciledBy": {
|
|
"type": "object",
|
|
"properties": {
|
|
"issuerType": {
|
|
"type": "string",
|
|
"enum": ["controller", "agent", "system"]
|
|
},
|
|
"issuerId": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"latency": {
|
|
"type": "object",
|
|
"description": "Timing metrics",
|
|
"properties": {
|
|
"requestToObservationMs": {
|
|
"type": "integer",
|
|
"description": "Time from request to observation in milliseconds"
|
|
},
|
|
"requestToReconciliationMs": {
|
|
"type": "integer",
|
|
"description": "Time from request to reconciliation in milliseconds"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|