remote-codex 0.1.2 → 0.1.4

package/README.md

@@ -43,8 +43,8 @@ remote-codex stop
 
 The global CLI starts the production API and web service:
 
-- API: `http://127.0.0.1:8787`
-- Web: `http://127.0.0.1:4173`
+- API: `http://127.0.0.1:45674`
+- Web: `http://127.0.0.1:45673`
 - service logs/state: `~/.remote-codex/service/`
 - production database: `~/.remote-codex/supervisor.sqlite`
 

package/apps/supervisor-api/dist/index.js

@@ -6097,7 +6097,10 @@ function getDefaultHostRecord() {
 // ../../packages/db/src/migrate.ts
 import fs2 from "fs";
 import path3 from "path";
-function resolveRepoRoot(start = process.cwd()) {
+function resolvePackageRoot(start = process.cwd()) {
+  if (process.env.REMOTE_CODEX_PACKAGE_ROOT) {
+    return path3.resolve(process.env.REMOTE_CODEX_PACKAGE_ROOT);
+  }
   let current = path3.resolve(start);
   while (current !== path3.dirname(current)) {
     if (fs2.existsSync(path3.join(current, "pnpm-workspace.yaml"))) {
@@ -6105,10 +6108,10 @@ function resolveRepoRoot(start = process.cwd()) {
     }
     current = path3.dirname(current);
   }
-  throw new Error("Unable to locate repository root from current working directory.");
+  throw new Error("Unable to locate package root from current working directory.");
 }
 function getMigrationsDir() {
-  return path3.join(resolveRepoRoot(), "packages", "db", "migrations");
+  return path3.join(resolvePackageRoot(), "packages", "db", "migrations");
 }
 function runMigrations(databaseUrl) {
   const { sqlite } = createDatabase(databaseUrl);
@@ -8262,7 +8265,10 @@ import fs7 from "fs";
 import path7 from "path";
 var TOKEN_PRICE_DENOMINATOR = 1e6;
 var cachedPricingConfig = null;
-function resolveRepoRoot2(start = process.cwd()) {
+function resolvePackageRoot2(start = process.cwd()) {
+  if (process.env.REMOTE_CODEX_PACKAGE_ROOT) {
+    return path7.resolve(process.env.REMOTE_CODEX_PACKAGE_ROOT);
+  }
   let current = path7.resolve(start);
   while (current !== path7.dirname(current)) {
     if (fs7.existsSync(path7.join(current, "pnpm-workspace.yaml"))) {
@@ -8270,10 +8276,10 @@ function resolveRepoRoot2(start = process.cwd()) {
     }
     current = path7.dirname(current);
   }
-  throw new Error("Unable to locate repository root for Codex pricing config.");
+  throw new Error("Unable to locate package root for Codex pricing config.");
 }
 function getPricingConfigPath() {
-  return path7.join(resolveRepoRoot2(), "config", "codex-model-pricing.json");
+  return path7.join(resolvePackageRoot2(), "config", "codex-model-pricing.json");
 }
 function isPositiveNumber(value) {
   return typeof value === "number" && Number.isFinite(value) && value >= 0;

package/bin/remote-codex.mjs

@@ -9,6 +9,11 @@ const binDir = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(binDir, '..');
 const packageJsonPath = path.join(packageRoot, 'package.json');
 const serviceManagerPath = path.join(packageRoot, 'scripts', 'service-manager.mjs');
+const sourceCheckout =
+  fs.existsSync(path.join(packageRoot, 'pnpm-workspace.yaml')) &&
+  fs.existsSync(path.join(packageRoot, 'scripts', 'service-restart.mjs'));
+const defaultServicePort = sourceCheckout ? 4173 : 45673;
+const defaultApiPort = sourceCheckout ? 8787 : 45674;
 
 const aliases = new Map([
   ['service:start', 'start'],
@@ -84,9 +89,9 @@ Usage:
 
 Environment:
   SERVICE_HOST              Web listen host, default 127.0.0.1
-  SERVICE_PORT              Web listen port, default 4173
+  SERVICE_PORT              Web listen port, default ${defaultServicePort}
   SERVICE_API_HOST          API listen host, default 127.0.0.1
-  SERVICE_API_PORT          API listen port, default 8787
+  SERVICE_API_PORT          API listen port, default ${defaultApiPort}
   REMOTE_CODEX_SERVICE_DIR  Service state and log directory, default ~/.remote-codex/service
 `);
 }

package/config/codex-model-pricing.json

@@ -0,0 +1,57 @@
+{
+  "currency": "USD",
+  "tiers": {
+    "standard": {
+      "multiplier": 1
+    },
+    "fast": {
+      "multiplier": 2
+    }
+  },
+  "models": {
+    "gpt-5.5": {
+      "inputUsdPerMillion": 5,
+      "cachedInputUsdPerMillion": 0.5,
+      "outputUsdPerMillion": 30,
+      "supportsFastMode": true,
+      "fastMultiplier": 2.5,
+      "contextWindowTokens": 272000
+    },
+    "gpt-5.3-codex": {
+      "inputUsdPerMillion": 1.75,
+      "cachedInputUsdPerMillion": 0.175,
+      "outputUsdPerMillion": 14,
+      "supportsFastMode": true
+    },
+    "gpt-5.4": {
+      "inputUsdPerMillion": 2.5,
+      "cachedInputUsdPerMillion": 0.25,
+      "outputUsdPerMillion": 15,
+      "supportsFastMode": true
+    },
+    "gpt-5.2-codex": {
+      "inputUsdPerMillion": 1.75,
+      "cachedInputUsdPerMillion": 0.175,
+      "outputUsdPerMillion": 14,
+      "supportsFastMode": false
+    },
+    "gpt-5.1-codex-max": {
+      "inputUsdPerMillion": 1.25,
+      "cachedInputUsdPerMillion": 0.125,
+      "outputUsdPerMillion": 10,
+      "supportsFastMode": false
+    },
+    "gpt-5.2": {
+      "inputUsdPerMillion": 1.75,
+      "cachedInputUsdPerMillion": 0.175,
+      "outputUsdPerMillion": 14,
+      "supportsFastMode": false
+    },
+    "gpt-5.1-codex-mini": {
+      "inputUsdPerMillion": 0.25,
+      "cachedInputUsdPerMillion": 0.025,
+      "outputUsdPerMillion": 2,
+      "supportsFastMode": false
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-codex",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local web supervisor for Codex workspaces and threads.",
   "license": "MIT",
   "type": "module",
@@ -13,6 +13,8 @@
     "scripts/run-web-service.mjs",
     "apps/supervisor-api/dist/",
     "apps/supervisor-web/dist/",
+    "config/codex-model-pricing.json",
+    "packages/db/migrations/*.sql",
     "README.md"
   ],
   "packageManager": "pnpm@10.11.1",

package/packages/db/migrations/0000_initial.sql

@@ -0,0 +1,74 @@
+CREATE TABLE IF NOT EXISTS hosts (
+  id TEXT PRIMARY KEY NOT NULL,
+  hostname TEXT NOT NULL,
+  platform TEXT NOT NULL,
+  tailscale_name TEXT,
+  created_at TEXT NOT NULL,
+  last_seen_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS workspaces (
+  id TEXT PRIMARY KEY NOT NULL,
+  host_id TEXT NOT NULL,
+  label TEXT NOT NULL,
+  abs_path TEXT NOT NULL UNIQUE,
+  is_favorite INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL,
+  last_opened_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS threads (
+  id TEXT PRIMARY KEY NOT NULL,
+  workspace_id TEXT NOT NULL,
+  codex_thread_id TEXT,
+  title TEXT NOT NULL,
+  model TEXT,
+  approval_mode TEXT,
+  status TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  last_turn_started_at TEXT,
+  last_turn_completed_at TEXT,
+  last_viewed_at TEXT,
+  is_pinned INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE TABLE IF NOT EXISTS shell_sessions (
+  id TEXT PRIMARY KEY NOT NULL,
+  workspace_id TEXT NOT NULL,
+  thread_id TEXT,
+  tmux_session_name TEXT,
+  cwd TEXT NOT NULL,
+  status TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  last_activity_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS viewer_sessions (
+  id TEXT PRIMARY KEY NOT NULL,
+  thread_id TEXT,
+  shell_id TEXT,
+  connected_at TEXT NOT NULL,
+  last_heartbeat_at TEXT,
+  active_tab TEXT
+);
+
+CREATE TABLE IF NOT EXISTS notifications (
+  id TEXT PRIMARY KEY NOT NULL,
+  thread_id TEXT,
+  kind TEXT NOT NULL,
+  severity TEXT NOT NULL,
+  title TEXT NOT NULL,
+  body TEXT NOT NULL,
+  is_read INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS policies (
+  id TEXT PRIMARY KEY NOT NULL,
+  key TEXT NOT NULL UNIQUE,
+  value_json TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);

package/packages/db/migrations/0001_thread_runtime_fields.sql

@@ -0,0 +1,3 @@
+ALTER TABLE threads ADD COLUMN codex_turn_id TEXT;
+ALTER TABLE threads ADD COLUMN summary_text TEXT;
+ALTER TABLE threads ADD COLUMN last_error TEXT;

package/packages/db/migrations/0002_thread_source.sql

@@ -0,0 +1 @@
+ALTER TABLE threads ADD COLUMN source TEXT NOT NULL DEFAULT 'supervisor';

package/packages/db/migrations/0003_thread_runtime_settings.sql

@@ -0,0 +1,2 @@
+ALTER TABLE threads ADD COLUMN reasoning_effort TEXT;
+ALTER TABLE threads ADD COLUMN collaboration_mode TEXT NOT NULL DEFAULT 'default';

package/packages/db/migrations/0004_thread_connection_state.sql

@@ -0,0 +1 @@
+ALTER TABLE threads ADD COLUMN is_connected INTEGER NOT NULL DEFAULT 1;

package/packages/db/migrations/0005_thread_turn_metadata.sql

@@ -0,0 +1,13 @@
+CREATE TABLE IF NOT EXISTS thread_turn_metadata (
+  id TEXT PRIMARY KEY NOT NULL,
+  thread_id TEXT NOT NULL,
+  turn_id TEXT NOT NULL,
+  model TEXT,
+  reasoning_effort TEXT,
+  reasoning_effort_available INTEGER,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS thread_turn_metadata_thread_turn_idx
+  ON thread_turn_metadata(thread_id, turn_id);

package/packages/db/migrations/0006_thread_sandbox_mode.sql

@@ -0,0 +1 @@
+ALTER TABLE threads ADD COLUMN sandbox_mode TEXT;

package/packages/db/migrations/0007_thread_pending_steers.sql

@@ -0,0 +1,13 @@
+CREATE TABLE IF NOT EXISTS thread_pending_steers (
+  id TEXT PRIMARY KEY,
+  thread_id TEXT NOT NULL,
+  turn_id TEXT NOT NULL,
+  client_request_id TEXT,
+  display_prompt TEXT NOT NULL,
+  submitted_prompt TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS thread_pending_steers_thread_created_idx
+  ON thread_pending_steers(thread_id, created_at);

package/packages/db/migrations/0008_thread_fast_mode_and_activity_notes.sql

@@ -0,0 +1,19 @@
+ALTER TABLE threads
+  ADD COLUMN fast_mode INTEGER NOT NULL DEFAULT 0;
+
+ALTER TABLE threads
+  ADD COLUMN fast_base_model TEXT;
+
+ALTER TABLE threads
+  ADD COLUMN fast_base_reasoning_effort TEXT;
+
+CREATE TABLE IF NOT EXISTS thread_activity_notes (
+  id TEXT PRIMARY KEY,
+  thread_id TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  text TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS thread_activity_notes_thread_created_idx
+  ON thread_activity_notes(thread_id, created_at);

package/packages/db/migrations/0009_thread_turn_token_usage.sql

@@ -0,0 +1,2 @@
+ALTER TABLE thread_turn_metadata
+  ADD COLUMN token_usage_json TEXT;

package/packages/db/migrations/0010_thread_turn_pricing_snapshot.sql

@@ -0,0 +1,5 @@
+ALTER TABLE thread_turn_metadata
+  ADD COLUMN pricing_model_key TEXT;
+
+ALTER TABLE thread_turn_metadata
+  ADD COLUMN pricing_tier_key TEXT;

package/packages/db/migrations/0011_thread_forks.sql

@@ -0,0 +1,8 @@
+CREATE TABLE IF NOT EXISTS thread_forks (
+  id TEXT PRIMARY KEY NOT NULL,
+  source_thread_id TEXT NOT NULL,
+  source_turn_id TEXT,
+  source_turn_index INTEGER,
+  forked_thread_id TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);

package/packages/db/migrations/0012_thread_goals.sql

@@ -0,0 +1,17 @@
+CREATE TABLE IF NOT EXISTS thread_goals (
+  id TEXT PRIMARY KEY NOT NULL,
+  thread_id TEXT NOT NULL,
+  codex_thread_id TEXT NOT NULL,
+  objective TEXT NOT NULL,
+  status TEXT NOT NULL,
+  token_budget INTEGER,
+  tokens_used INTEGER NOT NULL DEFAULT 0,
+  time_used_seconds INTEGER NOT NULL DEFAULT 0,
+  started_at TEXT NOT NULL,
+  completed_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS thread_goals_thread_updated_idx
+  ON thread_goals(thread_id, updated_at);

package/packages/db/migrations/0013_thread_activity_note_anchor.sql

@@ -0,0 +1,2 @@
+ALTER TABLE thread_activity_notes
+  ADD COLUMN anchor_turn_id TEXT;

package/scripts/run-web-service.mjs

@@ -7,11 +7,16 @@ import { fileURLToPath } from 'node:url';
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const repoRoot = path.resolve(scriptDir, '..');
+const sourceCheckout =
+  fs.existsSync(path.join(repoRoot, 'pnpm-workspace.yaml')) &&
+  fs.existsSync(path.join(repoRoot, 'scripts', 'service-restart.mjs'));
+const defaultServicePort = sourceCheckout ? 4173 : 45673;
+const defaultApiPort = sourceCheckout ? 8787 : 45674;
 
 const serviceHost = process.env.SERVICE_HOST ?? '127.0.0.1';
-const servicePort = parsePort(process.env.SERVICE_PORT, 4173);
+const servicePort = parsePort(process.env.SERVICE_PORT, defaultServicePort);
 const apiHost = process.env.SERVICE_API_HOST ?? '127.0.0.1';
-const apiPort = parsePort(process.env.SERVICE_API_PORT, 8787);
+const apiPort = parsePort(process.env.SERVICE_API_PORT, defaultApiPort);
 const distDir = path.resolve(
   process.env.SERVICE_WEB_DIST_DIR ?? path.join(repoRoot, 'apps/supervisor-web/dist')
 );

package/scripts/service-manager.mjs

@@ -4,6 +4,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
+import net from 'node:net';
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const repoRoot = path.resolve(scriptDir, '..');
@@ -17,11 +18,13 @@ const webIndex = path.join(repoRoot, 'apps', 'supervisor-web', 'dist', 'index.ht
 const supportsSourceRestart =
   fs.existsSync(path.join(repoRoot, 'pnpm-workspace.yaml')) &&
   fs.existsSync(path.join(repoRoot, 'scripts', 'service-restart.mjs'));
+const defaultServicePort = supportsSourceRestart ? 4173 : 45673;
+const defaultApiPort = supportsSourceRestart ? 8787 : 45674;
 
 const serviceHost = process.env.SERVICE_HOST ?? '127.0.0.1';
-const servicePort = parsePort(process.env.SERVICE_PORT, 4173);
+const servicePort = parsePort(process.env.SERVICE_PORT, defaultServicePort);
 const apiHost = process.env.SERVICE_API_HOST ?? '127.0.0.1';
-const apiPort = parsePort(process.env.SERVICE_API_PORT, 8787);
+const apiPort = parsePort(process.env.SERVICE_API_PORT, defaultApiPort);
 
 const command = process.argv[2];
 
@@ -58,6 +61,10 @@ async function startService() {
   const webLogPath = path.join(serviceDir, 'web.log');
   prepareLogFile(apiLogPath);
   prepareLogFile(webLogPath);
+
+  await assertTcpPortAvailable(apiHost, apiPort, 'API');
+  await assertTcpPortAvailable(serviceHost, servicePort, 'Web');
+
   const apiPid = spawnDetached(process.execPath, [apiEntry], apiLogPath, {
     NODE_ENV: 'production',
     HOST: apiHost,
@@ -73,7 +80,7 @@ async function startService() {
     await waitForHttp(`http://${apiHost}:${apiPort}/healthz`, apiPid, 15_000);
   } catch (error) {
     stopPid(apiPid);
-    throw error;
+    throw appendLogTail(error, apiLogPath, 'API');
   }
 
   const webPid = spawnDetached(process.execPath, [webEntry], webLogPath, {
@@ -89,7 +96,7 @@ async function startService() {
   } catch (error) {
     stopPid(webPid);
     stopPid(apiPid);
-    throw error;
+    throw appendLogTail(error, webLogPath, 'Web');
   }
 
   const state = {
@@ -214,6 +221,54 @@ async function waitForHttp(url, pid, timeoutMs) {
   throw new Error(`Timed out waiting for ${url}.`);
 }
 
+async function assertTcpPortAvailable(host, port, label) {
+  await new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+
+    server.once('error', (error) => {
+      const code = typeof error === 'object' && error !== null ? error.code : undefined;
+      if (code === 'EADDRINUSE') {
+        reject(
+          new Error(
+            `${label} port ${host}:${port} is already in use. Set ${label === 'API' ? 'SERVICE_API_PORT' : 'SERVICE_PORT'} to another port, or stop the process currently using it.`
+          )
+        );
+        return;
+      }
+
+      reject(error);
+    });
+
+    server.listen(port, host, () => {
+      server.close(resolve);
+    });
+  });
+}
+
+function appendLogTail(error, logPath, label) {
+  const message = error instanceof Error ? error.message : String(error);
+  const tail = readLogTail(logPath, 80);
+  if (!tail) {
+    return new Error(`${message}\n${label} log: ${logPath}`);
+  }
+
+  return new Error(`${message}\n${label} log: ${logPath}\n\nLast ${label} log lines:\n${tail}`);
+}
+
+function readLogTail(logPath, maxLines) {
+  try {
+    const content = fs.readFileSync(logPath, 'utf8').trimEnd();
+    if (!content) {
+      return '';
+    }
+
+    return content.split(/\r?\n/).slice(-maxLines).join('\n');
+  } catch {
+    return '';
+  }
+}
+
 async function probeHttp(url) {
   try {
     const controller = new AbortController();