How siddharth-1118/vss-self-deciding-agent works
VSS accepts text or JSON state plus typed questions, validates the request, and produces schema-constrained answers with probabilities, confidence, and optional abstention in a shared model pass. Its other major branches cover training and data preparation, calibration and evaluation, and REST serving. Some relationships are documented only by the README or SOURCE INDEX; unsampled modules are included where their role is established, without inferring internal calls.
Main entry points: vss_model.py VSS model · api.py Public API · schema.py Training data schema · trainer.py Trainer
Components 26
API and serving
- Public API
src/vss/api.py - REST server
src/vss/inference/server.py
Inference pipeline
- Request validation
src/vss/inference/schema.py - Batching
src/vss/inference/batching.py - Answer construction
src/vss/inference/engine.py
Model internals
- VSS model
src/vss/model/vss_model.py - State encoder
src/vss/model/encoder.py - Transformer
src/vss/model/transformer.py - State serialization
src/vss/model/serialize.py - Tokenizer
src/vss/model/tokenizer.py - BPE tokenizer
src/vss/model/tokenizer_bpe.py - Typed question heads
src/vss/model/questions.py - Model configuration
src/vss/model/config.py
Data and training
- Training data schema
src/vss/data/schema.py - Synthetic generator
src/vss/data/synthetic.py - Banking77 loader
src/vss/data/banking77.py - CLINC150 loader
src/vss/data/clinc150.py - Trainer
src/vss/training/trainer.py - Training losses
src/vss/training/losses.py - Curriculum
src/vss/training/curriculum.py - RLCD training
src/vss/training/rlcd.py - Checkpoint selection
src/vss/training/selection.py
Calibration and evaluation
- Calibration
src/vss/model/calibration.py - Evaluation metrics
src/vss/eval/metrics.py
Other components
- Decision caller
- REST client
Connections 31
- Decision caller → Public API: submits decisions
- REST client → REST server: posts requests
- REST server → Public API: delegates to
src/vss/inference/server.py - Public API → Request validation: validates requests
src/vss/api.py - Public API → Batching: runs batches
src/vss/api.py - Public API → Answer construction: runs single decisions
src/vss/api.py - Batching → VSS model: runs forward pass
src/vss/inference/batching.py - Batching → Answer construction: builds answers
src/vss/inference/batching.py - Batching → Typed question heads: parses questions
src/vss/inference/batching.py - Answer construction → VSS model: formats model outputs
src/vss/inference/engine.py - VSS model → State encoder: encodes state
src/vss/model/vss_model.py - VSS model → Typed question heads: routes questions
src/vss/model/vss_model.py - VSS model → Model configuration: uses settings
src/vss/model/vss_model.py - State encoder → State serialization: serializes state
src/vss/model/encoder.py - State encoder → Tokenizer: tokenizes text
src/vss/model/encoder.py - State encoder → Transformer: encodes tokens
src/vss/model/encoder.py - VSS model → Tokenizer: loads vocabulary
src/vss/model/vss_model.py - Synthetic generator → Training data schema: validates examples
src/vss/data/synthetic.py - Banking77 loader → Training data schema: uses data schema
src/vss/data/banking77.py - CLINC150 loader → Training data schema: uses data schema
src/vss/data/clinc150.py - Trainer → VSS model: trains model
src/vss/training/trainer.py - Trainer → Training data schema: consumes examples
src/vss/training/trainer.py - Trainer → Training losses: computes loss
src/vss/training/trainer.py - Trainer → Checkpoint selection: selects checkpoints
src/vss/training/trainer.py - Curriculum → Synthetic generator: generates stages
src/vss/training/curriculum.py - Curriculum → Training data schema: uses examples
src/vss/training/curriculum.py - RLCD training → VSS model: trains model
src/vss/training/rlcd.py - RLCD training → Training losses: uses losses
src/vss/training/rlcd.py - Public API → Calibration: reports confidence
- Calibration → Typed question heads: complements confidence head
src/vss/model/calibration.py - Evaluation metrics → Calibration: measures calibration