pdpp

Sandbox demo — all data is fictional and deterministic. No owner credentials, no live AS/RS, no real records.

Deployment

Reference deployment diagnostics: AS/RS metadata, retrieval state, and manifests.

Warnings (2)

Zero semantic participation

Sandbox deployment uses lexical search only; no semantic backend is configured.

Embedding backend unavailable

This is a mock reference deployment. Run the live reference server to demonstrate semantic retrieval, model caches, and real participation tuples.

Retrieval

Runtime capabilities

Bindings the provider/control-plane runtime advertises. Connectors requiring a binding the runtime does not advertise must run in a paired local collector runtime.

In container
no
Collector paired
no
Network binding
yes
Filesystem binding
no
Browser binding
no
Local-device binding
no
Accepted collector protocol versions
1
Paired collector protocol version
Paired runner version
Bundled connector versions

Lexical index

Index state
built

Semantic backend

Configured
no
Available
yes
Profile
Model
Dtype
Dimensions
Distance metric
Language bias
Model cache path
Model cached
Download allowed
Vector index kind
Index state

Participation

Every (connector, stream, field) that contributes to semantic retrieval. Derived from loaded manifests.

No participating fields

No loaded manifest declares query.search.semantic_fields. Until at least one stream participates, semantic retrieval returns empty results even if the backend and index are ready.

Manifests (3)

Manifests currently loaded by the reference server.

ConnectorNameProvenanceSemantic streams
acme_payroll_demoAcme Payroll (simulated)native0
northwind_health_demoNorthwind Health (simulated)polyfill-registered0
fabrikam_bank_demoFabrikam Bank (simulated)native0

Storage & Readiness

Database

On-disk database size is operator diagnostics. It is a different measurement from the retained payload (the JSON/blob byte length of records, history, and blobs) and is never summed with it: the physical size also includes index storage, the event log, TOAST, page bloat, and free space.

Path
(sandbox: in-memory deterministic dataset)
Vector index kind
On disk (physical)
Retained payload (logical)

On-disk size unmeasured

On-disk size is reported for Postgres backends only. This deployment is SQLite-backed or the size read was unavailable.

Diagnostics

Environment

Relevant environment variables shaping reference behavior. Secrets are redacted by the server and never reach this page.

NameValueProvenance
PDPP_REFERENCE_MODEsandboxpresent
PDPP_DB_PATHabsent
PDPP_ALLOW_MODEL_DOWNLOADabsent
Sandbox mock

Connect an AI app

Copy the MCP URL here, or open the setup page for Claude Code, Codex, ChatGPT, Claude.ai, and local agent entrypoints.

https://pdpp-smoky.vercel.app/sandbox/mcp

Sandbox URL is illustrative; it targets deterministic mock data, not owner data. The owner approves scoped access in the browser; no owner bearer token is pasted into the agent.

Capabilities matrix

Capabilities advertised by this reference implementation.

  • scoped_grant_issuanceOwner approves a request restricted to specific streams and fields.
    See grant_sb_quill_paystmt and the /sandbox/walkthrough story.
    live: ✓demo: ✓
  • grant_revocationOwner can revoke an outstanding grant; subsequent reads are refused.
    See grant_sb_ledger_txns_revoked.
    live: ✓demo: ✓
  • consent_declineOwner can decline a request without minting a grant.
    See grant_sb_sherwood_visits_denied.
    live: ✓demo: ✓
  • stream_schema_discoveryClients enumerate available streams and field schemas before requesting.
    GET /sandbox/v1/schema and /sandbox/v1/streams.
    live: ✓demo: ✓
  • lexical_searchOperator can search retained records by free-text keywords.
    GET /sandbox/v1/search.
    live: ✓demo: ✓
  • single_use_accessA grant can be marked single-use so it cannot be replayed.
    Single-use semantics are visible in walkthrough JSON; not yet enforced by sandbox API.
    live: ✓demo: —
  • token_introspectionAuthorization server exposes RFC 7662-style introspection.
    Introspection is a normative reference feature; sandbox documents it but does not stub it.
    live: ✓demo: —
  • semantic_searchVector-backed semantic search over retained records.
    Sandbox uses lexical search only; semantic backend requires a model cache.
    live: ✓demo: —

AS metadata

Live response from /sandbox/.well-known/oauth-authorization-server.

{
  "issuer": "https://pdpp-smoky.vercel.app/sandbox",
  "introspection_endpoint": "https://pdpp-smoky.vercel.app/sandbox/introspect",
  "pdpp_provider_connect_capabilities": [
    "owner_self_export",
    "cli_device_connect",
    "third_party_client_connect"
  ],
  "pushed_authorization_request_endpoint": "https://pdpp-smoky.vercel.app/sandbox/oauth/par",
  "pdpp_registration_modes_supported": [
    "pre_registered_public"
  ],
  "pdpp_authorization_details_types_supported": [
    "https://pdpp.org/data-access"
  ],
  "token_endpoint": "https://pdpp-smoky.vercel.app/sandbox/oauth/token",
  "token_endpoint_auth_methods_supported": [
    "none"
  ],
  "device_authorization_endpoint": "https://pdpp-smoky.vercel.app/sandbox/oauth/device_authorization",
  "grant_types_supported": [
    "urn:ietf:params:oauth:grant-type:device_code",
    "authorization_code",
    "refresh_token"
  ]
}

RS metadata

Live response from /sandbox/.well-known/oauth-protected-resource.

{
  "resource": "https://pdpp-smoky.vercel.app/sandbox",
  "resource_name": "Sandbox demo Resource Server",
  "authorization_servers": [
    "https://pdpp-smoky.vercel.app/sandbox"
  ],
  "bearer_methods_supported": [
    "header"
  ],
  "pdpp_provider_connect_version": "1.0.0",
  "pdpp_self_export_supported": true,
  "pdpp_token_kinds_supported": [
    "owner",
    "client"
  ],
  "pdpp_core_query_base": "https://pdpp-smoky.vercel.app/sandbox/v1",
  "pdpp_discovery_hints": {
    "schema_endpoint": "/v1/schema",
    "query_base": "/v1",
    "connectors_endpoint": "/v1/connectors",
    "streams_endpoint_template": "/v1/streams/{stream}",
    "aggregate": {
      "endpoint_template": "/v1/streams/{stream}/aggregate"
    },
    "changes_since_bootstrap": "beginning",
    "blob_indirection": "data.blob_ref.fetch_url",
    "search": {
      "endpoint": "https://pdpp-smoky.vercel.app/sandbox/v1/search",
      "scope_param": "streams[]",
      "filter_requires_single_stream": true
    },
    "owner_polyfill_requires_source_kind_connector": true
  },
  "pdpp_agent_discovery": {
    "advisory": true,
    "skill_name": "pdpp-data-access",
    "recommended_flow": "pdpp connect",
    "cli": {
      "package": "@pdpp/cli",
      "package_specifier": "@pdpp/cli",
      "bin_name": "pdpp",
      "install_command": "npx -y @pdpp/cli --help",
      "run_command": "npx -y @pdpp/cli connect https://pdpp-smoky.vercel.app/sandbox",
      "connect_command": "npx -y @pdpp/cli connect <provider-url>",
      "version_policy": "latest",
      "no_owner_token": true,
      "no_owner_token_policy": "owner_browser_approval_required"
    },
    "skill_catalog": "https://pdpp-smoky.vercel.app/.well-known/skills/index.json",
    "skill": "https://pdpp-smoky.vercel.app/.well-known/skills/pdpp-data-access/SKILL.md",
    "llms_txt": "https://pdpp-smoky.vercel.app/llms.txt",
    "llms_full_txt": "https://pdpp-smoky.vercel.app/llms-full.txt"
  },
  "capabilities": {
    "lexical_retrieval": {
      "supported": true,
      "endpoint": "https://pdpp-smoky.vercel.app/sandbox/v1/search",
      "cross_stream": true,
      "snippets": true,
      "default_limit": 25,
      "max_limit": 100,
      "score": {
        "supported": true,
        "kind": "bm25",
        "order": "lower_is_better",
        "value_semantics": "implementation_relative"
      }
    }
  }
}