Files
skills/orchestrator/server.py
T
Kevin Veen-BirkenbachandClaude Opus 5.5 96d4d2933c perf(hub): cache the names directory, share state builds, retry stations
Concurrent /api/state polls share one build through LiveState for a short TTL, and every POST and PATCH invalidates it, so a write is never followed by a stale view. The names directory is cached, the first transcript scan reads outside the hub lock, the graph timeline starts at the window begin, and unresolved radio stations are retried on a daemon thread every RETRY_SECONDS instead of failing until restart.

🎯 Fix: 85 %
💥 Break: 8 %
💸 Tokens: –
⏱️ Velocity: –
🛡️ Security: 100 %
🏆 Score: 78
🚦 Gate: ⛔ fix 85 % < 90, break 8 % > 5

Created-with: https://s.veen.world/skills
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 19:54:23 +00:00

138 lines
7.1 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, and the kvb-org-queue
queue.py.
--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: the durable council root (councilroot.py durable), 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
import threading
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, sighting, stations
from kvb_orchestrator.keys import key_from
from kvb_orchestrator.language import Model
from kvb_orchestrator.livestate import LIVE_TTL
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),
live_ttl=LIVE_TTL,
)
except ToolError as error:
parser.error(str(error))
server = HubServer((args.bind, args.listen_port), Handler)
server.hub = hub
sighting(hub, threading.Event())
stations(hub, threading.Event())
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())