claude-phone-local 2.0.7 → 2.0.9

package/claude-api-server/server.js

@@ -118,7 +118,7 @@ console.log('[STARTUP] API keys loaded:', apiKeys.join(', '));
 const sessions = new Map();
 
 // Model selection - Sonnet for balanced speed/quality
-const CLAUDE_MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-20250514';
+const CLAUDE_MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-5';
 
 function parseClaudeStdout(stdout) {
   // Claude Code CLI may output JSONL; when it does, extract the `result` message.

package/cli/lib/commands/setup.js

@@ -382,8 +382,19 @@ async function setupVoiceServer(config) {
   // Step 5: Server Configuration (IP only, no API port)
   console.log(chalk.bold('\n⚙️  Server Configuration'));
   const localIp = getLocalIP();
-  const serverAnswers = await inquirer.prompt([
+  const { ipMode } = await inquirer.prompt([
     {
+      type: 'confirm',
+      name: 'ipMode',
+      message: `Auto-detect the LAN IP on every "claude-phone start" (currently ${localIp})? ` +
+        'Recommended if this machine moves networks (laptop, DHCP) - answering ' +
+        'no locks in a fixed IP that goes stale the next time it changes.',
+      default: config.server.externalIp === 'auto' || config.server.externalIp === undefined
+    }
+  ]);
+
+  const serverAnswers = await inquirer.prompt([
+    ...(ipMode ? [] : [{
       type: 'input',
       name: 'externalIp',
       message: 'Server LAN IP (for RTP audio):',
@@ -397,7 +408,7 @@ async function setupVoiceServer(config) {
         }
         return true;
       }
-    },
+    }]),
     {
       type: 'input',
       name: 'httpPort',
@@ -413,7 +424,7 @@ async function setupVoiceServer(config) {
     }
   ]);
 
-  config.server.externalIp = serverAnswers.externalIp;
+  config.server.externalIp = ipMode ? 'auto' : serverAnswers.externalIp;
   config.server.httpPort = parseInt(serverAnswers.httpPort, 10);
 
   return config;

package/cli/lib/commands/start.js

@@ -5,8 +5,8 @@ import path from 'path';
 import { loadConfig, configExists, getInstallationType } from '../config.js';
 import { checkDocker, writeDockerConfig, startContainers } from '../docker.js';
 import { startServer, isServerRunning } from '../process-manager.js';
-import { isClaudeInstalled, sleep } from '../utils.js';
-import { checkClaudeApiServer } from '../network.js';
+import { isClaudeInstalled } from '../utils.js';
+import { checkClaudeApiServer, waitForVoiceAppReady } from '../network.js';
 import { runPrereqChecks } from '../prereqs.js';
 
 /**
@@ -184,10 +184,16 @@ async function startVoiceServer(config, isPiMode) {
     throw error;
   }
 
-  // Wait a bit for containers to initialize
-  spinner.start('Waiting for containers to initialize...');
-  await sleep(3000);
-  spinner.succeed('Containers initialized');
+  // Wait for FreeSWITCH to actually be ready to accept calls, not just for
+  // the container process to be up. A call landing in that gap gets a SIP
+  // 503 and falls through to 3CX's generic voicemail prompt.
+  spinner.start('Waiting for voice services to be ready...');
+  const readiness = await waitForVoiceAppReady(`http://localhost:${config.server.httpPort}`);
+  if (readiness.ready) {
+    spinner.succeed('Voice services ready');
+  } else {
+    spinner.warn('Voice services did not report ready in time - calls may briefly fail while it finishes starting');
+  }
 
   // Success
   console.log(chalk.bold.green('\n✓ Voice server running!\n'));
@@ -307,10 +313,16 @@ async function startBoth(config, isPiMode) {
     throw error;
   }
 
-  // Wait a bit for containers to initialize
-  spinner.start('Waiting for containers to initialize...');
-  await sleep(3000);
-  spinner.succeed('Containers initialized');
+  // Wait for FreeSWITCH to actually be ready to accept calls, not just for
+  // the container process to be up. A call landing in that gap gets a SIP
+  // 503 and falls through to 3CX's generic voicemail prompt.
+  spinner.start('Waiting for voice services to be ready...');
+  const readiness = await waitForVoiceAppReady(`http://localhost:${config.server.httpPort}`);
+  if (readiness.ready) {
+    spinner.succeed('Voice services ready');
+  } else {
+    spinner.warn('Voice services did not report ready in time - calls may briefly fail while it finishes starting');
+  }
 
   // Start claude-api-server (only in standard mode - Pi mode uses remote API server)
   if (!isPiMode) {

package/cli/lib/network.js

@@ -107,3 +107,42 @@ export async function checkClaudeApiServer(url) {
     }
   });
 }
+
+/**
+ * Poll voice-app's /health until it reports drachtio + FreeSWITCH both
+ * connected, or the timeout elapses. Fixes `claude-phone start` reporting
+ * "All services running!" while FreeSWITCH is still booting - a call landing
+ * in that gap gets a SIP 503 and falls through to the 3CX generic voicemail
+ * prompt instead of ever reaching the app.
+ * @param {string} url - voice-app base URL (e.g. http://localhost:3000)
+ * @param {object} [opts]
+ * @param {number} [opts.timeoutMs=30000] - Give up after this long
+ * @param {number} [opts.intervalMs=1000] - Poll interval
+ * @returns {Promise<{ready: boolean, timedOut: boolean}>}
+ */
+export async function waitForVoiceAppReady(url, { timeoutMs = 30000, intervalMs = 1000 } = {}) {
+  const deadline = Date.now() + timeoutMs;
+
+  while (Date.now() < deadline) {
+    const ready = await new Promise((resolve) => {
+      const req = http.get(url + '/health', { timeout: 3000 }, (res) => {
+        let body = '';
+        res.on('data', (chunk) => { body += chunk; });
+        res.on('end', () => {
+          try {
+            resolve(Boolean(JSON.parse(body).ready));
+          } catch {
+            resolve(false);
+          }
+        });
+      });
+      req.on('error', () => resolve(false));
+      req.on('timeout', () => { req.destroy(); resolve(false); });
+    });
+
+    if (ready) return { ready: true, timedOut: false };
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+
+  return { ready: false, timedOut: true };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-phone-local",
-  "version": "2.0.7",
+  "version": "2.0.9",
   "description": "Local/offline fork of NetworkChuck's claude-phone: talk to Claude Code over 3CX/SIP with faster-whisper STT + Piper TTS in one Docker container.",
   "type": "module",
   "bin": {

package/voice-app/index.js

@@ -178,7 +178,7 @@ function initializeServers() {
   }
 
   // HTTP server for TTS audio
-  httpServer = createHttpServer(config.audio_dir, config.http_port);
+  httpServer = createHttpServer(config.audio_dir, config.http_port, function () { return isReady; });
   console.log("[" + new Date().toISOString() + "] HTTP Server started on port " + config.http_port);
 
   // WebSocket server for audio fork

package/voice-app/lib/http-server.js

@@ -24,9 +24,13 @@ const FILE_MAX_AGE = 600000;
  *
  * @param {string} audioDir - Directory to serve audio files from
  * @param {number} port - Port to listen on (default: 3000)
+ * @param {() => boolean} [getReadiness] - Returns whether drachtio + FreeSWITCH
+ *   are both connected. /health reflects this instead of always reporting
+ *   healthy, so `claude-phone start` can actually wait for the stack to be
+ *   able to accept calls instead of guessing with a fixed sleep.
  * @returns {Object} { app, server, saveAudio, getAudioUrl, close, finalize }
  */
-function createHttpServer(audioDir, port = 3000) {
+function createHttpServer(audioDir, port = 3000, getReadiness) {
   const app = express();
 
   // Parse JSON bodies
@@ -58,10 +62,14 @@ function createHttpServer(audioDir, port = 3000) {
     }
   }));
 
-  // Health check endpoint
+  // Health check endpoint. `ready` reflects whether drachtio + FreeSWITCH are
+  // both connected - the process being up and able to accept calls are not
+  // the same thing, and a caller landing in the gap gets a SIP 503.
   app.get('/health', (req, res) => {
+    const ready = typeof getReadiness === 'function' ? getReadiness() : true;
     res.json({
       status: 'healthy',
+      ready,
       timestamp: new Date().toISOString(),
       audioDir,
       port