claude-phone-local 2.0.0

package/claude-api-server/structured.js

@@ -0,0 +1,208 @@
+/**
+ * Structured JSON Output helpers for Claude responses.
+ *
+ * Goal: make Claude usable from automation (n8n) by:
+ * - Prompting for a single JSON object
+ * - Extracting JSON from mixed prose/markdown responses
+ * - Validating required fields
+ * - Retrying once with a "repair" prompt when invalid
+ */
+
+function buildQueryContext({
+  queryType,
+  requiredFields,
+  fieldGuidance,
+  allowExtraFields = true,
+  example,
+}) {
+  const required = Array.isArray(requiredFields) ? requiredFields : [];
+  const guidanceLines = fieldGuidance && typeof fieldGuidance === 'object'
+    ? Object.entries(fieldGuidance).map(([key, value]) => `- ${key}: ${String(value)}`)
+    : [];
+
+  const exampleBlock = example ? `\nExample JSON (shape only):\n${JSON.stringify(example, null, 2)}\n` : '';
+
+  return `[STRUCTURED QUERY CONTEXT]
+You are responding to an automation system (n8n). Your output must be machine-parseable.
+
+Return EXACTLY ONE valid JSON object.
+- No markdown
+- No code fences
+- No backticks
+- No explanations
+- No leading/trailing text
+
+Query type: ${queryType || 'generic'}
+Required fields (must be present as keys): ${JSON.stringify(required)}
+Missing/unknown values: use null (not "unknown", not empty string).
+${allowExtraFields ? 'Extra fields allowed if useful.' : 'Do not include extra fields.'}
+
+Field guidance:
+${guidanceLines.length ? guidanceLines.join('\n') : '- (none)'}
+${exampleBlock}[END STRUCTURED QUERY CONTEXT]
+
+`;
+}
+
+function buildStructuredPrompt({
+  devicePrompt,
+  queryContext,
+  userPrompt,
+}) {
+  let fullPrompt = '';
+
+  if (devicePrompt) {
+    fullPrompt += `[DEVICE IDENTITY]\n${devicePrompt}\n[END DEVICE IDENTITY]\n\n`;
+  }
+
+  fullPrompt += queryContext;
+  fullPrompt += String(userPrompt || '');
+  return fullPrompt;
+}
+
+function stripBom(text) {
+  return text && text.charCodeAt(0) === 0xFEFF ? text.slice(1) : text;
+}
+
+function extractJsonCandidates(text) {
+  const input = stripBom(String(text || ''));
+  const candidates = [];
+
+  // 1) Prefer fenced ```json blocks if present.
+  const fenceRegex = /```(?:json)?\s*([\s\S]*?)\s*```/gi;
+  let match;
+  while ((match = fenceRegex.exec(input)) !== null) {
+    const inside = match[1].trim();
+    if (inside) candidates.push(inside);
+  }
+
+  // 2) Scan for balanced { ... } / [ ... ] blocks (handles prose around JSON).
+  const starts = [];
+  for (let i = 0; i < input.length; i++) {
+    const ch = input[i];
+    if (ch === '{' || ch === '[') starts.push(i);
+  }
+
+  for (const startIndex of starts) {
+    const startChar = input[startIndex];
+    const endChar = startChar === '{' ? '}' : ']';
+
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+
+    for (let i = startIndex; i < input.length; i++) {
+      const ch = input[i];
+
+      if (inString) {
+        if (escape) {
+          escape = false;
+        } else if (ch === '\\\\') {
+          escape = true;
+        } else if (ch === '"') {
+          inString = false;
+        }
+        continue;
+      }
+
+      if (ch === '"') {
+        inString = true;
+        continue;
+      }
+
+      if (ch === startChar) depth++;
+      if (ch === endChar) depth--;
+
+      if (depth === 0) {
+        const candidate = input.slice(startIndex, i + 1).trim();
+        if (candidate) candidates.push(candidate);
+        break;
+      }
+    }
+  }
+
+  // De-dupe, preserve order.
+  return [...new Set(candidates)];
+}
+
+function tryParseJsonFromText(text) {
+  const candidates = extractJsonCandidates(text);
+
+  for (const candidate of candidates) {
+    try {
+      const parsed = JSON.parse(candidate);
+      return { ok: true, jsonText: candidate, data: parsed, candidatesTried: candidates.length };
+    } catch {
+      // keep trying
+    }
+  }
+
+  return {
+    ok: false,
+    error: 'No valid JSON found in response',
+    candidatesTried: candidates.length,
+  };
+}
+
+function getByPath(obj, path) {
+  const parts = String(path).split('.').filter(Boolean);
+  let cur = obj;
+  for (const part of parts) {
+    if (cur && typeof cur === 'object' && part in cur) cur = cur[part];
+    else return undefined;
+  }
+  return cur;
+}
+
+function validateRequiredFields(data, requiredFields) {
+  const required = Array.isArray(requiredFields) ? requiredFields : [];
+  const missing = [];
+
+  if (!data || typeof data !== 'object' || Array.isArray(data)) {
+    return { ok: false, missing: required, error: 'Parsed JSON is not an object' };
+  }
+
+  for (const field of required) {
+    const value = getByPath(data, field);
+    if (value === undefined) missing.push(field);
+  }
+
+  if (missing.length) {
+    return { ok: false, missing, error: `Missing required fields: ${missing.join(', ')}` };
+  }
+
+  return { ok: true };
+}
+
+function buildRepairPrompt({
+  queryType,
+  requiredFields,
+  fieldGuidance,
+  allowExtraFields = true,
+  originalUserPrompt,
+  invalidAssistantOutput,
+  example,
+}) {
+  const queryContext = buildQueryContext({ queryType, requiredFields, fieldGuidance, allowExtraFields, example });
+
+  return `${queryContext}[REPAIR TASK]
+The previous assistant output was not valid JSON or did not include required fields.
+Reformat and return ONLY the corrected JSON object that answers the user's request.
+
+User request:
+"""${String(originalUserPrompt || '').trim()}"""
+
+Invalid assistant output:
+"""${String(invalidAssistantOutput || '').trim()}"""
+[END REPAIR TASK]
+`;
+}
+
+module.exports = {
+  buildQueryContext,
+  buildStructuredPrompt,
+  tryParseJsonFromText,
+  validateRequiredFields,
+  buildRepairPrompt,
+};
+

package/cli/README.md

@@ -0,0 +1,231 @@
+# Claude Phone CLI
+
+> **Note:** since v2 all services run in a **single container**, so commands
+> that used to target one service now act on the whole stack. Speech models and
+> config live in `./data` and are provisioned automatically on first run --
+> there are no manual download steps. See [../README.md](../README.md).
+
+Command-line interface for Claude Phone. Single-command setup and management.
+
+## Installation
+
+### One-Line Install
+
+```bash
+npm install -g claude-phone-local
+```
+
+### Manual Install
+
+```bash
+git clone https://github.com/masterdeepak15/claude-phone-local.git
+cd claude-phone/cli
+npm install
+npm link
+```
+
+## Setup Wizard
+
+```bash
+claude-phone setup
+```
+
+The wizard guides you through configuration based on your deployment type:
+
+### Voice Server
+
+Select this when setting up a Raspberry Pi or dedicated voice box that connects to a remote API server.
+
+**What it asks for:**
+1. 3CX SIP domain and registrar
+2. API server IP and port (where claude-api-server runs)
+3. Local or cloud speech (local = faster-whisper + Piper, no API keys; cloud = ElevenLabs + OpenAI)
+4. Device configuration (name, extension, auth, voice, prompt)
+5. Server LAN IP (for RTP audio routing)
+
+**What `claude-phone start` does:**
+- Starts the `claude-phone` container (drachtio, FreeSWITCH, voice-app, STT, TTS under supervisord)
+- Connects to the remote API server you specified
+
+### API Server
+
+Select this when setting up the Claude API wrapper on a machine with Claude Code CLI.
+
+**What it asks for:**
+- API server port (default: 3333)
+
+**What `claude-phone start` does:**
+- Starts claude-api-server on the configured port
+
+**Note:** You can also just run `claude-phone api-server` without setup - it defaults to port 3333.
+
+### Both (All-in-One)
+
+Select this for a single machine running everything.
+
+**What it asks for:**
+1. Local or cloud speech (local = faster-whisper + Piper, no API keys; cloud = ElevenLabs + OpenAI)
+2. 3CX SIP domain and registrar
+3. Device configuration
+4. Server LAN IP, API port, and HTTP port
+
+**What `claude-phone start` does:**
+- Starts the `claude-phone` container (drachtio, FreeSWITCH, voice-app, STT, TTS under supervisord)
+- Starts claude-api-server
+
+### Pi Auto-Detection
+
+On Raspberry Pi, the setup wizard:
+- Recommends "Voice Server" mode if you select "Both"
+- Checks for 3CX SBC on port 5060 and auto-configures drachtio to use 5070 to avoid conflicts
+- Uses optimized settings for Pi hardware
+
+## Commands
+
+### Setup & Configuration
+
+```bash
+claude-phone setup              # Interactive configuration wizard
+claude-phone setup --skip-prereqs   # Skip prerequisite checks
+claude-phone config show        # Display config (secrets redacted)
+claude-phone config path        # Show config file location (~/.claude-phone/config.json)
+claude-phone config reset       # Reset config (creates backup first)
+```
+
+### Service Management
+
+```bash
+claude-phone start              # Start services based on installation type
+claude-phone stop               # Stop all services
+claude-phone status             # Show service status
+claude-phone doctor             # Health check for dependencies and services
+claude-phone api-server         # Start API server standalone (default port 3333)
+claude-phone api-server -p 4000 # Start on custom port
+```
+
+### Device Management
+
+```bash
+claude-phone device add         # Add a new device/extension
+claude-phone device list        # List configured devices
+claude-phone device remove <name>   # Remove a device by name
+```
+
+### Logs
+
+```bash
+claude-phone logs               # Tail all service logs
+claude-phone logs               # all services (one container now)
+claude-phone logs drachtio      # SIP server only
+claude-phone logs freeswitch    # Media server only
+```
+
+### Backup & Recovery
+
+```bash
+claude-phone backup             # Create timestamped backup
+claude-phone restore            # Restore from backup (interactive)
+```
+
+### Maintenance
+
+```bash
+claude-phone update             # Update Claude Phone to latest
+claude-phone uninstall          # Complete removal
+```
+
+## Configuration Files
+
+All configuration is stored in `~/.claude-phone/`:
+
+```
+~/.claude-phone/
+├── config.json           # Main configuration (chmod 600)
+├── docker-compose.yml    # Generated: one service + ./data volume
+├── .env                  # Generated environment file
+├── server.pid            # API server process ID
+└── backups/              # Configuration backups
+```
+
+### Config Structure
+
+```json
+{
+  "version": "1.0.0",
+  "installationType": "both",
+  "api": {
+    "elevenlabs": { "apiKey": "...", "defaultVoiceId": "...", "validated": true },
+    "openai": { "apiKey": "...", "validated": true }
+  },
+  "sip": {
+    "domain": "your-3cx.3cx.us",
+    "registrar": "192.168.1.100",
+    "transport": "udp"
+  },
+  "server": {
+    "claudeApiPort": 3333,
+    "httpPort": 3000,
+    "externalIp": "192.168.1.50"
+  },
+  "devices": [{
+    "name": "Morpheus",
+    "extension": "9000",
+    "authId": "9000",
+    "password": "***",
+    "voiceId": "elevenlabs-voice-id",
+    "prompt": "You are Morpheus..."
+  }],
+  "deployment": {
+    "mode": "both"
+  }
+}
+```
+
+## Split Deployment Example
+
+### On Raspberry Pi (Voice Server)
+
+```bash
+# Install
+npm install -g claude-phone-local
+
+# Setup - select "Voice Server"
+# Enter your Mac's IP when prompted for API server
+claude-phone setup
+
+# Start voice services
+claude-phone start
+```
+
+### On Mac (API Server)
+
+```bash
+# Install (if not already)
+npm install -g claude-phone-local
+
+# Start API server (no setup needed)
+claude-phone api-server
+
+# Or on a custom port
+claude-phone api-server --port 4000
+```
+
+## Requirements
+
+- **Node.js 18+** - Required for CLI
+- **Docker** - Required for Voice Server or Both modes
+- **Claude Code CLI** - Required for API Server or Both modes
+
+## Development
+
+```bash
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT

package/cli/bin/check-publish-safety.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * prepublishOnly guard.
+ *
+ * `npm publish` is irreversible - a version number can be deprecated but its
+ * contents stay downloadable. This aborts the publish if the tarball would
+ * contain anything secret or absurdly large, rather than trusting .npmignore
+ * to have been maintained correctly.
+ */
+import { execSync } from 'node:child_process';
+
+const FORBIDDEN = [
+  { pattern: /(^|\/)\.env$/,            reason: 'environment file with credentials' },
+  { pattern: /devices\.json$/,          reason: 'SIP credentials' },
+  { pattern: /\.onnx$/,                 reason: 'voice model (downloaded at runtime)' },
+  { pattern: /(^|\/)data\//,            reason: 'runtime data directory' },
+  { pattern: /\.(pem|key|p12|pfx)$/,    reason: 'private key' },
+];
+
+const MAX_TARBALL_MB = 25;
+
+let files, sizeMB;
+try {
+  const out = execSync('npm pack --dry-run --json', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+  const meta = JSON.parse(out)[0];
+  files = meta.files.map((f) => f.path);
+  sizeMB = meta.unpackedSize / (1024 * 1024);
+} catch (err) {
+  console.error('publish-safety: could not inspect the tarball -', err.message);
+  process.exit(1);
+}
+
+const offenders = [];
+for (const file of files) {
+  for (const { pattern, reason } of FORBIDDEN) {
+    if (pattern.test(file)) offenders.push(`  ${file}  <- ${reason}`);
+  }
+}
+
+if (offenders.length) {
+  console.error('\npublish BLOCKED - these files must not be published:\n');
+  console.error(offenders.join('\n'));
+  console.error('\nAdd them to .npmignore, then try again.\n');
+  process.exit(1);
+}
+
+if (sizeMB > MAX_TARBALL_MB) {
+  console.error(`\npublish BLOCKED - unpacked size ${sizeMB.toFixed(1)} MB exceeds ${MAX_TARBALL_MB} MB.`);
+  console.error('Models are meant to download at runtime, not ship in the package.\n');
+  process.exit(1);
+}
+
+console.log(`publish-safety OK - ${files.length} files, ${sizeMB.toFixed(1)} MB unpacked`);

package/cli/bin/claude-phone.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+// Early Node.js version check - ES5 compatible for old Node versions
+// This MUST run before any ES module imports to catch version issues
+var nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
+var requiredMajor = 18;
+
+if (nodeMajor < requiredMajor) {
+  console.error('');
+  console.error('\x1b[31m' + 'ERROR: Node.js version too old' + '\x1b[0m');
+  console.error('  Current: v' + process.versions.node);
+  console.error('  Required: v' + requiredMajor + '.0.0 or higher');
+  console.error('');
+  console.error('\x1b[33m' + 'To install Node.js ' + requiredMajor + '+:' + '\x1b[0m');
+  console.error('  macOS/Linux: curl -fsSL https://fnm.vercel.app/install | bash');
+  console.error('               fnm install 20 && fnm default 20');
+  console.error('  Or visit: https://nodejs.org/');
+  console.error('');
+  process.exit(1);
+}
+
+// Node version OK - load the actual CLI
+import('./cli-main.js');