52 lines
1.2 KiB
Markdown
52 lines
1.2 KiB
Markdown
---
|
|
title: Entrypoints
|
|
kind: module
|
|
status: draft
|
|
owners:
|
|
- "@tzhouam"
|
|
- "@yinpeiqi"
|
|
- "@fake0fan"
|
|
- "@alex-jw-brooks"
|
|
primary_code_paths:
|
|
- vllm_omni/entrypoints/**
|
|
related_code_paths:
|
|
- vllm_omni/reasoning/**
|
|
depends_on:
|
|
- vllm_omni_config.md
|
|
- input_output_modality_contracts.md
|
|
- engine_orchestration.md
|
|
validation_paths:
|
|
- tests/entrypoints/**
|
|
- tests/reasoning/**
|
|
upstream_refs:
|
|
- vllm.entrypoints
|
|
last_reviewed: 2026-07-16
|
|
---
|
|
|
|
# Entrypoints
|
|
|
|
Entrypoints translate offline, CLI, and serving requests into stable engine
|
|
operations and translate engine outputs into public responses.
|
|
|
|
## Candidate invariants
|
|
|
|
### ENTRY-INV-001: Entrypoints adapt but do not orchestrate
|
|
|
|
**Rule:** Entrypoints MUST NOT implement cross-stage routing or stage lifecycle
|
|
policy.
|
|
|
|
### ENTRY-INV-002: Public requests are normalized once
|
|
|
|
**Rule:** Public protocol values MUST be validated and converted to internal
|
|
request contracts before engine submission.
|
|
|
|
### ENTRY-INV-003: Streaming preserves request identity
|
|
|
|
**Rule:** Every streamed response MUST remain associated with the request and
|
|
output modality that produced it.
|
|
|
|
## Safe-change guide
|
|
|
|
Test request validation, protocol conversion, streaming, cancellation, and
|
|
error mapping for each affected entrypoint.
|