Requirement 001 S8: the hub can use a shared OpenAI-style speech service (KVB_ORCHESTRATOR_SPEECH_URL, key from a mounted file) instead of the local piper and whisper engines, and the image takes its pinned artefacts through an optional INFINITO_ARTEFACT_BASE cache. A new transport serves speech and the LLM: one wall-clock deadline over DNS, connect, TLS handshake and body, certificate and hostname always verified, no redirect followed. A key travels only over https or to loopback; both the speech and the LLM start refuse it otherwise. Key files are capped at 4096 bytes. Streamed WAV answers with placeholder sizes are accepted only when the data chunk runs to the end, and are rewritten before caching. Accepted MEDUSA false positives (41, independent review, operator pick): raw client socket patterns in transport.py, AIC-EXFIL-005 on the sealed key path, JB-SCAN-2237 on the hub's own system prompt, STG009 on the RIFF pad byte and LLM01 at language.py:111, where agent-written titles reach the NL prompt but the model only proposes a plan the operator confirms. 🎯 Fix: 93 % 💥 Break: 4 % 💸 Cost: – ⏱️ Time: – 🛡️ Security: 100 % 🏆 Score: 89 🚦 Gate: ✅ 90/5, cost and time <= 100, security 100 % Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
132 lines
6.9 KiB
Python
Executable File
132 lines
6.9 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
"""Args:
|
|
--bind: address the server listens on.
|
|
--listen-port: port the server listens on.
|
|
--public-port: port browsers and agents reach the hub on; the Host and
|
|
Origin headers must name it.
|
|
--council: directory holding rasci.json, news.jsonl, queue-history.jsonl,
|
|
night.json, radio-silence.json and the claims under cluster/*/ and
|
|
work/*/; a missing file leaves its part of the state empty. The board
|
|
actions change it through the skill scripts.
|
|
--pages: directory every review page must lie in.
|
|
--state: writable directory for reviews.json, asks.json, decisions.json,
|
|
messages.json, rules.json, jobs.json, marks.json, settings.json,
|
|
log.jsonl, the page copies, uploads/<id>/<name>, the operator's last
|
|
50 voice recordings beside those a stored message carries as
|
|
voice/<id>.wav and the replay store of the signatures the hub checks
|
|
itself as replay/messages.json.
|
|
--host-state: the state directory's path on the host, named in the radio
|
|
rows that carry an upload or a voice recording.
|
|
--skills: installed skills directory holding the kvb-org-radio,
|
|
kvb-org-rasci and kvb-org-suspend scripts.
|
|
--transcripts: directory the Claude Code transcripts (*.jsonl) lie under.
|
|
--templates: directory holding index.html.j2 and the *.js modules it
|
|
includes.
|
|
--tree-file: the JSON file `pkgmgr branch tree --output` writes, mounted
|
|
read-only; read again whenever it changes.
|
|
--timers: directory holding the systemd user units (*.timer).
|
|
--kept: ~/.local/state/agents-council, mounted read-only: gates.db and
|
|
the resources/ files of the host sampler.
|
|
--vendor: directory holding the vendored Bootstrap Icons sprite,
|
|
3d-force-graph and three with their licence texts.
|
|
--cleanup: host-mounted directory the hub writes signed branch deletions
|
|
into (jobs/) and reads their results from (results/); the host's
|
|
kvb-orchestrator-cleanup path unit runs them.
|
|
--offices: host-mounted directory the hub writes signed office orders
|
|
(appoint, take over, recall) into (jobs/) and reads their results
|
|
from (results/); the host's kvb-orchestrator-offices path unit runs
|
|
council.py for them.
|
|
--llm-url: base URL of an OpenAI-compatible chat endpoint; empty turns the
|
|
natural-language command line off.
|
|
--llm-model: model name sent to that endpoint; empty turns it off.
|
|
--llm-key-file: file holding the endpoint's bearer key; an empty file
|
|
means no key, an unreadable one stops the start.
|
|
--piper: the Piper executable, run as a separate process; missing turns
|
|
speech output off.
|
|
--voices: directory holding the Piper voices as <model>.onnx with
|
|
<model>.onnx.json; every speaker of a model is a voice <model>:<id>.
|
|
--operator-voice: the voice of the operator and the hub; it must be one of
|
|
the installed voices when any is installed.
|
|
--whisper: the whisper.cpp command line executable; missing turns speech
|
|
input off.
|
|
--whisper-model: the ggml model whisper.cpp loads.
|
|
--scratch: writable directory the engines use as HOME and TMPDIR.
|
|
--speech-url: base URL with /v1 of an OpenAI-compatible audio API such as
|
|
the core role svc-ai-speech; /api/tts and /api/stt then render there
|
|
instead of in Piper and whisper.cpp, behind the same CPU gate and
|
|
transcription limits. Empty keeps the in-container engines.
|
|
--speech-key-file: file holding that service's bearer key; an empty file
|
|
means no key, an unreadable one stops the start.
|
|
--approvers: the pinned passkeys, mounted read-only; the hub lists their
|
|
ids and algorithms for the page, never pins, and verifies a signature
|
|
only for the operator messages, denials and rules it acts on itself,
|
|
and for the mayday and day/night board actions and new stream origins
|
|
it runs as the operator; every other approval its executor verifies.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import ssl
|
|
from pathlib import Path
|
|
|
|
from kvb_orchestrator import NAME
|
|
from kvb_orchestrator.engines import Engines
|
|
from kvb_orchestrator.errors import ToolError
|
|
from kvb_orchestrator.exchange import HubServer
|
|
from kvb_orchestrator.handler import Handler
|
|
from kvb_orchestrator.hub import Places, open_hub
|
|
from kvb_orchestrator.keys import key_from
|
|
from kvb_orchestrator.language import Model
|
|
from kvb_orchestrator.redirects import TIMEOUT, Redirects, dial
|
|
from kvb_orchestrator.skill_scripts import Scripts
|
|
from kvb_orchestrator.speechservice import Service
|
|
|
|
|
|
def main() -> int:
|
|
parser = argparse.ArgumentParser(prog=NAME)
|
|
parser.add_argument("--bind", required=True)
|
|
for name in ("--listen-port", "--public-port"):
|
|
parser.add_argument(name, type=int, required=True)
|
|
paths = ("--council", "--pages", "--state", "--host-state", "--skills", "--transcripts", "--templates", "--tree-file", "--timers", "--kept", "--vendor", "--cleanup", "--offices", "--llm-key-file", "--approvers")
|
|
for name in (*paths, "--piper", "--voices", "--whisper", "--whisper-model", "--scratch", "--speech-key-file"):
|
|
parser.add_argument(name, type=Path, required=True)
|
|
for name in ("--llm-url", "--llm-model", "--operator-voice", "--speech-url"):
|
|
parser.add_argument(name, required=True)
|
|
args = parser.parse_args()
|
|
try:
|
|
hub = open_hub(
|
|
council=args.council,
|
|
pages=args.pages,
|
|
public_port=args.public_port,
|
|
state=args.state,
|
|
host_state=args.host_state,
|
|
transcripts=args.transcripts,
|
|
scripts=Scripts(skills=args.skills, council=args.council, home=args.state),
|
|
templates=args.templates,
|
|
places=Places(tree_file=args.tree_file, timers=args.timers, vendor=args.vendor, cleanup=args.cleanup, offices=args.offices, kept=args.kept),
|
|
model=Model(url=args.llm_url.strip(), model=args.llm_model.strip(), key=key_from(args.llm_key_file, "model endpoint")),
|
|
engines=Engines(
|
|
piper=args.piper,
|
|
voices=args.voices,
|
|
operator_voice=args.operator_voice,
|
|
whisper=args.whisper,
|
|
whisper_model=args.whisper_model,
|
|
scratch=args.scratch,
|
|
service=Service(url=args.speech_url.strip(), key=key_from(args.speech_key_file, "speech service")),
|
|
),
|
|
approvers=args.approvers,
|
|
redirects=Redirects(tls=ssl.create_default_context(), dial=dial, timeout=TIMEOUT),
|
|
)
|
|
except ToolError as error:
|
|
parser.error(str(error))
|
|
server = HubServer((args.bind, args.listen_port), Handler)
|
|
server.hub = hub
|
|
print(f"{NAME}: listening on {args.bind}:{args.listen_port}, public port {args.public_port}", flush=True)
|
|
server.serve_forever()
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|