Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
docs: catch up on outputMode / verification-code context + lock panel routing with render tests
trohitga0d428f7191d
diff --git a/CLAUDE.md b/CLAUDE.mdindex 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.tsxnew file mode 100644index 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.tsxindex 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.mdindex 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 `useThe "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 Contractdiff --git a/docs-internal/frontend_architecture.md b/docs-internal/frontend_architecture.mdindex 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.mdindex 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.mdindex 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 outsidethe 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'smachine-friendly two-step (`--non-interactive` → `--complete <url>`).`vercel login` is a single **blocking** OAuth device flow: it prints adiff --git a/docs-internal/node_panels.md b/docs-internal/node_panels.mdindex 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** itsisn't already present in `executionResults` (deduplicated via `JSON.stringify`). Statuses otherthan `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 InvariantsLocked in by the test suite at:diff --git a/docs-internal/plugin_system.md b/docs-internal/plugin_system.mdindex 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.mdindex 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 lifetimeso the CLI never blocks on a full pipe buffer. The firstcode-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` mtimeadvanced 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, oneWARN 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