feat(examples): simple oneshot STT/TTS gateway (#30)

* fix(whisper): flush buffered data

* feat(examples): simple oneshot STT/TTS gateway

* feat(examples): sample microphone oneshot transcription

* chore: add missing licence

Author: streamer45

examples/speech-gateway/.golangci.yml

@@ -0,0 +1,26 @@
+version: "2"
+linters:
+  default: none
+  enable:
+    - bidichk
+    - errcheck
+    - govet
+    - ineffassign
+    - makezero
+    - misspell
+    - revive
+    - staticcheck
+    - unconvert
+    - unqueryvet
+    - unused
+    - whitespace
+  settings:
+    govet:
+      disable:
+        - fieldalignment
+      enable-all: true
+    unqueryvet:
+      check-sql-builders: true
+issues:
+  max-issues-per-linter: 0 # no maximum
+  max-same-issues: 0 # no maximum

examples/speech-gateway/README.md

@@ -0,0 +1,55 @@
+<!--
+SPDX-FileCopyrightText: © 2025 StreamKit Contributors
+
+SPDX-License-Identifier: MPL-2.0
+-->
+
+# Speech Gateway
+
+Thin HTTP gateway that rewrites simple STT/TTS requests into the multipart oneshot format expected by a StreamKit backend.
+
+## Prereqs
+
+- StreamKit server running locally (default assumed: `http://127.0.0.1:4545`).
+- Go 1.24+.
+
+## Run the gateway
+
+```sh
+cd examples/streamkit-cli-gateway
+go run ./cmd/gateway --listen :8080 --skit-url http://127.0.0.1:4545
+```
+
+Environment equivalents:
+
+- `GATEWAY_LISTEN` (default `:8080`)
+- `SKIT_URL` (default `http://127.0.0.1:4545`)
+- `SKIT_TOKEN` (optional bearer sent to Skit)
+- `GATEWAY_MAX_CONCURRENCY` (default 10)
+- `GATEWAY_MAX_BODY_BYTES` (default 10MB)
+
+## STT via curl (Ogg/Opus)
+
+Transcribe a file:
+
+```sh
+curl -H "Content-Type: audio/ogg" --data-binary @speech.ogg http://127.0.0.1:8080/stt
+```
+
+Transcribe from microphone (requires ffmpeg):
+
+```sh
+./stt.sh
+```
+
+Press Ctrl-C when done speaking. The script captures audio, sends it to the gateway, and displays the transcription.
+
+Response is NDJSON (one JSON object per line).
+
+## TTS via curl (plain text)
+
+```sh
+curl -H "Content-Type: text/plain" --data 'Hello from StreamKit' http://127.0.0.1:8080/tts | ffplay -nodisp -autoexit -
+```
+
+Response is `audio/ogg` (Opus mono).