Merge pull request 'Add POST /command endpoint with terminate support' (#3) from mikael-lovqvists-claude-agent/tts-server:add-terminate-command into main

Reviewed-on: efforting.tech/tts-server#3

chatterbox-server.py

@@ -6,6 +6,7 @@ Endpoints:
   POST /speak    {"text": "...", "temperature": 0.8, "top_p": 0.95, "audio_prompt": "/path.wav"}
   POST /chime    {"path": "/path/to/file.wav"}
   POST /preload  {"path": "/path/to/file.wav"}
+  POST /command  {"command": "terminate"}
 
 All endpoints return {"status": "ok"} or {"status": "error", "message": "..."}.
 Responses are sent after audio is queued for playback (not after playback finishes).
@@ -237,6 +238,14 @@ class Handler(BaseHTTPRequestHandler):
 			except Exception as e:
 				self.send_json({'status': 'error', 'message': str(e)}, 500)
 
+		elif self.path == '/command':
+			command = req.get('command', '')
+			if command == 'terminate':
+				self.send_json({'status': 'ok'})
+				threading.Thread(target=server.shutdown, daemon=True).start()
+			else:
+				self.send_json({'status': 'error', 'message': f'unknown command: {command}'}, 400)
+
 		else:
 			self.send_json({'status': 'error', 'message': 'not found'}, 404)
 

examples/terminate.mjs

@@ -0,0 +1,16 @@
+// Gracefully terminate the Chatterbox TTS server.
+// Usage: node terminate.mjs
+
+const PORT = process.env.TTS_PORT ?? '11500'
+
+const res = await fetch(`http://localhost:${PORT}/command`, {
+	method: 'POST',
+	headers: { 'Content-Type': 'application/json' },
+	body: JSON.stringify({ command: 'terminate' }),
+})
+
+const data = await res.json()
+if (data.status !== 'ok') {
+	console.error('error:', data.message)
+	process.exit(1)
+}