Clanka AI • Dashboard

                           (optional direct)
  CLI Terminal -----------------------------> [ Agent CLI ]
  node index.js <MINT>                           token-ai/index.js
             |                                         |
             |                                         | emits HTTP events → POST /events
             |                                         v
[ Browser UI ]-- POST /run -----------------> [ Live UI Server ] -----------------------------.
agent-live.html        JSON { mint }             token-ai/server.js                           |
ws://host:port/ws                              - spawns agent child                           |
(subscribes to WS)                              - broadcasts WS events                         |
                                                - /ohlcv proxy (Birdeye)                      |
                                                - /recent-analyses, /latest-analysis          |
             ^                                         |                                      |
             | <====== WS: ai_session/runner events ===|======================================|
             |        status, tool_call, partial, metrics, final_json                         |
             |                                                                                 |
             |                                                                                 v
             |                                 [ Child: Agent CLI ]                        writes
             |                                 - loads memory (DB/FS)                      reports
             |                                 - builds prompts                             under:
             |                                 - executes tools via core/exec-tools.js      reports/
             |                                 - posts events                                ai-token-analyses/
             |                                           |                                    gpt5-analysis-*.json
             |                                           | tool_call: socials_orchestrate     latest-*.json
             |                                           v
             |                                 [ Tool Executor ] (core/exec-tools.js)
             |                                 - routes tool calls
             |                                 - spawns orchestrator child
             |                                           |
             |                                           v
             |                                 [ Socials Orchestrator ]
             |                                 token-ai/socials/orchestrator.js
             |                                 - steps: market, website, telegram, x
             |                                 - Playwright/APIs, persists JSON to socials/reports/
             |                                 - prints REPORT_FILE:/abs/path.json
             |                                           |
             |                                           v
             |                                 exec-tools reads report, normalizes links
             |                                 returns data to Agent
             |                                           |
             |                                           | tool_call: analyze_token_ohlcv_range
             |                                           v
             |                                 Birdeye v3 OHLCV (fast)  <----.
             |                                 - range + interval fetch        |  external APIs
             |                                 - summarized to memory          |  - DexScreener
             |                                                                  - Birdeye v3
             |                                                                  - X/Twitter
             |                                                                  - Telegram
             |                                           ^
             |                                           |
             |                                 Agent correlates socials + OHLCV
             |                                 may web_search in gather rounds
             |                                 then Finalize (pure) → JSON
             |                                           |
             |                                           v
             +------------------- UI shows timeline, metrics, streamed text, final scores

Finalize (important):
- Pure synthesis: no tool calls, no parallel_tool_calls.
- Non‑stream strict JSON via json_schema.
- Draft → valid JSON repair if parsing fails (uses just-produced draft).
- Memory update only on schema-valid JSON.