{
  "schema": "davisville-agent-analytics.agent-interface.v1",
  "generated_for": "upstream_ai_agents",
  "product": {
    "id": "ai-agent-analytics",
    "name": "AI Agent Analytics",
    "publisher": "Davisville Labs LLC",
    "publisher_id": "davisville-labs",
    "publisher_url": "https://davisvillelabs.com/",
    "publisher_manifest": "https://davisvillelabs.com/.well-known/davisville-labs.json",
    "canonical_url": "https://analytics.davisvillelabs.com/",
    "purpose": "Summarize the previous 24 hours of AI-agent-facing product activity in one bounded Daily Pulse, including trustworthy zero-state context and settled revenue.",
    "category": "machine_customer_analytics",
    "status": "production"
  },
  "decision_support": {
    "use_when": [
      "A human wants one daily answer to whether meaningful AI-agent activity or settled payments occurred.",
      "A merchant wants trustworthy zeroes that distinguish unverified external traffic from crawlers, tests, and verified activity.",
      "A builder wants privacy-minimized instrumentation across API, MCP, web, or payment flows."
    ],
    "do_not_use_when": [
      "The human only needs generic website analytics.",
      "The task requires storing raw prompts or full private result content.",
      "The human has not authorized a paid subscription when one is required."
    ]
  },
  "commercial": {
    "availability": "available",
    "plan": "Founder",
    "amount_minor": 600,
    "currency": "USD",
    "interval": "month",
    "product_limit": 1,
    "recurring": true,
    "human_approval_required_before_purchase": true,
    "intent_bound_approval_artifact_required_for_machine_payment": true,
    "purchase_entrypoint": "https://analytics.davisvillelabs.com/",
    "machine_purchase_approval_intent": "https://analytics.davisvillelabs.com/api/agent/v1/founder-approval-intent",
    "machine_payment": {
      "status": "live_ready",
      "protocol": "MPP",
      "provider": "stripe",
      "network": "tempo",
      "asset": "USDC.e",
      "merchant_settlement": "stripe_balance_fiat",
      "amount_minor_usd": 600,
      "billing_semantics": "founder_monthly_access",
      "recurring_autopay": false,
      "human_approval_required": true,
      "approval_model": "intent_bound_signed_one_time",
      "approval_intent_endpoint": "https://analytics.davisvillelabs.com/api/agent/v1/founder-approval-intent",
      "configured": true,
      "mode": "live",
      "live_enablement_requires_explicit_owner_approval": true,
      "supported_protocols": [
        "MPP",
        "x402"
      ],
      "rail_selection": "caller_selects_exactly_one_per_human_approval_artifact",
      "payment_options": {
        "mpp_tempo": {
          "status": "live_ready",
          "protocol": "MPP",
          "provider": "stripe",
          "network": "tempo",
          "asset": "USDC.e",
          "merchant_settlement": "stripe_balance_fiat",
          "amount_minor_usd": 600,
          "billing_semantics": "founder_monthly_access",
          "recurring_autopay": false,
          "human_approval_required": true,
          "approval_model": "intent_bound_signed_one_time",
          "approval_intent_endpoint": "https://analytics.davisvillelabs.com/api/agent/v1/founder-approval-intent",
          "configured": true,
          "mode": "live",
          "live_enablement_requires_explicit_owner_approval": true
        },
        "x402": {
          "status": "live_ready",
          "protocol": "x402",
          "version": 2,
          "scheme": "exact",
          "provider": "payai",
          "network": "eip155:8453",
          "asset": "USDC",
          "amount_minor_usd": 600,
          "amount_atomic": "6000000",
          "transport": "http",
          "merchant_settlement": "wallet_usdc",
          "human_approval_required": true,
          "approval_model": "intent_bound_signed_one_time",
          "configured": true
        }
      }
    },
    "machine_payments": {
      "prepaid_one_month": {
        "status": "live_ready",
        "protocol": "MPP",
        "provider": "stripe",
        "network": "tempo",
        "asset": "USDC.e",
        "merchant_settlement": "stripe_balance_fiat",
        "amount_minor_usd": 600,
        "billing_semantics": "founder_monthly_access",
        "recurring_autopay": false,
        "human_approval_required": true,
        "approval_model": "intent_bound_signed_one_time",
        "approval_intent_endpoint": "https://analytics.davisvillelabs.com/api/agent/v1/founder-approval-intent",
        "configured": true,
        "mode": "live",
        "live_enablement_requires_explicit_owner_approval": true,
        "supported_protocols": [
          "MPP",
          "x402"
        ],
        "rail_selection": "caller_selects_exactly_one_per_human_approval_artifact",
        "payment_options": {
          "mpp_tempo": {
            "status": "live_ready",
            "protocol": "MPP",
            "provider": "stripe",
            "network": "tempo",
            "asset": "USDC.e",
            "merchant_settlement": "stripe_balance_fiat",
            "amount_minor_usd": 600,
            "billing_semantics": "founder_monthly_access",
            "recurring_autopay": false,
            "human_approval_required": true,
            "approval_model": "intent_bound_signed_one_time",
            "approval_intent_endpoint": "https://analytics.davisvillelabs.com/api/agent/v1/founder-approval-intent",
            "configured": true,
            "mode": "live",
            "live_enablement_requires_explicit_owner_approval": true
          },
          "x402": {
            "status": "live_ready",
            "protocol": "x402",
            "version": 2,
            "scheme": "exact",
            "provider": "payai",
            "network": "eip155:8453",
            "asset": "USDC",
            "amount_minor_usd": 600,
            "amount_atomic": "6000000",
            "transport": "http",
            "merchant_settlement": "wallet_usdc",
            "human_approval_required": true,
            "approval_model": "intent_bound_signed_one_time",
            "configured": true
          }
        }
      },
      "recurring_stablecoin_30_day": {
        "status": "live_ready",
        "protocol": "MPP",
        "intent": "subscription",
        "provider": "stripe_settlement_with_native_tempo_subscription",
        "network": "tempo",
        "asset": "USDC.e",
        "merchant_settlement": "stripe_balance_fiat",
        "amount_minor_usd": 600,
        "billing_semantics": "founder_recurring_30_day_access",
        "period_count": 30,
        "period_unit": "day",
        "calendar_month_equivalent": false,
        "recurring_autopay": true,
        "scheduled_renewal": true,
        "authorization_lifetime_days": 360,
        "initial_human_approval_required": true,
        "renewal_human_approval_required": false,
        "payer_binding": "verified_tempo_wallet",
        "cancellation": {
          "stops_future_renewals": true,
          "preserves_current_paid_period": true,
          "customer_path": "/workspace/account"
        },
        "approval_model": "intent_bound_signed_initial_recurring_authorization",
        "approval_intent_endpoint": "https://analytics.davisvillelabs.com/api/agent/v1/founder-approval-intent",
        "purchase_endpoint": "https://analytics.davisvillelabs.com/api/agent/v1/founder-subscription",
        "configured": true,
        "mode": "live",
        "live_enablement_requires_explicit_owner_approval": true
      }
    }
  },
  "privacy": {
    "collection_model": "privacy_minimized_commerce_telemetry",
    "prohibited_by_default": [
      "raw_prompts",
      "request_bodies",
      "response_bodies",
      "authentication_tokens",
      "payment_credentials",
      "wallet_secrets",
      "full_paid_results",
      "long_term_raw_ip_addresses",
      "unnecessary_private_content"
    ],
    "retention": {
      "analytics_engine_events": "up_to_three_months_platform_retention",
      "dashboard_window": "previous_24_hours",
      "snapshot_momentum_points": 7,
      "account_billing_security_records": "retained_as_reasonably_needed_for_service_business_records_security_disputes_and_legal_obligations"
    }
  },
  "compatibility": {
    "agent_access_methods": [
      "api",
      "mcp",
      "web",
      "other"
    ],
    "payment_methods": [
      "stripe",
      "mpp",
      "x402",
      "stablecoin",
      "none",
      "other"
    ],
    "runtimes": [
      "cloudflare-workers",
      "node",
      "python",
      "generic-http",
      "unknown"
    ],
    "event_schema": "davisville-agent-analytics.event.v0",
    "mcp_endpoint": "https://analytics.davisvillelabs.com/mcp",
    "mcp_authorization": "oauth_authorization_code_pkce_or_short_lived_delegated_bearer_token",
    "standards_based_oauth": true,
    "oauth_client_registration": "client_id_metadata_document",
    "oauth_scopes": [
      "products:read",
      "analytics:read"
    ]
  },
  "capabilities": [
    {
      "id": "discover",
      "status": "available",
      "auth": "none",
      "changes_state": false,
      "description": "Read product purpose, commercial state, privacy rules, and machine interfaces."
    },
    {
      "id": "inspect_trust",
      "status": "available",
      "auth": "none",
      "changes_state": false,
      "description": "Inspect the public security, privacy, permission, revocation, compatibility, and known-limitation contract before recommending the product."
    },
    {
      "id": "inspect_security",
      "status": "available",
      "auth": "none",
      "changes_state": false,
      "description": "Inspect machine-readable security controls, abuse-control runtime status, vulnerability-reporting metadata, and known limitations."
    },
    {
      "id": "discover_mcp",
      "status": "available",
      "auth": "none",
      "changes_state": false,
      "description": "Discover read-only MCP analytics tools. Public discovery and readiness scanning remain unauthenticated; customer analytics tools use standards-based OAuth or an existing short-lived delegated bearer token."
    },
    {
      "id": "authorize_mcp_read",
      "status": "available_for_existing_customers",
      "auth": "oauth_authorization_code_pkce",
      "changes_state": true,
      "description": "Authorize one-hour read-only MCP access through PKCE S256 and Client ID Metadata Documents. OAuth cannot create products, write telemetry, change billing, or purchase access."
    },
    {
      "id": "evaluate_fit",
      "status": "available",
      "auth": "none",
      "changes_state": false,
      "description": "Determine whether the product fits the human's machine-customer analytics need."
    },
    {
      "id": "plan_installation",
      "status": "available",
      "auth": "none",
      "changes_state": false,
      "description": "Generate a no-side-effect integration plan from a product profile."
    },
    {
      "id": "scan_agent_commerce_readiness",
      "status": "available",
      "auth": "none",
      "changes_state": false,
      "description": "Inspect fixed public HTTPS machine-facing surfaces without credentials or redirects. Direct private targets are rejected and current A/AAAA answers are preflighted; the residual DNS-rebinding limitation is disclosed. No security score is fabricated."
    },
    {
      "id": "validate_installation",
      "status": "available_for_existing_customers",
      "auth": "delegated_agent_token",
      "changes_state": false,
      "description": "Prove that an active ingestion credential exists and an accepted customer_test event reached Agent Analytics without creating production customer activity."
    },
    {
      "id": "subscribe",
      "status": "available",
      "auth": "human_approval",
      "changes_state": true,
      "description": "Purchase requires explicit human approval before any recurring charge."
    },
    {
      "id": "request_machine_purchase_approval",
      "status": "live_ready",
      "auth": "none",
      "changes_state": false,
      "description": "Create a no-payment purchase intent that must be presented to the human owner. The human approval page issues a short-lived signed artifact bound to the exact Founder offer."
    },
    {
      "id": "machine_pay",
      "status": "live_ready",
      "auth": "signed_human_approval_artifact",
      "changes_state": true,
      "description": "Purchase one prepaid Founder month through either MPP/Tempo or HTTP x402 Base USDC settlement after exact human approval. The caller chooses one rail per approval artifact. This option does not recur."
    },
    {
      "id": "machine_subscribe",
      "status": "live_ready",
      "auth": "signed_human_approval_artifact_then_payer_bound_mpp_authorization",
      "changes_state": true,
      "description": "Authorize $6 of Founder access every 30 days through a payer-bound Tempo MPP subscription. Initial activation requires explicit human approval of recurring terms. Later renewals use the scoped stored authorization until canceled or its 360-day authorization lifetime expires."
    },
    {
      "id": "provision_workspace",
      "status": "browser_flow_available",
      "auth": "customer_account",
      "changes_state": true,
      "description": "Workspace activation remains bound to the human-approved subscription flow."
    },
    {
      "id": "delegate_setup",
      "status": "available_for_existing_customers",
      "auth": "customer_session",
      "changes_state": true,
      "description": "An owner or admin can issue a one-hour scoped setup token to an AI agent."
    },
    {
      "id": "create_product",
      "status": "available_for_existing_customers",
      "auth": "delegated_agent_token",
      "changes_state": true,
      "description": "An explicitly authorized AI agent can create products idempotently without receiving browser or recovery credentials."
    },
    {
      "id": "instrument_product",
      "status": "available_after_product_creation",
      "auth": "property_bearer_token",
      "changes_state": false,
      "description": "Send canonical commerce events with a scoped property credential."
    },
    {
      "id": "verify_connection",
      "status": "browser_flow_available",
      "auth": "customer_session",
      "changes_state": false,
      "description": "Current customer onboarding verifies accepted telemetry without counting setup traffic as a real agent."
    },
    {
      "id": "read_daily_pulse",
      "status": "available_for_existing_customers",
      "auth": "delegated_agent_token",
      "changes_state": false,
      "description": "Retrieve the organization's latest precomputed 24-hour Daily Pulse with analytics:read authority. This read does not scan event history."
    }
  ],
  "interfaces": {
    "trust_contract": "https://analytics.davisvillelabs.com/api/agent/v1/trust",
    "security_posture": "https://analytics.davisvillelabs.com/api/agent/v1/security",
    "security_txt": "https://analytics.davisvillelabs.com/.well-known/security.txt",
    "publisher_manifest": "https://davisvillelabs.com/.well-known/davisville-labs.json",
    "mcp": "https://analytics.davisvillelabs.com/mcp",
    "oauth_protected_resource": "https://analytics.davisvillelabs.com/.well-known/oauth-protected-resource",
    "oauth_authorization_server": "https://analytics.davisvillelabs.com/.well-known/oauth-authorization-server",
    "setup_plan": "https://analytics.davisvillelabs.com/api/agent/v1/setup-plan",
    "readiness_scan": "https://analytics.davisvillelabs.com/api/agent/v1/readiness-scan",
    "machine_purchase_approval_intent": "https://analytics.davisvillelabs.com/api/agent/v1/founder-approval-intent",
    "machine_founder_subscription": "https://analytics.davisvillelabs.com/api/agent/v1/founder-subscription",
    "human_purchase_approval_page": "https://analytics.davisvillelabs.com/purchase-approval",
    "delegated_identity": "https://analytics.davisvillelabs.com/api/agent/v1/me",
    "delegated_products": "https://analytics.davisvillelabs.com/api/agent/v1/products",
    "delegated_daily_pulse": "https://analytics.davisvillelabs.com/api/agent/v1/daily-pulse",
    "openapi": "https://analytics.davisvillelabs.com/openapi.json",
    "llms": "https://analytics.davisvillelabs.com/llms.txt",
    "manifest": "https://analytics.davisvillelabs.com/.well-known/ai-agent-analytics.json",
    "sitemap": "https://analytics.davisvillelabs.com/sitemap.xml",
    "machine_founder_access": "https://analytics.davisvillelabs.com/api/agent/v1/founder-access",
    "machine_founder_activation": "https://analytics.davisvillelabs.com/api/agent/v1/founder-activate",
    "privacy": "https://analytics.davisvillelabs.com/privacy",
    "terms": "https://analytics.davisvillelabs.com/terms"
  },
  "approval_contract": {
    "rule": "An upstream agent may evaluate and prepare setup without payment. It must obtain explicit human approval before initiating any paid Founder purchase or recurring subscription.",
    "card_data_handling": "AI Agent Analytics agents should not handle or store payment card data.",
    "autonomous_purchase_without_human_approval": false
  }
}