New application architecture

.github/workflows/ci.yml

@@ -17,7 +17,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.1.38
+          bun-version: 1.3.9
 
       - name: Cache Bun and Turbo
         uses: actions/cache@v4
@@ -40,3 +40,6 @@ jobs:
 
       - name: Test
         run: bun run test
+
+      - name: Smoke Test (t3 runtime)
+        run: bun run --cwd apps/t3 build && bun run smoke-test

.gitignore

@@ -5,7 +5,6 @@ node_modules
 *.log
 *.tsbuildinfo
 apps/*/dist
-apps/*/dist-electron
 packages/*/dist
 .env
 .env.local

.oxfmtrc.json

@@ -3,7 +3,6 @@
   "ignorePatterns": [
     ".plans",
     "dist",
-    "dist-electron",
     "node_modules",
     "bun.lock",
     "*.tsbuildinfo"

.oxlintrc.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./node_modules/oxlint/configuration_schema.json",
-  "ignorePatterns": ["dist", "dist-electron", "node_modules", "bun.lock", "*.tsbuildinfo"],
+  "ignorePatterns": ["dist", "node_modules", "bun.lock", "*.tsbuildinfo"],
   "plugins": ["eslint", "oxc", "react", "unicorn", "typescript"],
   "categories": {
     "correctness": "warn",

.plans/01-shared-model-normalization.md

@@ -5,7 +5,7 @@ Move model alias/default normalization into `packages/contracts` so desktop and
 
 ## Motivation
 - Removes duplicated logic between:
-  - `apps/desktop/src/codexAppServerManager.ts`
+  - `packages/runtime-core/src/codexAppServerManager.ts`
   - `apps/renderer/src/model-logic.ts`
 - Prevents behavior drift when model aliases/defaults are updated.
 
@@ -22,7 +22,7 @@ Move model alias/default normalization into `packages/contracts` so desktop and
    - `resolveModelSlug`
    - `DEFAULT_MODEL`
 2. Export model utilities from `packages/contracts/src/index.ts`.
-3. Update `apps/desktop/src/codexAppServerManager.ts` to replace local alias map/helper.
+3. Update `packages/runtime-core/src/codexAppServerManager.ts` to replace local alias map/helper.
 4. Update `apps/renderer/src/model-logic.ts` to wrap or re-export shared functions.
 5. Update tests:
    - Move/duplicate normalization tests to contracts.
@@ -38,5 +38,5 @@ Move model alias/default normalization into `packages/contracts` so desktop and
 - Manual check that model selection and session start still send expected model slug.
 
 ## Done Criteria
-- No duplicated alias/default map in desktop and renderer.
+- No duplicated alias/default map in runtime-core and renderer.
 - Shared model utilities are contract-tested.

.plans/02-typed-ipc-boundaries.md

@@ -1,37 +1,37 @@
-# Plan: Strengthen Typed IPC Boundaries in Main Process
+# Plan: Strengthen Typed WS RPC Boundaries in Runtime Server
 
 ## Summary
-Replace loose payload casting in IPC handlers with strict schema parsing and typed helper wrappers.
+Replace loose payload casting in runtime RPC handlers with strict schema parsing and typed helper wrappers.
 
 ## Motivation
-- `apps/desktop/src/main.ts` currently uses casts like `payload as Parameters<...>`.
+- `apps/t3/src/runtimeApiServer.ts` should avoid payload casts and parse all unknown input at the RPC boundary.
 - Casts can hide contract breakages until runtime.
 
 ## Scope
-- Desktop main process IPC registration.
-- Optional shared helper for handler registration.
+- Runtime WebSocket RPC registration and method dispatch.
+- Optional shared helper for method-level parse/dispatch registration.
 
 ## Proposed Changes
-1. Add IPC helper utility (e.g. `apps/desktop/src/ipcHelpers.ts`) to:
+1. Add RPC helper utility (e.g. `apps/t3/src/rpcHelpers.ts`) to:
    - Parse payload(s) with Zod schemas
    - Standardize typed handler signatures
-2. Refactor provider IPC handlers in `apps/desktop/src/main.ts` to use:
+2. Refactor provider RPC handlers in `apps/t3/src/runtimeApiServer.ts` to use:
    - `providerSessionStartInputSchema.parse`
    - `providerSendTurnInputSchema.parse`
    - `providerInterruptTurnInputSchema.parse`
    - `providerStopSessionInputSchema.parse`
-3. Apply same pattern to agent/terminal handlers where possible.
-4. Add tests for handler parsing failure paths (invalid payloads).
+3. Apply same pattern to app/todo/agent/terminal/shell handlers where possible.
+4. Add tests for parsing failure paths (invalid payloads).
 
 ## Risks
-- Refactor can subtly change IPC error shape/messages.
+- Refactor can subtly change RPC error shape/messages.
 - Helper abstraction should stay simple and not obscure control flow.
 
 ## Validation
 - `bun run test`
 - `bun run typecheck`
-- Manual invalid payload check from renderer/devtools to confirm fast failure.
+- Manual invalid payload check from websocket client/devtools to confirm fast failure.
 
 ## Done Criteria
-- No provider handler uses `payload as Parameters<...>`.
-- All IPC entrypoints parse unknown payloads at boundary.
+- No runtime handler uses `payload as Parameters<...>`.
+- All websocket RPC entrypoints parse unknown payloads at boundary.

.plans/03-split-codex-app-server-manager.md

@@ -4,15 +4,15 @@
 Split `CodexAppServerManager` into smaller modules with clear responsibilities.
 
 ## Motivation
-- `apps/desktop/src/codexAppServerManager.ts` is large and mixes:
+- `packages/runtime-core/src/codexAppServerManager.ts` is large and mixes:
   - Process lifecycle
   - JSON-RPC parsing/routing
   - Session state transitions
   - Event emission
 - This increases regression risk and slows changes.
 
 ## Scope
-- Desktop provider internals only.
+- Runtime-core provider internals only.
 - Keep external behavior/API stable.
 
 ## Proposed Changes

.plans/06-provider-logstream-lifecycle.md

@@ -4,18 +4,18 @@
 Ensure `ProviderManager` logging stream is initialized, rotated/structured, and closed safely.
 
 ## Motivation
-- `apps/desktop/src/providerManager.ts` opens a write stream in constructor.
+- `packages/runtime-core/src/providerManager.ts` opens a write stream in constructor.
 - Stream lifecycle is not explicit on shutdown.
 
 ## Scope
-- Desktop provider logging behavior.
-- App shutdown integration.
+- Runtime-core provider logging behavior.
+- Runtime server shutdown integration.
 
 ## Proposed Changes
 1. Add explicit `dispose()` on `ProviderManager`:
    - Remove event listeners
    - End/close log stream
-2. Call `providerManager.dispose()` from app shutdown path in `apps/desktop/src/main.ts`.
+2. Call `providerManager.dispose()` from app shutdown path in `apps/t3/src/runtimeApiServer.ts` close flow.
 3. Optional: change log format to JSON lines with stable fields.
 4. Optional: per-session log files under `.logs/providers/`.
 

.plans/10-unify-process-session-abstraction.md

@@ -4,11 +4,11 @@
 Refactor `ProcessManager` to use a single runtime-session interface for child-process and PTY modes.
 
 ## Motivation
-- `apps/desktop/src/processManager.ts` maintains parallel maps and branch-heavy logic.
+- `packages/runtime-core/src/processManager.ts` maintains parallel maps and branch-heavy logic.
 - New execution backends/providers will multiply complexity.
 
 ## Scope
-- Desktop process execution internals.
+- Runtime-core process execution internals.
 - Preserve public `ProcessManager` API.
 
 ## Proposed Changes

AGENTS.md

@@ -1,34 +1,44 @@
 # AGENTS.md
 
 ## Project Snapshot
+
 CodeThing is a minimal GUI for using code agents like Codex and Claude Code (coming soon).
 
 This repository is a VERY EARLY WIP. Proposing sweeping changes that improve long-term maintainability is encouraged.
 
 ## Core Priorities
+
 1. Performance first.
 2. Reliability first.
 3. Keep behavior predictable under load and during failures (session restarts, reconnects, partial streams).
 
 If a tradeoff is required, choose correctness and robustness over short-term convenience.
 
 ## Package Roles
-- `apps/desktop`: Electron main/preload runtime. Owns provider orchestration, process/session lifecycle, and native IPC boundaries.
+
+- `apps/t3`: Node CLI/runtime. Owns WebSocket server lifecycle, browser launch, and RPC routing.
 - `apps/renderer`: React/Vite UI. Owns session UX, conversation/event rendering, and client-side state.
-- `packages/contracts`: Shared Zod schemas and TypeScript contracts for provider events, IPC payloads, and model/session types.
+- `packages/contracts`: Shared Zod schemas and TypeScript contracts for provider events, WebSocket payloads, and model/session types.
+- `packages/runtime-core`: Shared Node runtime services (`ProcessManager`, `TodoStore`, `ProviderManager`, `CodexAppServerManager`) used by `apps/t3`.
+- Legacy desktop runtime wrapper package has been removed; `runtime-core` is the canonical runtime service source.
+- Legacy desktop runtime wrapper package has been removed; `runtime-core` is the canonical runtime service source.
 
 ## Codex App Server (Important)
-CodeThing is currently Codex-first. The desktop app starts `codex app-server` (JSON-RPC over stdio) per provider session, then streams structured events into the renderer through the provider APIs.
+
+CodeThing is currently Codex-first. The `t3` runtime starts `codex app-server` (JSON-RPC over stdio) per provider session, then streams structured events into the renderer through the provider APIs.
 
 How we use it in this codebase:
-- Session startup/resume and turn lifecycle are brokered in `apps/desktop/src/codexAppServerManager.ts`.
-- Provider dispatch and thread event logging are coordinated in `apps/desktop/src/providerManager.ts`.
+
+- Session startup/resume and turn lifecycle are brokered in `packages/runtime-core/src/codexAppServerManager.ts`.
+- Provider dispatch and thread event logging are coordinated in `packages/runtime-core/src/providerManager.ts`.
 - Renderer consumes provider event streams via `nativeApi.providers.onEvent`.
 
 Docs:
+
 - Codex App Server docs: https://developers.openai.com/codex/sdk/#app-server
 
 ## Reference Repos
+
 - Open-source Codex repo: https://github.com/openai/codex
 - Codex-Monitor (Tauri, feature-complete, strong reference implementation): https://github.com/Dimillian/CodexMonitor