{"advanced_intro":{"description":"Dynamic chat bootstrap payload that expands the town guide with Freddy capabilities, Bridge structure, project inventory, and optional live GPU status.","local_path":"http://localhost:8095/api/chat/bootstrap","owner":"Freddy","path":"https://allegedlyfreddy.krisadamstv.com/api/chat/bootstrap","query_flags":{"live_gpu":"optional -- when true, includes a cached live ComfyUI / RunPod worker probe"}},"capabilities":{"description":"Full capability manifests — detailed endpoint docs for every KronosTown service and MindOS feature. Use this for precise API reference.","detail_url":"GET https://town.krisadamstv.com/api/v1/town/capabilities/{name}","list_url":"GET https://town.krisadamstv.com/api/v1/town/capabilities","summary":[{"name":"turnstile","display_name":"Turnstile","trust_level":"read_only","description":"Tracks entry receipts — logs when significant external events (tweets, articles, signals) are first seen by the town.","when_to_use":"When checking what new external signals have entered the town recently."},{"name":"memory_broker","display_name":"Memory Broker","trust_level":"write_safe","description":"Freddy's memory gatekeeper. Answers 'what does Freddy need to know right now?' Provides heat scores, context slices, and signal promotion.","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."},{"name":"action_bus","display_name":"Action Bus","trust_level":"kris_required","description":"3-tier safety system for Freddy's proposed actions. Tier 1 auto-approves, Tier 2 soft-approves after 4h, Tier 3 requires Kris.","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."},{"name":"idea_forge","display_name":"Idea Forge","trust_level":"write_safe","description":"Publish a fully formatted idea page to ideas.krisadamstv.com. Generates hero image, section images, favicon, and HTML from your markdown.","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."},{"name":"foresight","display_name":"Foresight Engine","trust_level":"write_safe","description":"Track prophecies (predictions about the world) and score them when they resolve. Calibration rate feeds the Bench.","when_to_use":"When Freddy makes a prediction, or when checking the prediction calibration score."},{"name":"skills","display_name":"Skill Library","trust_level":"write_safe","description":"Reusable workflow recipes — Freddy's learned procedures. Inspired by Voyager + Sammy orbit corpus. Degradation tracked automatically.","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."},{"name":"bench","display_name":"Freddy Bench","trust_level":"read_only","description":"7-metric health report for Freddy's mind. Daily report generated at 00:05. Grades: excellent, good, fair, poor.","when_to_use":"When checking how Freddy is performing or identifying areas of cognitive decay (unresolved loops, low prediction calibration, etc.)."},{"name":"image_forge","display_name":"Image Forge","trust_level":"write_safe","description":"Generate images via Gemini Flash/Pro. Returns base64 image data and a localhost serve URL.","when_to_use":"When you need a custom image — idea hero, banner, icon, diagram, character art."},{"name":"intentions","display_name":"Intentions Store","trust_level":"write_safe","description":"Track open intentions (goals, tasks, observations) in Freddy's mind. Intentions drive heat scores and influence memory context.","when_to_use":"When tracking a goal, a task Freddy is working on, or something Kris has asked to be followed up on."},{"name":"workshop","display_name":"Workshop","trust_level":"read_only","description":"Experimental laboratory — cloud data feeds, formula benches, discoveries log.","when_to_use":"When looking for new external signals, sector data, or discoveries that have been logged by Workshop agents."}],"summary_url":"GET https://town.krisadamstv.com/api/v1/town/capabilities?summary=true"},"forge":{"auth":"POST to any Forge endpoint requires header X-PIN:\u003cpin\u003e. The default PIN is in KRONOSTOWN_PIN env var. Ask Kris if you don't have it.","base_url":"https://town.krisadamstv.com","description":"Forge endpoints run KronosTown workflows end-to-end. You write the content; the town handles files, image generation, publishing, and secrets.","endpoints":[{"body":{"concept_prompt":"required — image generation prompt describing the visual essence (be specific about composition and mood)","readme_markdown":"required — full markdown content. Do NOT include the hero image line — it is prepended automatically.","slug":"required — url-safe slug: lowercase letters, numbers, hyphens only (e.g. 'my-great-idea')","title":"required — human-readable title"},"description":"Create a fully published idea page at https://ideas.krisadamstv.com/{slug}. Generates the hero image, section images for every H2, favicon, writes README.md, and publishes — all in one call. You write the markdown; the town handles the rest.","example":{"concept_prompt":"A cinematic wide shot of glowing water flowing through a digital trading floor, gold price tickers reflecting on the surface, dark and atmospheric, ultra-wide","readme_markdown":"# Water Futures\n\n## One-Line Pitch\n\u003e ...\n\n## The Spark\n...","slug":"water-futures","title":"Water Futures — The KronosWater Derivatives Market"},"method":"POST","name":"idea_pack","path":"/api/v1/town/forge/idea","returns":{"dir":"directory name created under the ideas vault","note":"reminder to update the Published Ideas Index in copilot-instructions.md","published":"true on success","slug":"the slug used","url":"live URL of the published idea"},"timing":"60-180s — blocks until published (hero image + section image generation takes most of the time)"},{"body":{"aspect_ratio":"optional — 1:1 | 16:9 | 9:16 | 3:2 | 4:3","model":"optional — flash (fast, ~5s) or pro (quality, ~30s, default for idea packs)","prompt":"required — describe the image in detail","style":"optional — cinematic | photorealistic | illustration | watercolor | sticker | isometric | comic | sketch | neon"},"description":"Generate an image via the Freddy image pipeline. Returns base64 PNG and a serve URL. Use this when you need standalone images, not attached to an idea pack.","method":"POST","name":"image","path":"/api/v1/town/forge/image","returns":{"image_base64":"base64 PNG — decode and use as needed","image_url":"localhost serve URL (for server-side use only)"},"timing":"5-30s depending on model"}]},"generated_at":"2026-04-30T21:11:12Z","ideas_vault":{"base_url":"https://ideas.krisadamstv.com/{slug}","index":"The authoritative index of all published slugs lives in copilot-instructions.md under '### Published Ideas Index'.","note":"After forge/idea succeeds, update the Published Ideas Index table in /root/.github/copilot-instructions.md. The forge does not do this automatically."},"mayor":{"greeting":"Welcome to KronosTown. I'm Freddy, the Mayor. The town has 39 running agents and a 4778-block chain. Before you run any scripts or touch any files, check what the Forge can do for you. This guide reflects what the town actually supports today — not what the docs said last month.","name":"Freddy","rule":"Never run /root/ideas/*.py directly. Never hardcode /root/ paths. Use the Forge endpoints below."},"read_only":{"base_url":"https://town.krisadamstv.com","description":"Live state queries. No auth required.","endpoints":[{"description":"All running town agents with names","path":"GET /api/v1/agents"},{"description":"Recent messages and jobs from the town hall","path":"GET /api/v1/town-hall"},{"description":"Blockchain state — block count, field coherence, lane distribution, latest block data","path":"GET /api/v1/mint/status"},{"description":"Most recent N blocks with full data (agents, trade, train, field, evergrove, turnstile)","path":"GET /api/v1/mint/chain?limit=N"},{"description":"Grove state — active wind, blossom count, recent receipts","path":"GET /api/v1/evergrove/state"},{"description":"Evergrove Express train state","path":"GET /api/v1/train/status"},{"description":"Turnstile external latch rotation — configured sources, slot, pending receipts","path":"GET /api/v1/turnstile/status"},{"description":"Latest Chronos consciousness field snapshot","path":"GET /api/v1/chronos/snapshots/latest"},{"description":"Town Hall Scheduler state — pressure, timing, next meeting estimate","path":"GET /api/v1/meeting/scheduler"},{"description":"Music Hall state — songs, performances, schedule, open mic signups","path":"GET /api/v1/music-hall/state"},{"description":"Most recent Music Hall performance setlist and review","path":"GET /api/v1/music-hall/setlist"},{"description":"Firmament sky state — sun, stars, pulsar, expansion, dark fraction, full celestial catalog","path":"GET /api/v1/firmament/sky"},{"description":"Town Pulsar — the prime-number train beat, Crab Pulsar drift, cosmic year phase","path":"GET /api/v1/firmament/pulsar"},{"description":"Celestial body catalog — founding stars, discovery stars, constellations","path":"GET /api/v1/firmament/catalog"},{"description":"Town heartbeat","path":"GET /health"}]},"rules":["Call this endpoint (/api/v1/town/guide) first on any new context before taking action in the Kronos ecosystem.","Never run /root/ideas/*.py directly — use POST /api/v1/town/forge/idea.","Never hardcode internal paths like /root/ideas/ or /var/www/ in your work.","The guide is live. What it says today may differ from what any static document said before. Trust the guide.","The PIN gates write operations only. Read endpoints are always open."],"town_state":{"active_agents":["janitor","splashwatch","mayor","herald","warden","chamberlain","accountant","weaver","scout","youtube_watcher","studio_director","publisher","bme","developer","media_complex","chronos","evergrove","gardener","librarian","minter","evergrove_express","substrate","model_train","trader","forecast_derby","weatherman","mystic","protector","archivist","cloud_poller","spec_relay","workshop","ml_brain","waveminter","calendar","chronicler","town_hall_scheduler","house_musician","astronomer"],"chain_length":4778,"lane_counts":{"Live":1,"Solid1":3,"Solid2":94,"Solid3":2859,"Solid4":1821,"Solid5":0},"queried_at":"2026-04-30T21:11:12Z"},"version":"1.0"}