Skip to content

Self-improving AI Employees for everyone

build: move to stable TypeScript 7 and React Compiler 1.0.0

trohitg82355659e970
diff --git a/.github/workflows/predeploy.yml b/.github/workflows/predeploy.yml
index 3a799033..39fd62e7 100644
--- a/.github/workflows/predeploy.yml
+++ b/.github/workflows/predeploy.yml
@@ -68,6 +68,14 @@ jobs:
- uses: ./.github/actions/setup
- run: pnpm run build
+ # The TS7 compiler is a per-platform Go binary delivered through
+ # optionalDependencies. The type-check gate runs on ubuntu only, so
+ # without this the darwin-arm64 and win32-x64 binaries are installed
+ # on every matrix run and never executed — a broken one would pass CI
+ # and surface on a developer machine instead.
+ - name: TypeScript binary resolves on this platform
+ run: pnpm exec tsc --version
+
- name: Test start (Unix)
if: runner.os != 'Windows'
shell: bash
diff --git a/CLAUDE.md b/CLAUDE.md
index ab4689f8..a2218648 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -34,11 +34,11 @@ This is a React Flow-based workflow automation platform implementing n8n-inspire
| **[Google Cloud Service](./docs-internal/gcloud_service.md)** | Google Cloud CLI integration — `gcloudAction` (auth/config/projects + set_project / Compute Engine instances list-start-stop-describe / Cloud Run deploy-list-describe / Cloud Storage ls-cp-rm / `custom` passthrough; AI tool `gcloud`) wrapping the official gcloud CLI (pinned versioned archive via pooch into `package_dir("gcloud")` — NOT npm; the Windows bundled-python zip keeps the legacy `google-cloud-sdk-` filename prefix, the `-cli-` spelling 404s, locked by test). Cloudflare login variant (CLI opens the browser itself, random loopback port — no fixed-port hazard) + the gh marker-token pattern; success gate = `gcloud auth list --filter=status:ACTIVE --format=json` non-empty (exit codes never trusted). **Config isolation divergence from gh**: every invocation pins `CLOUDSDK_CONFIG=<DATA_DIR>/gcloud/`, so terminal logins against the operator's global gcloud are deliberately NOT visible to the node. ADC note: node login mints gcloud USER creds only (CLI commands never read ADC); client-library code gets ADC via the `custom` op `auth application-default login` (lands isolated in the pinned dir). Cold install ~100 MB → login answers `pending: True` within the 22 s WS budget. Provider id `gcloud` is orthogonal to the Workspace `google` OAuth2 provider. Palette group `deployment`. |
| **[Sarvam AI Service](./docs-internal/sarvam_service.md)** | Sarvam AI (Indic-first). **`nodes/sarvam/` no longer exists** — every capability it served is now a *provider* inside an abstracted node: speech in `nodes/speech/`, and translate / transliterate / detect-language in `nodes/translate/`. What remains Sarvam-specific is `sarvamChatModel` (an **OpenAI-compat provider**: one `_COMPAT_PROVIDERS` entry + a JSON block, no provider subclass) under `nodes/model/`. **One stored key spans two auth styles** — the chat route takes `Authorization: Bearer` (what the openai SDK sends) while every other endpoint takes only `api-subscription-key`, so `SarvamCredential` declares the native header and every surface shares it. Introduces the generic **`supports_model_listing: false`** flag: Sarvam ships no `/v1/models` route, and unhandled that 404 becomes a `NodeUserError` that `AIService.fetch_models` re-raises *before* its curated fallback, breaking key validation and the model dropdown — so `OpenAIProvider.fetch_models` serves the curated list and probes with a one-token completion instead (defaults `true`; the other 12 providers are untouched, locked by test). Also added generic **`Connection.request(files=)`** multipart support. |
| **[Speech Provider RFC](./docs-internal/speech_provider_rfc.md)** | Provider-abstracted speech — two nodes (`textToSpeech`, `speechToText`) with a `provider` dropdown, backed by **two registries, one per direction** (registry membership IS the capability: a synthesis-only vendor simply never appears in the transcription enum). Everything vendor-specific lives in the plugin folder [`server/nodes/speech/`](./server/nodes/speech/) — protocol, registries, dispatch, per-vendor modules; only the generic `services/provider_registry.py` and the vendor-neutral `services/media/` are shared. v1 providers: OpenAI (both directions), ElevenLabs (TTS), Deepgram + Groq (STT), Sarvam (both). Capabilities are JSON (`server/config/speech_defaults.json`) with per-model overrides, so no shared code branches on a provider name. **Audio never travels as bytes** — nodes return an `AudioRef` (a ~400 B reference) because a 12 MB base64 result blows Temporal's 2 MiB blob limit and retries 3× re-billing the provider each time. Backing routes: `GET/POST /api/workspace/{workflow_id}/…` in [`routers/workspace.py`](./server/routers/workspace.py). |
-| **[Media Transport](./docs-internal/media_transport.md)** | How files move through the engine, and why they move as **references rather than bytes**. `services/media/` — `AudioRef` (~400 B, `extra="forbid"` so adding a bytes field is a `ValidationError` rather than a silent regression), `write_audio` / `resolve_media` / `coerce_file_param` (the one nodes should call — accepts an `AudioRef`, a bare path, or the legacy base64 envelope), `inspect_audio` (tinytag → stdlib `wave` → PCM arithmetic, **never raises**), and `limits.py`. Containment runs through `resolve_within`, which closed a live vulnerability: a node joined a user path onto the workspace root unchecked, so `audio_file="../../credentials.db"` read the encrypted credential store and uploaded it. **The id/slug asymmetry is the trap** — workspace dirs are named by the mutable `Workflow.slug` while an `AudioRef` stores the immutable `workflow_id` so refs survive rename; `workspace_root()` raises rather than guessing, and the HTTP route owns the lookup. HTTP surface in [`routers/workspace.py`](./server/routers/workspace.py): Range support comes free from Starlette's `FileResponse`, and only `audio/ image/ video/` render inline — `text/html` and `image/svg+xml` are forced to `attachment` because `shell` / `fileDownloader` / `fileModify` can write arbitrary files into a workspace. |
+| **[Media Transport](./docs-internal/media_transport.md)** | How files move through the engine, and why they move as **references rather than bytes**. `services/media/` — `FileRef` (the base; `FileKind = file\|audio\|image\|video\|document`) with `AudioRef(FileRef)` as the probed-container narrowing (~400 B, `extra="forbid"` so adding a bytes field is a `ValidationError` rather than a silent regression), `write_audio` / `resolve_media` / `coerce_file_param` (the one nodes should call — accepts a `FileRef`/`AudioRef`, a bare path, or the legacy base64 envelope), `inspect_audio` (tinytag → stdlib `wave` → PCM arithmetic, **never raises**), `limits.py`, and **`preview.py` — the single owner of the inline-vs-attachment rule**, with two consumers: `routers/workspace.py` picks its `Content-Disposition` from `serves_inline`, and the gallery listing sets each row's `preview` from `preview_kind`, so the panel can never offer a preview the route refuses to serve. Containment runs through `resolve_within`, which closed a live vulnerability: a node joined a user path onto the workspace root unchecked, so `audio_file="../../credentials.db"` read the encrypted credential store and uploaded it. **The id/slug asymmetry is the trap** — workspace dirs are named by the mutable `Workflow.slug` while a ref stores the immutable `workflow_id` so refs survive rename; the lookup lives in [`services/workspace_locator.py`](./server/services/workspace_locator.py) (`resolve_workspace_root(..., allow_default=)`), and **every mutating caller must pass `allow_default=False`** or an unresolvable id silently lands the write in the shared anonymous workspace. HTTP surface in [`routers/workspace.py`](./server/routers/workspace.py): Range support comes free from Starlette's `FileResponse`; `NEVER_INLINE` is `{image/svg+xml, text/html, text/xml, application/xhtml+xml}` because `shell` / `fileDownloader` / `fileModify` can write arbitrary files into a workspace. |
| **[Translate / Transliterate / Detect](./docs-internal/speech_provider_rfc.md#8-what-this-pattern-should-absorb-next)** | The second application of the multi-vendor pattern, and the one that retired `nodes/sarvam/`. Three nodes (`translateText`, `transliterateText`, `detectLanguage`) in [`server/nodes/translate/`](./server/nodes/translate/), backed by **three registries — one per capability**, because the asymmetry is sharper than speech's: DeepL translates and does nothing else, while Sarvam and LLM-backed providers do all three. Membership makes an unsupported selection unrepresentable rather than a runtime failure inside a paid call. Providers: **deepl** (`Authorization: DeepL-Auth-Key`, `text` is an array, free keys ending `:fx` route to a different host, and it returns `billed_characters` so cost is the provider's own figure), **sarvam** (all three over dedicated REST), **openai** (all three via `ChatUnifier` — proves the Protocol does not care what a provider does internally; billing deliberately NOT recorded because that path bills tokens the LLM layer already costs). Capabilities in `server/config/translate_defaults.json`. |
| **[CI/CD Pipeline](./docs-internal/ci_cd.md)** | GitHub Actions workflows, predeploy validation, release publishing, and composite setup action |
| **[Performance](./docs-internal/performance.md)** | Cold-start measurements (Application startup complete 2.90 s warm, 21.5 s cold post-`company clean` — was 71 s before the 2026-07-14 boot-delay fixes; first WS connect 8.29 s) + warm and cold per-phase timelines + optimisation history (lazy LangChain imports, lazy LLM-SDK exception refs, esbuild sidecar bundle, bytecode-at-build, PartySocket reconnect, TanStack Query auth bootstrap, `manualChunks`, Vite dep-cache preservation, off-loop Temporal build-id hash) + bottleneck inventory + reproduction commands + anti-patterns to never reintroduce (incl. eager SDK import at LLM provider registration, unconditional `.vite` wipe, synchronous `Worker()` on the event loop). Pairs with the build-time pipeline doc below. |
-| **[Release Build Pipeline](./docs-internal/release_build_pipeline.md)** | npm-distribution build pipeline: `tsgo` for type-check (5× faster than tsc), Vite `manualChunks` + `target: 'es2022'`, esbuild Node.js sidecar bundle (drops `tsx` interpreter cost), bytecode pre-compile in two halves — `[tool.uv] compile-bytecode = true` (uv sync compiles `.venv/` site-packages) + `python -m compileall` for project source (plain `.pyc`, **no `-O`** — per PEP 488 the non-`-O` runtimes never load `.opt-1.pyc`; excludes `.venv/`, `tests/`). Single source of truth for the bytecode-compile path list: `cli.commands.build.COMPILEALL_SOURCE_DIRS`. |
+| **[Release Build Pipeline](./docs-internal/release_build_pipeline.md)** | npm-distribution build pipeline: `typescript@7` (native Go compiler, exact-pinned in **root** devDependencies — client keeps `typescript@^5.x` because typescript-eslint's peer range excludes 6/7, and one manifest cannot declare `typescript` twice) for type-check, measured 5.9× faster than tsc 5.9.3 (820 ms vs 4830 ms); `pnpm --filter react-flow-client run typecheck` delegates up to the root gate, Vite `manualChunks` + `target: 'es2022'`, esbuild Node.js sidecar bundle (drops `tsx` interpreter cost), bytecode pre-compile in two halves — `[tool.uv] compile-bytecode = true` (uv sync compiles `.venv/` site-packages) + `python -m compileall` for project source (plain `.pyc`, **no `-O`** — per PEP 488 the non-`-O` runtimes never load `.opt-1.pyc`; excludes `.venv/`, `tests/`). Single source of truth for the bytecode-compile path list: `cli.commands.build.COMPILEALL_SOURCE_DIRS`. |
| **[Workflow Schema](./docs-internal/workflow-schema.md)** | JSON schema for workflows, edge handle conventions, config node architecture |
| **[Execution Engine Design](./docs-internal/DESIGN.md)** | Architecture patterns, design standards, and implementation details for the workflow execution engine |
| **[Execution Roadmap](./docs-internal/ROADMAP.md)** | Implementation status, completed phases, and pending features |
@@ -130,7 +130,15 @@ server/services/
├── email_service.py # EmailService orchestrator (credential resolution, provider presets)
├── todo_service.py # TodoService singleton for writeTodos tool (JSON per-session state)
├── media/ # Media transport — vendor-neutral, kind-agnostic (see media_transport.md)
-│ ├── refs.py # AudioRef — a reference, never bytes; extra="forbid" makes that structural
+│ ├── refs.py # FileRef (base; FileKind = file|audio|image|video|document)
+│ │ # + AudioRef(FileRef), the probed-container narrowing.
+│ │ # A reference, never bytes; extra="forbid" makes that structural.
+│ │ # kind="audio" ASSERTS inspect_audio ran — never guess it.
+│ ├── preview.py # Single owner of the inline-vs-attachment rule (serves_inline /
+│ │ # preview_kind). TWO consumers: routers/workspace.py picks the
+│ │ # Content-Disposition, the gallery listing sets each row's
+│ │ # `preview`. One function, so the panel can never offer a preview
+│ │ # the route refuses to serve inline.
│ ├── workspace.py # write_audio / resolve_media / read_media_bytes / coerce_file_param
│ ├── inspect.py # tinytag -> wave -> PCM arithmetic; NEVER raises
│ └── limits.py # every size constant, each annotated with what it defends against
@@ -570,6 +578,7 @@ Backend endpoints serve SVGs at `GET /api/schemas/nodes/<type>/icon` (plugin ico
### Core Types
- `src/types/INodeProperties.ts` - Core interfaces for n8n-inspired node properties system
- `src/types/NodeTypes.ts` - Legacy compatibility types (NodeParameter, NodeOutput)
+- `src/types/workspaceFiles.ts` - Wire types for the gallery / workspace file explorer (`WorkspaceEntry`, `WorkspaceFileRef`, `FILE_REF_KINDS`, `isWorkspaceFileRef`, `WORKSPACE_FILE_DRAG_TYPE`). Declarations only — it documents which decisions are server-owned and must not be re-derived client-side
### Node System
Node metadata is SSOT on the backend after Wave 11. Each node is a Python
@@ -594,6 +603,7 @@ authoring model.
- `src/components/parameterPanel/MiddleSection.tsx` - Parameter panel middle section with conditional display logic
- `src/components/output/OutputPanel.tsx` - Connected node output display with drag mapping
- `src/components/LocationParameterPanel.tsx` - Location-specific parameter handling
+- `src/components/parameterPanel/GalleryPanel.tsx` - Workspace file explorer for the `gallery` node (`isGalleryPanel` uiHint); supporting parts in `parameterPanel/gallery/` (`FilePreviewDialog`, `FileGlyph`, `fileIcons`)
- `src/components/AIAgentNode.tsx` - Spec-driven agent canvas component. Reads `useNodeSpec(type)` for handles / icon / colour / displayName / uiHints; renders any plugin whose backend `component_kind` is `"agent"` or `"chat"`. No `AGENT_CONFIGS` map.
- `src/ParameterPanel.tsx` - Main parameter configuration modal
@@ -613,7 +623,8 @@ AI model nodes route through `SquareNode` via `Dashboard.tsx`'s `COMPONENT_BY_KI
- `src/hooks/useApiKeys.ts` - API key management via WebSocket
- `src/hooks/useAndroidOperations.ts` - Android device operations via WebSocket
- `src/hooks/useWhatsApp.ts` - WhatsApp operations via WebSocket
-- `src/hooks/useDragAndDrop.ts` - Drag-and-drop functionality
+- `src/hooks/useDragAndDrop.ts` - Drag-and-drop functionality (palette → canvas, `application/reactflow`)
+- `src/hooks/useDragWorkspaceFile.ts` - Drag a workspace file onto another node's parameter (`workspaceFile` payload); mirrors `useDragVariable`'s dual-MIME contract — `application/json` for the structured payload, `text/plain` for the bare path
- `src/hooks/useComponentPalette.ts` - Component palette state with localStorage persistence
- `src/store/useAppStore.ts` - Zustand application state with localStorage persistence for UI settings
@@ -635,7 +646,7 @@ The project uses WebSocket as the primary communication method between frontend
### Node Catalogue (collapsed)
-> The authoritative, per-node reference is the backend plugin registry plus the per-node "logic-flow" cards under [docs-internal/node-logic-flows/](./docs-internal/node-logic-flows/) (one card per node, grouped by category, with handles / params / outputs / side-effects / edge-cases). Live node list = the plugin registry (one folder per node under `server/nodes/<group>/`, 131 node types today via `len(services.node_registry.NODE_METADATA)`; a bare `__init__.py` glob overcounts by also matching the group packages). Do NOT maintain a per-node catalogue here — it drifts on every plugin add.
+> The authoritative, per-node reference is the backend plugin registry plus the per-node "logic-flow" cards under [docs-internal/node-logic-flows/](./docs-internal/node-logic-flows/) (one card per node, grouped by category, with handles / params / outputs / side-effects / edge-cases). Live node list = the plugin registry (one folder per node under `server/nodes/<group>/`; read the total from `len(services.node_registry.NODE_METADATA)` rather than hardcoding it here — a bare `__init__.py` glob overcounts by also matching the group packages). Do NOT maintain a per-node catalogue here — it drifts on every plugin add.
Node groups (palette categories): agent, model, skill, tool, trigger, workflow, search, google, android, whatsapp, telegram, twitter, social, email, proxy, chat, scheduler, text, code, document, location, utility, browser, scraper, filesystem, stripe, vercel, github (palette group `vcs`), cloudflare and gcloud (palette group `deployment`), speech and translate (both palette group `language` — provider-abstracted `textToSpeech` / `speechToText` and `translateText` / `transliterateText` / `detectLanguage`; `nodes/sarvam/` was retired into them, and only `sarvamChatModel` under `nodes/model/` remains vendor-named). See [docs-internal/node-logic-flows/](./docs-internal/node-logic-flows/) for the card index.
@@ -674,9 +685,17 @@ Node groups (palette categories): agent, model, skill, tool, trigger, workflow,
- `GET /api/workspace/{workflow_id}/files/{path:path}` - Serve a file from a workflow's workspace.
Range/seeking comes free from Starlette's `FileResponse` (`206` / `Content-Range` / `If-Range` /
`416`) — do NOT wrap it in a `StreamingResponse`. Containment via `resolve_within`; 404 never 403
- (a distinct status would confirm what exists outside the workspace). Only `audio/ image/ video/`
- render inline — `text/html` and `image/svg+xml` are forced to `attachment`, because nodes can
- write arbitrary files into a workspace and inline markup from the app origin is stored XSS.
+ (a distinct status would confirm what exists outside the workspace). **The `Content-Disposition`
+ is not decided here** — it comes from `services.media.preview.serves_inline`, which the gallery
+ listing also reads (via `preview_kind`) so the panel never offers a preview the route refuses to
+ serve. Only `audio/ image/ video/` render inline; `NEVER_INLINE` is `{image/svg+xml, text/html,
+ text/xml, application/xhtml+xml}`, because nodes can write arbitrary files into a workspace and
+ inline markup from the app origin is stored XSS.
+- **Listing is a WebSocket command, not an HTTP route.** `list_workspace_files` (owned by the
+ gallery plugin) is the listing channel; these HTTP routes stay the *content* channel. The
+ consumer is the parameter panel, which already holds an authenticated socket with request
+ correlation — a second HTTP listing surface would mean a second auth path and a second error
+ envelope for no gain.
- `POST /api/workspace/{workflow_id}/uploads` - Streamed multipart upload (the first in the repo on
either side of the wire). Chunked read with a running total — `Content-Length` is never trusted —
413 past `MEDIA_MAX_UPLOAD_BYTES`. Returns an `AudioRef`, which `coerce_file_param` accepts.
@@ -685,7 +704,7 @@ Node groups (palette categories): agent, model, skill, tool, trigger, workflow,
[Media Transport](./docs-internal/media_transport.md).
#### Workflow Services (`server/services/workflow.py`)
-- Node execution dispatches every registered plugin via the `BaseNode` registry (one self-contained folder per node under `server/nodes/<group>/`; 131 node types today via `len(services.node_registry.NODE_METADATA)` — a bare `__init__.py` glob overcounts by also matching the group packages)
+- Node execution dispatches every registered plugin via the `BaseNode` registry (one self-contained folder per node under `server/nodes/<group>/`; live total via `len(services.node_registry.NODE_METADATA)` — do not hardcode it, and note a bare `__init__.py` glob overcounts by also matching the group packages)
- Parameter resolution and template variable substitution
- Result formatting and error handling
@@ -1031,7 +1050,7 @@ workspace_base_dir: str = Field(default="workspaces", env="WORKSPACE_BASE_DIR")
- `workflow.py` creates the workspace dir and injects `workspace_dir` into the execution context. The dir name is the `workflow_slug` resolved from the DB (falls back to `"default"` for one-off Runs without a saved row).
- `fileDownloader` saves to `{workspace_dir}/downloads/` by default
- Code executors (Python/JS/TS) receive `workspace_dir` in their execution namespace
-- The `fileRead`, `fileModify`, `fsSearch`, and `shell` nodes use the native `WorkspaceBackend` rooted at `workspace_dir`; Coding Agent can invoke those nodes when they are connected as tools
+- The `fileRead`, `fileModify`, `fsSearch`, `shell` and `gallery` nodes use the native `WorkspaceBackend` rooted at `workspace_dir`; Coding Agent can invoke the first four when they are connected as tools. **`gallery` is deliberately `usable_as_tool = False`** — it carries destructive operations, and `fsSearch` + `fileModify` already cover what an agent needs, so shipping an editor panel must not hand every agent a delete tool as a side effect
- `WorkspaceBackend` resolves and validates paths beneath that root, rejects traversal and symlink escapes, and uses per-path locks plus atomic replacement for writes
- Rename follows the workflow: when the user renames a workflow, `save_workflow` recomputes the slug and `os.rename`s the workspace dir to match (existing files preserved).
@@ -1157,8 +1176,12 @@ Full reference — agent loop, skill injection, tool building, input/auto-prompt
# Development server test
curl -I http://localhost:${PYTHON_BACKEND_PORT:-5678}
-# TypeScript validation
-npx tsc --noEmit
+# TypeScript validation — the gate is TypeScript 7 (native Go) at the REPO ROOT.
+pnpm run typecheck # root: tsc --noEmit -p client/tsconfig.json
+pnpm --filter react-flow-client run typecheck # what CI runs; delegates up to the same gate
+# NOT `npx tsc --noEmit` — there is no root tsconfig.json.
+# NOT client's `typecheck:tsc` — that resolves [email protected], kept only because
+# typescript-eslint's peer range excludes 6/7. It is a second opinion, not the gate.
# Build verification
npm run build
@@ -2686,8 +2709,9 @@ This function:
- **Execution correlation IDs**: `handle_execute_node` issues a `uuid4().hex` token at request entry, propagates it through every `node_status` / `node_output` broadcast for the run, and returns it in the response payload as `execution_id`. Frontend `ExecutionResult.executionId` carries it; `OutputSection` dedups runs by it instead of `JSON.stringify(outputs)` (which collapsed distinct executions whose payloads matched). Same trace-id pattern as OpenTelemetry / HTTP request ids.
- **`clear_node_status` idle reset**: `StatusBroadcaster.clear_node_status(node_id)` resets the slot to `{status: "idle", data: {}, cleared: true}` instead of `del`'ing it. Deleting created a race window where the in-flight execution's `success` broadcast re-created the entry and stuck the UI on "completed" for a cancelled node. Idle reset preserves entry identity so subsequent broadcasts update normally; the `cleared: true` flag distinguishes "never ran" from "explicitly cleared."
- **`get_node_output` race**: in-memory `_outputs` cache re-population after a DB-fallback `await` previously overwrote a fresh in-memory write with a stale DB value. Fix uses nested `dict.setdefault` (atomic at the CPython GIL level -- no lock needed). `store_node_output` and `clear_all_outputs` had no real race because asyncio coroutines do not preempt at synchronous statements. Reference for the Python concurrency model: https://docs.python.org/3/library/asyncio-task.html#asyncio-await
-- **`NodeUserError` (services.plugin)**: typed exception for user/LLM-correctable failures (string not found, command not found, bad cwd, missing required field, operator-only Twitter query, Python sandbox `import`, Node.js sidecar down). `BaseNode.execute()` catches it specifically: single WARN line in the operator log (no traceback) + structured `{success: False, error_type: "NodeUserError", error: ...}` envelope. Genuine bugs still flow through the generic `except Exception` branch and keep their full stacktrace via `logger.exception`. Adopted across `fileRead` / `fileModify` / `fsSearch` / `process_manager` / `pythonExecutor` / `javascriptExecutor` / `typescriptExecutor`. Reach for it whenever the LLM (or user) can fix the input and retry — never for actual server bugs.
+- **`NodeUserError` (services.plugin)**: typed exception for user/LLM-correctable failures (string not found, command not found, bad cwd, missing required field, operator-only Twitter query, Python sandbox `import`, Node.js sidecar down). `BaseNode.execute()` catches it specifically: single WARN line in the operator log (no traceback) + structured `{success: False, error_type: "NodeUserError", error: ...}` envelope. Genuine bugs still flow through the generic `except Exception` branch and keep their full stacktrace via `logger.exception`. Adopted across `fileRead` / `fileModify` / `fsSearch` / `gallery` / `process_manager` / `pythonExecutor` / `javascriptExecutor` / `typescriptExecutor`. **Plugin WS handlers that can fail user-correctably must use `@ws_response` (from `services.plugin.ws`), not `@ws_handler`** — the latter logs every exception at ERROR with a full traceback, which breaks the one-WARN-line `NodeUserError` contract. `gallery/_handlers.py` is the reference. Reach for it whenever the LLM (or user) can fix the input and retry — never for actual server bugs.
- **Process manager Windows shim resolution**: `process_service.start()` resolves `argv[0]` via `shutil.which()` before `asyncio.create_subprocess_exec`. On Windows, `shutil.which` honours `PATHEXT` and returns the absolute `.cmd` path (e.g. `C:\...\npm.cmd`); `CreateProcessW` then launches it directly. No `cmd /c` wrap — same canonical idiom used by `browser_service`, `claude_code_service`, `claude_oauth`, `himalaya_service`. Without this, bare `argv[0]="npm"` raises `WinError 2` because `CreateProcessW` does NOT apply `PATHEXT` to bare names. Missing binary → early `Command not found: '<bin>'. Check spelling or ensure the binary is on PATH.` envelope (no traceback).
+- **Gallery — the workspace file explorer (`gallery`, `nodes/filesystem/gallery/`)**: sibling of the process-manager pattern below — the `isGalleryPanel` uiHint gives it a full-height MiddleSection panel (breadcrumbs, grid/list, image thumbnails, search, preview, upload) instead of the plain params list. It pairs the hint with `hideInputSection` but **keeps** the Output section, because unlike `processManager` it produces output worth seeing and dragging. Four rules worth knowing before touching it: (1) **The panel edits the node's own params** — navigating writes `path`, pinning writes `selection` — so what you browse is what the node emits, rather than a second copy of that state free to drift. (2) **The backend decides; the panel renders.** Each listing row arrives with a finished `ref` (a serialized `FileRef`, `null` for directories) and a `preview` verdict from `services/media/preview.py`; breadcrumbs arrive as `crumbs`; a search term is turned into a glob by `search_to_pattern` server-side. Re-deriving any of these client-side would be a second copy of a server rule — and for `preview` specifically, a second copy of a *security* decision. (3) **Drag uses its own `workspaceFile` discriminator, never the existing `nodeOutput`** — that branch calls `onChange(value)` unconditionally, so reusing it would mean dropping a file into a half-written prompt destroys the prompt. `ParameterRenderer.handleDrop` therefore branches: a `file` param takes the ref whole, everything else appends the path with smart spacing. (4) **`isFileRef` accepts every `FileKind`, not just `audio`** — the gallery emits `kind: "file"` even for a `.wav`, because `kind: "audio"` asserts `inspect_audio` probed the container and a fabricated duration would mis-bill a per-second provider downstream; narrowing the check back would render a dropped file as raw JSON. Listing rides the WebSocket (`list_workspace_files`) because the consumer already holds an authenticated socket with request correlation; `GET /api/workspace/{id}/files/{path}` stays the *content* channel (preview, download, Range). Frontend: [GalleryPanel.tsx](./client/src/components/parameterPanel/GalleryPanel.tsx) + `parameterPanel/gallery/`, [useDragWorkspaceFile.ts](./client/src/hooks/useDragWorkspaceFile.ts), [types/workspaceFiles.ts](./client/src/types/workspaceFiles.ts).
- **Process manager port admission + middle panel**: server commands declare listener `ports` (with compatibility inference for `--port`, `-p`, `PORT`, and `*_PORT`). `ProcessService.start()` serializes admission, checks managed reservations plus OS TCP listeners, and returns structured `PORT_IN_USE` without killing the owner or allowing framework auto-port fallback. Explicit ports/environment survive restart. The `isProcessManagerPanel` UI hint gives only `processManager` a full-height workflow-scoped process table with PID/ports/timestamps/elapsed/output and stop/restart controls. See [docs-internal/process_manager.md](./docs-internal/process_manager.md).
- **Telegram message auto-split + caption spill**: the Bot API caps `sendMessage.text` at 4096 and media captions at 1024 (constants `_TG_TEXT_LIMIT` / `_TG_CAPTION_LIMIT` in `nodes/telegram/_service.py`; per https://core.telegram.org/bots/api). **Both limits are measured in UTF-16 code units, not characters** — an emoji costs 2 — so length goes through `_tg_len`, never `len()`. `_split_head` cuts one chunk at the cleanest paragraph → line → sentence → space boundary past the halfway mark, else hard-cuts; `_split_text` loops it. `send_message` chunks long text and threads each part under the previous (`reply_to_message_id` cascade), returning the first message's metadata + `parts` + `message_ids[]`. `_send_captioned_media` (used by `send_photo` / `send_document`) truncates an over-long caption at the cap and sends the remainder as a threaded reply with `disable_notification=True`, reporting `caption_truncated` + `follow_up_message_ids` — previously the whole send just failed with `BadRequest("Message caption is too long")`. **Ordering invariant: split the RAW body before `_resolve_body` runs markdown→HTML.** Splitting after conversion can separate a `<b>` from its closing tag, which Telegram rejects with "can't find end of the entity"; Telegram measures the cap against entity-parsed text, so truncating raw markdown is conservative. Locked by `tests/nodes/test_telegram_service.py`.
- **Telegram inbound content types**: `_format_message` extracts detail dicts for all 11 types via the `_CONTENT_PROBES` / `_DETAIL_EXTRACTORS` tables, plus a normalized `media` block (`kind` / `file_id` / `mime_type` / `file_name` / …) that downstream nodes read instead of branching per type; MIME and filename are synthesised where Telegram omits them. **Probe order is load-bearing**: Telegram sets `message.document` on animation messages too, so `animation` and `video_note` must be probed before `document` and `video` or every GIF classifies as a document. The trigger never downloads — media travels as a `file_id`, never bytes or base64, because node results are persisted, broadcast, and replayed into the LLM conversation every turn.
@@ -2722,5 +2746,5 @@ This function:
- **Multi-vendor nodes: one node, a `provider` dropdown, two registries.** `nodes/speech/` is the reference and the first multi-credential plugin in the repo (`credentials = (A, B, C)`; `ctx.connection(id)` is a dict lookup over that tuple). Four load-bearing rules. (1) **Imperative `@Operation` only** — the declarative `routing=` path resolves `credentials[0]` (`base.py:571`), so a routed op authenticates every provider with the first key in the tuple and `test_plugin_contract.py` would not catch it. (2) **Registry membership IS the capability** — one registry per direction, the node's provider enum literally *is* `tts_providers()`, so a synthesis-only vendor cannot be selected for transcription and there is no `supports_x` flag to keep honest. (3) **Capabilities live in JSON** (`server/config/speech_defaults.json`), per-model overrides resolved exact -> longest-prefix -> `_default`, boolean flags defaulting **permissive**; no shared code branches on a vendor name. (4) **Vendor divergence stays in the vendor module** — auth scheme, query-vs-body, response shape. The v1 set diverges on all three axes and three of those divergences fail *silently* (ElevenLabs ignores a body-placed `output_format`, Deepgram ignores body options entirely, Sarvam returns a base64 array), so each has a test asserting the outgoing request rather than the parsed result. Full reference: **[Speech Provider RFC](./docs-internal/speech_provider_rfc.md)** + [plugin_system.md -> Multi-credential nodes](./docs-internal/plugin_system.md#multi-credential-nodes).
- **Never name a Params field `model` or `api_key` on a node that also has a `provider` field.** An effect at [`ParameterRenderer.tsx:866`](./client/src/components/ParameterRenderer.tsx#L866) keys on those two literal names: with a sibling `provider` field present it overwrites `model` with the *chat-model* list and clears `api_key` — and it never validates that the provider is an LLM provider, so `provider: "elevenlabs"` still triggers it and the field is wiped the moment the user picks a vendor. Line 930 also writes options onto the literal string `'model'`, not `parameter.name`. Prefix instead (`tts_model` / `stt_model`), locked by a test in `tests/nodes/test_speech.py`. Other reserved sibling names with name-based magic in that file: `parameters`, `message_type`, `group_id`, `group_name`, `channel_jid`, `sender_number`, `sender_name`, `session_id`, `service_id`, `action`.
- **`usable_as_tool = True` auto-hides both canvas handles.** `base.py:215` sets `hide_input_handle` / `hide_output_handle` to `True` unless the class declares them, so a dual-purpose node that must stay wirable has to declare both `False` explicitly. Symptom: the node works fine as an AI tool but cannot be connected to anything on the canvas.
-- **Media leaves a node as a reference, never as bytes.** `services/media/` + `AudioRef` (~400 B, `extra="forbid"`). A node result is persisted 3x, broadcast 2x, retained in `_status` forever, aggregated into the workflow result, copied into every downstream activity *input*, and — if `usable_as_tool` — serialized into an LLM message; a 12 MB base64 payload therefore fails the activity, **retries 3x re-billing the provider each time**, and reports a generic error. Nodes call `write_audio` (out) and `coerce_file_param` (in); both enforce containment through `resolve_within`, which closed a live traversal that let `audio_file="../../credentials.db"` read the encrypted credential store and upload it. **id/slug trap:** workspace dirs are named by the mutable `Workflow.slug` while an `AudioRef` stores the immutable `workflow_id` so refs survive rename — `workspace_root()` raises rather than composing a wrong path, and `routers/workspace.py` owns the lookup because it needs the DB. Full reference: **[Media Transport](./docs-internal/media_transport.md)**.
+- **Media leaves a node as a reference, never as bytes.** `services/media/` + `FileRef` (~400 B, `extra="forbid"`) with `AudioRef(FileRef)` as the probed-container narrowing — set `kind="audio"` only when the duration actually came from `inspect_audio`, because a fabricated one silently mis-bills per-second providers; the `gallery` node therefore emits `kind="file"` even for a `.wav`. A node result is persisted 3x, broadcast 2x, retained in `_status` forever, aggregated into the workflow result, copied into every downstream activity *input*, and — if `usable_as_tool` — serialized into an LLM message; a 12 MB base64 payload therefore fails the activity, **retries 3x re-billing the provider each time**, and reports a generic error. Nodes call `write_audio` (out) and `coerce_file_param` (in); both enforce containment through `resolve_within`, which closed a live traversal that let `audio_file="../../credentials.db"` read the encrypted credential store and upload it. **id/slug trap:** workspace dirs are named by the mutable `Workflow.slug` while a ref stores the immutable `workflow_id` so refs survive rename — `workspace_root()` raises rather than composing a wrong path, and the lookup now lives in `services/workspace_locator.py`, which every database-holding caller delegates to (the HTTP route, the gallery WS handlers, `WorkflowService`). Reads may fall back to the anonymous `"default"` workspace; **mutating callers must pass `allow_default=False`**, or a stale tab's unresolvable id destroys files in a different context than the caller believes. Full reference: **[Media Transport](./docs-internal/media_transport.md)**.
- never use emojis in prints
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 98cb10e7..b8d693a0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -132,7 +132,8 @@ pnpm install # install workspace dependencies
pnpm run dev # start the app (Vite HMR + backend; Temporal starts from the backend when TEMPORAL_ENABLED, WhatsApp only on demand)
pnpm run stop # stop everything
pnpm run build # production build
-pnpm exec tsc --noEmit # typecheck client (from client/)
+pnpm --filter react-flow-client run typecheck # THE gate: TypeScript 7 (native Go). Same command CI runs.
+pnpm --filter react-flow-client run typecheck:tsc # second opinion under tsc 5.9 — for triaging a red gate, not a substitute
uv run pytest # run backend tests (from server/, uv-managed venv)
```
@@ -183,7 +184,7 @@ Full setup and scripts reference: [SETUP.md](docs-internal/SETUP.md) - [SCRIPTS.
| [authentication.md](docs-internal/authentication.md) | JWT/cookie auth — modes, middleware, frontend bootstrap |
| [errors.md](docs-internal/errors.md) | Known errors and troubleshooting |
| [performance.md](docs-internal/performance.md) | Cold-start measurements, optimisation history, anti-patterns |
-| [release_build_pipeline.md](docs-internal/release_build_pipeline.md) | npm-distribution build pipeline (tsgo, esbuild sidecar, bytecode) |
+| [release_build_pipeline.md](docs-internal/release_build_pipeline.md) | npm-distribution build pipeline (TypeScript 7 native-Go type-check, esbuild sidecar, bytecode) |
| [Skill Creation Guide](server/skills/GUIDE.md) | How to create new skills |
## Community
diff --git a/cli/tests/test_release_pipeline_config.py b/cli/tests/test_release_pipeline_config.py
index dfdaff42..291f6db4 100644
--- a/cli/tests/test_release_pipeline_config.py
+++ b/cli/tests/test_release_pipeline_config.py
@@ -200,34 +200,79 @@ def test_sidecar_dist_is_gitignored(sidecar_dir: Path):
# ---------------------------------------------------------------------------
-def test_client_typecheck_uses_tsgo(client_pkg: dict):
- """The fast type-check (``pnpm run typecheck``) goes through tsgo
- (Microsoft's Go-port of tsc, ~5x faster). The slower tsc fallback
- stays available as ``typecheck:tsc`` in case tsgo regresses on a
- dev release.
+def test_client_typecheck_delegates_to_the_root_gate(
+ client_pkg: dict, root_pkg: dict
+):
+ """The type-check gate runs TypeScript 7 (the native Go compiler),
+ which lives at the ROOT rather than in the client.
+
+ Placement is forced, not stylistic: ``client`` already depends on
+ ``typescript@^5.9.3`` (typescript-eslint needs the JS API), and one
+ manifest cannot declare the same package twice. Worse, ``typescript``
+ 7 and 5 both ship a ``tsc`` bin, so co-locating them would let pnpm's
+ bin-link conflict resolution decide which compiler gates CI.
+
+ The client script therefore delegates upward, which keeps the CI
+ command (``pnpm --filter react-flow-client run typecheck``) and its
+ guard below unchanged.
"""
- scripts = client_pkg["scripts"]
+ assert client_pkg["scripts"].get("typecheck") == "pnpm -w run typecheck", (
+ "client typecheck must delegate to the root gate, got "
+ f"{client_pkg['scripts'].get('typecheck')!r}"
+ )
assert (
- scripts.get("typecheck") == "tsgo --noEmit"
- ), f"client typecheck must be tsgo, got {scripts.get('typecheck')!r}"
- assert scripts.get("typecheck:tsc") == "tsc --noEmit", (
- "tsc fallback (typecheck:tsc) must remain available so a tsgo "
- "regression has a one-line revert path"
+ root_pkg["scripts"].get("typecheck") == "tsc --noEmit -p client/tsconfig.json"
+ ), f"root typecheck must run TS7 against the client project, got {root_pkg['scripts'].get('typecheck')!r}"
+ assert client_pkg["scripts"].get("typecheck:tsc") == "tsc --noEmit", (
+ "typecheck:tsc must remain available as a TS 5.9 SECOND OPINION for "
+ "triaging a red gate (is this my code, or a known typescript-go bug?). "
+ "It is NOT an equivalent check and NOT a revert path: the two "
+ "compilers check different programs under different default rules, "
+ "and no CI lane proves this script still passes."
)
-def test_tsgo_devdependency_is_pinned_exactly(client_pkg: dict):
- """tsgo ships breaking changes between dev releases. A ``^`` or
- ``~`` range would silently shift the type-check gate on each
- install. Pin the exact version so upgrades are explicit.
+def test_typescript_is_pinned_exactly_at_the_root(root_pkg: dict):
+ """The compiler that gates CI must never move on an unrelated install.
+
+ An exact pin makes a compiler change an explicit, reviewable commit.
"""
- version = client_pkg.get("devDependencies", {}).get("@typescript/native-preview")
- assert (
- version is not None
- ), "@typescript/native-preview must be in client devDependencies"
+ version = root_pkg.get("devDependencies", {}).get("typescript")
+ assert version is not None, "typescript must be in ROOT devDependencies"
assert not version.startswith(
("^", "~", ">=", ">", "<")
- ), f"tsgo must be pinned exactly (no range prefix), got {version!r}"
+ ), f"the gate compiler must be pinned exactly (no range prefix), got {version!r}"
+ assert version.startswith("7."), (
+ f"the gate must run TypeScript 7 (the native Go compiler), got {version!r}"
+ )
+
+
+def test_dead_native_preview_channel_does_not_creep_back(client_pkg: dict):
+ """``@typescript/native-preview`` shipped the Go compiler before it
+ landed in mainline ``typescript``. That channel stopped publishing at
+ the 7.0 GA (last build 2026-07-07) and its bin is ``tsgo``, not
+ ``tsc`` — so a reinstall of it would silently fork the gate.
+ """
+ assert "@typescript/native-preview" not in client_pkg.get("devDependencies", {}), (
+ "@typescript/native-preview is a dead channel superseded by "
+ "typescript@7 — the native compiler now ships in the mainline package"
+ )
+
+
+def test_client_keeps_typescript_5_for_typescript_eslint(client_pkg: dict):
+ """Do NOT 'clean this up' by unifying on one TypeScript.
+
+ ``typescript-eslint`` loads the TypeScript API at module scope and
+ declares a peer range that excludes 6.x and 7.x. With
+ ``strict-peer-dependencies=true`` in .npmrc, bumping this is not a
+ warning — it is a hard ``pnpm install`` failure, and CI installs with
+ ``--frozen-lockfile``.
+ """
+ version = client_pkg.get("dependencies", {}).get("typescript")
+ assert version is not None and version.startswith("^5."), (
+ "client must keep typescript ^5.x for typescript-eslint's peer range; "
+ f"got {version!r}"
+ )
@pytest.mark.parametrize(
@@ -344,10 +389,10 @@ def _step_by_name(job: dict, step_name: str) -> dict | None:
def test_predeploy_typecheck_step_routes_through_pnpm_script(predeploy_yml: dict):
- """The CI typecheck step must invoke the npm script (which routes
- through tsgo) rather than calling ``tsc`` directly. Keeps the
- fast-vs-fallback choice in one place — ``client/package.json`` —
- so devs can swap tools without editing the workflow.
+ """The CI typecheck step must invoke the npm script (which delegates
+ up to the root TypeScript 7 gate) rather than calling ``tsc``
+ directly. Keeps the compiler choice in one place — the ROOT
+ ``package.json`` — so it can change without editing the workflow.
"""
job = predeploy_yml["jobs"]["build-and-lint"]
step = _step_by_name(job, "TypeScript check")
@@ -361,7 +406,7 @@ def test_predeploy_typecheck_step_routes_through_pnpm_script(predeploy_yml: dict
), f"predeploy.yml typecheck step must filter to {CLIENT_PKG_NAME}, got {cmd!r}"
assert "tsc --noEmit" not in cmd, (
"predeploy.yml still calls `tsc --noEmit` directly — switch to "
- "the typecheck script so tsgo is used"
+ "the typecheck script so the root TypeScript 7 gate is used"
)
diff --git a/client/package.json b/client/package.json
index 9896881b..ea247dc1 100644
--- a/client/package.json
+++ b/client/package.json
@@ -8,7 +8,7 @@
"build": "vite build",
"lint": "eslint .",
"preview": "vite preview",
- "typecheck": "tsgo --noEmit",
+ "typecheck": "pnpm -w run typecheck",
"typecheck:tsc": "tsc --noEmit",
"test": "vitest run",
"test:watch": "vitest",
@@ -87,9 +87,8 @@
"@testing-library/react": "^16.3.2",
"@testing-library/user-event": "^14.6.1",
"@typescript-eslint/parser": "^8.65.0",
- "@typescript/native-preview": "7.0.0-dev.20260504.1",
"@vitest/coverage-v8": "^4.1.8",
- "babel-plugin-react-compiler": "19.1.0-rc.3",
+ "babel-plugin-react-compiler": "1.0.0",
"jsdom": "^25.0.1",
"rollup-plugin-visualizer": "^7.0.1",
"typescript-eslint": "^8.65.0",
diff --git a/client/src/components/SkillEditorModal.tsx b/client/src/components/SkillEditorModal.tsx
index c9aae55e..ab9dfaf6 100644
--- a/client/src/components/SkillEditorModal.tsx
+++ b/client/src/components/SkillEditorModal.tsx
@@ -1,4 +1,7 @@
-/* eslint-disable react-hooks/incompatible-library -- react-compiler advisory only; no functional impact. */
+/* eslint-disable react-hooks/incompatible-library -- react-hook-form's watch()
+ cannot be memoized safely; the compiler (>= 1.0.0) skips this component
+ rather than miscompiling it, so the warning is advisory. Not true before
+ 1.0.0 — do not downgrade. */
import React, { useEffect } from 'react';
import { useForm } from 'react-hook-form';
import { zodResolver } from '@hookform/resolvers/zod';
diff --git a/client/src/components/__tests__/ConsolePanel.focus.test.tsx b/client/src/components/__tests__/ConsolePanel.focus.test.tsx
index e05334b1..e074eb6b 100644
--- a/client/src/components/__tests__/ConsolePanel.focus.test.tsx
+++ b/client/src/components/__tests__/ConsolePanel.focus.test.tsx
@@ -41,10 +41,12 @@ beforeAll(() => {
// Vitest's jsdom env normally provides rAF (pretendToBeVisual); polyfill
// defensively so the flush helper below always works.
if (typeof globalThis.requestAnimationFrame === 'undefined') {
- globalThis.requestAnimationFrame = ((cb: FrameRequestCallback) =>
- setTimeout(() => cb(performance.now()), 0)) as typeof requestAnimationFrame;
- globalThis.cancelAnimationFrame = ((id: number) =>
- clearTimeout(id)) as typeof cancelAnimationFrame;
+ // `window.setTimeout`, not the bare global: with @types/node in scope the
+ // bare one is typed `NodeJS.Timeout`, which does not convert to the
+ // `number` that rAF must return (TS2352 under tsc 5.x).
+ globalThis.requestAnimationFrame = (cb: FrameRequestCallback) =>
+ window.setTimeout(() => cb(performance.now()), 0);
+ globalThis.cancelAnimationFrame = (id: number) => window.clearTimeout(id);
}
});
diff --git a/client/src/components/credentials/panels/EmailPanel.tsx b/client/src/components/credentials/panels/EmailPanel.tsx
index 778b83a0..23c69e08 100644
--- a/client/src/components/credentials/panels/EmailPanel.tsx
+++ b/client/src/components/credentials/panels/EmailPanel.tsx
@@ -1,5 +1,10 @@
/* eslint-disable react-hooks/exhaustive-deps -- form bootstrap effect runs once on mount; deps intentionally curated. */
-/* eslint-disable react-hooks/incompatible-library -- react-compiler advisory only; no functional impact. */
+/* eslint-disable react-hooks/incompatible-library -- react-hook-form's watch()
+ returns a value the compiler cannot memoize safely. babel-plugin-react-compiler
+ >= 1.0.0 knows this and skips memoizing the component, so the warning is
+ advisory. That skip list did NOT exist before 1.0.0 (the repo sat on
+ 19.1.0-rc.3, where this suppression hid a real stale-render risk) — so do not
+ downgrade the compiler, and note semver sorts rc.3 ABOVE 1.0.0. */
/**
* EmailPanel — Himalaya IMAP/SMTP credentials.
*
diff --git a/client/src/components/credentials/sections/ProviderDefaultsSection.tsx b/client/src/components/credentials/sections/ProviderDefaultsSection.tsx
index e454fb76..70e133d2 100644
--- a/client/src/components/credentials/sections/ProviderDefaultsSection.tsx
+++ b/client/src/components/credentials/sections/ProviderDefaultsSection.tsx
@@ -1,5 +1,8 @@
/* eslint-disable react-hooks/exhaustive-deps -- form bootstrap effects run once on provider change; deps intentionally curated. */
-/* eslint-disable react-hooks/incompatible-library -- react-compiler advisory only; no functional impact. */
+/* eslint-disable react-hooks/incompatible-library -- react-hook-form's watch()
+ cannot be memoized safely; the compiler (>= 1.0.0) skips this component
+ rather than miscompiling it, so the warning is advisory. Not true before
+ 1.0.0 — do not downgrade. */
/**
* ProviderDefaultsSection — provider default LLM parameters.
*
diff --git a/client/src/components/credentials/sections/RateLimitSection.tsx b/client/src/components/credentials/sections/RateLimitSection.tsx
index 541607fa..dcab6001 100644
--- a/client/src/components/credentials/sections/RateLimitSection.tsx
+++ b/client/src/components/credentials/sections/RateLimitSection.tsx
@@ -1,4 +1,7 @@
-/* eslint-disable react-hooks/incompatible-library -- react-compiler advisory only; no functional impact. */
+/* eslint-disable react-hooks/incompatible-library -- react-hook-form's watch()
+ cannot be memoized safely; the compiler (>= 1.0.0) skips this component
+ rather than miscompiling it, so the warning is advisory. Not true before
+ 1.0.0 — do not downgrade. */
/**
* RateLimitSection — WhatsApp rate limit configuration.
*
diff --git a/docs-internal/ci_cd.md b/docs-internal/ci_cd.md
index b8c2f11a..2cb5b04d 100644
--- a/docs-internal/ci_cd.md
+++ b/docs-internal/ci_cd.md
@@ -168,4 +168,4 @@ The following existed in earlier drafts of this doc but are **not present in the
- **`rollback.yml`** — manual `npm deprecate` + optional revert PR.
- **`codeql.yml`** — Python + JS/TS SAST (`security-extended`).
- **`check-zizmor.yml`** — workflow-security linter (SARIF to the Security tab).
-- **`.pre-commit-config.yaml`** — ruff / prettier / eslint / actionlint hooks (note: the project rule is to verify with pytest + tsgo/eslint, not ruff).
+- **`.pre-commit-config.yaml`** — ruff / prettier / eslint / actionlint hooks (note: the project rule is to verify with pytest + the root `typecheck` gate + eslint, not ruff). This file is **not currently present in the tree**; the entry describes intent, not a live hook.
diff --git a/docs-internal/frontend_architecture.md b/docs-internal/frontend_architecture.md
index 3a0fc382..f5779e85 100644
--- a/docs-internal/frontend_architecture.md
+++ b/docs-internal/frontend_architecture.md
@@ -6,7 +6,7 @@ Post-migration (2026-04-14). Single source of truth for the current frontend.
## TL;DR
-- **React 19 + Vite 7 + TypeScript 5.9** with the **React Compiler** (`babel-plugin-react-compiler@19`, scoped to all of `src/` except `components/ui/`).
+- **React 19 + Vite 7**, type-checked by **TypeScript 7** (the native Go compiler, exact-pinned `7.0.2` in the **root** `devDependencies`). The client keeps `typescript@^5.9.3` only because typescript-eslint's peer range excludes 6/7 — it is not the gate. With the **React Compiler** (`[email protected]`, `target: '19'`, scoped to all of `src/` except `components/ui/`).
- **Tailwind v4** via `@tailwindcss/vite` + `@import "tailwindcss"` in [src/index.css](../client/src/index.css). Tokens defined in the same CSS file via `@theme inline` (no `tailwind.config.js` colors block).
- **shadcn/ui** via the canonical CLI (`npx shadcn@latest add`). All primitives live under [client/src/components/ui/](../client/src/components/ui/) as first-class repo files we can edit.
- **Radix UI** is the primitive engine shadcn uses (Dialog, Accordion, Select, Switch, Tabs, Tooltip, Popover, Dropdown, AlertDialog, Collapsible, Progress, Slider, Label, Checkbox).
@@ -22,7 +22,9 @@ Post-migration (2026-04-14). Single source of truth for the current frontend.
|---|---|---|
| Bundler | Vite 7 | [client/vite.config.js](../client/vite.config.js) |
| Framework | React 19 | [client/src/main.tsx](../client/src/main.tsx) |
-| Compiler | `[email protected]` | [vite.config.js](../client/vite.config.js) (scoped: all of `/src/` except `components/ui/`) |
+| Type checker | `[email protected]` — native Go compiler, **exact-pinned in the root `package.json`** | root `pnpm run typecheck` → `tsc --noEmit -p client/tsconfig.json`; client's `typecheck` delegates up |
+| Type checker (second opinion) | `typescript@^5.9.3` in **client** `dependencies` | Kept for typescript-eslint's peer range (`>=4.8.4 <6.1.0`). Two `typescript` entries cannot live in one manifest, and both 5.x and 7.x expose a `tsc` bin — hence the root/client split. `pnpm typecheck:tsc` runs it for triage only. |
+| Compiler | `[email protected]` (exact-pinned; `target: '19'` = the React version, not the plugin version) | [vite.config.js](../client/vite.config.js) (scoped: all of `/src/` except `components/ui/`). Pin is exact because semver sorts the old `19.1.0-rc.3` **above** `1.0.0`, so a range would silently reinstall the release candidate — which lacks the incompatible-library skip list. |
| Styling | Tailwind v4 + `@tailwindcss/vite` | [index.css](../client/src/index.css) + [tailwind.config.js](../client/tailwind.config.js) |
| Component library | shadcn/ui (CLI `npx shadcn@latest add`) | [components/ui/](../client/src/components/ui/) |
| Primitives | Radix UI | Pulled as transitive deps by shadcn |
@@ -501,6 +503,10 @@ Defined on `INodeTypeDescription.uiHints` ([client/src/types/INodeProperties.ts]
| `isMemoryPanel` | `MiddleSection` | Render the memory markdown panel + token usage stats |
| `isToolPanel` | `MiddleSection` | Surface the ToolSchemaEditor for connected services |
| `isMonitorPanel` | `MiddleSection`, `ParameterPanel` | Render the team-monitor panel |
+| `isTodoEditor` | `MiddleSection` | Render the editable Current Todos manager (`writeTodos`) instead of the plain params list |
+| `isTaskManagerPanel` | `MiddleSection` | Render the execution-scoped team task control panel |
+| `isProcessManagerPanel` | `MiddleSection` | Render live managed-process inspection and controls |
+| `isGalleryPanel` | `MiddleSection` | Render the workspace file browser (breadcrumbs, grid/list, search, preview, upload, drag-to-parameter) instead of the plain params list. Declared by `gallery`, which pairs it with `hideInputSection` but **keeps** the Output section — unlike `processManager` it produces output worth seeing and dragging. The panel writes back to the node's own `path` / `selection` params, so what you browse is what the node emits. |
| `showLocationPanel` | `LocationParameterPanel` | Special-case panel for nodes with map preview |
| `isAndroidToolkit` | `ToolSchemaEditor` | Toolkit aggregator (Android service hub) |
| `isChatTrigger` | `ConsolePanel` | This node is a chat-message target |
@@ -607,7 +613,8 @@ pnpm run build # full prod build; bundle analyzer at dist/stats.html if
cd client
pnpm dev # Vite dev server
pnpm build # Vite prod build (Tailwind v4 via @tailwindcss/vite plugin)
-pnpm exec tsc --noEmit # Typecheck
+pnpm typecheck # THE gate — delegates up to the root TypeScript 7 compiler
+pnpm typecheck:tsc # second opinion under client's tsc 5.9.3 (triage only, never the gate)
```
**Adding shadcn components:**
diff --git a/docs-internal/onboarding.md b/docs-internal/onboarding.md
index 4587e454..7e27e9a4 100644
--- a/docs-internal/onboarding.md
+++ b/docs-internal/onboarding.md
@@ -283,7 +283,7 @@ No new handlers were needed. The onboarding system reuses existing generic handl
7. **Existing user migration**: With existing `workflow.db` where `examples_loaded=1` -- onboarding does NOT appear
8. **Theme support**: Switch themes -- role-token cards and region tints adapt correctly
9. **Replay**: Open Settings, click "Replay Welcome Guide" -- wizard reopens from step 0
-10. **TypeScript**: `tsgo --noEmit` (or `npx tsc --noEmit`) passes clean
+10. **TypeScript**: `pnpm run typecheck` (root gate, TypeScript 7) passes clean
## Key Files
diff --git a/docs-internal/performance.md b/docs-internal/performance.md
index ffbaed97..0a4ef7b7 100644
--- a/docs-internal/performance.md
+++ b/docs-internal/performance.md
@@ -42,13 +42,25 @@ corresponding `start.log` measurement.
| Date | Change | Saved | Commit | Plan / RFC |
|---|---|---|---|---|
| 2026-05-04 | Lazy LangChain imports in `services/ai.py` (BaseMessage stays eager; everything else moves into local imports) | **~30 s** AIService cold import | `74b75b6` | inline plan |
-| 2026-05-05 | `tsgo` for client `--noEmit` typecheck (5× faster than `tsc`) | ~6 s in CI gate | `0b45fb1` | [release_build_pipeline.md](release_build_pipeline.md) |
+| 2026-05-05 | `tsgo` for client `--noEmit` typecheck | ~6 s in CI gate | `0b45fb1` | [release_build_pipeline.md](release_build_pipeline.md) |
| 2026-05-05 | Vite `manualChunks` (split reactflow / radix / lobehub-icons / TanStack Query / markdown stack) + `target: 'es2022'` | main bundle 232 KB gz, 7 vendor chunks separately cached | `0b45fb1` | same |
| 2026-05-05 | Pre-bundle Node.js sidecar with esbuild (`tsx src/index.ts` → `node dist/index.js`) | ~500 ms-1 s of tsx startup per server boot | `0b45fb1` | same |
| 2026-05-05 | Scoped `python -O -m compileall` over project source dirs (excludes `.venv/`, `tests/`) | 3-5 s on warm-disk imports | `0b45fb1` | same |
| 2026-05-05 | Test coverage: 12 build-orchestrator + 32 config-contract tests under `cli/tests/` | n/a (regression guard) | `0f1e55e` | same |
| 2026-05-06 | Frontend WS reconnect → PartySocket; auth bootstrap → TanStack Query; CloudEvents envelope typed | **~20 s** (eliminates +12 s WS drop + +7 s reconnect cycle on cold start) | `e77215c` | inline plan |
| 2026-07-14 | Boot-delay fix set: (1) lazy `"module:Class"` SDK exception refs on `ProviderSpec` (no SDK import at provider registration); (2) `[tool.uv] compile-bytecode = true` + `-O`-less compileall (bytecode compiled at build for the interpreter that actually runs); (3) Vite dep cache preserved across `company dev` boots (`--force` → `VITE_FORCE` → `optimizeDeps.force`) + `optimizeDeps.include` for heavy lazily-reached deps; (4) temporalio build-id hash pre-warmed off-loop via `asyncio.to_thread` | **~50 s** on post-clean cold boot (71 s → 21.5 s); ~7 s on warm boot (AIService import back to baseline); ~2 min of Vite re-optimize per warm dev boot; event loop no longer frozen ~3 s during Temporal worker start | this change | plan file `analyze-the-log-txt-file-eager-locket.md`; log evidence `log.txt` / `cold.txt` (2026-07-14) |
+| 2026-07-27 | TypeScript 7 GA (`[email protected]`, native Go) replaces the frozen `@typescript/native-preview` dev build; gate moves to the repo root | **820 ms vs 4830 ms** on the client `--noEmit` gate | this change | [release_build_pipeline.md](release_build_pipeline.md) |
+
+The 2026-07-27 row is the first **measured** figure for this gate — 3 warm runs of
+each compiler, best-of spread under 70 ms. It supersedes the "5×" that sat in the
+2026-05-05 row above and the "~10×" in `release_build_pipeline.md`; neither had a
+recorded baseline, a benchmark command, or a reproduction. Reproduce with:
+
+```bash
+cd client
+../node_modules/.bin/tsc --noEmit -p tsconfig.json # TS 7 (the gate)
+./node_modules/.bin/tsc --noEmit # TS 5.9.3 (second opinion)
+```
## Where launch time is spent today (post `e77215c`, warm cache)
diff --git a/docs-internal/release_build_pipeline.md b/docs-internal/release_build_pipeline.md
index 333150f9..8d7256a7 100644
--- a/docs-internal/release_build_pipeline.md
+++ b/docs-internal/release_build_pipeline.md
@@ -8,19 +8,45 @@ User scope (confirmed before this work): stay on npm distribution; **no** Nuitka
| Layer | Tool | Why |
|---|---|---|
-| TypeScript type-check | `@typescript/native-preview` (tsgo) | Microsoft's Go-port of `tsc`, ~10x faster on `--noEmit`. Type-check only — JS emit in tsgo is still preview. Vite/esbuild keep producing the actual JS bundles. Stays in `devDependencies`, never ships to users. |
+| TypeScript type-check | `typescript@7` (the native Go compiler) at the **repo root** | **5.9× faster** on `--noEmit` — measured 2026-07-26 on this codebase, 3 warm runs each: **~820 ms** vs **~4830 ms** under `tsc` 5.9.3. Type-check only; Vite/esbuild keep producing the actual JS bundles. Lives in root `devDependencies`, exact-pinned, never ships to users. |
| Vite output | `manualChunks` + `target: 'es2022'` | Split heavy libs (reactflow, radix-ui, lobehub, react-markdown stack) so the main bundle no longer hits the 1500KB warning ceiling. ES2022 unlocks `findLast` / optional-chaining-assignment without polyfills (Chrome 94+, FF 93+, Safari 15.4+ — within React 19 / Tailwind 4 baseline). |
| Node sidecar | `esbuild` bundle to `dist/index.js`, run via `node` | Drops tsx interpreter startup (~500ms-1s every server boot). `--packages=external` keeps Express in `node_modules/` for patch flow. |
| Python | `python -m compileall -q -j 0 <project dirs>` + `[tool.uv] compile-bytecode = true` | Pre-compile bytecode. Implemented as step `[5/6]` in [`cli/commands/build.py`](../cli/commands/build.py) (`COMPILEALL_SOURCE_DIRS` constant lists the dirs); `server/pyproject.toml`'s `compile-bytecode = true` makes `uv sync` (step `[4/6]`) compile `.venv/` site-packages too. No `-O`: every runtime launches python without `-O`, and per PEP 488 a non-optimized interpreter only loads plain `.pyc` — the earlier `-O` invocation produced `.opt-1.pyc` that nothing ever loaded (fixed 2026-07-14; ~30-50s cold-start gain, see [performance.md](performance.md)). |
## Implementation steps
-### 1. tsgo type-check
-
-- `client/package.json` → add `"@typescript/native-preview"` to `devDependencies`, add scripts:
- - `"typecheck": "tsgo --noEmit"`
- - `"typecheck:tsc": "tsc --noEmit"` (fallback during the rollout)
-- `.github/workflows/release.yml` → add `pnpm --filter react-flow-client run typecheck` to the predeploy gate before the build job.
+### 1. TypeScript 7 type-check
+
+The native Go compiler shipped inside mainline `typescript` at the 7.0 GA
+(2026-07-08). The old `@typescript/native-preview` channel — whose binary was
+named `tsgo` — stopped publishing the day before and must not come back.
+
+**The gate lives at the repo root, and that placement is forced, not stylistic:**
+
+- `client` already depends on `typescript@^5.9.3`, which typescript-eslint needs
+ (it loads the TS API at module scope and its peer range excludes 6.x/7.x). A
+ single manifest cannot declare `typescript` twice.
+- `typescript@7` and `typescript@5` **both** ship a `tsc` bin. Co-locating them
+ would leave pnpm's bin-link conflict resolution deciding which compiler gates
+ CI. (No collision exists today only because `native-preview`'s bin was `tsgo`.)
+- Root declares no `typescript` and no `typescript-eslint`, so there is no peer
+ conflict and nothing else claims `tsc`.
+
+- root `package.json` → `devDependencies: { "typescript": "7.0.2" }`, **exact —
+ no caret**, so the compiler that gates CI never moves on an unrelated install;
+ plus `"typecheck": "tsc --noEmit -p client/tsconfig.json"`
+- `client/package.json` → `"typecheck": "pnpm -w run typecheck"` (delegates up,
+ so the CI command and its guard test stay byte-identical)
+ - `"typecheck:tsc": "tsc --noEmit"` — resolves client's own 5.9.3. A **second
+ opinion for triaging a red gate**, NOT an equivalent check and NOT a revert
+ path: the two compilers check different programs under different default
+ rules. Nothing in CI runs it, so verify it independently before trusting it.
+- `.github/workflows/predeploy.yml` → `pnpm --filter react-flow-client run typecheck` in the
+ `build-and-lint` job. (This gate lives in `predeploy.yml`, not `release.yml`.) The cross-OS
+ `test-build-start` matrix additionally runs `pnpm exec tsc --version`, because the TS7
+ compiler is a per-platform Go binary delivered via `optionalDependencies` — the type-check
+ itself runs only on ubuntu, so without that step the darwin-arm64 and win32-x64 binaries
+ would be installed on every matrix run and never executed.
### 2. Vite manualChunks + target
@@ -97,14 +123,15 @@ Idempotent on re-runs (compileall only rewrites stale pyc; esbuild is determinis
| File | Action |
|---|---|
-| `client/package.json` | + tsgo devDep, + typecheck scripts |
+| root `package.json` | + `typescript@7` devDep (exact-pinned), + root `typecheck` script |
+| `client/package.json` | `typecheck` delegates to the root gate; keeps `typescript@^5.x` for typescript-eslint |
| `client/vite.config.js` | + manualChunks, target, lower warning |
| `server/nodejs/package.json` | + esbuild devDep, build script, change start |
| `server/nodejs/.gitignore` | new — ignore `dist/` |
| `cli/commands/build.py` | + compileall step (`[5/6]`, plain `.pyc` — no `-O`), `COMPILEALL_SOURCE_DIRS` constant |
| `scripts/install.js` | + sidecar bundle + compileall calls |
| `server/pyproject.toml` | `[tool.uv] compile-bytecode = true` — `uv sync` compiles `.venv/` site-packages |
-| `.github/workflows/release.yml` | + typecheck gate before build |
+| `.github/workflows/predeploy.yml` | + typecheck gate in `build-and-lint`; + `tsc --version` in the cross-OS matrix |
## Verification
diff --git a/package.json b/package.json
index 4eca0b55..167f05b9 100644
--- a/package.json
+++ b/package.json
@@ -94,6 +94,7 @@
"daemon:status": "python -m cli daemon status",
"daemon:restart": "python -m cli daemon restart",
"version:sync": "python -m cli version sync",
+ "typecheck": "tsc --noEmit -p client/tsconfig.json",
"prepublishOnly": "python -m cli version sync && node -e \"const p=require('./package.json'); if(!p.bin||!p.version){process.exit(1)}\"",
"preinstall": "node scripts/preinstall.js",
"postinstall": "node scripts/postinstall.js",
@@ -108,6 +109,9 @@
"lucide-react": "^1.14.0",
"three": "^0.184.0"
},
+ "devDependencies": {
+ "typescript": "7.0.2"
+ },
"pnpm": {
"peerDependencyRules": {
"allowedVersions": {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index bd7c8f64..3fe715c6 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -47,6 +47,10 @@ importers:
three:
specifier: ^0.184.0
version: 0.184.0
+ devDependencies:
+ typescript:
+ specifier: 7.0.2
+ version: 7.0.2
client:
dependencies:
@@ -228,15 +232,12 @@ importers:
'@typescript-eslint/parser':
specifier: ^8.65.0
- '@typescript/native-preview':
- specifier: 7.0.0-dev.20260504.1
- version: 7.0.0-dev.20260504.1
'@vitest/coverage-v8':
specifier: ^4.1.8
version: 4.1.8([email protected])
babel-plugin-react-compiler:
- specifier: 19.1.0-rc.3
- version: 19.1.0-rc.3
+ specifier: 1.0.0
+ version: 1.0.0
jsdom:
specifier: ^25.0.1
version: 25.0.1
@@ -2584,52 +2585,125 @@ packages:
resolution: {integrity: sha512-8C71BQkGjiMmXtop7pHVJu1l2NNShFdkCyD6a2ezzs5vU/L3LRtb69EtcteFwz0mYMPzIgOw0n6OV4VBUWZd7A==}
engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
- '@typescript/[email protected]':
- resolution: {integrity: sha512-+Qs1Q7Qxfp11n/hU3pweFU+EQ37FnDsdWOOxb7/vCy8QGBysrLUUYRhQ+GSW3s663oMtN6+9Kf82hk3ZT+kXlg==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-MTKKkWB7p/0E9xi1d1tHtZ5PiLkGEMIq88pK2CubZjOsLtYTLqhgIgi6zepFa+9GHZ6h05NMCkQxGKiPXMxXtQ==}
+ engines: {node: '>=16.20.0'}
+ cpu: [ppc64]
+ os: [aix]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-gowzar9MwS/aRWp6f3a4KUqzRjAZjOsmGNCM6LcTgXum+dBfgsBVMN+AgvOCCbguXyick6LJhpBszxMebJ8syA==}
engines: {node: '>=16.20.0'}
cpu: [arm64]
os: [darwin]
- '@typescript/[email protected]':
- resolution: {integrity: sha512-Wr3GWTRiMgibmhe88cjQ612ZyY7sbgsPYEaWKGPUxBaXtMHFIzgTBIoJMuaQqQx4GEJs6AUDyhnIHG1gx4rJjg==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-SZ9xZInqApNlNGc9s0W1VSsktYSOe9cFqNOIqmN1Gs8SmkjKZYFt017G4VwPxASInODuAdbTW7sXiFUf893RgA==}
engines: {node: '>=16.20.0'}
cpu: [x64]
os: [darwin]
- '@typescript/[email protected]':
- resolution: {integrity: sha512-y1Qai5l55Sl+/3B0hyQtvynq//C22BKFH3CfU35fbLYUo4P/ISUycyAbcA+PAPazpDFO3E56I96QUQrbJL2VVA==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-W5NH4y/J0plIIS5b2xvTEkU7JFxyqdMAOgf+Ilhl0vHQXKO5dZoxd+C/jEtq56c4F3wk71RB4BMRQ2XdI+bwYQ==}
+ engines: {node: '>=16.20.0'}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-UMGDx5sTpzNw3WiPebH7l90IWfJggEd+egHt/q6p7/Cm3zqoV7VxkGXt+3DxPIw8CcmvAB0j3sVVfbhX+M4Tpw==}
+ engines: {node: '>=16.20.0'}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-Qh4eU4/y3yDjnfjjyPYihMj5/ODIlmt+Bzu17OI+fiSRDW57QmU5SiN63exPRNJPKUzcc1INa1NXdrJ+MqHjUQ==}
engines: {node: '>=16.20.0'}
cpu: [arm64]
os: [linux]
- '@typescript/[email protected]':
- resolution: {integrity: sha512-s8QkhZe0M4QD2xhK1Xiy2JUQv1AOl8kUg5DLx1G8ws0f1BK/oKyqDNbxhZMGINYLFvkjpr9lOxt7qehSnpJMYQ==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-gffT3xPz9sR7j/YJExkyPntrI0P2EP9XbOyWzth2/Gs0RstK+90RBcO0ncXoXy/beYll1SXw846Nf2zdnEz0QQ==}
engines: {node: '>=16.20.0'}
cpu: [arm]
os: [linux]
- '@typescript/[email protected]':
- resolution: {integrity: sha512-ngN3Ie3Vin6pFtqeNywxm86RTxgI0Fo0GZyJ1PxokLES8J3xfMPtMYfv85c/+5uz5+7T+m4LRLyY5IoLY4gtuw==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-uEHck9i8hoAzXPiYRib1O7miOnz23SxIeVl6F4LXox+qov1K35jHcEW6VHKvZI+pyvl7fZEP4MCU5LYvIq1GuQ==}
+ engines: {node: '>=16.20.0'}
+ cpu: [loong64]
+ os: [linux]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-R4KvAMnE43W5Qeqb0Ly56O3mWMWIAgsMyz36DCaycd5nbg/9kzm0liw3JocfRqyJY0KPmzFjbswozXyW0DnIYA==}
+ engines: {node: '>=16.20.0'}
+ cpu: [mips64el]
+ os: [linux]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-DORx5b3sd/4S7eayxm4FQv+A7CrkUIGRaHiwI8oiHTAI1fAPWhF4J0vAlkC8biAlHSVVwxMQ3tjZ2/DVbnQiiA==}
+ engines: {node: '>=16.20.0'}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-wf0jqEDOjrPRnKwYRyyJDRo11KMbvMFrU+q4zqKyChODBzvlkbhNQfKvLxQCcwTpdDaXSHZTVuh0JoCrKCUMHQ==}
+ engines: {node: '>=16.20.0'}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-IkwJc3L7yhytWd/ewjyxNDfOmswCm9GWMJT/ue/dU4aZNbwZeYAetq42VyLmsmSjvoX7z74X6ZaYCtzAr0EuGw==}
+ engines: {node: '>=16.20.0'}
+ cpu: [s390x]
+ os: [linux]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-EYdf2cNg7rgCWJnxCdJ+F3V39O8ihb37eHAu1LK8oAFizgTQbPOK7zHHXbPt8rX24COqODXeI3sIf0fCXG7H/A==}
engines: {node: '>=16.20.0'}
cpu: [x64]
os: [linux]
- '@typescript/[email protected]':
- resolution: {integrity: sha512-/GZDJN/CsLbqIe7EdWDkXhNX9C41VjemBeUN6+9ckvEFLH8XyKTmXPYikNOn0N819M1KSeNZltplyUslfROOdw==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-+polYF4MF04aPpO5FTkHran9yUQDSXqy5GiSDKpsll5jy3l3+g9QLhpf39T+ePtefhXLOGrLl0QIjkQP6VnelA==}
engines: {node: '>=16.20.0'}
cpu: [arm64]
- os: [win32]
+ os: [netbsd]
- '@typescript/[email protected]':
- resolution: {integrity: sha512-EYQBdVZq4xIzhTtKxw6wvee9238hEb7XrPG413AEZBD3kcR3qqvPULXsPzQyEpneCReATSaihscP/LfhMQYUmA==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-8YIT0EHM/3dq10ZOVF/A7pc/YSMtbcecct4rWtexrnSCHOPcpC2KTLXfTCR6vDpnSiY12heNb1GiN/wu+T/FyA==}
engines: {node: '>=16.20.0'}
cpu: [x64]
+ os: [netbsd]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-APT8+ClYnuYm1u9+kgGXoMj2VzWzcymwh2gNSQVySHfkRDGOTVkoWLjCmOQSaO+PoqQ57B0flRp9SA+7GnnkzQ==}
+ engines: {node: '>=16.20.0'}
+ cpu: [arm64]
+ os: [openbsd]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-yX7s+Q0Dln0Dt9tEzZsAjXXR/+ytBM7AlglaqyeMPxQszJ1JhlJdZ6jLA+IzldHtflX81em7lDao1xXu+aRRkg==}
+ engines: {node: '>=16.20.0'}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-dLJDGaLZ1D4HPQn62u1n8mBDkJREwMsAkCdkwd4Ieqw+x3TUyTsqY0YiBCtE6H6OzzgGk3iuZ3vFWRS+E8/d1g==}
+ engines: {node: '>=16.20.0'}
+ cpu: [x64]
+ os: [sunos]
+
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-Gyl1Vy6OsWesLzmq+EP0Fb7b4Nid5232AvcA2SFcdYreldpNtYFFofPjnt62y9hQy7VTaZp65ICJjuAQRaVcIQ==}
+ engines: {node: '>=16.20.0'}
+ cpu: [arm64]
os: [win32]
- '@typescript/[email protected]':
- resolution: {integrity: sha512-bHFGxyIU83qjj6ywn3817A+Ug2ZID0GiBA5WFdbc/T7EjcrKnUUylexq0fU81N/mTbfw3FyP6ZCEdO2Ntcl/VQ==}
+ '@typescript/[email protected]':
+ resolution: {integrity: sha512-0BQ3HkAHHlKLSp1qRvf3SUhGpGsDuhB/jgFw75guyqbxJqEaS0Cw/VFO8i2nHglJUzQCRtMMR/IBAKE3ETMC4g==}
engines: {node: '>=16.20.0'}
- hasBin: true
+ cpu: [x64]
+ os: [win32]
resolution: {integrity: sha512-botRpQ5AgymYEsqXSdT2/1LefAJEYfMntvdnx1SqhTQCTW9HygeFZXx9inkYqUmiQZ3+0QlZnodjBvwnUfZhVA==}
@@ -2832,8 +2906,8 @@ packages:
peerDependencies:
'@babel/core': ^7.29.7
- resolution: {integrity: sha512-mjRn69WuTz4adL0bXGx8Rsyk1086zFJeKmes6aK0xPuK3aaXmDJdLHqwKKMrpm6KAI1MCoUK72d2VeqQbu8YIA==}
+ resolution: {integrity: sha512-Ixm8tFfoKKIPYdCCKYTsqv+Fd4IJ0DQqMyEimo+pxUOMUR9cVPlwTrFt9Avu+3cb6Zp3mAzl+t1MrG2fxxKsxw==}
resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
@@ -5917,6 +5991,11 @@ packages:
engines: {node: '>=14.17'}
hasBin: true
+ resolution: {integrity: sha512-8FYau96o3NKOhbjKi/qNvG/W5jhzxkbdm5sj9AbZ/5T5sWqn3hJgLfGx27sRKZWTvyzCP8dLRBTf5tBTSRVUNA==}
+ engines: {node: '>=16.20.0'}
+ hasBin: true
+
resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
@@ -6428,7 +6507,7 @@ snapshots:
dependencies:
- '@babel/types': 7.29.0
+ '@babel/types': 7.29.7
dependencies:
@@ -6531,7 +6610,7 @@ snapshots:
dependencies:
'@babel/traverse': 7.29.0
- '@babel/types': 7.29.0
+ '@babel/types': 7.29.7
transitivePeerDependencies:
- supports-color
@@ -6643,7 +6722,7 @@ snapshots:
'@babel/helper-globals': 7.28.0
'@babel/parser': 7.29.3
'@babel/template': 7.28.6
- '@babel/types': 7.29.0
+ '@babel/types': 7.29.7
debug: 4.4.3
transitivePeerDependencies:
- supports-color
@@ -8578,16 +8657,16 @@ snapshots:
dependencies:
- '@babel/types': 7.29.0
+ '@babel/types': 7.29.7
dependencies:
'@babel/parser': 7.29.3
- '@babel/types': 7.29.0
+ '@babel/types': 7.29.7
dependencies:
- '@babel/types': 7.29.0
+ '@babel/types': 7.29.7
dependencies:
@@ -8932,36 +9011,65 @@ snapshots:
'@typescript-eslint/types': 8.65.0
eslint-visitor-keys: 5.0.1
- '@typescript/[email protected]':
+ '@typescript/[email protected]':
optional: true
- '@typescript/[email protected]':
+ '@typescript/[email protected]':
optional: true
- '@typescript/[email protected]':
+ '@typescript/[email protected]':
optional: true
- '@typescript/[email protected]':
+ '@typescript/[email protected]':
optional: true
- '@typescript/[email protected]':
+ '@typescript/[email protected]':
optional: true
- '@typescript/[email protected]':
+ '@typescript/[email protected]':
optional: true
- '@typescript/[email protected]':
+ '@typescript/[email protected]':
optional: true
- '@typescript/[email protected]':
- optionalDependencies:
- '@typescript/native-preview-darwin-arm64': 7.0.0-dev.20260504.1
- '@typescript/native-preview-darwin-x64': 7.0.0-dev.20260504.1
- '@typescript/native-preview-linux-arm': 7.0.0-dev.20260504.1
- '@typescript/native-preview-linux-arm64': 7.0.0-dev.20260504.1
- '@typescript/native-preview-linux-x64': 7.0.0-dev.20260504.1
- '@typescript/native-preview-win32-arm64': 7.0.0-dev.20260504.1
- '@typescript/native-preview-win32-x64': 7.0.0-dev.20260504.1
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
+
+ '@typescript/[email protected]':
+ optional: true
dependencies:
@@ -9255,9 +9363,9 @@ snapshots:
transitivePeerDependencies:
- supports-color
dependencies:
- '@babel/types': 7.29.0
+ '@babel/types': 7.29.7
@@ -12980,6 +13088,29 @@ snapshots:
+ optionalDependencies:
+ '@typescript/typescript-aix-ppc64': 7.0.2
+ '@typescript/typescript-darwin-arm64': 7.0.2
+ '@typescript/typescript-darwin-x64': 7.0.2
+ '@typescript/typescript-freebsd-arm64': 7.0.2
+ '@typescript/typescript-freebsd-x64': 7.0.2
+ '@typescript/typescript-linux-arm': 7.0.2
+ '@typescript/typescript-linux-arm64': 7.0.2
+ '@typescript/typescript-linux-loong64': 7.0.2
+ '@typescript/typescript-linux-mips64el': 7.0.2
+ '@typescript/typescript-linux-ppc64': 7.0.2
+ '@typescript/typescript-linux-riscv64': 7.0.2
+ '@typescript/typescript-linux-s390x': 7.0.2
+ '@typescript/typescript-linux-x64': 7.0.2
+ '@typescript/typescript-netbsd-arm64': 7.0.2
+ '@typescript/typescript-netbsd-x64': 7.0.2
+ '@typescript/typescript-openbsd-arm64': 7.0.2
+ '@typescript/typescript-openbsd-x64': 7.0.2
+ '@typescript/typescript-sunos-x64': 7.0.2
+ '@typescript/typescript-win32-arm64': 7.0.2
+ '@typescript/typescript-win32-x64': 7.0.2
+