Transport Layer

The transport layer provides a unified IPC abstraction so the same frontend code works in both Tauri (native desktop) and browser (HTTP) modes.

Files

File	Purpose
`src/invoke.ts`	Smart `invoke()` wrapper — zero overhead in Tauri
`src/transport.ts`	HTTP transport implementation and command-to-endpoint mapping

invoke.ts

export function invoke<T>(cmd: string, args?: Record<string, unknown>): Promise<T>
export function listen<T>(event: string, handler: (event: Event<T>) => void): Promise<Unsubscribe>

Resolution: At module import time, detects if running in Tauri webview:

Tauri mode: Delegates directly to @tauri-apps/api/core.invoke() (zero overhead)
Browser mode: Maps command to HTTP endpoint via transport.ts

Concurrent identical calls for read-only commands in DEDUP_COMMANDS share a single IPC round-trip — the second caller gets the same Promise as the first, cleared on settle. Prevents the repo-changed fan-out storm where ~20 mounted components each spawned parallel git processes for the same repo. Mutations (stage/commit/push) are never deduped. Browser mode has the equivalent via isIdempotentRpc in transport.ts.

export function isTauri(): boolean
// Checks window.__TAURI__ existence

transport.ts

Command Mapping

Maps every Tauri command name to an HTTP method + path via a declarative COMMAND_TABLE. Each entry is a CommandTableEntry — an object { map } whose map(args, p) returns { method, path, body?, transform? }.

// Table-driven: each command maps to an HTTP request
const COMMAND_TABLE: Record<string, CommandTableEntry> = {
  create_pty: { map: (args) => ({ method: "POST", path: "/sessions", body: args.config }) },
  get_repo_info: { map: (args) => ({ method: "GET", path: `/repo/info?path=${enc(args.path)}` }) },
  write_pty: { map: (args) => ({ method: "POST", path: `/sessions/${args.sessionId}/write`, body: { data: args.data } }) },
  // ... ~80 commands
};

This replaces the previous 370-line switch statement with a flat lookup table for easier maintenance and review.

PTY Subscription

export function subscribePty(
  sessionId: string,
  onData: PtyDataHandler,
  onExit: PtyExitHandler
): Unsubscribe

Tauri mode: Uses listen("pty-output") and listen("pty-exit") Tauri events
Browser mode: Opens WebSocket to /sessions/{id}/stream

URL Building

export function buildHttpUrl(path: string): string
// Reads MCP port from config, builds http://localhost:{port}{path}

Design

The transport abstraction enables:

Development: Run frontend with pnpm dev against the Rust HTTP server
Browser mode: Access TUICommander from a browser on another device
Testing: Frontend tests can mock at the invoke level
MCP integration: External tools use the same HTTP API

The abstraction is resolved once at module load — no per-call overhead in production Tauri mode.

Keyboard shortcuts