Examples¶
All examples in this section are valid instances of their declared schemas. Every example here is validated in CI via the conformance suite.
A basic profile¶
{
"ppx_version": "0.1",
"profile_id": "ppx:profile:7f4f7c87-9d98-4c9b-b8a0-0d86b1a8d502",
"subject_id": "did:example:user-123",
"provider_id": "ppx:provider:blazing-customs",
"created_at": "2026-04-06T18:05:00Z",
"updated_at": "2026-04-20T09:14:00Z",
"default_policy": {
"cross_domain_transfer": "deny",
"inference_writeback": "review_required",
"retention_days": 365
},
"claims": [
{
"claim_id": "ppx:claim:c-001",
"type": "preference",
"namespace": "core",
"key": "novelty_tolerance",
"value": 0.62,
"value_type": "float",
"units": "normalized_0_1",
"polarity": "positive",
"confidence": 0.78,
"stability": "medium",
"source": {
"kind": "inferred",
"origin": "onboarding_quiz_v1",
"evidence_refs": ["ppx:evidence:quiz:12", "ppx:evidence:behavior:93"]
},
"explanation": {
"summary": "User tends to prefer moderate novelty over highly familiar or highly disruptive options."
},
"applicability": { "domains": ["fragrance", "travel", "media"], "contexts": ["default"] },
"lifecycle": {
"last_confirmed_at": "2026-03-20T15:00:00Z",
"expires_at": "2026-09-20T15:00:00Z",
"decay_policy": "linear"
},
"review": {
"user_visible": true,
"user_editable": true,
"review_status": "pending_confirmation"
}
},
{
"claim_id": "ppx:claim:c-002",
"type": "preference",
"namespace": "core",
"key": "social_energy_preference",
"value": 0.48,
"value_type": "float",
"units": "normalized_0_1",
"confidence": 0.66,
"stability": "medium",
"source": { "kind": "user_stated", "origin": "onboarding_quiz_v1" },
"review": { "user_visible": true, "user_editable": true, "review_status": "confirmed" }
},
{
"claim_id": "ppx:claim:c-003",
"type": "preference",
"namespace": "fragrance",
"key": "family_preference",
"value": { "woody": 0.82, "citrus": 0.64, "oriental": 0.28, "aquatic": 0.55, "gourmand": 0.18 },
"value_type": "map<string,float>",
"confidence": 0.71,
"stability": "medium",
"source": { "kind": "observed", "origin": "sample_rating_session" },
"applicability": { "domains": ["fragrance"], "contexts": ["default"] },
"review": { "user_visible": true, "user_editable": true, "review_status": "confirmed" }
},
{
"claim_id": "ppx:claim:c-004",
"type": "aversion",
"namespace": "fragrance",
"key": "sweetness_preference",
"value": 0.18,
"value_type": "float",
"units": "normalized_0_1",
"polarity": "negative",
"confidence": 0.74,
"stability": "high",
"source": { "kind": "user_stated", "origin": "onboarding_quiz_v1" },
"review": { "user_visible": true, "user_editable": true, "review_status": "confirmed" }
}
],
"context_modifiers": [
{
"modifier_id": "ppx:modifier:014",
"namespace": "core",
"key": "climate_heat_humidity_bias",
"effect_type": "weight_adjustment",
"targets": ["fragrance.projection_tolerance", "fragrance.freshness_preference"],
"condition": { "climate": "hot_humid" },
"effect": {
"increase": ["freshness_preference"],
"decrease": ["projection_tolerance"]
},
"confidence": 0.81,
"source": { "kind": "observed", "origin": "seasonal_behavior_log" }
}
],
"consent_grants": [],
"extensions": [
{ "namespace": "core", "version": "0.1" },
{ "namespace": "fragrance", "version": "0.1" }
]
}
A fragrance grant¶
Domain-scoped, 30-day, read + propose_update.
{
"grant_id": "ppx:grant:g-001",
"subject_id": "did:example:user-123",
"grantee_id": "did:example:agent:fragrance-app",
"status": "active",
"granted_at": "2026-04-06T18:10:00Z",
"expires_at": "2026-05-06T18:10:00Z",
"purposes": ["recommendation", "ranking", "explanation", "propose_update"],
"allowed_domains": ["fragrance"],
"allowed_namespaces": ["core", "fragrance"],
"allowed_claim_keys": [
"novelty_tolerance",
"sensory_intensity_preference",
"fragrance.family_preference",
"fragrance.intensity_preference",
"fragrance.projection_tolerance",
"fragrance.sweetness_preference",
"fragrance.freshness_preference",
"fragrance.occasion_bias"
],
"allowed_operations": ["read", "propose_update"],
"cross_domain_transfer": "deny",
"writeback_policy": "review_required",
"redisclosure": "forbidden",
"audit": { "log_access": true, "notify_on_writeback": true }
}
A travel grant with cross-domain review¶
Core-only, 7-day, read-only, allow_with_review cross-domain. This is the
canonical cross-domain consent pattern.
{
"grant_id": "ppx:grant:g-002",
"subject_id": "did:example:user-123",
"grantee_id": "did:example:agent:travelly",
"status": "active",
"granted_at": "2026-04-20T10:00:00Z",
"expires_at": "2026-04-27T10:00:00Z",
"purposes": ["recommendation", "explanation"],
"allowed_domains": ["travel"],
"allowed_namespaces": ["core"],
"allowed_claim_keys": [
"novelty_tolerance",
"social_energy_preference",
"sensory_intensity_preference",
"ambiguity_tolerance"
],
"allowed_operations": ["read"],
"cross_domain_transfer": "allow_with_review",
"writeback_policy": "forbidden",
"redisclosure": "forbidden",
"audit": { "log_access": true, "notify_on_writeback": false }
}
A derived compatibility view¶
{
"view_id": "ppx:view:match-991",
"view_kind": "compatibility",
"subject_id": "did:example:user-123",
"grantee_id": "did:example:agent:dating-compat",
"created_at": "2026-04-22T20:15:00Z",
"expires_at": "2026-04-22T21:15:00Z",
"signals": {
"social_energy_alignment": 0.82,
"novelty_alignment": 0.69,
"communication_alignment": 0.87,
"spontaneity_alignment": 0.41
},
"warnings": [
"Potential mismatch in spontaneity tolerance."
],
"explanations": [
"Both profiles indicate preference for depth over breadth in conversation.",
"One profile prefers more structured planning than the other."
],
"basis": [
"core.social_energy_preference",
"core.novelty_tolerance",
"core.conversation_depth_preference",
"core.ambiguity_tolerance"
]
}
Note: the derived view exposes signals and explanations, not raw claim values.
A discovery card¶
{
"ppx_version": "0.1",
"provider_id": "ppx:provider:blazing-customs",
"name": "Blazing Customs PPX Reference Provider",
"base_url": "https://profiles.example.com",
"capabilities": {
"profile_read": true,
"claim_query": true,
"consent_management": true,
"propose_update": true,
"export": true,
"delete": true,
"audit_log": true
},
"supported_namespaces": ["core", "fragrance", "travel"],
"supported_purposes": [
"recommendation",
"ranking",
"matching",
"explanation",
"propose_update"
],
"default_policies": {
"cross_domain_transfer": "deny",
"writeback_policy": "review_required"
},
"auth": {
"schemes": ["oauth2.1", "openid_connect"],
"authorization_endpoint": "https://profiles.example.com/oauth/authorize",
"token_endpoint": "https://profiles.example.com/oauth/token"
},
"signing": { "profile_signatures": false, "grant_signatures": false },
"transport_bindings": {
"mcp": {
"supported": true,
"server_uri": "https://profiles.example.com/mcp"
},
"a2a": {
"supported": true,
"agent_card_uri": "https://profiles.example.com/.well-known/agent-card.json"
},
"http_api": {
"supported": true,
"openapi_uri": "https://profiles.example.com/openapi.json"
}
},
"ui": { "ag_ui_supported": true, "a2ui_supported": true }
}
A climate context modifier¶
{
"modifier_id": "ppx:modifier:014",
"namespace": "core",
"key": "climate_heat_humidity_bias",
"effect_type": "weight_adjustment",
"targets": [
"fragrance.projection_tolerance",
"fragrance.freshness_preference"
],
"condition": { "climate": "hot_humid" },
"effect": {
"increase": ["freshness_preference"],
"decrease": ["projection_tolerance", "sweetness_preference"]
},
"confidence": 0.81,
"source": {
"kind": "observed",
"origin": "seasonal_behavior_log"
}
}