{
  "schema_version": "1.0",
  "title": "idlidu handbook",
  "updated": "2026-09-07",
  "canonical_html": "https://www.idlidu.com/handbook/",
  "canonical_json": "https://www.idlidu.com/handbook.json",
  "contact": "research@idlidu.com",
  "support_desk": false,
  "auth": {
    "header": "Authorization",
    "scheme": "Bearer",
    "key_pattern": "idl_*",
    "notes": "Track-specific prefixes may apply. Keys are secrets; revoke on abuse/non-payment/AUP."
  },
  "hosts": {
    "pattern": {
      "docs": "https://{prefix}.idlidu.com",
      "api": "https://{prefix}-api.idlidu.com",
      "mcp": "https://{prefix}-mcp.idlidu.com"
    },
    "brand": "https://www.idlidu.com"
  },
  "discovery": [
    "GET /v1/health",
    "GET /v1/openapi.json",
    "GET /v1/public/... (when offered)",
    "Authenticated entity / as-of / events / index routes",
    "Usage / entitlements when billed"
  ],
  "agent_loop": [
    "health",
    "openapi",
    "public_sample_optional",
    "auth_search",
    "as_of_or_events_or_index",
    "check_usage",
    "stop"
  ],
  "question_types": [
    { "ask": "What was true as of date D?", "expect": "point_in_time + methodology_version" },
    { "ask": "What changed?", "expect": "change_or_drift_events" },
    { "ask": "What does the index say?", "expect": "methodology_versioned_series" },
    { "ask": "Does this input fail known rules?", "expect": "shape_c_hits_with_citations" }
  ],
  "steps": [
    { "id": 1, "part": "I", "title": "Understand the brand", "audience": ["human", "agent"] },
    { "id": 2, "part": "I", "title": "Learn the three public hosts", "audience": ["human", "agent"] },
    { "id": 3, "part": "I", "title": "Know the factory line", "audience": ["human", "agent"] },
    { "id": 4, "part": "I", "title": "Know the three shapes (A/B/C)", "audience": ["human", "agent"] },
    { "id": 5, "part": "II", "title": "Authenticate with Bearer key", "audience": ["human", "agent"] },
    { "id": 6, "part": "II", "title": "Prefer versioned HTTP under /v1", "audience": ["human", "agent"] },
    { "id": 7, "part": "II", "title": "Use MCP when tool-native", "audience": ["agent", "human"] },
    { "id": 8, "part": "II", "title": "Ask the right question types", "audience": ["agent", "human"] },
    { "id": 9, "part": "II", "title": "Respect non-claims / disclaimer tokens", "audience": ["human", "agent"] },
    { "id": 10, "part": "III", "title": "Pick a dataset from /products/", "audience": ["human"] },
    { "id": 11, "part": "III", "title": "Read methodology before money", "audience": ["human"] },
    { "id": 12, "part": "III", "title": "Obtain a key", "audience": ["human"] },
    { "id": 13, "part": "III", "title": "First successful call", "audience": ["human", "agent"] },
    { "id": 14, "part": "III", "title": "Wire metering into agent loops", "audience": ["human", "agent"] },
    { "id": 15, "part": "III", "title": "Escalate only when docs fail", "audience": ["human"] },
    { "id": 16, "part": "IV", "title": "Bootstrap from handbook.json + OpenAPI", "audience": ["agent"] },
    { "id": 17, "part": "IV", "title": "Choose transport (HTTP vs MCP)", "audience": ["agent"] },
    { "id": 18, "part": "IV", "title": "Safe default loop", "audience": ["agent"] },
    { "id": 19, "part": "IV", "title": "Citation rules for agents", "audience": ["agent"] },
    { "id": 20, "part": "IV", "title": "Bot / crawler boundaries", "audience": ["agent", "human"] },
    { "id": 21, "part": "VI", "title": "Plan families (Starter/Growth/Archive)", "audience": ["human"] },
    { "id": 22, "part": "VI", "title": "Money rules (USD; no x402 headline)", "audience": ["human", "agent"] },
    { "id": 23, "part": "VII", "title": "Read platform legal", "audience": ["human", "agent"] },
    { "id": 24, "part": "VII", "title": "Acceptable use summary", "audience": ["human", "agent"] },
    { "id": 25, "part": "VII", "title": "What idlidu will not do", "audience": ["human", "agent"] }
  ],
  "assets": [
    { "n": 1, "dataset": "finance", "prefix": "finance", "shape": "B", "blurb": "US bank ratios, peers, credit-conditions indices", "disclaimer": "Not a credit rating" },
    { "n": 2, "dataset": "saas", "prefix": "saas", "shape": "B", "blurb": "B2B software pricing/packaging history", "disclaimer": "Not CPI; list prices from public marketing pages only" },
    { "n": 3, "dataset": "k8s", "prefix": "k8s", "shape": "B", "blurb": "Managed K8s list prices + Helm/OCI archive", "disclaimer": "Not a security rating; not a cost guarantee" },
    { "n": 4, "dataset": "mcp", "prefix": "mcp", "shape": "A", "blurb": "Public MCP tool/schema/scope fingerprints", "disclaimer": "Not a security certification; does not execute tool payloads" },
    { "n": 5, "dataset": "pkgs", "prefix": "pkgs", "shape": "B", "blurb": "Package ownership/yank/transfer timelines", "disclaimer": "Not a malware verdict; not a safe-package score" },
    { "n": 6, "dataset": "robots", "prefix": "robots", "shape": "B", "blurb": "Dated robots.txt / AI-policy records", "disclaimer": "Evidence product — not legal advice; does not authorize crawling" },
    { "n": 7, "dataset": "apibreak", "prefix": "apibreak", "shape": "A", "blurb": "Silent breaks from fixed public-API suite", "disclaimer": "Not an uptime SLA; not legal evidence of vendor breach" },
    { "n": 8, "dataset": "labprice", "prefix": "labprice", "shape": "B", "blurb": "CAS × grade × supplier catalogue prices", "disclaimer": "Not an offer to sell chemicals" },
    { "n": 9, "dataset": "hire", "prefix": "hire", "shape": "B", "blurb": "Sci/tech hiring adoption timelines", "disclaimer": "Not a recruiting service; no applicant PII" },
    { "n": 10, "dataset": "simdeck", "prefix": "simdeck", "shape": "C", "blurb": "Simulation deck checks with citations", "disclaimer": "Not a correctness guarantee; pass ≠ physics match" },
    { "n": 11, "dataset": "uaweb", "prefix": "uaweb", "shape": "A", "blurb": "Cross-UA response deltas for the same URL", "disclaimer": "Observation of public responses; not a privacy product" },
    { "n": 12, "dataset": "gpucap", "prefix": "gpucap", "shape": "A", "blurb": "Cloud capacity obtainability probes", "disclaimer": "Not a price guarantee; allocation observation only" },
    { "n": 13, "dataset": "labsec", "prefix": "labsec", "shape": "B", "blurb": "Sci instrument secondary-market asks", "disclaimer": "Not an appraisal or offer to sell equipment" },
    { "n": 14, "dataset": "mlipfit", "prefix": "mlip", "shape": "C", "blurb": "MLIP ensemble fitness / disagreement", "disclaimer": "Not a DFT replacement; ensemble disagreement only" },
    { "n": 15, "dataset": "dftconv", "prefix": "dftconv", "shape": "C", "blurb": "Versioned DFT convergence recipes", "disclaimer": "Not a correctness guarantee for production runs" },
    { "n": 16, "dataset": "engprobe", "prefix": "engprobe", "shape": "A+C", "blurb": "Engineering canary solve history", "disclaimer": "Not a generic LLM leaderboard" },
    { "n": 17, "dataset": "llmstxt", "prefix": "llmstxt", "shape": "B", "blurb": "Dated llms.txt / AI-manifest archive", "disclaimer": "Evidence of published manifests; not legal advice" },
    { "n": 18, "dataset": "specarc", "prefix": "specarc", "shape": "B", "blurb": "As-of API contract snapshots", "disclaimer": "Archive of published contracts; not live behaviour" },
    { "n": 19, "dataset": "hfcard", "prefix": "hfcard", "shape": "B", "blurb": "HF model-card timeline", "disclaimer": "Not an endorsement by Hugging Face" },
    { "n": 20, "dataset": "extstore", "prefix": "extstore", "shape": "B", "blurb": "IDE extension marketplace history", "disclaimer": "Not a malware verdict" },
    { "n": 21, "dataset": "crddrift", "prefix": "crddrift", "shape": "A/B", "blurb": "CRD / values-schema drift", "disclaimer": "Not a security rating" }
  ],
  "legal": {
    "terms": "https://www.idlidu.com/legal/terms/",
    "privacy": "https://www.idlidu.com/legal/privacy/",
    "aup": "https://www.idlidu.com/legal/aup/",
    "bot": "https://www.idlidu.com/bot/",
    "counsel_reviewed": false
  },
  "bot_user_agent": "idlidu-bot/1.0 (+https://www.idlidu.com/bot)",
  "pricing_model": {
    "currency": "USD",
    "families": ["Starter", "Growth", "Archive", "Scale", "Institution"],
    "shape_ab_usd_mo": {
      "starter": 99,
      "growth": 249,
      "archive": 599,
      "scale": 1499,
      "institution": 3999
    },
    "shape_c_usd_mo": {
      "starter": 199,
      "growth": 499,
      "archive": 999,
      "scale": 2499,
      "institution": 6999
    },
    "bulk_skus": [
      { "id": "bulk_snapshot", "usd": 2500, "billing": "one_shot" },
      { "id": "bulk_deep", "usd": 7500, "billing": "one_shot" },
      { "id": "bulk_annual", "usd": 4500, "billing": "yearly" },
      { "id": "bulk_scale_addon", "usd": 500, "billing": "monthly_addon" },
      { "id": "bulk_rulepack", "usd": 5000, "billing": "one_shot", "shape": "C" }
    ],
    "packs_usd_mo": {
      "pack_3_growth": 599,
      "pack_5_archive": 1999,
      "pack_cohort_archive": 3999,
      "pack_scale_3": 3499,
      "pack_institution_portfolio": 9999
    },
    "annual_prepay": "pay_10_get_12_archive_plus",
    "overage_per_10k_calls_usd": 8,
    "invoice_net30_min_usd": 2500,
    "x402_headline": false,
    "canonical": "https://www.idlidu.com/pricing/"
  },
  "links": {
    "products": "https://www.idlidu.com/products/",
    "indices": "https://www.idlidu.com/indices/",
    "indices_json": "https://www.idlidu.com/indices.json",
    "developers": "https://www.idlidu.com/developers/",
    "pricing": "https://www.idlidu.com/pricing/",
    "markdown_source": "https://github.com/manishthatte/idlidu.com/blob/platform/common/HANDBOOK.md"
  }
}