Definitions

@@ -21,9 +21,10 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in  | Term | Definition | |------|-----------|-| **webview** (short: **wv**) | A native Adom workspace webview tab, opened via `adom-cli hydrogen webview open-or-refresh`. ONE word, always — "Web View" as two words is not an Adom term. On every platform, "show me in webview"/"wv" means THIS — never VS Code's built-in Simple Browser. |-| **pup** | A clean, scriptable Chrome the AI fully owns (Puppeteer bridge via AD, `browser_*` verbs, sessionIds/tabs, cold profiles). The logged-out, automation-safe surface. Always lowercase. |-| **native browser** | The user's own signed-in Chrome/Edge, driven via abe (`nbrowser_*`). For logged-in sites. |+| **webview** (short: **wv**) | THE workhorse display surface: a native Adom workspace webview tab — a first-class panel next to the editor. ONE word, always ("Web View" is not an Adom term); on every platform "show me in webview"/"wv" means THIS, never VS Code's Simple Browser. Open idempotently: `adom-cli hydrogen webview open-or-refresh --name "<Tab>" --url "<URL>" --panel-id <id>` (re-running with the same `--name` just navigates — a stable handle). THE PLATFORM TRAP is the URL: in a CLOUD container the tab renders in the user's browser, so `localhost` is WRONG — use the slug proxy URL (`https://{slug}.adom.cloud/proxy/{port}/`); under HD the tab renders on the same machine, so `http://localhost:{port}` is correct. Verify the tab exists (`adom-cli hydrogen workspace tabs`) before claiming it opened. |+| **pup** | The AI's own Chrome on the user's desktop (Puppeteer bridge via AD, `browser_*` verbs). A real, full browser window the AI fully controls: sessions (`sessionId` is the handle — task-prefix it and set `owner` so threads never steal each other's windows), many TABS in one window (preferred over window sprawl), screenshots, JS eval, taskbar flash. Opens BACKGROUND by default — `foreground:true` is the only thing that raises it; signal with a flash instead of stealing focus. Cold profiles = LOGGED OUT by design: the safe automation surface (fresh-user testing, scraping public pages, showing wiki pages). For logged-in sites use nb instead. Windows never auto-close — clean up when a task ends. Always lowercase. |+| **native browser** (short: **nb**) | The user's own signed-in Chrome/Edge, driven via abe (`nbrowser_*`). For logged-in sites. "Show it in nb" == open in the user's real browser. |+| **nb addressing** | `nb [browser] [profile]` names a specific browser/profile: "nb chrome", "nb edge", "nb chrome work", "nb chrome personal". Maps to the Browser Picker's native destination ids (`browser:<browser>:<profileDir>`) and the profiles abe reports. The AI resolves the profile from the user's words + `GET /browser-profiles`. | | **hdbw** | HD Browser Window — Hydrogen Desktop's standalone built-in Tauri browser window (picker label "HD Browser Window", window label `hd-browse-*`, destination id `webview-window`). Open first-class via `POST /hdbw/open {url}` on HD's control API. NOT a webview panel, NOT pup — its own surface, only under HD. | | **Browser Picker** | HD's canonical URL router: every link opened inside HD goes through it. Offers the surfaces above + native profiles from abe, a fresh-window toggle, a 5s auto-countdown, and per-domain memory of the user's past choice (incl. localhost:port domains). | | **Simple Browser** | VS Code's built-in browser page. NEVER an Adom surface — showing an app there is a bug on every platform. |@@ -84,7 +85,7 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | Rule | Detail | |------|--------| | **webview is one word** | Never "Web View". Short form: wv. |-| **lowercase tools** | pup, shotlog, abe, wv, hdbw — always lowercase in prose. |+| **lowercase tools** | pup, shotlog, abe, wv, nb, hdbw — always lowercase in prose. | | **VS Code** | The IDE inside the workspace (powered by code-server). Never call it "the editor" — the Editor is the Adom App around it. Avoid "code-server"/"Coder" in user-facing text. | | **No internal codenames to users** | "Hydrogen" (the web app) and "Carbon" (backend registry) appear in code/URLs only. Public names: Adom App / Adom. |