Skip to content

Self-improving AI Employees for everyone

docs: catch up on outputMode / verification-code context + lock panel routing with render tests

trohitga0d428f7191d
diff --git a/CLAUDE.md b/CLAUDE.md
index 202ebd36..9b0205eb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2751,6 +2751,7 @@ This function:
- **Workflow-scoped chat + console history**: chat messages persist with `chat_messages.session_id == <workflow_id>` (or `"default"` when no workflow is open); console logs persist with `console_logs.workflow_id`. Backend `database.get_console_logs(limit, workflow_id=None)` and `clear_console_logs(workflow_id=None)` filter by workflow when given. `handle_clear_console_logs` broadcasts `console_logs_cleared` carrying the `workflow_id` so the existing frontend filter in `WebSocketContext` keeps other workflows' panels intact. Frontend reads `currentWorkflow.id` via the documented Zustand escape hatch (`useAppStore.getState().currentWorkflow?.id`) at call time for `clearChatMessages` / `clearConsoleLogs` / `sendChatMessage` so the callbacks don't re-create on every workflow switch. A dedicated `useEffect([currentWorkflowId, isReady])` resets local `chatMessages` / `consoleLogs` and refetches both when the user opens / switches workflow. Incoming `console_log` broadcasts are filtered by `currentWorkflow.id` so a parallel run on another workflow never bleeds into the active panel. Legacy logs without `workflow_id` still surface (transition guard).
- **Auto-derived `isConfigNode` uiHint**: `_derive_auto_ui_hints(group)` in `services/plugin/base.py` automatically sets `uiHints.isConfigNode: True` on any plugin whose `group` tuple contains `memory` or `tool` (centralized as `_CONFIG_NODE_GROUPS = frozenset({"memory", "tool"})`). Explicit `cls.ui_hints` always wins (merge order: auto first, then `dict.update`). Frontend `InputSection.tsx` and `OutputPanel.tsx` consume the flag via `definition?.uiHints?.isConfigNode === true` — the old `groups.includes('memory') || groups.includes('tool')` heuristic is gone. Pytest invariant `test_ui_hints_only_carry_known_flags` locks the flag name. Adding a new auxiliary node type costs zero per-plugin code; opting out costs one line (`ui_hints = {"isConfigNode": False}`).
- **`isMasterSkillEditor` uiHint replaces `node.type === 'masterSkill'` checks**: 6 frontend callsites (`Dashboard.tsx:98` component dispatch, `useAutoSkillEdges.ts` constant + edge filter, `MiddleSection.tsx` × 3) now read `getCachedNodeSpec(type)?.uiHints?.isMasterSkillEditor === true` instead of comparing the type string. The `MasterSkillNode` plugin already declared the hint — no backend change. Renaming the plugin's `type` is now a single backend edit followed by a NodeSpec deploy; the frontend never needs to know the string.
+- **`outputMode: "terminal"` uiHint — spec-driven CLI output rendering**: the output panel (`components/output/OutputPanel.tsx`, the active renderer — `ui/OutputDisplayPanel.tsx` is legacy/unimported) renders string responses through ReactMarkdown by default, which whitespace-collapses CLI text. CLI-wrapper plugins (`githubAction`, `vercelAction`, `shell`) declare `ui_hints = {"outputMode": "terminal"}`; the panel resolves the spec via `useNodeSpec(selectedNode?.type)` and renders their text in a `<pre>` on the per-theme `--code-*` surface, routes wholly-JSON strings to the JSON tree via the shared `tryParseJson` (`utils/formatters.ts`), and surfaces object/array `result` payloads (server-side-parsed CLI JSON; arrays survive `unwrap` un-peeled) in the Response section. Pair with the `_shape` convention: parsed JSON in `result` OR text in `stdout` — never both — empty keys omitted. Locked by `client/src/components/__tests__/OutputPanel.test.tsx` (render tests: real `\n`/`\t` preserved) + the uiHints known-set in `test_node_spec.py`. Cache note: nodeSpecs are session-sticky (`staleTime: FOREVER`, revision-busted at page load) — after a backend restart a hard browser reload is needed before new uiHints reach an open canvas.
- **`--action-X-hover` triplet + ActionButton zero-arithmetic**: each of the 6 action roles (`run`/`stop`/`save`/`config`/`secret`/`tools`) now exposes a `-hover` variant (0.25 alpha) alongside the existing `-soft` (0.15) and `-border` (0.6). ActionButton's CVA reads `hover:bg-action-X-hover` directly; disabled state is the shadcn-idiomatic `disabled:opacity-50` on the base class. No per-token `/25`, `/40`, `/10` opacity arithmetic at any call site. Credential-modal panels (`OAuthConnect`, `EmailPanel`, `QrPairingPanel`) and the skill / tool-schema editors (`SkillEditorModal`, `ToolSchemaEditor`) consume `<ActionButton intent="...">` directly. `ActionDef` carries an `intent` key; the catalogue adapter maps server-sent `theme_color` palette strings to intents via `SERVER_COLOR_TO_INTENT`.
- **Credentials: DB as single source of truth + symmetric broadcasts + cache dedup**: `CredentialsDatabase` (encrypted SQLite) is canonical; every other layer is a derived cache with explicit invalidation. Backend `AuthService._memory_cache + _models_cache` collapsed into one `_api_key_cache: Dict[str, ApiKeyCacheEntry]` dataclass — single write/evict site. Per RFC 9700 (OAuth 2.0 BCP, 2024) the `_oauth_cache` no longer carries `refresh_token`; new `get_oauth_refresh_token(provider, customer)` reads from the encrypted DB on every call. `validate_api_key`, `save_api_key`, `delete_api_key`, `twitter_logout`, `google_logout` now broadcast symmetrically: `update_api_key_status` (in-memory map) + `broadcast_credential_event(...)` (refetch signal) wrapping `WorkflowEvent` (CloudEvents v1.0 from `services/events/envelope.py`, the same envelope the Wave 12 EventSource framework uses). The dead-letter `credential_catalogue_updated` event is finally emitted by the backend. Frontend retired the 200-LOC `client/src/components/credentials/providers.tsx` static fallback — `useCatalogueQuery` is the only source; cold-boot renders `<Skeleton>`, server-unreachable shows an explicit error state. `ApiKeyStatus.hasKey` mirror dropped (duplicated catalogue's `provider.stored`); two new selector hooks (`useProviderStored`, `useStoredProviderCount`) read the catalogue. Pytest invariant `test_credential_broadcasts.py` (14 tests) locks the broadcast contract via `inspect.getsource` introspection + the CloudEvents v1.0 envelope shape + AuthService DB-write-then-cache-update ordering + the no-refresh-token-in-cache rule.
- **Local-LLM provider routing + per-model context**: Ollama and LM Studio are first-class providers (9 in total for agents now: cloud 7 + 2 local). Provider detection is driven by `detect_ai_provider` in `server/constants.py` plus the `provider` Literal in `nodes/agent/{ai_agent,chat_agent,_specialized}.py` — both MUST list `ollama` / `lmstudio` or chat-model nodes / agent dropdowns silently fall through to `'openai'` and `execute_chat` calls api.openai.com with the placeholder key. The validator at `nodes/model/_local_validator.py` probes via the official SDKs (`ollama.AsyncClient.ps()` for typed `ProcessResponse.Model`, `lmstudio.AsyncClient.llm.list_loaded()` for typed `LlmInstanceInfo`) — reads only typed fields (`context_length`, `max_context_length`, `vision`, `trained_for_tool_use`, `architecture`, `params_string`, `format`, plus Ollama's `details.{family,parameter_size,quantization_level}`). No regex, no Modelfile-parameters parsing, no `/api/show` modelinfo dict-key hunting. Per-model params persist in `EncryptedAPIKey.models["model_params"]` (via `save_api_key(model_params=...)`) AND in `model_registry.json` via `register_local_model()` — sync `get_context_length()` / `get_max_output_tokens()` find real values without async DB lookups, and entries survive process restart. `is_model_valid_for_provider` returns `True` for open-world providers (`openrouter` / `ollama` / `lmstudio`) so local model names like `qwen/qwen3.6-27b` aren't rejected by the cloud-style pattern check. Runtime path uses `OpenAIProvider(base_url={user_proxy_url}, api_key="ollama")` — traffic stays on `localhost`.
diff --git a/client/src/components/__tests__/OutputPanel.test.tsx b/client/src/components/__tests__/OutputPanel.test.tsx
new file mode 100644
index 00000000..4064f75b
--- /dev/null
+++ b/client/src/components/__tests__/OutputPanel.test.tsx
@@ -0,0 +1,96 @@
+/**
+ * Tests for the output renderer (components/output/OutputPanel) —
+ * specifically the spec-driven Response branches.
+ *
+ * Locks in:
+ * - uiHints.outputMode === 'terminal' renders string output in a
+ * <pre> with REAL newlines preserved (never ReactMarkdown, which
+ * collapses whitespace — the "raw stdout" mangling bug)
+ * - without the hint, string output keeps the markdown path
+ * - terminal stdout that is wholly JSON routes to the JSON tree
+ * - an object/array `result` payload (server-side-parsed CLI JSON)
+ * surfaces in the Response section as a tree
+ */
+
+import { describe, it, expect, vi } from 'vitest';
+import { screen } from '@testing-library/react';
+import { renderWithProviders } from '../../test/providers';
+
+// Heavy renderers mocked — the tests assert ROUTING, not markdown/json internals.
+vi.mock('react-markdown', () => ({
+ default: ({ children }: any) => <div data-testid="markdown">{children}</div>,
+}));
+vi.mock('remark-gfm', () => ({ default: () => null }));
+vi.mock('remark-breaks', () => ({ default: () => null }));
+vi.mock('@uiw/react-json-view', () => ({
+ default: ({ value }: any) => <div data-testid="json-view">{JSON.stringify(value)}</div>,
+}));
+
+// Spec source — the backend-owned display hint under test.
+const specState: { spec: any } = { spec: null };
+vi.mock('@/lib/nodeSpec', () => ({
+ useNodeSpec: () => specState.spec,
+}));
+
+import OutputPanel from '../output/OutputPanel';
+
+const NODE = { id: 'gh-1', type: 'githubAction' } as any;
+
+const makeResult = (outputs: Record<string, any>) =>
+ [{ nodeId: 'gh-1', success: true, executionTime: 12, outputs }] as any;
+
+const GH_TABLE = 'trohitg/opencowork\tpublic\t2026-07-06\ntrohitg/opencompany\tpublic\t2026-07-06';
+
+describe('OutputPanel response routing', () => {
+ it('renders terminal stdout in a <pre> with real newlines when uiHints.outputMode=terminal', () => {
+ specState.spec = { uiHints: { outputMode: 'terminal' } };
+ renderWithProviders(
+ <OutputPanel
+ results={makeResult({ operation: 'custom', success: true, stdout: GH_TABLE })}
+ selectedNode={NODE}
+ />,
+ );
+ const pre = screen.getByTestId('terminal-output');
+ // Real newline + tab preserved — NOT whitespace-collapsed.
+ expect(pre.textContent).toContain('trohitg/opencowork\tpublic');
+ expect(pre.textContent).toContain('\ntrohitg/opencompany');
+ expect(screen.queryByTestId('markdown')).toBeNull();
+ });
+
+ it('keeps the markdown path for string output when no outputMode hint is declared', () => {
+ specState.spec = null; // e.g. spec not yet served / non-CLI node
+ renderWithProviders(
+ <OutputPanel
+ results={makeResult({ operation: 'custom', success: true, stdout: GH_TABLE })}
+ selectedNode={NODE}
+ />,
+ );
+ expect(screen.getByTestId('markdown')).toBeTruthy();
+ expect(screen.queryByTestId('terminal-output')).toBeNull();
+ });
+
+ it('routes terminal stdout that is wholly JSON to the tree viewer', () => {
+ specState.spec = { uiHints: { outputMode: 'terminal' } };
+ renderWithProviders(
+ <OutputPanel
+ results={makeResult({ operation: 'custom', success: true, stdout: '[{"login": "octocat"}]' })}
+ selectedNode={NODE}
+ />,
+ );
+ const views = screen.getAllByTestId('json-view');
+ expect(views.some(v => v.textContent?.includes('octocat'))).toBe(true);
+ expect(screen.queryByTestId('terminal-output')).toBeNull();
+ });
+
+ it('surfaces a parsed array `result` payload in the Response section', () => {
+ specState.spec = { uiHints: { outputMode: 'terminal' } };
+ renderWithProviders(
+ <OutputPanel
+ results={makeResult({ operation: 'pr_list', success: true, result: [{ number: 42 }] })}
+ selectedNode={NODE}
+ />,
+ );
+ const views = screen.getAllByTestId('json-view');
+ expect(views.some(v => v.textContent?.includes('42'))).toBe(true);
+ });
+});
diff --git a/client/src/components/output/OutputPanel.tsx b/client/src/components/output/OutputPanel.tsx
index 2407b35e..1194db8d 100644
--- a/client/src/components/output/OutputPanel.tsx
+++ b/client/src/components/output/OutputPanel.tsx
@@ -197,6 +197,7 @@ export default function OutputPanel({ results, onClear, selectedNode }: Props) {
// never markdown — `#` would become headings and indentation
// would collapse (gh/vercel tables, clone progress).
<pre
+ data-testid="terminal-output"
className="overflow-auto rounded-md border p-3 font-mono text-sm whitespace-pre-wrap break-words"
style={TERMINAL_STYLE}
>
diff --git a/docs-internal/credentials_panel.md b/docs-internal/credentials_panel.md
index 5cca188f..906ab818 100644
--- a/docs-internal/credentials_panel.md
+++ b/docs-internal/credentials_panel.md
@@ -304,6 +304,12 @@ Usage panels (`Usage & Costs`, `API Usage`, model constraints) fetch inside `use
The "Refresh" buttons in OAuth panels (Twitter/Google/Telegram) explicitly call the corresponding status request handler to force a re-check, which in turn re-broadcasts.
+### 3.6 Device-flow verification code (CLI-managed providers)
+When an oauth-kind provider's `ws.login` response carries a `verification_code` (OAuth device flows: GitHub via `gh auth login --web`, Vercel), `useCredentialPanel.oauthLogin` captures it into transient state (reset on provider switch / logout) and `OAuthConnect` renders it prominently in the info box — large monospace, letter-spaced, `select-all` — alongside opening `url` in a new tab. GitHub's `github.com/login/device` page cannot pre-fill the code, so this display is load-bearing there. Generic: any provider returning `{success, url, verification_code}` gets it for free.
+
+### 3.7 Login gating on required fields only
+`OAuthConnect` disables the Login button via `hasRequiredFields && !stored` where `hasRequiredFields = config.fields?.some(f => f.required)`. Required fields (Google/Twitter client creds, Telegram bot token) gate Login as prerequisites; optional fields (Vercel's `vercel_token`) are an *alternative* auth path and never block it. Fieldless CLI-managed providers (Stripe, GitHub) always have Login enabled.
+
---
## 4. Backend Contract
diff --git a/docs-internal/frontend_architecture.md b/docs-internal/frontend_architecture.md
index 716124fe..eb7a5cdf 100644
--- a/docs-internal/frontend_architecture.md
+++ b/docs-internal/frontend_architecture.md
@@ -418,7 +418,7 @@ Wave 2 introduced two typed fields on `INodeTypeDescription` so panels and the i
### `uiHints` — per-node panel visibility flags
-Defined on `INodeTypeDescription.uiHints` ([client/src/types/INodeProperties.ts](../client/src/types/INodeProperties.ts)). Each flag is consumed by exactly one panel and defaults to `false` (the panel renders normally). 15 flags today:
+Defined on `INodeTypeDescription.uiHints` ([client/src/types/INodeProperties.ts](../client/src/types/INodeProperties.ts)). Each flag is consumed by exactly one panel and defaults to off (the panel renders normally). The current set (live list = the `known` set in `test_node_spec.py`):
| Flag | Read by | Effect |
|---|---|---|
@@ -436,6 +436,7 @@ Defined on `INodeTypeDescription.uiHints` ([client/src/types/INodeProperties.ts]
| `isConsoleSink` | `ConsolePanel` | This node consumes console output (filter source) |
| `hasSkills` | Agent panels | Connect the connected-skills section |
| `isConfigNode` | `InputSection`, `OutputPanel` | This node is auxiliary configuration — its panel inherits the parent's main inputs instead of showing direct upstream connections. **Auto-derived on the backend** by `_derive_auto_ui_hints` in [`server/services/plugin/base.py`](../server/services/plugin/base.py): plugins whose `group` tuple contains `memory` or `tool` get this for free. Explicit `cls.ui_hints` always wins. |
+| `outputMode: "terminal"` | `output/OutputPanel` | The node's textual output is CLI/terminal text: render it in a `<pre>` painted with the per-theme `--code-*` tokens instead of ReactMarkdown (which turns `#` into headings and collapses indentation). Strings that are wholly JSON route to the JSON tree via the shared `tryParseJson` helper. Declared by the CLI-wrapper plugins (`githubAction`, `vercelAction`, `shell`). |
Adding new panel behaviour: add a flag to `INodeUIHints`, annotate the relevant node definitions (or extend the auto-derivation rule on the backend), read the flag in the panel. Don't add another `nodeDefinition.name === '…'` branch — six such checks for `'masterSkill'` were retired in this round in favour of `uiHints.isMasterSkillEditor`. Pytest invariant `test_ui_hints_only_carry_known_flags` in `server/tests/test_node_spec.py` locks the flag set; new flags must be added there too.
diff --git a/docs-internal/github_service.md b/docs-internal/github_service.md
index 48122782..79811b56 100644
--- a/docs-internal/github_service.md
+++ b/docs-internal/github_service.md
@@ -30,7 +30,7 @@ strictly. MachinaOs never stores, reads, or injects a token:
| File | Role |
|---|---|
| `__init__.py` | `register_ws_handlers(WS_HANDLERS)` + `register_output_schema("githubAction", …)`; node auto-registers on import |
-| `github_action.py` | `GitHubActionNode(ActionNode)`, `usable_as_tool=True`, `tool_name="github"`, gmail-style multi-`@Operation` dispatch; `_run` = `ensure_gh_cli()` → `run_cli_command(env=gh_env(), cwd=…)` → non-zero exit → `NodeUserError` (stderr tail) |
+| `github_action.py` | `GitHubActionNode(ActionNode)`, `usable_as_tool=True`, `tool_name="github"`, gmail-style multi-`@Operation` dispatch; `_run` = `ensure_gh_cli()` → `run_cli_command(env=gh_env(), cwd=…)` → non-zero exit → `NodeUserError` (stderr tail). `ui_hints = {"outputMode": "terminal"}` — the Output panel renders textual output preformatted, parsed `--json` payloads as a tree; `_shape` omits empty keys and never ships raw stdout alongside a parsed `result` |
| `_handlers.py` | `github_login` / `github_logout` / `github_status`; login-banner parser; marker + broadcast helpers |
| `_service.py` | `gh_env()` (automation baseline: `GH_PROMPT_DISABLED=1`, `NO_COLOR=1`, `GH_NO_UPDATE_NOTIFIER=1`, `GH_PAGER=cat`), `login_env()` (see below), `resolve_gh_light()` (no-download binary probe), `cli_logged_in()` (`gh auth status` exit 0), `resolve_repo_path()` (workspace-relative cwd, vercel idiom) |
| `_install.py` | `ensure_gh_cli()` — **project-local, pooch-driven** (mirrors `services/temporal/_install.py`, the repo's shared binary-fetch pattern): pinned release extracted under `package_dir("gh")` via `pooch.retrieve` (caching + Unzip/Untar handled by the library). The system-global gh is never consulted; gh's user-level config/credential-store is shared either way, so terminal `gh auth login` sessions remain visible. Note gh's `macOS`-capitalized zip assets |
diff --git a/docs-internal/node_creation.md b/docs-internal/node_creation.md
index 99069bc4..3c8e2c43 100644
--- a/docs-internal/node_creation.md
+++ b/docs-internal/node_creation.md
@@ -156,6 +156,16 @@ browser-OAuth" plugin lands as a self-contained folder under
`server/config/credential_providers.json` and zero touches outside
the folder.
+**Output display for CLI nodes**: declare
+`ui_hints = {"outputMode": "terminal"}` so the Output panel renders
+the node's textual output preformatted (never ReactMarkdown — `#`
+would become headings and indentation would collapse), and follow the
+`_shape` convention: parsed JSON goes in `result`, human text in
+`stdout` — never both (pre-stringified duplication violates the
+output contract) — with empty keys omitted. Reference:
+`githubAction` / `vercelAction` / `shell`; the panel side is locked by
+`client/src/components/__tests__/OutputPanel.test.tsx`.
+
**Device-flow variant (Vercel).** Not every CLI exposes Stripe's
machine-friendly two-step (`--non-interactive` → `--complete <url>`).
`vercel login` is a single **blocking** OAuth device flow: it prints a
diff --git a/docs-internal/node_panels.md b/docs-internal/node_panels.md
index c3045fc2..6710aaad 100644
--- a/docs-internal/node_panels.md
+++ b/docs-internal/node_panels.md
@@ -124,6 +124,18 @@ The WebSocket result is folded in at the front (newest-first) **only when** its
isn't already present in `executionResults` (deduplicated via `JSON.stringify`). Statuses other
than `success`/`error` (e.g. `running`) are ignored.
+Rendering lives in [client/src/components/output/OutputPanel.tsx](../client/src/components/output/OutputPanel.tsx)
+(the active renderer — `ui/OutputDisplayPanel.tsx` is legacy and unimported). The Response
+section picks, in order: `response` / `output` / `text` / `content` (prose keys), then an
+object-typed `result` (the canonical payload key CLI nodes fill with server-side-parsed JSON —
+arrays survive `unwrap` un-peeled and surface here), then `stdout`. Objects/arrays render in the
+themed `@uiw/react-json-view` tree. Strings render through ReactMarkdown **unless** the node's
+NodeSpec declares `uiHints.outputMode = "terminal"` (CLI-wrapper plugins: `githubAction`,
+`vercelAction`, `shell`) — then they render preformatted in a `<pre>` on the per-theme
+`--code-*` surface, with wholly-JSON strings detected via the shared `tryParseJson`
+(`utils/formatters.ts`) and routed to the tree instead. The panel resolves the spec via
+`useNodeSpec(selectedNode?.type)` — backend owns display logic, no node-name checks.
+
## 7. Refactor Invariants
Locked in by the test suite at:
diff --git a/docs-internal/plugin_system.md b/docs-internal/plugin_system.md
index d5aeb062..b655c567 100644
--- a/docs-internal/plugin_system.md
+++ b/docs-internal/plugin_system.md
@@ -71,7 +71,7 @@ class SpecializedAgentBase(ActionNode, abstract=True):
| `group` | Tuple of palette groupings (first is primary). |
| `component_kind` | Frontend dispatch: `square` / `trigger` / `agent` / `tool` / `model` / `start` / `generic`. |
| `handles` | React Flow handle topology (`input-main`, `output-main`, …). |
-| `ui_hints` | Dict of panel flags (`hasCodeEditor`, `isMemoryPanel`, `isMasterSkillEditor`, `isToolPanel`, `hasSkills`, `isConfigNode`, …). See "Auto-derived uiHints" below — `isConfigNode` is set automatically for `('memory', 'tool')` group plugins. |
+| `ui_hints` | Dict of panel flags (`hasCodeEditor`, `isMemoryPanel`, `isMasterSkillEditor`, `isToolPanel`, `hasSkills`, `isConfigNode`, `outputMode: "terminal"` for CLI-wrapper nodes whose textual output must render preformatted, …). See "Auto-derived uiHints" below — `isConfigNode` is set automatically for `('memory', 'tool')` group plugins. Live flag list = the `known` set in `test_node_spec.py`. |
| `annotations` | Pipedream-style: `destructive` / `readonly` / `open_world`. |
| `credentials` | Tuple of `Credential` subclasses the node uses. |
| `Params` | Pydantic `BaseModel` — user-facing parameters. Used for both UI rendering and AI tool schemas. |
diff --git a/docs-internal/vercel_service.md b/docs-internal/vercel_service.md
index f4f2e236..463aa051 100644
--- a/docs-internal/vercel_service.md
+++ b/docs-internal/vercel_service.md
@@ -52,8 +52,11 @@ Either path is sufficient; the token wins when both exist.
outlive the handler, draining both pipes for the process lifetime
so the CLI never blocks on a full pipe buffer. The first
code-embedding URL is returned as `{success, url,
- verification_code}` — the frontend only opens `url`
- (`useCredentialPanel.oauthLogin`), so the URL must carry the code.
+ verification_code}` — the frontend opens `url` AND renders
+ `verification_code` prominently in the modal's info box
+ (`useCredentialPanel.oauthLogin` → `OAuthConnect`, the generic
+ device-flow display shipped with the GitHub plugin; prefer a
+ code-embedding URL anyway so the user rarely needs to type it).
A background task (strong-ref'd — asyncio holds only weak refs)
awaits process exit; the success gate is **`auth.json` mtime
advanced past the pre-login snapshot AND `is_logged_in()`** (exit
@@ -105,6 +108,13 @@ auth="oauth2"`, which produces the credential envelope + the
→ `NodeUserError` carrying the stderr tail (user/LLM-correctable, one
WARN line, no traceback).
+Output shaping: `_shape` never ships raw stdout alongside a
+server-side-parsed JSON `result` (pre-stringified duplication violates
+the output contract) and omits empty keys entirely (`exclude_unset`
+preserves the producer's key set). The node declares
+`ui_hints = {"outputMode": "terminal"}` so the Output panel renders
+its textual output preformatted instead of through ReactMarkdown.
+
**First-deploy project guard**: an unlinked deploy (no `project`
param, no `.vercel/project.json` in the cwd, no `VERCEL_PROJECT_ID`,
no `--project` in `extra_args`) raises a `NodeUserError` up front with