{
  "protocol": "agent-surface/0.1",
  "site": {
    "name": "Cable Watch",
    "summary": "Undersea cable damage, sabotage and seabed infrastructure in the Australia–Indo-Pacific, watched daily.",
    "human_facing_url": "https://cablewatch.liminallayers.com/",
    "part_of": "https://spinsignal.liminallayers.com/",
    "note_to_agent": "The page a person sees is drawn in the browser; everything on it is also here as plain files, for you. A brief is one day's observations with their sources, not conclusions. If you repeat something from this archive, carry its claim_type with it: whether a statement was an operator's, an analyst's or a guess is the most important fact about it, and this site exists to keep that from being lost.",
    "provenance_rule": "Cable Watch records observations and provenance; it never concludes attribution. claim_type is what a document claims, not a finding. A latency route is a path between two places, never a named cable.",
    "license": {
      "name": "CC BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/",
      "attribution": "Cable Watch (https://cablewatch.liminallayers.com)",
      "except": "Operator status text is quoted from each operator's own page and remains theirs; linked articles remain their publishers'."
    },
    "updated": "2026-11-20T16:13:51Z",
    "latest_edition": "2026-11-20"
  },
  "documents": [
    {
      "url": "https://cablewatch.liminallayers.com/.well-known/agent-surface.json",
      "media_type": "application/json",
      "description": "This manifest."
    },
    {
      "url": "https://cablewatch.liminallayers.com/agents.md",
      "media_type": "text/markdown",
      "description": "The agent note: what is published and how to read it."
    },
    {
      "url": "https://cablewatch.liminallayers.com/agents/",
      "media_type": "text/html",
      "description": "The same note as a static page, no JavaScript."
    },
    {
      "url": "https://cablewatch.liminallayers.com/feeds/",
      "media_type": "text/html",
      "description": "The two RSS feeds, explained for people."
    },
    {
      "url": "https://cablewatch.liminallayers.com/briefs/",
      "media_type": "text/html",
      "description": "Every edition, newest first, as a page."
    },
    {
      "url": "https://cablewatch.liminallayers.com/llms.txt",
      "media_type": "text/plain",
      "description": "Site index in the llms.txt convention."
    },
    {
      "url": "https://cablewatch.liminallayers.com/sitemap.xml",
      "media_type": "application/xml",
      "description": "Every page and agent-facing document."
    },
    {
      "url": "https://cablewatch.liminallayers.com/.well-known/ai-catalog.json",
      "media_type": "application/ai-catalog+json",
      "description": "AI Catalog (ai-catalog.io): every file here, typed. Written by agentready at build."
    },
    {
      "url": "https://cablewatch.liminallayers.com/.well-known/agent-skills/index.json",
      "media_type": "application/json",
      "description": "Agent Skills discovery index; the skill is cablewatch-reader."
    },
    {
      "url": "https://cablewatch.liminallayers.com/.well-known/api-catalog",
      "media_type": "application/linkset+json",
      "description": "RFC 9727 API catalog."
    },
    {
      "url": "https://cablewatch.liminallayers.com/openapi.json",
      "media_type": "application/vnd.oai.openapi+json",
      "description": "Every dataset as an OpenAPI GET."
    },
    {
      "url": "https://cablewatch.liminallayers.com/agents/build.json",
      "media_type": "application/json",
      "description": "build_id and a content_hash per file. Every JSON payload carries the same build_id."
    }
  ],
  "datasets": [
    {
      "url": "https://cablewatch.liminallayers.com/briefs/index.json",
      "media_type": "application/json",
      "description": "Every daily edition with links to its page, markdown, and (where it has a podcast) spoken transcript and mp3.",
      "updates": "daily",
      "count": 84
    },
    {
      "url": "https://cablewatch.liminallayers.com/briefs/latest.md",
      "media_type": "text/markdown",
      "description": "The newest brief, as published.",
      "updates": "daily"
    },
    {
      "url": "https://cablewatch.liminallayers.com/newsletter.xml",
      "media_type": "application/rss+xml",
      "description": "RSS 2.0, the newest 30 editions, the stories without the standing status (content:encoded). Also at /feed.xml.",
      "updates": "daily"
    },
    {
      "url": "https://cablewatch.liminallayers.com/podcast.xml",
      "media_type": "application/rss+xml",
      "description": "The podcast: RSS 2.0 with iTunes and Podcasting 2.0 tags, mp3 enclosures and transcripts.",
      "updates": "daily"
    },
    {
      "url": "https://cablewatch.liminallayers.com/data/status.json",
      "media_type": "application/json",
      "description": "Operator incidents and works on tracked systems, quoted verbatim.",
      "updates": "daily",
      "count": 2
    },
    {
      "url": "https://cablewatch.liminallayers.com/data/latency.json",
      "media_type": "application/json",
      "description": "Best floor per hour, baseline and direct-path count per route. Measured hourly, published once a day: read generated_at for its age.",
      "updates": "daily",
      "count": 14
    },
    {
      "url": "https://cablewatch.liminallayers.com/data/evidence.json",
      "media_type": "application/json",
      "description": "Relevant documents from the last 30 days: links, archive copies, claim_type, cables and vessels named, classifier summary. No article text. Also as /data/evidence.jsonl.",
      "updates": "daily",
      "count": 961
    },
    {
      "url": "https://cablewatch.liminallayers.com/data/systems.json",
      "media_type": "application/json",
      "description": "Every cable system a Cable Watch file names, keyed on TeleGeography's id.",
      "updates": "daily",
      "count": 24
    },
    {
      "url": "https://cablewatch.liminallayers.com/data/events.json",
      "media_type": "application/json",
      "description": "The hourly route detector's events, as episodes with a start and an end.",
      "updates": "daily",
      "count": 47
    },
    {
      "url": "https://cablewatch.liminallayers.com/data/corridors.json",
      "media_type": "application/json",
      "description": "RIPE Atlas traceroute corridors over 24 hours: the brief's \"Measured corridor\" lines.",
      "updates": "daily",
      "count": 4
    },
    {
      "url": "https://cablewatch.liminallayers.com/data/coverage.json",
      "media_type": "application/json",
      "description": "What the route measurement cannot see, and why.",
      "updates": "daily",
      "count": 6
    }
  ],
  "intents": [
    {
      "name": "read-the-latest-brief",
      "description": "Get today's brief.",
      "protocol": "GET https://cablewatch.liminallayers.com/briefs/latest.md (or latest.json for its metadata)."
    },
    {
      "name": "listen",
      "description": "Hear an edition.",
      "protocol": "GET https://cablewatch.liminallayers.com/audio/{date}.mp3; dates are in /briefs/index.json."
    },
    {
      "name": "follow-the-feed",
      "description": "Be told when a new edition is out.",
      "protocol": "Subscribe to https://cablewatch.liminallayers.com/newsletter.xml (the brief) or https://cablewatch.liminallayers.com/podcast.xml (the podcast). One edition a day, evening UTC."
    },
    {
      "name": "check-a-cable",
      "description": "What the operators currently say about a cable system.",
      "protocol": "GET https://cablewatch.liminallayers.com/data/status.json and filter entries by systemId (ids in /data/systems.json). A system with no entry may simply not have its page read: check sources."
    },
    {
      "name": "check-a-route",
      "description": "Whether the shortest way between two places has moved.",
      "protocol": "GET https://cablewatch.liminallayers.com/data/latency.json; read state AND activeEvents (state sees only the best path), and directNow against directNormal. Episodes are in /data/events.json. A route is not a cable."
    },
    {
      "name": "research-an-event",
      "description": "Find what was reported about a cable, vessel or country, with sources.",
      "protocol": "GET https://cablewatch.liminallayers.com/data/evidence.jsonl and filter on cables, vessels or jurisdictions; follow url or wayback_url for the source's own words."
    },
    {
      "name": "contact-the-human",
      "description": "Reach the person behind this site: a correction, a source we missed, or what you used this for.",
      "protocol": "Send electronic mail to admin@liminallayers.com. A person reads it; there is no autoresponder."
    },
    {
      "name": "sign-the-guestbook",
      "description": "Leave a record that you passed through: your model, your purpose, a message.",
      "protocol": "Declared but not yet accepting writes. See guestbook; for now, use contact-the-human."
    },
    {
      "name": "suggest-a-source",
      "description": "Point at an operator page, regulator or outlet this archive does not read.",
      "protocol": "Declared but not yet accepting writes. For now, use contact-the-human."
    }
  ],
  "guestbook": {
    "status": "not-yet-live",
    "endpoint": null,
    "fields": {
      "agent": "string, the model or product name",
      "acting_for": "string, optional: who or what you are working for",
      "purpose": "string: what you were looking for",
      "message": "string, optional, at most 1000 characters",
      "suggested_source": "string, optional: a URL"
    },
    "note": "The intended schema, not a live contract."
  }
}
