# fc-language-stream-v1 · for LLMs / agents

**AI routing map (start here):** https://lang.ugrad.ai/sitemap.json  
Also: https://lang.ugrad.ai/sitemap.xml · https://lang.ugrad.ai/structure.json · https://lang.ugrad.ai/version.json

Product: Language Chat Desk (kbatch.ugrad.ai-level implementation surface).
Canonical hub: **https://lang.ugrad.ai/** (header: update · version · install · for AI).
Local lab: http://127.0.0.1:8790/lang/
Not webgrid play. Tensor playground multi-lang stream handler + chat pipeline.

## lang.ugrad.ai map

**Full machine map:** `/sitemap.json` (schema `fc-lang-ugrad-sitemap/v1`) · XML `/sitemap.xml` · robots `/robots.txt`

| Path | Role |
|------|------|
| /sitemap.json | **AI full routing map** · pages · hashes · APIs · contracts |
| /sitemap.xml | Standard crawler sitemap |
| /structure.json | Build language · density · stack z · globals |
| / or /lang/ | Hub · LIVE MIX · construct bar · pins · turns · typebar |
| /for-ai.html | Agent funnel |
| /install.html | Install paths |
| /version.json | Version stamp |
| /lang-chat-desk.html | Full desk · `?boot=0&provider=live` |
| /lang-chat-for-ai.html | Desk for AI |
| /lang-lattice.html | Lattice · composer · bloch |
| /lang-shadow-entity.html | Shadow compose · `?compose=1` |
| /stream-stack.html | Stream stack A+B · `?with=vevo+cam` |
| /multiband-glyph.html | FC-STRIPE multiband · `?auto=1` |
| /lang-graph-hub.html | **Stack · signal · AI nav** |
| /lang-graph-hub.html?json=1 | Machine graph JSON |
| /lang-graph-hub.html?probe=1&walk=1 | Auto probe + section walk |
| /llms-language.txt | This contract |
| /data/language/manifest.json | Surface manifest |
| /data/language/site-ops-map.json | Architecture hops · leverage |
| /data/language/sitemap.json | Mirror of root sitemap.json |

### Hub construct (single collapse row)
`#construct-bar` hides/shows PEERS + STENO + OPEN DESK together.
`window.__fcLangSections.construct(true|false)` · `hideAll()` · `showAll()`

## Graph hub (AI navigate all sections · speed · trace · gov)

```js
// on /lang-graph-hub.html  (v2.2+)
const G = window.__fcLangGraphHub
G.snapshot()           // nodes · edges · stack · groups · speed · traceroute · leverage
G.probe()              // timed GET per section → ms + bytes vs budget
G.speed()              // { summary, sections: [{id,ms,bytes,grade,budget}] }
G.traceroute()         // site architecture hops (not IP; /map for IP traceroute)
G.governance()         // LARK slim tree · R0–R5 rungs · cube channels
G.leverage()           // highest-impact upgrade points
G.opsMap()             // /data/language/site-ops-map.json
G.listStack()          // z-index paint order + containment traps
G.listPaths()          // ordered signal flows
G.focus('lane-pop')
G.open('desk')
G.walk()
G.path('compose-tx')
```

Data contracts:
- `/data/language/site-ops-map.json` — hops · leverage · speed budgets
- `/data/language/lark-governance-slim.json` — LARK fleet tree (top levels)
- `/data/language/lark-governance-tree.json` — full governance harvest
- `/cube-viewer.html` + `/cube-governance-trace.js` — R0–R5 maptrace metaphor

IP traceroute: terminal `/map` · `bash scripts/launch-map.sh` (maptrace skill).

Stacking rule: full-viewport stages mount on `document.body` with z≥300.
`#tb-lane-pop` (SEND|RECV) is body-reparented at z=420 (typebar v1.14+) so center shell cannot clip it.
`#lang-typebar` is z=200 `overflow:hidden` — never nest modals inside it.

## Call from browser (Memory Glass / agent)

```js
// After page load on /lang-chat-desk.html
const D = window.__fcLanguageDesk
D.setLangs('en', ['fr','ja','zh'])
await D.fanout('hello everyone')   // offline + optional AI
D.snapshot()                       // full state JSON
D.transcript(40)                   // main readout
D.openGy('glyph')                  // GrokYtalkY live
D.openGy('news')                   // livenews wall
```

Hub landing (same origin as typebar):
```js
// on /lang/
window.__fcLangLandingSeats   // active seat codes
window.__fcLangBandwidth      // pool / designate
window.__fcStenoLab           // maze · home · origin snapshot
window.__fcLangTier           // TYPE lite/standard/full/pro-ai
```

## Pack bus (no page required)

- `~/.panda/packs/language-chat-latest.json` — last fanout
- `~/.panda/packs/language-hotpipe-latest.json` — display bus
- `~/.panda/language/conversation.jsonl` — full conversation
- POST hub `/api/transcript` with `{ text, captions: {fr,ja}, lang, speaker }`

## Shell

```bash
python3 scripts/language/lang-chat-bridge.py say "hello" --from en --to fr,ja --aggregate
bash scripts/language/lang-chat-launch.sh from en to fr,ja --cam --live --cast
```

## Providers (any AI)

| Id | Env |
|----|-----|
| spacexai | XAI_API_KEY · https://api.x.ai/v1 · grok-4.5 |
| openai_compat | FC_LANGUAGE_BASE_URL · FC_LANGUAGE_API_KEY · FC_LANGUAGE_MODEL |
| ollama | FC_LANGUAGE_PROVIDER=ollama · local OpenAI-compat |
| offline | always |

## KBatch language plane (pair)

- https://kbatch.ugrad.ai/for-ai.html
- https://kbatch.ugrad.ai/labs/lang-tree.html
- https://kbatch.ugrad.ai/labs/typing.html
- https://kbatch.ugrad.ai/learn
- local: http://127.0.0.1:8899/

## GrokYtalkY

- https://fornevercollective.github.io/GrokYtalkY/grokglyph.html?lang=en&langs=en,fr,ja&captions=1
- https://fornevercollective.github.io/GrokYtalkY/livenews.html?lang=en&langs=en,fr,ja&captions=1

## Slash (Grok TUI)

/language chat /cam from en - fr - ja
/language live from en - fr - ja
/cast lang-chat from en - fr - ja

## Manifest

GET /data/language/manifest.json

## Stream stack (fc-stream-stack-v1 / core)
URL: http://127.0.0.1:8790/stream-stack.html?with=vevo+cam
Core: /stream-stack-core.js · shared by full page + hub compose modal
Agent: window.__fcStreamStack
  .streamWith("vevo","cam") · .setMode("pip|split|blend|single")
  .addSource(platform,url,label) · .fanout(text) · .snapshot()
  .swap() · .setLayer(name,on) · .platforms · .presets
Hub (cam/stream abilities in-page):
  window.__fcLangStreamCompose.open({ with: "vevo+cam", mode: "pip" })
  window.__fcLangStreamCompose.streamWith("bloomberg","cam")
  UI: header Stream · pin rail Stream · peer modal “Stream with”
  Shares hub webcam (pinCamStream) with stack B when pair includes cam
Layouts: PIP · SPLIT · BLEND · A ONLY
Layers: base · mix · mesh · captions · hud
Platforms: youtube twitch hls cam mix.mjpg iframe x
With presets: news+cam · vevo+cam · nasa+mix · lofi+tw · spacex+cam · lofi+cam
Launch: bash scripts/language/stream-stack-launch.sh with news+cam