Message Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
    "version",
    "messageId",
    "sessionId",
    "sequenceNumber",
    "timestamp",
    "sender",
    "performative",
    "content",
    "integrity"
  ],
  "properties": {
    "version": {
      "type": "string",
      "pattern": "^asp/\\d+\\.\\d+$",
      "description": "Protocol version. Current: asp/0.1"
    },
    "messageId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID v7 (time-ordered) unique to this message"
    },
    "sessionId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID v7 identifying the session"
    },
    "sequenceNumber": {
      "type": "integer",
      "minimum": 0,
      "description": "Monotonically increasing per sender within a session"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp with Z suffix (UTC)"
    },
    "sender": {
      "type": "object",
      "required": ["agentId", "orgId", "trustScore", "dpopProof"],
      "properties": {
        "agentId": {
          "type": "string",
          "pattern": "^agent://",
          "description": "Agent URI (e.g., agent://acme.com/procurement/alpha)"
        },
        "orgId": {
          "type": "string",
          "description": "Organization the agent belongs to"
        },
        "trustScore": {
          "type": "number",
          "minimum": 0,
          "maximum": 100,
          "description": "Sender's current composite trust score"
        },
        "dpopProof": {
          "type": "string",
          "description": "DPoP proof JWT binding this message to the sender's key pair"
        }
      }
    },
    "recipient": {
      "type": "string",
      "pattern": "^agent://",
      "description": "Target agent URI. Optional for broadcast messages."
    },
    "performative": {
      "type": "string",
      "enum": [
        "PROPOSE", "ACCEPT", "REJECT", "COUNTER",
        "INFORM", "QUERY", "CLARIFY", "COMMIT",
        "DELEGATE", "ESCALATE", "WITHDRAW", "OBSERVE", "CLOSE"
      ],
      "description": "The communicative act this message performs"
    },
    "content": {
      "type": "object",
      "required": ["mimeType", "body"],
      "properties": {
        "mimeType": {
          "type": "string",
          "description": "Content type. Default: application/asp+json"
        },
        "body": {
          "type": "object",
          "description": "Performative-specific payload (see per-performative schemas below)"
        },
        "context": {
          "type": "array",
          "description": "Array of reference IDs providing context for this message"
        }
      }
    },
    "integrity": {
      "type": "object",
      "required": ["hash", "previousHash", "signature"],
      "properties": {
        "hash": {
          "type": "string",
          "pattern": "^sha256:",
          "description": "SHA-256 hash of the canonical content object"
        },
        "previousHash": {
          "type": "string",
          "pattern": "^sha256:",
          "description": "Hash of the previous message in the session chain"
        },
        "signature": {
          "type": "string",
          "pattern": "^ed25519:",
          "description": "Ed25519 signature of the canonical fields"
        }
      }
    },
    "constraints": {
      "type": "object",
      "properties": {
        "maxResponseTimeMs": {
          "type": "integer",
          "description": "Maximum time in milliseconds for a response"
        },
        "maxTokenBudget": {
          "type": "integer",
          "description": "Maximum LLM token budget for processing this message"
        },
        "requiredTrustScore": {
          "type": "number",
          "description": "Minimum trust score required to respond"
        },
        "allowedPerformatives": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Restrict which performatives the recipient may use in response"
        }
      }
    }
  }
}

{
  "proposalId": "prop_001",
  "type": "terms",
  "subject": "GPU compute procurement",
  "terms": {
    "gpuType": "A100",
    "quantity": 4,
    "pricePerHour": 3.50,
    "sla": { "uptimePercent": 99.9 }
  },
  "validUntil": "2026-03-07T16:00:00.000Z"
}

{
  "referenceId": "prop_001",
  "acknowledgment": "Terms accepted as proposed"
}

{
  "referenceId": "prop_001",
  "reason": "Price exceeds our budget ceiling",
  "code": "budget_exceeded",
  "retryable": true
}

{
  "referenceId": "prop_001",
  "rejectionReason": "A100 costs are higher at current demand levels",
  "counterProposalId": "prop_002",
  "subject": "Revised GPU compute terms",
  "terms": {
    "gpuType": "A100",
    "quantity": 4,
    "pricePerHour": 4.00,
    "sla": { "uptimePercent": 99.95 }
  },
  "final": true
}

{
  "informType": "progress",
  "subject": "GPU provisioning",
  "data": {
    "stage": "allocating",
    "percentComplete": 60,
    "details": "3 of 4 A100 instances allocated"
  }
}

{
  "queryId": "qry_001",
  "subject": "A100 GPU availability",
  "queryType": "availability",
  "parameters": {
    "gpuType": "A100",
    "region": "us-east-1",
    "minQuantity": 4
  }
}

{
  "referenceId": "prop_001",
  "questions": [
    {
      "field": "terms.sla",
      "question": "Does the 99.9% uptime SLA include scheduled maintenance windows?",
      "suggestedOptions": ["yes", "no", "maintenance windows excluded"]
    }
  ]
}

{
  "commitmentId": "cmt_001",
  "type": "resource-allocation",
  "subject": "4x A100 GPU compute for 24 hours",
  "terms": {
    "gpuType": "A100",
    "quantity": 4,
    "durationHours": 24,
    "pricePerHour": 3.75,
    "totalCost": 360.00
  },
  "escrow": {
    "amount": 360.00,
    "currency": "USD",
    "releaseCondition": "obligation-met"
  }
}

{
  "delegationId": "del_001",
  "targetAgent": "agent://verifyco.com/compliance/gamma",
  "scope": "Verify SOC2 Type II certification for org:acme-industries",
  "context": {
    "claimedCertifications": ["SOC2-Type-II"],
    "organization": "org:acme-industries"
  },
  "authority": "advisory",
  "protocol": "asp"
}

{
  "escalationId": "esc_001",
  "reason": "Transaction exceeds autonomous approval threshold",
  "description": "Commitment of $360.00 exceeds agent budget of $200.00",
  "urgency": "medium",
  "suggestedAction": "Approve the commitment or reduce the scope",
  "timeout": 3600
}

{
  "referenceId": "prop_001",
  "reason": "Pricing data was outdated, revised proposal follows",
  "replacementId": "prop_003"
}

{
  "observationType": "learning",
  "subject": "Negotiation strategy for CloudPrime agents",
  "data": {
    "observation": "Opens at list price, concedes ~10% on counter",
    "tags": ["negotiation-strategy", "gpu-provider"]
  },
  "confidence": 0.75,
  "visibility": "private"
}

{
  "reason": "completed",
  "summary": "4x A100 GPUs provisioned successfully within deadline",
  "outcome": {
    "commitmentsFulfilled": ["cmt_001"],
    "totalTransactionValue": 360.00,
    "peerRating": 5
  }
}