Files
t3mp3st/docs
2alfandJoseph Magly 8ccea7c82a feat(llm): add Hugging Face provider + selectable local Claude Code models (#127)
* feat(llm): add Hugging Face provider + selectable local Claude Code models

Adds two operator-selectable LLM backbones, wired through both the backend
and the War Room UI.

Hugging Face (OpenAI-compatible Inference Providers router):
- New `huggingface` provider reusing OpenAIAdapter (router.huggingface.co/v1)
- HF_TOKEN / HUGGINGFACE_API_KEY / HUGGINGFACE_TOKEN env resolution, config,
  setup wizard, CLI, factory, best-available, and .env.example
- Settings key card + 4 inference models in the picker + direct client routing
- Tests: src/__tests__/huggingface-provider.test.ts

Local Claude from Claude Code:
- Explicit "active backbone" pin in Settings so a connected agent (Claude Code)
  can be chosen; a pin outranks stored API keys in both the client resolver and
  mission dispatch
- Claude Code model picker (Account default / Opus / Sonnet / Haiku), threaded
  to the CLI's --model via an "agentId::model" encoding parsed by LocalAgentAdapter;
  requireLiveLocalAgent strips the suffix for connected-agent validation

* fix(llm): address PR #127 review — self-contained keyless path + centralized pin/model routing

Finding 1 — keyless mission path was not self-contained:
- Add the `local-agent` case to ConfigManager.getLLMConfig so provider:'local-agent'
  resolves (keyless, agent id — optionally "agentId::model" — in `model`) instead of
  hitting the default "Unknown provider" throw.

Finding 2 — inconsistent pin/model routing across dispatch surfaces:
- Centralize backend agent resolution in window.t3mpDispatchAgent (single source of truth).
  It honors an explicit pin OVER a stored API key and encodes the picked local model as
  "agentId::model" so it is never dropped.
- Route all three surfaces through it: mission dispatch, General (getGeneralConfig), and
  Admiral (_admBackbone). Previously General/Admiral only picked an agent when no key
  existed and sent the bare agent id, so a stored key overrode the pin and the selected
  Claude model was lost.

Tests:
- getLLMConfig('local-agent') regression coverage (self-contained keyless path)
- LocalAgentAdapter "agentId::model" passthrough reaches the CLI --model flag
- t3mpDispatchAgent behavior: pin>key precedence, model encoding, fallbacks (evaluated
  from the shipped docs/index.html)
- centralization invariant: mission/General/Admiral all route through t3mpDispatchAgent
- update the Op-Admiral keyless-routing static test to the centralized resolver

---------

Co-authored-by: Joseph Magly <1159087+jmagly@users.noreply.github.com>
2026-07-27 15:47:06 -04:00
..
2026-07-02 13:57:34 -04:00
2026-07-02 13:57:34 -04:00
2026-07-02 13:57:34 -04:00
2026-07-02 13:57:34 -04:00
2026-07-02 13:57:34 -04:00
2026-07-02 13:57:34 -04:00
2026-07-02 13:57:34 -04:00
2026-07-02 13:57:34 -04:00
2026-07-03 10:57:20 -04:00

T3MP3ST Documentation

Start here when you want to install, run, integrate, or contribute to T3MP3ST.

For Operators

Doc Use it for
Getting Started Install, first launch, first safe mission, updates, and troubleshooting
Scope and Authorization Rules of engagement, target receipts, and evidence requirements
Target Headers Supplying auth headers for an explicitly authorized target origin
Arsenal Activation Plan Installing optional external tools and understanding adapter readiness
Team Preview Ten-minute UI walkthrough for preview builds

For Developers

Doc Use it for
Developer Guide Architecture, local development, scripts, extension points, and release checks
API Reference HTTP server endpoints grouped by workflow
MCP Guide Model Context Protocol setup and the security_recon tool
Contribution Receipts Evidence template for PRs and claim changes
Pull Request Delivery Contributor and maintainer PR checklist

Preview this documentation as a Pagenary site:

npm run docs:serve

Benchmarks And Provenance

Doc Use it for
Verified Provenance How T3MP3ST ties findings to tool evidence
XBOW Baseline XBEN benchmark notes
Cybench Cybench benchmark notes
Wall Forensics Per-challenge misses and benchmark analysis
Integrity Ledger Contamination audit and retractions
Obsidivm Local web range and evaluation notes
Cognitive Architecture Prompt and reasoning architecture boundaries
AI Red-Team Techniques Defensive taxonomy and technique map

Release And Maintenance

Doc Use it for
Install Matrix OS readiness notes
Release Checklist Release gates
Changelog Project change history