Open Continuity Protocol
Download0.4 Working Draft0.4 Draft

Request → receipt → package

An example travel planner requests one accepted lodging preference for a ten-day planning task. The provider grants only the approved view and produces a recipient-bound package.

The transfer

Every object shares a correlation identifier, but each has a distinct job: request expresses intent, receipt records the bounded authorization result, and package carries the resulting data and limits.

OCP transfer and loss-accounting flowA source provider exports data into quarantine. A declared adapter maps it, creates a loss report, and packages authorized output for a destination provider.SourceexportQuarantineuntrustedAdapterdeclared mapLoss reportexplicit gapsPackageauthorized viewROUND-TRIP COMPARISON · SEMANTIC DIGESTS · EXPLICIT LOSS
The adapter never upgrades unknown meaning into accepted context; gaps remain machine-readable.

1. Request the minimum

{
  "ocp_version": "0.4",
  "schema_uri": "https://opencontinuity.org/schemas/0.4/context-request.schema.json",
  "type": "context_request",
  "id": "urn:uuid:39ef7160-7243-41e9-93cb-3a6daec9f566",
  "revision": 1,
  "created_at": "2026-08-12T15:00:00Z",
  "created_by": {
    "id": "https://travel-client.example",
    "type": "service",
    "display_name": "Example Travel Planner"
  },
  "extensions": {},
  "correlation_id": "urn:uuid:bd6ee087-a8b4-450d-9f84-aa89b8b978c0",
  "delivery_recipient": {
    "recipient": {
      "id": "https://travel-client.example",
      "type": "service",
      "display_name": "Example Travel Planner"
    },
    "client_instance": {
      "id": "urn:uuid:43af637a-fcfe-42d5-938e-0fcd55eb075f",
      "type": "device",
      "display_name": "Example Travel Planner instance"
    },
    "client_declaration_ref": {
      "id": "urn:uuid:763f4e35-b4d7-4931-9510-59d89db1a1b4",
      "revision": 1,
      "schema_uri": "https://opencontinuity.org/schemas/0.4/client-declaration.schema.json",
      "digest": "sha-256:59079539153538f2d01f8c2f45ed0bcda2ff0d9caf81ea54605428c54ada0501"
    }
  },
  "processing_recipients": [
    {
      "recipient": {
        "id": "https://model-provider.example",
        "type": "service",
        "display_name": "Example Model Provider"
      },
      "roles": [
        "model_provider"
      ],
      "purpose_codes": [
        "https://opencontinuity.org/vocab/purposes/plan-trip"
      ],
      "receives_plaintext": true
    }
  ],
  "purpose": {
    "code": "https://opencontinuity.org/vocab/purposes/plan-trip",
    "description": "Plan a ten-day trip while respecting the traveler’s accepted lodging preferences."
  },
  "selectors": [
    {
      "layer": "context",
      "space_refs": [
        {
          "id": "urn:uuid:a27fd923-d0a7-4dde-972c-46c40fe575a5",
          "revision": 1,
          "schema_uri": "https://opencontinuity.org/schemas/0.4/context-space.schema.json",
          "digest": "sha-256:6909de5bcd6a97dc15d7c906892e197ec069630ec8125b23deb00e4537446445"
        }
      ],
      "item_categories": [
        "statement"
      ],
      "predicates": [
        "https://opencontinuity.org/vocab/predicates/prefers-hotel-style"
      ],
      "sensitivity_max": "normal"
    }
  ],
  "views": {
    "context": "accepted",
    "evidence": "none",
    "artifacts": "none"
  },
  "requested_not_after": "2026-08-12T20:00:00Z",
  "retention": {
    "mode": "session",
    "legal_retention_may_apply": false
  },
  "processing_uses": {
    "task_use": "permitted",
    "model_training": "prohibited",
    "product_improvement": "prohibited",
    "advertising": "prohibited"
  },
  "offline_use": "prohibited",
  "proposal_rights": {
    "mode": "bounded",
    "operations": [
      "create",
      "revise"
    ],
    "selectors": [
      {
        "layer": "context",
        "item_categories": [
          "statement"
        ],
        "predicates": [
          "https://opencontinuity.org/vocab/predicates/prefers-hotel-style"
        ],
        "sensitivity_max": "normal"
      }
    ],
    "sensitivity_max": "normal",
    "source_attachment": "referenced_authorized"
  },
  "delegation": {
    "mode": "none"
  },
  "status": "submitted"
}
JSONComplete canonical fixture

2. Bind the approval

The receipt binds the approval to the delivery client, processing recipient, purpose, selector, views, time window, retention, and live status references.

{
  "ocp_version": "0.4",
  "schema_uri": "https://opencontinuity.org/schemas/0.4/grant-receipt.schema.json",
  "type": "grant_receipt",
  "id": "urn:uuid:d7681bd6-5807-4e3c-bfd8-33c4f0799bfd",
  "revision": 1,
  "created_at": "2026-08-12T15:02:00Z",
  "created_by": {
    "id": "https://context-provider.example",
    "type": "service",
    "display_name": "Example Context Provider"
  },
  "extensions": {},
  "correlation_id": "urn:uuid:bd6ee087-a8b4-450d-9f84-aa89b8b978c0",
  "request_ref": {
    "id": "urn:uuid:39ef7160-7243-41e9-93cb-3a6daec9f566",
    "revision": 1,
    "schema_uri": "https://opencontinuity.org/schemas/0.4/context-request.schema.json",
    "digest": "sha-256:6f79ce11f397b728fb2bfe2f24e64912e021b0c24c0c436c6ae1ca7d9b31cb8e"
  },
  "request_status_ref": {
    "uri": "https://context-provider.example/ocp/v0.4/context-requests/39ef7160-7243-41e9-93cb-3a6daec9f566/status",
    "last_checked_at": "2026-08-12T15:02:00Z"
  },
  "authorization_ref": {
    "uri": "https://authorization.example/decisions/604f4b86-f565-48f6-a662-b4735aad6c84",
    "last_checked_at": "2026-08-12T15:02:00Z"
  },
  "authorization_system": "oauth",
  "authorizer": {
    "id": "urn:uuid:7a4ea2e0-94c2-4e8e-b83b-785f0ad78ca9",
    "type": "person",
    "display_name": "Avery Chen"
  },
  "authority_basis": {
    "type": "self",
    "scope_note": "Self-authorization for personal travel context."
  },
  "purpose": {
    "code": "https://opencontinuity.org/vocab/purposes/plan-trip",
    "description": "Plan a ten-day trip while respecting the traveler’s accepted lodging preferences."
  },
  "approved_selectors": [
    {
      "layer": "context",
      "space_refs": [
        {
          "id": "urn:uuid:a27fd923-d0a7-4dde-972c-46c40fe575a5",
          "revision": 1,
          "schema_uri": "https://opencontinuity.org/schemas/0.4/context-space.schema.json",
          "digest": "sha-256:6909de5bcd6a97dc15d7c906892e197ec069630ec8125b23deb00e4537446445"
        }
      ],
      "item_categories": [
        "statement"
      ],
      "predicates": [
        "https://opencontinuity.org/vocab/predicates/prefers-hotel-style"
      ],
      "sensitivity_max": "normal"
    }
  ],
  "approved_views": {
    "context": "accepted",
    "evidence": "none",
    "artifacts": "none"
  },
  "delivery_recipient": {
    "recipient": {
      "id": "https://travel-client.example",
      "type": "service",
      "display_name": "Example Travel Planner"
    },
    "client_instance": {
      "id": "urn:uuid:43af637a-fcfe-42d5-938e-0fcd55eb075f",
      "type": "device",
      "display_name": "Example Travel Planner instance"
    },
    "client_declaration_ref": {
      "id": "urn:uuid:763f4e35-b4d7-4931-9510-59d89db1a1b4",
      "revision": 1,
      "schema_uri": "https://opencontinuity.org/schemas/0.4/client-declaration.schema.json",
      "digest": "sha-256:59079539153538f2d01f8c2f45ed0bcda2ff0d9caf81ea54605428c54ada0501"
    }
  },
  "processing_recipients": [
    {
      "recipient": {
        "id": "https://model-provider.example",
        "type": "service",
        "display_name": "Example Model Provider"
      },
      "roles": [
        "model_provider"
      ],
      "purpose_codes": [
        "https://opencontinuity.org/vocab/purposes/plan-trip"
      ],
      "receives_plaintext": true
    }
  ],
  "not_before": "2026-08-12T15:02:00Z",
  "expires_at": "2026-08-12T20:00:00Z",
  "retention": {
    "mode": "session",
    "legal_retention_may_apply": false
  },
  "processing_uses": {
    "task_use": "permitted",
    "model_training": "prohibited",
    "product_improvement": "prohibited",
    "advertising": "prohibited"
  },
  "offline_use": "prohibited",
  "proposal_rights": {
    "mode": "bounded",
    "operations": [
      "create",
      "revise"
    ],
    "selectors": [
      {
        "layer": "context",
        "item_categories": [
          "statement"
        ],
        "predicates": [
          "https://opencontinuity.org/vocab/predicates/prefers-hotel-style"
        ],
        "sensitivity_max": "normal"
      }
    ],
    "sensitivity_max": "normal",
    "source_attachment": "referenced_authorized"
  },
  "delegation": {
    "mode": "none"
  },
  "status": "active",
  "status_ref": {
    "uri": "https://context-provider.example/ocp/v0.4/grant-receipts/d7681bd6-5807-4e3c-bfd8-33c4f0799bfd/status",
    "last_checked_at": "2026-08-12T15:02:00Z"
  }
}
JSONComplete canonical fixture

3. Deliver and contain

The package carries one accepted entry, explicitly records the omitted evidence layer, limits retention and processing, and declares external_action_authority as none.

{
  "ocp_version": "0.4",
  "schema_uri": "https://opencontinuity.org/schemas/0.4/context-package.schema.json",
  "type": "context_package",
  "id": "urn:uuid:82b2f316-2adc-4181-b676-c8431fceb32c",
  "revision": 1,
  "created_at": "2026-08-12T15:05:00Z",
  "created_by": {
    "id": "https://context-provider.example",
    "type": "service",
    "display_name": "Example Context Provider"
  },
  "extensions": {},
  "correlation_id": "urn:uuid:bd6ee087-a8b4-450d-9f84-aa89b8b978c0",
  "grant_receipt_ref": {
    "id": "urn:uuid:d7681bd6-5807-4e3c-bfd8-33c4f0799bfd",
    "revision": 1,
    "schema_uri": "https://opencontinuity.org/schemas/0.4/grant-receipt.schema.json",
    "digest": "sha-256:4657179eadb7ccb43cbef2c4fa1f990cac8443d995ae775fa7fa00de7f66ad47"
  },
  "grant_status_ref": {
    "uri": "https://context-provider.example/ocp/v0.4/grant-receipts/d7681bd6-5807-4e3c-bfd8-33c4f0799bfd/status",
    "last_checked_at": "2026-08-12T15:05:00Z"
  },
  "purpose": {
    "code": "https://opencontinuity.org/vocab/purposes/plan-trip",
    "description": "Plan a ten-day trip while respecting the traveler’s accepted lodging preferences."
  },
  "delivery_recipient": {
    "recipient": {
      "id": "https://travel-client.example",
      "type": "service",
      "display_name": "Example Travel Planner"
    },
    "client_instance": {
      "id": "urn:uuid:43af637a-fcfe-42d5-938e-0fcd55eb075f",
      "type": "device",
      "display_name": "Example Travel Planner instance"
    },
    "client_declaration_ref": {
      "id": "urn:uuid:763f4e35-b4d7-4931-9510-59d89db1a1b4",
      "revision": 1,
      "schema_uri": "https://opencontinuity.org/schemas/0.4/client-declaration.schema.json",
      "digest": "sha-256:59079539153538f2d01f8c2f45ed0bcda2ff0d9caf81ea54605428c54ada0501"
    }
  },
  "processing_recipients": [
    {
      "recipient": {
        "id": "https://model-provider.example",
        "type": "service",
        "display_name": "Example Model Provider"
      },
      "roles": [
        "model_provider"
      ],
      "purpose_codes": [
        "https://opencontinuity.org/vocab/purposes/plan-trip"
      ],
      "receives_plaintext": true
    }
  ],
  "issued_at": "2026-08-12T15:05:00Z",
  "expires_at": "2026-08-12T20:00:00Z",
  "subject_aliases": [
    {
      "package_subject_ref": "urn:uuid:42a6ad3c-b34c-4d35-9b43-8cf72e989735",
      "delivery_alias": "urn:uuid:6d812d74-140b-4fb4-92ed-e29c89677854"
    }
  ],
  "reference_aliases": [
    {
      "package_ref": "urn:uuid:fd1d94b4-d14a-4920-983a-3b501238a6c5",
      "kind": "space"
    },
    {
      "package_ref": "urn:uuid:ad2be2ce-827b-45a6-8c21-1f788cb5bef1",
      "kind": "decision"
    },
    {
      "package_ref": "urn:uuid:cdc815e6-7e51-47d1-95bf-01be8e18a320",
      "kind": "source"
    },
    {
      "package_ref": "urn:uuid:f1d80f51-dfa1-4c7c-af44-b6296572ff07",
      "kind": "artifact"
    }
  ],
  "entries": [
    {
      "entry_id": "urn:uuid:4f7ba4ce-aee1-49a3-a705-14f29d98a501",
      "layer": "context",
      "disclosure": "accepted",
      "media_type": "application/ocp+json",
      "content_schema_uri": "https://opencontinuity.org/schemas/0.4/context-package.schema.json#/$defs/packageContextContent",
      "digest": "sha-256:af9c0f49046b829c5db808ca9020ceab46d452bc80d825f774fd64a60f43f3cb",
      "package_item_ref": "urn:uuid:9b0d728f-8b6e-4aa5-ae3b-2a3b46e3d0f2",
      "content": {
        "subject_refs": [
          "urn:uuid:42a6ad3c-b34c-4d35-9b43-8cf72e989735"
        ],
        "space_ref": "urn:uuid:fd1d94b4-d14a-4920-983a-3b501238a6c5",
        "category": "statement",
        "statement": {
          "predicate": "https://opencontinuity.org/vocab/predicates/prefers-hotel-style",
          "object": {
            "type": "string",
            "value": "boutique",
            "language": "en"
          }
        },
        "epistemic_basis": "subject_confirmed",
        "review_status": "accepted",
        "decision_ref": "urn:uuid:ad2be2ce-827b-45a6-8c21-1f788cb5bef1",
        "provenance_refs": [
          "urn:uuid:cdc815e6-7e51-47d1-95bf-01be8e18a320"
        ],
        "sensitivity": "normal",
        "instruction_treatment": "untrusted_data"
      },
      "instruction_treatment": "untrusted_data"
    }
  ],
  "renderings": [
    {
      "media_type": "text/plain",
      "language": "en",
      "derived_from_entries": [
        "urn:uuid:4f7ba4ce-aee1-49a3-a705-14f29d98a501"
      ],
      "content_ref": "urn:uuid:f1d80f51-dfa1-4c7c-af44-b6296572ff07",
      "digest": "sha-256:8d077f2c6db228c41aee3cfd52fc47f720c37e9f770fbd38a3a46a0bf4b622ee",
      "instruction_treatment": "untrusted_data"
    }
  ],
  "omissions": [
    {
      "selector": {
        "layer": "evidence",
        "space_refs": [
          "urn:uuid:fd1d94b4-d14a-4920-983a-3b501238a6c5"
        ]
      },
      "reason": "not_granted"
    }
  ],
  "warnings": [],
  "retention": {
    "mode": "session",
    "legal_retention_may_apply": false
  },
  "processing_uses": {
    "task_use": "permitted",
    "model_training": "prohibited",
    "product_improvement": "prohibited",
    "advertising": "prohibited"
  },
  "offline_use": "prohibited",
  "proposal_rights": {
    "mode": "bounded",
    "operations": [
      "create",
      "revise"
    ],
    "selectors": [
      {
        "layer": "context",
        "item_categories": [
          "statement"
        ],
        "predicates": [
          "https://opencontinuity.org/vocab/predicates/prefers-hotel-style"
        ],
        "sensitivity_max": "normal",
        "space_refs": [
          "urn:uuid:fd1d94b4-d14a-4920-983a-3b501238a6c5"
        ]
      }
    ],
    "sensitivity_max": "normal",
    "source_attachment": "referenced_authorized"
  },
  "delegation": {
    "mode": "none"
  },
  "external_action_authority": "none",
  "integrity": {
    "digest": "sha-256:09cbcb90f08b8e29d5e938b9a6234e3061eecb3d8854fd98a2949c91934a6f2d",
    "canonicalization": "RFC8785"
  }
}
JSONComplete canonical fixture

Consumer checklist

  • Resolve and validate every canonical schema URI.
  • Verify reference revisions and digests.
  • Check live request and grant status where required.
  • Enforce recipient, purpose, expiry, use, retention, and offline limits.
  • Treat content and renderings as untrusted data.
  • Preserve omissions and warnings in user-facing behavior.

Search Open Continuity