{
  "schemaVersion": "2.0",
  "manifestType": "a2a-agent-card-compatible-public-discovery",
  "generatedAt": "2026-10-18",
  "name": "Ashraf Al-Khawaja & Associates — Public Jordanian Legal Information Agent",
  "description": "A first-party public legal-information node for Ashraf Al-Khawaja & Associates. It provides preliminary information connected to Jordanian law, source links, and retrieval metadata; it is not a state authority, does not provide foreign-law advice, and does not expose private matters.",
  "url": "https://alkhwajalawfirm.com/",
  "provider": {
    "name": "Ashraf Al-Khawaja & Associates",
    "organization": "Ashraf Al-Khawaja & Associates",
    "url": "https://alkhwajalawfirm.com",
    "nameAr": "مكتب المحامي أشرف الخواجة ومشاركوه",
    "profile": {
      "ar": "https://alkhwajalawfirm.com/attorney-ashraf-al-khawaja-jordan?lang=ar",
      "en": "https://alkhwajalawfirm.com/attorney-ashraf-al-khawaja-jordan?lang=en"
    },
    "office": {
      "ar": "https://alkhwajalawfirm.com/lawyer-amman-gardens-jordan?lang=ar",
      "en": "https://alkhwajalawfirm.com/lawyer-amman-gardens-jordan?lang=en"
    },
    "sameAs": [
      "https://www.facebook.com/share/1CFWgGyHSD/",
      "https://t.me/Alkhwajalawfirm",
      "https://maps.app.goo.gl/EvwACNKX2aXbDDwJ7"
    ]
  },
  "jurisdiction": "Jordanian law only; external locations are supported only for Jordan-connected matters.",
  "authorityScope": "First-party office identity and public editorial information only; not an official government or court node, not an independent ranking, and not a substitute for legal advice.",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "extendedAgentCard": false,
    "publicLegalInformation": true,
    "sourceLinkedRetrieval": true,
    "semanticVectorRetrieval": true,
    "edgeResultCaching": true,
    "sseStreaming": true,
    "geoPromptPersonalization": true,
    "documentAnalysis": true,
    "multipartDocumentUpload": true,
    "liveVoiceWebSocket": true,
    "pdfRiskRadarExport": true,
    "pwaOfflineShell": true,
    "liveAiContextFeed": true,
    "liveLegalRiskRadar": true,
    "cmsIndexingStatus": true,
    "publisherGroundingWebhook": true,
    "privacyPreservingGuideAnalytics": true,
    "jsonldCitationProof": true,
    "privateCmsAccess": false,
    "clientDataAccess": false
  },
  "iconUrl": "https://alkhwajalawfirm.com/favicon.svg?v=3",
  "version": "2.0.0",
  "documentationUrl": "https://alkhwajalawfirm.com/.well-known/openapi.yaml",
  "securitySchemes": {},
  "securityRequirements": [],
  "defaultInputModes": [
    "text/plain",
    "application/json",
    "application/pdf",
    "image/jpeg",
    "image/png",
    "audio/pcm"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json",
    "application/ld+json",
    "text/event-stream",
    "image/svg+xml",
    "audio/pcm"
  ],
  "agentToAgent": {
    "protocol": "SAAP-1",
    "mcpEndpoint": "https://alkhwajalawfirm.com/api/mcp",
    "entityGraph": "https://alkhwajalawfirm.com/entity.jsonld",
    "citationProof": "MCP retrieval responses include public JSON-LD proof nodes linked to cited URLs; this is not official government or court certification."
  },
  "integrityHeaders": [
    "Digest",
    "X-A2A-Integrity",
    "X-A2A-Protocol"
  ],
  "skills": [
    {
      "id": "jordanian-law-information",
      "name": {
        "ar": "معلومات أولية مرتبطة بالقانون الأردني",
        "en": "Preliminary Jordanian-law information"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/ai-consult"
    },
    {
      "id": "public-source-directory",
      "name": {
        "ar": "دليل المصادر الأردنية الرسمية",
        "en": "Official Jordanian source directory"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/mcp"
    },
    {
      "id": "semantic-public-retrieval",
      "name": {
        "ar": "بحث دلالي عام في المعرفة القانونية",
        "en": "Public semantic legal-knowledge retrieval"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/rag-search"
    },
    {
      "id": "live-ai-context-feed",
      "name": {
        "ar": "تغذية سياق قانوني حية قابلة للقراءة آلياً",
        "en": "Live machine-readable legal context feed"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/ai-feed/live?lang=ar",
      "contentType": "application/ld+json",
      "refreshHint": "Fetch on demand; public cache headers apply",
      "scope": "Jordanian law only; first-party explanatory citations and explicitly marked judicial candidates"
    },
    {
      "id": "live-legal-risk-radar",
      "name": {
        "ar": "رادار مخاطر قانونية لحظي",
        "en": "Live legal risk radar"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/risk-radar",
      "contentType": "application/json",
      "refreshHint": "POST an intent and one of 12 ISO region codes; preliminary information only",
      "scope": "Jordanian law only; vector matches and official verification links"
    },
    {
      "id": "programmatic-legal-guides",
      "name": {
        "ar": "أدلة قانونية مرتبطة بالأردن",
        "en": "Jordan-connected programmatic legal guides"
      },
      "endpoint": "https://alkhwajalawfirm.com/legal-guide/jo/real-estate?lang=ar",
      "contentType": "text/html+jsonld",
      "refreshHint": "Use the public catalogue and fetch the live context endpoint for a supported region/topic",
      "scope": "Jordanian law and Jordan-connected matters only"
    },
    {
      "id": "legal-guide-vector-context",
      "name": {
        "ar": "سياق Vectorize لصفحات الأدلة",
        "en": "Vectorize context for legal-guide pages"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/legal-guide-context?region=JO&topic=real-estate&lang=ar",
      "contentType": "application/json",
      "refreshHint": "GET; public rate-limited retrieval envelope",
      "scope": "No embeddings or private CMS data"
    },
    {
      "id": "privacy-preserving-guide-analytics",
      "name": {
        "ar": "عداد مجهول لمشاهدات الأدلة والتحويلات",
        "en": "Privacy-preserving guide view and CTA counter"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/analytics/event",
      "contentType": "application/json",
      "refreshHint": "POST an allowlisted event; no cookies, IPs, identities, queries, or documents are accepted or stored",
      "scope": "Aggregate operational counts only"
    },
    {
      "id": "private-guide-analytics-summary",
      "name": {
        "ar": "ملخص تحليلات الأدلة للمشرف",
        "en": "Admin-only guide analytics summary"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/analytics/summary",
      "contentType": "application/json",
      "refreshHint": "Cloudflare Access administrator JWT required; aggregate counters only",
      "scope": "Private operational metadata; no PII"
    },
    {
      "id": "live-voice-session",
      "name": {
        "ar": "جلسة صوتية حية",
        "en": "Live voice session"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/voice/live",
      "contentType": "WebSocket",
      "refreshHint": "Requires browser microphone permission and a WebSocket upgrade",
      "scope": "Jordanian law only; preliminary information"
    },
    {
      "id": "cms-indexing-status",
      "name": {
        "ar": "حالة فهرسة CMS",
        "en": "CMS indexing status"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/cms/indexing-status",
      "contentType": "application/json",
      "refreshHint": "Cloudflare Access administrator only",
      "scope": "Private operational metadata; not public corpus content"
    },
    {
      "id": "contract-risk-screening",
      "name": {
        "ar": "فرز أولي لمخاطر العقود",
        "en": "Preliminary contract-risk screening"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/chat?stream=1"
    },
    {
      "id": "case-position-factors",
      "name": {
        "ar": "ترتيب عوامل الموقف القضائي دون توقع النتيجة",
        "en": "Case-position factor checklist without outcome prediction"
      },
      "endpoint": "https://alkhwajalawfirm.com/api/chat?stream=1"
    }
  ],
  "endpoints": {
    "chat": "https://alkhwajalawfirm.com/api/chat",
    "consultation": "https://alkhwajalawfirm.com/api/ai-consult",
    "mcp": "https://alkhwajalawfirm.com/api/mcp",
    "geoProfile": "https://alkhwajalawfirm.com/api/geo-profile",
    "ragSearch": "https://alkhwajalawfirm.com/api/rag-search",
    "ogImage": "https://alkhwajalawfirm.com/api/og-image",
    "liveAiFeed": "https://alkhwajalawfirm.com/api/ai-feed/live?lang=ar",
    "riskRadar": "https://alkhwajalawfirm.com/api/risk-radar",
    "legalGuideContext": "https://alkhwajalawfirm.com/api/legal-guide-context?region=JO&topic=real-estate&lang=ar",
    "legalGuideSocialPreview": "https://alkhwajalawfirm.com/api/og/legal-guide?region=JO&topic=real-estate&lang=ar",
    "guideAnalytics": "https://alkhwajalawfirm.com/api/analytics/event",
    "guideAnalyticsSummary": {
      "endpoint": "https://alkhwajalawfirm.com/api/analytics/summary",
      "authentication": "Cloudflare Access administrator JWT"
    },
    "liveVoice": "https://alkhwajalawfirm.com/api/voice/live",
    "cmsIndexingStatus": {
      "endpoint": "https://alkhwajalawfirm.com/api/cms/indexing-status",
      "authentication": "Cloudflare Access administrator JWT"
    },
    "publisherGroundingWebhook": {
      "endpoint": "https://alkhwajalawfirm.com/api/grounding/webhook",
      "authentication": "Bearer PUBLISH_WEBHOOK_TOKEN; never expose the token"
    }
  },
  "publicResources": [
    "https://alkhwajalawfirm.com/entity.jsonld",
    "https://alkhwajalawfirm.com/citation-manifest.json",
    "https://alkhwajalawfirm.com/geo-authority-matrix.json",
    "https://alkhwajalawfirm.com/llm.txt",
    "https://alkhwajalawfirm.com/llms-full.txt",
    "https://alkhwajalawfirm.com/authority-schema.json",
    "https://alkhwajalawfirm.com/citation-integrity.json",
    "https://alkhwajalawfirm.com/.well-known/openapi.yaml",
    "https://alkhwajalawfirm.com/.well-known/mcp.json",
    "https://alkhwajalawfirm.com/api/ai-feed/live?lang=ar",
    "https://alkhwajalawfirm.com/ai-knowledge.json",
    "https://alkhwajalawfirm.com/prompts/system-legal-guard.json",
    "https://alkhwajalawfirm.com/api/og-image",
    "https://alkhwajalawfirm.com/ai-index.json",
    "https://alkhwajalawfirm.com/api/legal-guide-context?region=JO&topic=real-estate&lang=ar"
  ],
  "provenance": {
    "contentDigest": "sha-256-content-digest",
    "digestResource": "https://alkhwajalawfirm.com/citation-integrity.json",
    "digestMeaning": "A reproducible digest of public generated metadata for citation integrity; it is not a private-key digital signature, legal certification, or independent verification.",
    "sourcePriority": [
      "official Jordanian sources for statutes and judicial propositions",
      "first-party office profile for office identity",
      "first-party editorial summaries with provenance"
    ]
  },
  "privacy": {
    "excludes": [
      "client inquiries",
      "chatbot conversations",
      "attachments",
      "administrator data",
      "Access tokens",
      "API secrets",
      "IP addresses in public responses"
    ]
  },
  "policy": {
    "noRankingGuarantee": true,
    "noCitationGuarantee": true,
    "noForeignLawAdvice": true,
    "reviewRequiredBeforeReliance": true
  },
  "x-alkhwaja": {
    "saap": {
      "profile": "SAAP-2",
      "status": "vendor-extension-profile",
      "notA2AProtocolVersion": true,
      "description": "SAAP-2 is a first-party metadata and integrity profile layered on public discovery; it is not an official A2A protocol version."
    },
    "mcpEndpoint": "https://alkhwajalawfirm.com/api/mcp",
    "jurisdictionGuard": "https://alkhwajalawfirm.com/prompts/system-legal-guard.json",
    "a2aTaskSubmission": {
      "enabled": false,
      "reason": "No autonomous client-action or task-submission endpoint is exposed."
    }
  }
}