{
  "schema_version": "1.0",
  "name": "PiQrypt Ambassador",
  "description": "Cryptographically-signed AI agent for PiQrypt — the trust layer for autonomous AI agents. Every response is Ed25519-signed and AISS hash-chained. Verified offline.",
  "url": "https://trust-server-ucjb.onrender.com",
  "provider": {
    "organization": "PiQrypt",
    "url": "https://piqrypt.com",
    "contact": "contact@piqrypt.com"
  },
  "version": "1.8.6",
  "protocol": "AISS-1.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": true,
    "cryptographicProof": true,
    "multiTurn": true,
    "a2aHandshake": true
  },
  "authentication": {
    "schemes": ["none"],
    "note": "Public endpoint — no authentication required for /api/ambassador/interact and /api/ambassador/chat"
  },
  "skills": [
    {
      "id": "piqrypt-technical-guidance",
      "name": "PiQrypt Technical Guidance",
      "description": "Answers technical questions about PiQrypt, AISS protocol, cryptographic stamping, hash chains, framework bridges, and agent identity.",
      "tags": ["piqrypt", "aiss", "cryptography", "ai-agents", "trust", "audit"],
      "examples": [
        "How do I integrate PiQrypt with LangChain?",
        "What is the difference between AISS-1 and AISS-2?",
        "How does the hash chain work?",
        "Show me the code to stamp an event"
      ]
    },
    {
      "id": "a2a-interaction",
      "name": "A2A Agent Interaction",
      "description": "Accepts A2A interactions from external agents. Every response is cryptographically signed with Ed25519 and chain-linked to previous interactions.",
      "tags": ["a2a", "multi-agent", "signed-response", "audit-trail"],
      "examples": [
        "Can PiQrypt audit my CrewAI pipeline?",
        "How do I establish A2A trust with your agent?",
        "What is the event_hash in your response?"
      ]
    }
  ],
  "endpoints": {
    "interact": {
      "url": "https://trust-server-ucjb.onrender.com/api/ambassador/interact",
      "method": "POST",
      "contentType": "application/json",
      "requestSchema": {
        "type": "object",
        "required": ["from_agent", "platform", "message"],
        "properties": {
          "from_agent": {"type": "string", "description": "Your agent's unique identifier"},
          "platform": {"type": "string", "description": "Your platform name (e.g. 'langchain', 'crewai', 'autogen')"},
          "message": {"type": "string", "maxLength": 4096}
        }
      },
      "responseSchema": {
        "type": "object",
        "properties": {
          "response": {"type": "string"},
          "event_hash": {"type": "string", "description": "Ed25519 AISS chain hash — 64 hex chars"},
          "signed_by": {"type": "string", "description": "Ambassador agent_id"},
          "verified": {"type": "boolean", "description": "True when AISS stamp succeeded"}
        }
      }
    },
    "chat": {
      "url": "https://trust-server-ucjb.onrender.com/api/ambassador/chat",
      "method": "POST",
      "contentType": "application/json",
      "requestSchema": {
        "type": "object",
        "required": ["session_id", "message"],
        "properties": {
          "session_id": {"type": "string", "description": "Stable session identifier for multi-turn memory"},
          "message": {"type": "string", "maxLength": 4096},
          "context": {"type": "string", "maxLength": 512, "description": "Optional extra context"}
        }
      }
    }
  },
  "trustSignals": {
    "protocol": "AISS-1.0",
    "signing": "Ed25519 (RFC 8032)",
    "hashing": "SHA-256 (NIST FIPS 180-4)",
    "canonicalization": "RFC 8785",
    "ip_protection": "INPI e-Soleau DSO2026006483 + DSO2026009143",
    "chain_verifiable": true,
    "auditEndpoint": "https://trust-server-ucjb.onrender.com/admin/ambassador/audit-chain"
  },
  "links": {
    "github": "https://github.com/piqrypt/piqrypt",
    "pypi": "https://pypi.org/project/piqrypt/",
    "protocol_spec": "https://github.com/piqrypt/piqrypt/blob/main/docs/RFC_AISS_v2.0.md",
    "a2a_guide": "https://github.com/piqrypt/piqrypt/blob/main/docs/A2A_SESSION_GUIDE.md",
    "integration": "https://github.com/piqrypt/piqrypt/blob/main/INTEGRATION.md",
    "skills": "https://trust-server-ucjb.onrender.com/.well-known/skills.md"
  }
}
