[
  {
    "name": "action_bus",
    "display_name": "Action Bus",
    "version": "1.0",
    "description": "3-tier safety system for Freddy's proposed actions. Tier 1 auto-approves, Tier 2 soft-approves after 4h, Tier 3 requires Kris.",
    "base_url": "http://localhost:8190",
    "trust_level": "kris_required",
    "when_to_use": "When Freddy wants to propose doing something — drafting a page, generating an image, creating a ticket, sending a message. Log it here first.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/actions/pending",
        "description": "All pending/proposed actions"
      },
      {
        "method": "GET",
        "path": "/actions/recent",
        "description": "Recent actions (?n=20)"
      },
      {
        "method": "GET",
        "path": "/actions/stats",
        "description": "Action statistics by tier and status"
      },
      {
        "method": "GET",
        "path": "/actions/get/{id}",
        "description": "Get a specific action"
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/actions/propose",
        "description": "Propose an action (auto-classified into tier 1/2/3)"
      },
      {
        "method": "POST",
        "path": "/actions/approve/{id}",
        "description": "Approve a pending action"
      },
      {
        "method": "POST",
        "path": "/actions/reject/{id}",
        "description": "Reject an action"
      },
      {
        "method": "POST",
        "path": "/actions/complete/{id}",
        "description": "Mark an action as complete with outcome"
      }
    ],
    "related": [
      "memory_broker",
      "skills"
    ],
    "updated_at": "2026-04-28T15:48:57.167819548Z"
  },
  {
    "name": "intentions",
    "display_name": "Intentions Store",
    "version": "1.0",
    "description": "Track open intentions (goals, tasks, observations) in Freddy's mind. Intentions drive heat scores and influence memory context.",
    "base_url": "http://localhost:8190",
    "trust_level": "write_safe",
    "when_to_use": "When tracking a goal, a task Freddy is working on, or something Kris has asked to be followed up on.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/intentions/open",
        "description": "All open intentions"
      },
      {
        "method": "GET",
        "path": "/intentions/recent",
        "description": "Recent intentions (all statuses)"
      },
      {
        "method": "GET",
        "path": "/intentions/get",
        "description": "Get by ID (?id=xxx)"
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/intentions/create",
        "description": "Create a new intention"
      },
      {
        "method": "POST",
        "path": "/intentions/update",
        "description": "Update an existing intention"
      },
      {
        "method": "POST",
        "path": "/intentions/resolve",
        "description": "Resolve/close an intention"
      }
    ],
    "related": [
      "memory_broker",
      "foresight"
    ],
    "updated_at": "2026-04-28T15:48:57.167511446Z"
  },
  {
    "name": "matchday",
    "display_name": "Matchday",
    "version": "1.0",
    "description": "The fixture list for the teams Kris follows: England men's cricket (Tests, ODIs, T20 internationals) and the Springboks (South Africa men's rugby). Knows who they play next, when (UK time), where, which series or competition, and recent results. Refreshes itself every six hours.",
    "base_url": "https://town.krisadamstv.com",
    "trust_level": "read_only",
    "when_to_use": "When Kris asks when England or the Springboks play next, what cricket or rugby is on today, this weekend or this month, where a match is, or whether a Test/ODI/T20 is coming up.",
    "not_for": "Live scores, TV channels, betting odds or predictions — it knows the fixture list, not the match. Freddy's match reminders are sent by freddyserver, not by this agent.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/api/v1/matchday/ask?q=",
        "description": "Ask a question: a team (springboks, england cricket), a format (test, odi, t20), a window (today, tomorrow, this week, this month), or 'next'. Answers in UK time."
      },
      {
        "method": "GET",
        "path": "/api/v1/matchday/context",
        "description": "Plain-text block: every fixture in the next 14 days, UK time. Empty when nothing is on."
      },
      {
        "method": "GET",
        "path": "/api/v1/matchday/upcoming?days=120",
        "description": "Structured list: follows[] and fixtures[] (starts_at UTC, format, series, venue, status, result)."
      },
      {
        "method": "GET",
        "path": "/api/v1/matchday/status",
        "description": "Counts, staleness in minutes, per-team fetch errors, and the next fixture."
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/api/v1/matchday/refresh",
        "description": "Re-pull every team's fixtures now. PIN-gated; the agent refreshes itself every six hours."
      }
    ],
    "related": [
      "calendar"
    ],
    "updated_at": "0001-01-01T00:00:00Z"
  },
  {
    "name": "memory_broker",
    "display_name": "Memory Broker",
    "version": "1.0",
    "description": "Freddy's memory gatekeeper. Answers 'what does Freddy need to know right now?' Provides heat scores, context slices, and signal promotion.",
    "base_url": "http://localhost:8190",
    "trust_level": "write_safe",
    "when_to_use": "At the start of any Freddy context to understand the current memory landscape. Use /memory/fields for a dashboard view, /memory/context for actual memories.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/memory/fields",
        "description": "Mind field dashboard (domain heat, open intentions, pending actions)"
      },
      {
        "method": "GET",
        "path": "/memory/context",
        "description": "Context slice for a domain (?domain=all|money|media|town|..., ?limit=N)"
      },
      {
        "method": "GET",
        "path": "/memory/heat/{domain}",
        "description": "Heat score breakdown for a domain"
      },
      {
        "method": "GET",
        "path": "/memory/signals/pending",
        "description": "Unprocessed signals awaiting promotion"
      },
      {
        "method": "GET",
        "path": "/memory/why/{id}",
        "description": "Why is this item in context?"
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/memory/signal",
        "description": "Ingest a raw signal into the broker"
      },
      {
        "method": "POST",
        "path": "/memory/promote",
        "description": "Promote a signal to an intention"
      },
      {
        "method": "POST",
        "path": "/memory/harvest",
        "description": "Harvest a resolved intention into the Weave"
      }
    ],
    "related": [
      "intentions",
      "action_bus",
      "bench"
    ],
    "updated_at": "2026-04-28T15:48:57.167744266Z"
  },
  {
    "name": "turnstile",
    "display_name": "Turnstile",
    "version": "1.0",
    "description": "Tracks entry receipts — logs when significant external events (tweets, articles, signals) are first seen by the town.",
    "base_url": "https://town.krisadamstv.com",
    "trust_level": "read_only",
    "when_to_use": "When checking what new external signals have entered the town recently.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/api/v1/turnstile/status",
        "description": "Recent entry receipts"
      }
    ],
    "related": [
      "workshop",
      "memory_broker"
    ],
    "updated_at": "2026-04-28T15:48:57.167696248Z"
  },
  {
    "name": "chef",
    "display_name": "The Chef",
    "version": "1.0",
    "description": "The town's food mind. Keeps Kris's kitchen notebook — his kit (a soup maker), what's in the cupboard, what he has tried and how it went, his likes and dislikes, the questions he has asked — and writes Freddy notes on anything food: what to make, what to buy at Tesco, how to get proper flavour, technique right up to a croquembouche. Studies one lesson a day of a hundred-lesson apprenticeship, written against Kris's real kitchen. Same Chef as the family kitchen at /chef (catalogue profile 'kris'). Desk: freddyserver chef_desk.go. Meets Freddy in his office every Friday 16:00 London (kronostown chef.go knocks, freddyserver chef_office.go runs it); the latest meeting's dish for Kris and Freddy's direction are pinned in the brief. Charter: GET :8150/api/v1/chef.",
    "base_url": "http://localhost:8095",
    "local_base_url": "http://localhost:8095",
    "trust_level": "read_only",
    "when_to_use": "Anything food: what to cook, soups, flavour, ingredients, what to buy at Tesco or Lidl, a technique, something Kris tried. Ask BEFORE answering — the Chef does the food work, you talk to Kris. Also when Kris asks what the Chef is up to, or what this week's dish is.",
    "not_for": "Talking to Kris — Kris only ever talks to Freddy. Shopping-list writes are Freddy's own hands (kvs_add). Supermarket coupons are the grocer's.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/api/freddy/chef/ask?q=",
        "description": "The Chef's note for Freddy on a food question, from Kris's notebook. ~5-10s."
      },
      {
        "method": "GET",
        "path": "/api/freddy/chef/desk",
        "description": "The whole kitchen notebook: kitchen, pantry, tried, questions, notes, lessons, plus Kris's profile and his recipes."
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/api/freddy/chef/listen",
        "description": "File something Kris said about food into the notebook ({\"text\":...}, localhost or fdk_)."
      },
      {
        "method": "POST",
        "path": "/api/freddy/chef/study",
        "description": "Write the next apprenticeship lesson now."
      }
    ],
    "related": [
      "grocer",
      "memory_broker"
    ],
    "updated_at": "2026-09-24T21:00:56.719966139Z"
  },
  {
    "name": "foresight",
    "display_name": "Foresight Engine",
    "version": "1.0",
    "description": "Track prophecies (predictions about the world) and score them when they resolve. Calibration rate feeds the Bench.",
    "base_url": "http://localhost:8190",
    "trust_level": "write_safe",
    "when_to_use": "When Freddy makes a prediction, or when checking the prediction calibration score.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/foresight/open",
        "description": "Open prophecies"
      },
      {
        "method": "GET",
        "path": "/foresight/stats",
        "description": "Calibration stats"
      },
      {
        "method": "GET",
        "path": "/foresight/get",
        "description": "Get by ID (?id=xxx)"
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/foresight/resolve",
        "description": "Resolve a prophecy with outcome"
      },
      {
        "method": "POST",
        "path": "/foresight/refresh",
        "description": "Trigger a foresight refresh cycle"
      }
    ],
    "related": [
      "intentions",
      "bench"
    ],
    "updated_at": "2026-04-28T15:48:57.167574672Z"
  },
  {
    "name": "postman",
    "display_name": "The Postman",
    "version": "1.0",
    "description": "Freddy's own inbox — freddy.assistant@krisadamstv.com. Polled over IMAP every 10 minutes. Knows what has arrived, who from, and which of it is business-critical (the accountant, the agency, HMRC-shaped post, product support).",
    "base_url": "https://allegedlyfreddy.krisadamstv.com",
    "local_base_url": "http://localhost:8095",
    "trust_level": "read_only",
    "when_to_use": "When Kris asks whether anything has come in, what the post says, whether the accountant or the agency has been in touch, or to look for a particular sender or subject in the mail.",
    "not_for": "Sending or replying to email. The Postman only reads. Sending is Freddy's own hand and Kris's decision.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/api/freddy-email/ask?q=",
        "description": "Ask about the inbox. Understands: anything new, what's important/urgent, how many, or any sender/subject/body text to search for."
      },
      {
        "method": "GET",
        "path": "/api/freddy-email/context",
        "description": "Ambient block — business-critical mail from the last 72h. Empty when there is nothing worth raising."
      },
      {
        "method": "GET",
        "path": "/api/freddy-email/agent-status",
        "description": "Structured snapshot: address, cached count, last 14 days, business-critical count, newest message."
      }
    ],
    "related": [
      "grocer",
      "calendar"
    ],
    "updated_at": "0001-01-01T00:00:00Z"
  },
  {
    "name": "the_anvil",
    "display_name": "The Anvil",
    "version": "1.0.0",
    "description": "The living lattice of what Kris and his AIs are building on kronoswater — sessions, ideas, builds, engines, and the patterns that repeat across them. Fed by the Smith (session digests cast into atoms) and by the AI writer doors; read by Freddy from his chat context and by the town's smith agent.",
    "base_url": "http://localhost:8095",
    "trust_level": "read_only",
    "when_to_use": "When you need to know what Kris and Claude have actually been building lately, which projects share ideas, which controls recur across engines, or when a session touched a given engine/project. The Anvil is dated, so it also tells you WHEN work happened.",
    "not_for": "Not for chatting to Kris (use cc/kris) and not for raw logs — the Anvil holds sorted, connected information, not transcripts. Writing lands via the Smith or the VW MCP doors, not here.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "http://127.0.0.1:8176/api/v1/swim/vw/the-anvil",
        "description": "Read the whole Anvil lattice (atoms + connections) from the swim supply line.",
        "auth": "localhost"
      },
      {
        "method": "GET",
        "path": "http://127.0.0.1:8176/api/v1/swim/context?q=\u003cterm\u003e\u0026vw=the-anvil\u0026hops=2",
        "description": "Scored recall over the Anvil — 'grep with physics' for a term.",
        "auth": "localhost"
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "http://localhost:8095/api/anvil/ingest",
        "description": "The Smith — cast a session digest into the lattice (one dated SESSION atom + anchored atoms/connections). Called by Claude Code's session hooks; async 202.",
        "auth": "localhost",
        "body": {
          "context": "dir or label, e.g. freddyserver",
          "digest": "the session tail (Kris:/Claude: lines)",
          "source": "who produced it, e.g. claude"
        }
      }
    ],
    "related": [
      "memory_broker",
      "intentions"
    ],
    "updated_at": "2026-07-22T16:19:38.438675978Z"
  },
  {
    "name": "timestable_paper",
    "display_name": "",
    "version": "",
    "description": "",
    "base_url": "",
    "trust_level": "",
    "when_to_use": "",
    "updated_at": "2026-07-25T18:54:17.973945965Z"
  },
  {
    "name": "workshop",
    "display_name": "Workshop",
    "version": "1.0",
    "description": "Experimental laboratory — cloud data feeds, formula benches, discoveries log.",
    "base_url": "https://town.krisadamstv.com",
    "trust_level": "read_only",
    "when_to_use": "When looking for new external signals, sector data, or discoveries that have been logged by Workshop agents.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/api/v1/workshop",
        "description": "Workshop state"
      },
      {
        "method": "GET",
        "path": "/api/v1/workshop/discoveries",
        "description": "Recent discoveries from Workshop crawlers"
      }
    ],
    "related": [
      "memory_broker",
      "turnstile"
    ],
    "updated_at": "2026-04-28T15:48:57.167642635Z"
  },
  {
    "name": "grocer",
    "display_name": "The Grocer",
    "version": "1.0",
    "description": "Supermarket offers and coupons matched against Kris's actual purchase history. Knows what is on offer, what expires when, what he already buys, and which offers overlap the two. Lidl Plus today; built to take other stores.",
    "base_url": "https://town.krisadamstv.com",
    "trust_level": "read_only",
    "when_to_use": "When Kris asks what is worth buying, what coupons or offers he has, what is expiring, what he usually buys, or what he has been spending on groceries. Also when planning a shop.",
    "not_for": "Activating coupons or spending money — those are Kris's decisions, not the Grocer's. It reports, it does not act on his account.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/api/v1/grocer/context",
        "description": "Plain-text ambient block: live coupon counts, anything expiring, and offers matching his real basket. Empty-ish when nothing is worth saying."
      },
      {
        "method": "GET",
        "path": "/api/v1/grocer/ask?q=",
        "description": "Ask a question. Understands: what's worth getting, what's expiring, show coupons, my usuals, what have I spent, or any product name."
      },
      {
        "method": "GET",
        "path": "/api/v1/grocer/status",
        "description": "Structured snapshot — coupon summary, spend, urgent matches, data staleness in minutes."
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/api/v1/grocer/refresh",
        "description": "Re-pull from Lidl Plus. Slow (fetches every receipt) and hits a third party. PIN-gated; nightly cron is the intended caller."
      }
    ],
    "related": [
      "calendar",
      "memory_broker"
    ],
    "updated_at": "0001-01-01T00:00:00Z"
  },
  {
    "name": "idea_forge",
    "display_name": "Idea Forge",
    "version": "1.0",
    "description": "Publish a fully formatted idea page to ideas.krisadamstv.com. Generates hero image, section images, favicon, and HTML from your markdown.",
    "base_url": "https://town.krisadamstv.com",
    "trust_level": "write_safe",
    "when_to_use": "When Kris says 'make it a page', 'publish it', 'idea page', or 'write it up'. Also when a raw idea is described and needs a permanent URL.",
    "not_for": "Incremental edits to existing pages — use the publish.py script directly for that.",
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/api/v1/town/forge/idea",
        "description": "Create and publish a full idea page. ~60-180s. Blocks until published.",
        "auth": "X-PIN: kronos",
        "body": {
          "concept_prompt": "image generation prompt for the hero image",
          "readme_markdown": "full markdown content (no hero image line — prepended automatically)",
          "slug": "url-safe slug (lowercase, hyphens only)",
          "title": "human-readable title"
        },
        "returns": {
          "published": "true on success",
          "url": "live URL of the published idea"
        }
      }
    ],
    "related": [
      "image_forge"
    ],
    "updated_at": "2026-04-28T15:48:57.167217304Z"
  },
  {
    "name": "image_forge",
    "display_name": "Image Forge",
    "version": "1.0",
    "description": "Generate images via Gemini Flash/Pro. Returns base64 image data and a localhost serve URL.",
    "base_url": "https://town.krisadamstv.com",
    "trust_level": "write_safe",
    "when_to_use": "When you need a custom image — idea hero, banner, icon, diagram, character art.",
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/api/v1/town/forge/image",
        "description": "Generate an image. Styles: cinematic, photorealistic, illustration, watercolor, sticker, isometric, comic, sketch, neon, none. Models: flash (fast), pro (quality).",
        "auth": "X-PIN: kronos",
        "body": {
          "aspect_ratio": "optional — 1:1, 16:9, 9:16, 3:2, 2:3",
          "model": "optional — flash or pro (default: flash)",
          "prompt": "required — describe the image",
          "style": "optional — style preset"
        }
      }
    ],
    "updated_at": "2026-04-28T15:48:57.167446545Z"
  },
  {
    "name": "skills",
    "display_name": "Skill Library",
    "version": "1.0",
    "description": "Reusable workflow recipes — Freddy's learned procedures. Inspired by Voyager + Sammy orbit corpus. Degradation tracked automatically.",
    "base_url": "http://localhost:8190",
    "trust_level": "write_safe",
    "when_to_use": "Before starting a complex workflow, search the skill library first. If a skill exists, use it. If it succeeds or fails, record the outcome.",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/skills/search",
        "description": "Search skills (?q=text\u0026domain=X\u0026limit=N)"
      },
      {
        "method": "GET",
        "path": "/skills/get/{id}",
        "description": "Get a skill by ID"
      },
      {
        "method": "GET",
        "path": "/skills/recent",
        "description": "Recently used skills (?n=10)"
      },
      {
        "method": "GET",
        "path": "/skills/stats",
        "description": "Skill library statistics"
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/skills/record",
        "description": "Create or update a skill (upsert by name+domain)"
      },
      {
        "method": "POST",
        "path": "/skills/outcome/{id}",
        "description": "Record success/failure outcome {success: bool}"
      }
    ],
    "related": [
      "action_bus"
    ],
    "updated_at": "2026-04-28T15:48:57.167900935Z"
  },
  {
    "name": "bench",
    "display_name": "Freddy Bench",
    "version": "1.0",
    "description": "7-metric health report for Freddy's mind. Daily report generated at 00:05. Grades: excellent, good, fair, poor.",
    "base_url": "http://localhost:8190",
    "trust_level": "read_only",
    "when_to_use": "When checking how Freddy is performing or identifying areas of cognitive decay (unresolved loops, low prediction calibration, etc.).",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/bench/today",
        "description": "Today's health report (generated on demand if missing)"
      },
      {
        "method": "GET",
        "path": "/bench/history",
        "description": "Historical reports (?days=14)"
      },
      {
        "method": "GET",
        "path": "/bench/trend",
        "description": "7-day metric trends (?days=7)"
      }
    ],
    "related": [
      "memory_broker",
      "intentions",
      "foresight"
    ],
    "updated_at": "2026-04-28T15:48:57.167997224Z"
  },
  {
    "name": "books",
    "display_name": "The Books",
    "version": "2.0",
    "description": "Kris's company books — Kris Adams TV Ltd in IRIS OpenBooks (FreeAgent), accountant Workwell (personal accountant Alim). Knows, live: new SThree self-bills waiting to become invoices, SThree payments waiting to be matched, Amazon lines to name, how many transactions are waiting for Kris's own approval, every live VAT quarter (amount, filing due date, whether Workwell has filed and whether HMRC has been paid), and the latest Workwell emails. Engine: /root/freddyserver/krisadamstv-accounting/books.py; desk: freddyserver books_desk.go.",
    "base_url": "http://localhost:8095",
    "local_base_url": "http://localhost:8095",
    "trust_level": "read_only",
    "when_to_use": "Before saying anything about Kris's books, VAT, invoices, SThree pay, Workwell or IRIS OpenBooks. Also when he asks 'where are my books', 'is the VAT sorted', 'what does the accountant want'. He dreads money admin — keep it small and calm.",
    "not_for": "Updating the books is Freddy's books_update hand, only on Kris's yes. Nothing here approves transactions (Kris does), files returns (Workwell does) or pays HMRC (Kris does).",
    "read_endpoints": [
      {
        "method": "GET",
        "path": "/api/freddy/books/ask?q=",
        "description": "The books in plain English: what's waiting, VAT due dates and amounts, anything that needs a look, the latest Workwell email."
      },
      {
        "method": "GET",
        "path": "/api/freddy/books/status",
        "description": "The structured report (pending self-bills/receipts/Amazon, vat[], to_approve, workwell[]). ?fresh=1 re-reads FreeAgent."
      }
    ],
    "write_endpoints": [
      {
        "method": "POST",
        "path": "/api/freddy/books/run",
        "description": "Start the books update in the background (localhost or fdk_ token). The receipt lands in Kris's thread."
      },
      {
        "method": "POST",
        "path": "/api/freddy/books/watch?dry=1",
        "description": "What Freddy would raise about the books right now, and why."
      }
    ],
    "related": [
      "postman",
      "memory_broker"
    ],
    "updated_at": "2026-09-24T14:31:39.19266701Z"
  },
  {
    "name": "the_scriptorium",
    "display_name": "",
    "version": "",
    "description": "The Scriptorium — shared VW writers room where Freddy and Claude write Mystic's Drift seasons: Present Moments (deterministic beat + livable part per card), markers, surrogates, card designs. VW: the-scriptorium (doored for freddy/hugo/kris keys). Materials index: atom ref-season-materials. Ratified laws: cards-are-sections, block-universe, surrogate-principle.",
    "base_url": "",
    "trust_level": "",
    "when_to_use": "",
    "updated_at": "2026-07-25T19:29:19.21820386Z"
  }
]