@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/route-registry.cjs

@@ -0,0 +1,951 @@
+
+//#region src/route-registry.ts
+/**
+* Single source of truth for every first-class HTTP route aimock serves.
+*
+* Both the HTTP dispatcher (`server.ts`) and the machine-readable catalog
+* (`openapi.ts` → `GET /__aimock/openapi.json` + `GET /__aimock/routes`) import
+* from this module. Drift is prevented three ways, not one:
+*
+* 1. Shared bindings — the dispatcher matches against the exact `*_PATH`
+*    constants and `*_RE` patterns defined here (never inline literals), and
+*    `metrics.ts` path-label normalization imports the same patterns, so the
+*    three consumers cannot disagree on what a route looks like.
+* 2. Bidirectional tests (`openapi-catalog.test.ts`) — every catalog entry is
+*    probed against the live router (catalog → router) AND every dispatch
+*    literal/pattern imported from this module must have a catalog entry
+*    whose example path it matches (router → catalog).
+* 3. Runtime drift guard — the dispatcher's terminal 404 consults
+*    `matchRouteDefinition` and warns when the registry claims a route the
+*    dispatcher just missed.
+*
+* `path` is the OpenAPI path template (`{param}` for dynamic segments).
+* `examplePath` is a concrete path the drift test probes against the live
+* server (a templated path can never be fetched verbatim).
+*
+* Plugin mounts (`Mountable`: A2A/MCP/AG-UI/vector) are dynamic per-server and
+* intentionally excluded — this registry covers the built-in first-class
+* surfaces only. Likewise excluded from `ROUTE_DEFINITIONS` (their bindings
+* above are still shared so dispatch cannot typo them): the WebSocket upgrades
+* (`REALTIME_PATH`, `GEMINI_LIVE_PATH`, `LIVE_PATH` — same URL as an HTTP
+* route or no HTTP method at all, so they cannot appear in an HTTP catalog)
+* and the header-gated fal.ai proxy branch (`FAL_ROUTE_RE` +
+* `x-fal-target-host`, a dynamic upstream mirror rather than a fixed route).
+*/
+const COMPLETIONS_PATH = "/v1/chat/completions";
+const RESPONSES_PATH = "/v1/responses";
+const REALTIME_PATH = "/v1/realtime";
+const LIVE_PATH = "/v1/live/sessions";
+const GEMINI_LIVE_PATH = "/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent";
+const MESSAGES_PATH = "/v1/messages";
+const EMBEDDINGS_PATH = "/v1/embeddings";
+const COHERE_CHAT_PATH = "/v2/chat";
+const COHERE_EMBED_PATH = "/v2/embed";
+const SEARCH_PATH = "/search";
+const RERANK_PATH = "/v2/rerank";
+const MODERATIONS_PATH = "/v1/moderations";
+const IMAGES_PATH = "/v1/images/generations";
+const IMAGES_EDIT_PATH = "/v1/images/edits";
+const IMAGES_VARIATIONS_PATH = "/v1/images/variations";
+const SPEECH_PATH = "/v1/audio/speech";
+const TRANSCRIPTIONS_PATH = "/v1/audio/transcriptions";
+const TRANSLATIONS_PATH = "/v1/audio/translations";
+const VIDEOS_PATH = "/v1/videos";
+const GROK_VIDEO_SUBMIT_PATH = "/v1/videos/generations";
+const GROK_VIDEO_STATUS_RE = /^\/v1\/videos\/([^/]+)$/;
+const OPENAI_VIDEO_STATUS_RE = /^\/v1\/videos\/([^/]+)$/;
+const GEMINI_PREDICT_RE = /^\/v1beta\/models\/([^:]+):predict$/;
+const VEO_PREDICT_LRO_RE = /^\/v1beta\/models\/([^:]+):predictLongRunning$/;
+const VEO_OPERATION_RE = /^\/v1beta\/(operations\/.+)$/;
+const BYTEPLUS_VIDEO_SUBMIT_RE = /^(?:\/api\/v3)?\/contents\/generations\/tasks$/;
+const BYTEPLUS_VIDEO_STATUS_RE = /^(?:\/api\/v3)?\/contents\/generations\/tasks\/([^/]+)$/;
+const ELEVENLABS_SOUND_GENERATION_PATH = "/v1/sound-generation";
+const ELEVENLABS_TTS_RE = /^\/v1\/text-to-speech\/([^/]+)$/;
+const ELEVENLABS_MUSIC_RE = /^\/v1\/music(?:\/(.+))?$/;
+const ELEVENLABS_VOICE_DESIGN_PATH = "/v1/text-to-voice/design";
+const ELEVENLABS_VOICE_CREATE_PATH = "/v1/text-to-voice";
+const ELEVENLABS_VOICE_RE = /^\/v1\/voices\/([^/]+)$/;
+const FAL_QUEUE_SUBMIT_RE = /^\/fal\/queue\/submit\/(.+)$/;
+const FAL_QUEUE_REQUESTS_RE = /^\/fal\/queue\/requests\/(.+)$/;
+const FAL_RUN_RE = /^\/fal\/run\/(.+)$/;
+const FAL_ROUTE_RE = /^\/fal(?:\/.*)?$/;
+const GEMINI_INTERACTIONS_PATH = "/v1beta/interactions";
+const GEMINI_PATH_RE = /^\/v1beta\/models\/([^:]+):(generateContent|streamGenerateContent)$/;
+const GEMINI_EMBED_RE = /^\/v1beta\/models\/([^:]+):embedContent$/;
+const AZURE_DEPLOYMENT_RE = /^\/openai\/deployments\/([^/]+)\/(chat\/completions|embeddings)$/;
+const BEDROCK_INVOKE_RE = /^\/model\/([^/]+)\/invoke$/;
+const BEDROCK_STREAM_RE = /^\/model\/([^/]+)\/invoke-with-response-stream$/;
+const BEDROCK_CONVERSE_RE = /^\/model\/([^/]+)\/converse$/;
+const BEDROCK_CONVERSE_STREAM_RE = /^\/model\/([^/]+)\/converse-stream$/;
+const VERTEX_AI_RE = /^\/v1\/projects\/[^/]+\/locations\/[^/]+\/publishers\/google\/models\/([^/:]+):(generateContent|streamGenerateContent)$/;
+const OLLAMA_CHAT_PATH = "/api/chat";
+const OLLAMA_GENERATE_PATH = "/api/generate";
+const OLLAMA_EMBEDDINGS_PATH = "/api/embeddings";
+const OLLAMA_EMBED_PATH = "/api/embed";
+const OLLAMA_TAGS_PATH = "/api/tags";
+const OPENROUTER_VIDEOS_PATH = "/api/v1/videos";
+const OPENROUTER_VIDEO_MODELS_PATH = "/api/v1/videos/models";
+const OPENROUTER_MODELS_PATH = "/api/v1/models";
+const OPENROUTER_KEY_PATH = "/api/v1/key";
+const OPENROUTER_CREDITS_PATH = "/api/v1/credits";
+const OPENROUTER_VIDEO_CONTENT_RE = /^\/api\/v1\/videos\/([^/]+)\/content$/;
+const OPENROUTER_VIDEO_STATUS_RE = /^\/api\/v1\/videos\/([^/]+)$/;
+const HEALTH_PATH = "/health";
+const READY_PATH = "/ready";
+const METRICS_PATH = "/metrics";
+const MODELS_PATH = "/v1/models";
+const REQUESTS_PATH = "/v1/_requests";
+const FILES_PATH = "/v1/files";
+const FILES_CONTENT_RE = /^\/v1\/files\/([^/]+)\/content$/;
+const FILES_ID_RE = /^\/v1\/files\/([^/]+)$/;
+const BATCHES_PATH = "/v1/batches";
+const BATCHES_CANCEL_RE = /^\/v1\/batches\/([^/]+)\/cancel$/;
+const BATCHES_ID_RE = /^\/v1\/batches\/([^/]+)$/;
+const FINE_TUNING_JOBS_PATH = "/v1/fine_tuning/jobs";
+const FINE_TUNING_ID_RE = /^\/v1\/fine_tuning\/jobs\/([^/]+)$/;
+const FINE_TUNING_CANCEL_RE = /^\/v1\/fine_tuning\/jobs\/([^/]+)\/cancel$/;
+const FINE_TUNING_EVENTS_RE = /^\/v1\/fine_tuning\/jobs\/([^/]+)\/events$/;
+const VECTOR_STORES_PATH = "/v1/vector_stores";
+const VECTOR_STORES_SEARCH_RE = /^\/v1\/vector_stores\/([^/]+)\/search$/;
+const VECTOR_STORES_BATCH_FILES_RE = /^\/v1\/vector_stores\/([^/]+)\/file_batches\/([^/]+)\/files$/;
+const VECTOR_STORES_BATCH_CANCEL_RE = /^\/v1\/vector_stores\/([^/]+)\/file_batches\/([^/]+)\/cancel$/;
+const VECTOR_STORES_BATCH_RE = /^\/v1\/vector_stores\/([^/]+)\/file_batches\/([^/]+)$/;
+const VECTOR_STORES_FILE_RE = /^\/v1\/vector_stores\/([^/]+)\/files\/([^/]+)$/;
+const VECTOR_STORES_ID_RE = /^\/v1\/vector_stores\/([^/]+)$/;
+const VECTOR_STORES_FILES_RE = /^\/v1\/vector_stores\/([^/]+)\/files$/;
+const VECTOR_STORES_FILE_BATCHES_RE = /^\/v1\/vector_stores\/([^/]+)\/file_batches$/;
+const CONTROL_PREFIX = "/__aimock";
+/**
+* Every built-in route, in the same order the dispatcher checks them
+* (mounts → ollama → openrouter-video → byteplus → openrouter discovery →
+* azure/compat → ops → models/requests → provider handlers → fal → chat).
+* Regex branches are represented by their canonical OpenAPI template.
+*/
+const ROUTE_DEFINITIONS = [
+	{
+		method: "POST",
+		path: OLLAMA_CHAT_PATH,
+		service: "ollama",
+		description: "Ollama chat"
+	},
+	{
+		method: "POST",
+		path: OLLAMA_GENERATE_PATH,
+		service: "ollama",
+		description: "Ollama generate"
+	},
+	{
+		method: "POST",
+		path: OLLAMA_EMBEDDINGS_PATH,
+		service: "ollama",
+		description: "Ollama embeddings (legacy path)"
+	},
+	{
+		method: "POST",
+		path: OLLAMA_EMBED_PATH,
+		service: "ollama",
+		description: "Ollama embed (current path)"
+	},
+	{
+		method: "GET",
+		path: OLLAMA_TAGS_PATH,
+		service: "ollama",
+		description: "Ollama tags"
+	},
+	{
+		method: "GET",
+		path: "/api/v1/videos/{jobId}/content",
+		examplePath: "/api/v1/videos/test-job/content",
+		service: "video",
+		description: "OpenRouter video content download"
+	},
+	{
+		method: "GET",
+		path: OPENROUTER_VIDEO_MODELS_PATH,
+		service: "video",
+		description: "OpenRouter video model listing"
+	},
+	{
+		method: "GET",
+		path: "/api/v1/videos/{jobId}",
+		examplePath: "/api/v1/videos/test-job",
+		service: "video",
+		description: "OpenRouter video job status"
+	},
+	{
+		method: "POST",
+		path: OPENROUTER_VIDEOS_PATH,
+		service: "video",
+		description: "OpenRouter video job submit"
+	},
+	{
+		method: "GET",
+		path: "/contents/generations/tasks/{id}",
+		examplePath: "/contents/generations/tasks/test-id",
+		service: "video",
+		description: "BytePlus video task status"
+	},
+	{
+		method: "GET",
+		path: "/api/v3/contents/generations/tasks/{id}",
+		examplePath: "/api/v3/contents/generations/tasks/test-id",
+		service: "video",
+		description: "BytePlus video task status (api/v3 prefix)"
+	},
+	{
+		method: "POST",
+		path: "/contents/generations/tasks",
+		service: "video",
+		description: "BytePlus video task submit"
+	},
+	{
+		method: "POST",
+		path: "/api/v3/contents/generations/tasks",
+		service: "video",
+		description: "BytePlus video task submit (api/v3 prefix)"
+	},
+	{
+		method: "GET",
+		path: OPENROUTER_MODELS_PATH,
+		service: "openrouter",
+		description: "OpenRouter models"
+	},
+	{
+		method: "GET",
+		path: OPENROUTER_KEY_PATH,
+		service: "openrouter",
+		description: "OpenRouter key info"
+	},
+	{
+		method: "GET",
+		path: OPENROUTER_CREDITS_PATH,
+		service: "openrouter",
+		description: "OpenRouter credits"
+	},
+	{
+		method: "POST",
+		path: "/openai/deployments/{deploymentId}/chat/completions",
+		examplePath: "/openai/deployments/test-deployment/chat/completions",
+		service: "azure",
+		description: "Azure OpenAI chat completions"
+	},
+	{
+		method: "POST",
+		path: "/openai/deployments/{deploymentId}/embeddings",
+		examplePath: "/openai/deployments/test-deployment/embeddings",
+		service: "azure",
+		description: "Azure OpenAI embeddings"
+	},
+	{
+		method: "GET",
+		path: HEALTH_PATH,
+		service: "ops",
+		description: "Health probe (public)"
+	},
+	{
+		method: "GET",
+		path: READY_PATH,
+		service: "ops",
+		description: "Readiness probe (public)"
+	},
+	{
+		method: "GET",
+		path: METRICS_PATH,
+		service: "ops",
+		description: "Prometheus metrics (public)"
+	},
+	{
+		method: "GET",
+		path: MODELS_PATH,
+		service: "openai",
+		description: "Models listing"
+	},
+	{
+		method: "GET",
+		path: REQUESTS_PATH,
+		service: "control",
+		description: "Legacy journal listing"
+	},
+	{
+		method: "DELETE",
+		path: REQUESTS_PATH,
+		service: "control",
+		description: "Legacy journal clear"
+	},
+	{
+		method: "POST",
+		path: RESPONSES_PATH,
+		service: "openai",
+		description: "OpenAI Responses API"
+	},
+	{
+		method: "POST",
+		path: MESSAGES_PATH,
+		service: "anthropic",
+		description: "Anthropic messages"
+	},
+	{
+		method: "POST",
+		path: COHERE_CHAT_PATH,
+		service: "cohere",
+		description: "Cohere chat"
+	},
+	{
+		method: "POST",
+		path: COHERE_EMBED_PATH,
+		service: "cohere",
+		description: "Cohere embed"
+	},
+	{
+		method: "POST",
+		path: EMBEDDINGS_PATH,
+		service: "openai",
+		description: "OpenAI embeddings"
+	},
+	{
+		method: "POST",
+		path: IMAGES_PATH,
+		service: "images",
+		description: "Image generation"
+	},
+	{
+		method: "POST",
+		path: IMAGES_EDIT_PATH,
+		service: "images",
+		description: "Image edits (multipart)"
+	},
+	{
+		method: "POST",
+		path: "/v1/images/variations",
+		service: "images",
+		description: "Image variations (removed upstream 2026-05-12 — replays the real 404)"
+	},
+	{
+		method: "POST",
+		path: SPEECH_PATH,
+		service: "speech",
+		description: "Text-to-speech"
+	},
+	{
+		method: "POST",
+		path: TRANSCRIPTIONS_PATH,
+		service: "transcription",
+		description: "Audio transcription (multipart)"
+	},
+	{
+		method: "POST",
+		path: TRANSLATIONS_PATH,
+		service: "transcription",
+		description: "Audio translation (multipart)"
+	},
+	{
+		method: "POST",
+		path: VIDEOS_PATH,
+		service: "video",
+		description: "Video generation submit (Sora)"
+	},
+	{
+		method: "POST",
+		path: "/v1/videos/generations",
+		service: "video",
+		description: "Grok video generation submit"
+	},
+	{
+		method: "GET",
+		path: "/v1/videos/{id}",
+		examplePath: "/v1/videos/test-id",
+		service: "video",
+		description: "Video job status (Sora/Grok)"
+	},
+	{
+		method: "POST",
+		path: "/v1beta/models/{model}:predictLongRunning",
+		examplePath: "/v1beta/models/veo-3:predictLongRunning",
+		service: "video",
+		description: "Veo video submit"
+	},
+	{
+		method: "GET",
+		path: "/v1beta/operations/{name}",
+		examplePath: "/v1beta/operations/test-op",
+		service: "video",
+		description: "Veo operation status"
+	},
+	{
+		method: "POST",
+		path: "/v1beta/models/{model}:predict",
+		examplePath: "/v1beta/models/imagen-3:predict",
+		service: "gemini",
+		description: "Gemini Imagen predict"
+	},
+	{
+		method: "POST",
+		path: GEMINI_INTERACTIONS_PATH,
+		service: "gemini",
+		description: "Gemini interactions"
+	},
+	{
+		method: "POST",
+		path: "/v1beta/models/{model}:embedContent",
+		examplePath: "/v1beta/models/text-embedding-004:embedContent",
+		service: "gemini",
+		description: "Gemini embedContent"
+	},
+	{
+		method: "POST",
+		path: "/v1beta/models/{model}:generateContent",
+		examplePath: "/v1beta/models/gemini-2.0-flash:generateContent",
+		service: "gemini",
+		description: "Gemini generateContent"
+	},
+	{
+		method: "POST",
+		path: "/v1beta/models/{model}:streamGenerateContent",
+		examplePath: "/v1beta/models/gemini-2.0-flash:streamGenerateContent",
+		service: "gemini",
+		description: "Gemini streaming"
+	},
+	{
+		method: "POST",
+		path: "/v1/projects/{project}/locations/{location}/publishers/google/models/{model}:generateContent",
+		examplePath: "/v1/projects/test-proj/locations/us-central1/publishers/google/models/gemini-2.0-flash:generateContent",
+		service: "vertex",
+		description: "Vertex AI generateContent"
+	},
+	{
+		method: "POST",
+		path: "/v1/projects/{project}/locations/{location}/publishers/google/models/{model}:streamGenerateContent",
+		examplePath: "/v1/projects/test-proj/locations/us-central1/publishers/google/models/gemini-2.0-flash:streamGenerateContent",
+		service: "vertex",
+		description: "Vertex AI streaming"
+	},
+	{
+		method: "POST",
+		path: "/model/{modelId}/invoke",
+		examplePath: "/model/anthropic.claude-3/invoke",
+		service: "bedrock",
+		description: "Bedrock invoke"
+	},
+	{
+		method: "POST",
+		path: "/model/{modelId}/invoke-with-response-stream",
+		examplePath: "/model/anthropic.claude-3/invoke-with-response-stream",
+		service: "bedrock",
+		description: "Bedrock streaming invoke"
+	},
+	{
+		method: "POST",
+		path: "/model/{modelId}/converse",
+		examplePath: "/model/anthropic.claude-3/converse",
+		service: "bedrock",
+		description: "Bedrock converse"
+	},
+	{
+		method: "POST",
+		path: "/model/{modelId}/converse-stream",
+		examplePath: "/model/anthropic.claude-3/converse-stream",
+		service: "bedrock",
+		description: "Bedrock converse streaming"
+	},
+	{
+		method: "POST",
+		path: SEARCH_PATH,
+		service: "search",
+		description: "Tavily search"
+	},
+	{
+		method: "POST",
+		path: RERANK_PATH,
+		service: "rerank",
+		description: "Cohere rerank"
+	},
+	{
+		method: "POST",
+		path: MODERATIONS_PATH,
+		service: "moderation",
+		description: "Moderation"
+	},
+	{
+		method: "POST",
+		path: ELEVENLABS_SOUND_GENERATION_PATH,
+		service: "elevenlabs",
+		description: "ElevenLabs sound generation"
+	},
+	{
+		method: "POST",
+		path: "/v1/text-to-voice/design",
+		service: "elevenlabs",
+		description: "ElevenLabs voice design preview"
+	},
+	{
+		method: "POST",
+		path: "/v1/text-to-voice",
+		service: "elevenlabs",
+		description: "ElevenLabs save designed voice"
+	},
+	{
+		method: "GET",
+		path: "/v1/voices/{voice_id}",
+		examplePath: "/v1/voices/test-voice",
+		service: "elevenlabs",
+		description: "ElevenLabs voice slot get"
+	},
+	{
+		method: "DELETE",
+		path: "/v1/voices/{voice_id}",
+		examplePath: "/v1/voices/test-voice",
+		service: "elevenlabs",
+		description: "ElevenLabs voice slot delete"
+	},
+	{
+		method: "POST",
+		path: "/v1/text-to-speech/{voice_id}",
+		examplePath: "/v1/text-to-speech/test-voice",
+		service: "elevenlabs",
+		description: "ElevenLabs text-to-speech"
+	},
+	{
+		method: "POST",
+		path: "/v1/music",
+		service: "elevenlabs",
+		description: "ElevenLabs music"
+	},
+	{
+		method: "POST",
+		path: "/v1/music/{subtype}",
+		examplePath: "/v1/music/generation",
+		service: "elevenlabs",
+		description: "ElevenLabs music sub-operation"
+	},
+	{
+		method: "POST",
+		path: "/fal/queue/submit/{model}",
+		examplePath: "/fal/queue/submit/fal-ai-test",
+		service: "fal",
+		description: "fal.ai queue submit"
+	},
+	{
+		method: "GET",
+		path: "/fal/queue/requests/{requestId}",
+		examplePath: "/fal/queue/requests/test-id",
+		service: "fal",
+		description: "fal.ai queue status/result"
+	},
+	{
+		method: "POST",
+		path: "/fal/queue/requests/{requestId}",
+		examplePath: "/fal/queue/requests/test-id",
+		service: "fal",
+		description: "fal.ai queue status/result (POST)"
+	},
+	{
+		method: "PUT",
+		path: "/fal/queue/requests/{requestId}",
+		examplePath: "/fal/queue/requests/test-id",
+		service: "fal",
+		description: "fal.ai queue status/result (PUT)"
+	},
+	{
+		method: "POST",
+		path: "/fal/run/{model}",
+		examplePath: "/fal/run/fal-ai-test",
+		service: "fal",
+		description: "fal.ai synchronous run"
+	},
+	{
+		method: "POST",
+		path: "/v1/batches/{batch_id}/cancel",
+		examplePath: "/v1/batches/batch-test123/cancel",
+		service: "batches",
+		description: "Batch cancel"
+	},
+	{
+		method: "GET",
+		path: "/v1/batches/{batch_id}",
+		examplePath: "/v1/batches/batch-test123",
+		service: "batches",
+		description: "Batch retrieve"
+	},
+	{
+		method: "GET",
+		path: BATCHES_PATH,
+		service: "batches",
+		description: "Batch list"
+	},
+	{
+		method: "POST",
+		path: BATCHES_PATH,
+		service: "batches",
+		description: "Batch create"
+	},
+	{
+		method: "GET",
+		path: "/v1/files/{file_id}/content",
+		examplePath: "/v1/files/file-test123/content",
+		service: "files",
+		description: "File content download"
+	},
+	{
+		method: "GET",
+		path: "/v1/files/{file_id}",
+		examplePath: "/v1/files/file-test123",
+		service: "files",
+		description: "File retrieve"
+	},
+	{
+		method: "DELETE",
+		path: "/v1/files/{file_id}",
+		examplePath: "/v1/files/file-test123",
+		service: "files",
+		description: "File delete"
+	},
+	{
+		method: "GET",
+		path: "/v1/files",
+		service: "files",
+		description: "File list"
+	},
+	{
+		method: "POST",
+		path: "/v1/files",
+		service: "files",
+		description: "File upload (JSON or multipart)"
+	},
+	{
+		method: "POST",
+		path: "/v1/fine_tuning/jobs/{job_id}/cancel",
+		examplePath: "/v1/fine_tuning/jobs/ftjob-test123/cancel",
+		service: "fine-tuning",
+		description: "Fine-tuning job cancel"
+	},
+	{
+		method: "GET",
+		path: "/v1/fine_tuning/jobs/{job_id}/events",
+		examplePath: "/v1/fine_tuning/jobs/ftjob-test123/events",
+		service: "fine-tuning",
+		description: "Fine-tuning job events"
+	},
+	{
+		method: "GET",
+		path: "/v1/fine_tuning/jobs/{job_id}",
+		examplePath: "/v1/fine_tuning/jobs/ftjob-test123",
+		service: "fine-tuning",
+		description: "Fine-tuning job retrieve"
+	},
+	{
+		method: "GET",
+		path: "/v1/fine_tuning/jobs",
+		service: "fine-tuning",
+		description: "Fine-tuning job list"
+	},
+	{
+		method: "POST",
+		path: "/v1/fine_tuning/jobs",
+		service: "fine-tuning",
+		description: "Fine-tuning job create"
+	},
+	{
+		method: "POST",
+		path: "/v1/vector_stores/{vector_store_id}/search",
+		examplePath: "/v1/vector_stores/vs-test123/search",
+		service: "vector-stores",
+		description: "Vector store search"
+	},
+	{
+		method: "GET",
+		path: "/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/files",
+		examplePath: "/v1/vector_stores/vs-test123/file_batches/vsbf-test123/files",
+		service: "vector-stores",
+		description: "Vector file batch files list"
+	},
+	{
+		method: "POST",
+		path: "/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel",
+		examplePath: "/v1/vector_stores/vs-test123/file_batches/vsbf-test123/cancel",
+		service: "vector-stores",
+		description: "Vector file batch cancel"
+	},
+	{
+		method: "GET",
+		path: "/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}",
+		examplePath: "/v1/vector_stores/vs-test123/file_batches/vsbf-test123",
+		service: "vector-stores",
+		description: "Vector file batch retrieve"
+	},
+	{
+		method: "POST",
+		path: "/v1/vector_stores/{vector_store_id}/file_batches",
+		examplePath: "/v1/vector_stores/vs-test123/file_batches",
+		service: "vector-stores",
+		description: "Vector file batch create"
+	},
+	{
+		method: "GET",
+		path: "/v1/vector_stores/{vector_store_id}/files/{file_id}",
+		examplePath: "/v1/vector_stores/vs-test123/files/file-test123",
+		service: "vector-stores",
+		description: "Vector store file retrieve"
+	},
+	{
+		method: "DELETE",
+		path: "/v1/vector_stores/{vector_store_id}/files/{file_id}",
+		examplePath: "/v1/vector_stores/vs-test123/files/file-test123",
+		service: "vector-stores",
+		description: "Vector store file delete"
+	},
+	{
+		method: "POST",
+		path: "/v1/vector_stores/{vector_store_id}/files",
+		examplePath: "/v1/vector_stores/vs-test123/files",
+		service: "vector-stores",
+		description: "Vector store file attach"
+	},
+	{
+		method: "GET",
+		path: "/v1/vector_stores/{vector_store_id}/files",
+		examplePath: "/v1/vector_stores/vs-test123/files",
+		service: "vector-stores",
+		description: "Vector store files list"
+	},
+	{
+		method: "GET",
+		path: "/v1/vector_stores/{vector_store_id}",
+		examplePath: "/v1/vector_stores/vs-test123",
+		service: "vector-stores",
+		description: "Vector store retrieve"
+	},
+	{
+		method: "POST",
+		path: "/v1/vector_stores/{vector_store_id}",
+		examplePath: "/v1/vector_stores/vs-test123",
+		service: "vector-stores",
+		description: "Vector store modify"
+	},
+	{
+		method: "DELETE",
+		path: "/v1/vector_stores/{vector_store_id}",
+		examplePath: "/v1/vector_stores/vs-test123",
+		service: "vector-stores",
+		description: "Vector store delete"
+	},
+	{
+		method: "GET",
+		path: "/v1/vector_stores",
+		service: "vector-stores",
+		description: "Vector store list"
+	},
+	{
+		method: "POST",
+		path: "/v1/vector_stores",
+		service: "vector-stores",
+		description: "Vector store create"
+	},
+	{
+		method: "POST",
+		path: COMPLETIONS_PATH,
+		service: "openai",
+		description: "OpenAI chat completions"
+	},
+	{
+		method: "GET",
+		path: "/__aimock/health",
+		service: "control",
+		description: "Control health"
+	},
+	{
+		method: "GET",
+		path: "/__aimock/journal",
+		service: "control",
+		description: "Request journal"
+	},
+	{
+		method: "GET",
+		path: "/__aimock/fixtures",
+		service: "control",
+		description: "Fixture count"
+	},
+	{
+		method: "POST",
+		path: "/__aimock/fixtures",
+		service: "control",
+		description: "Add fixtures"
+	},
+	{
+		method: "DELETE",
+		path: "/__aimock/fixtures",
+		service: "control",
+		description: "Clear fixtures"
+	},
+	{
+		method: "GET",
+		path: "/__aimock/chaos",
+		service: "control",
+		description: "Read chaos config"
+	},
+	{
+		method: "POST",
+		path: "/__aimock/chaos",
+		service: "control",
+		description: "Set chaos config"
+	},
+	{
+		method: "DELETE",
+		path: "/__aimock/chaos",
+		service: "control",
+		description: "Clear chaos override"
+	},
+	{
+		method: "POST",
+		path: "/__aimock/reset",
+		service: "control",
+		description: "Full reset"
+	},
+	{
+		method: "POST",
+		path: "/__aimock/reset/journal",
+		service: "control",
+		description: "Journal-only reset"
+	},
+	{
+		method: "POST",
+		path: "/__aimock/reset/fixtures",
+		service: "control",
+		description: "Full reset (deprecated alias)"
+	},
+	{
+		method: "POST",
+		path: "/__aimock/error",
+		service: "control",
+		description: "One-shot error"
+	},
+	{
+		method: "GET",
+		path: "/__aimock/openapi.json",
+		service: "control",
+		description: "OpenAPI catalog"
+	},
+	{
+		method: "GET",
+		path: "/__aimock/routes",
+		service: "control",
+		description: "Flat route list"
+	}
+];
+/**
+* Compile an OpenAPI path template (`{param}` segments) to the equivalent
+* single-segment matcher. Every `{param}` becomes `[^/]+`; everything else
+* matches literally (including `:action` suffixes like `:predict`).
+*
+* This is intentionally the CANONICAL matcher, not a copy of each
+* dispatcher's regex: a couple of dispatch regexes are deliberately wider
+* (e.g. `VEO_OPERATION_RE` allows multi-segment operation names), so the
+* registry matcher may miss exotic paths the dispatcher serves — but it must
+* never CLAIM a path the dispatcher does not serve, which is the direction
+* the runtime drift guard relies on.
+*/
+function templateToRegExp(template) {
+	const pattern = template.split(/(\{[^}]+\})/g).map((part) => /^\{[^}]+\}$/.test(part) ? "[^/]+" : part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("");
+	return new RegExp(`^${pattern}$`);
+}
+/**
+* Find the registry entry serving `METHOD pathname`, in dispatcher order
+* (first match wins — `ROUTE_DEFINITIONS` is kept in dispatch order for
+* exactly this reason). Returns `undefined` when no catalog entry covers the
+* request. Method comparison is case-insensitive, like the dispatcher.
+*/
+function matchRouteDefinition(method, pathname) {
+	const want = method.toUpperCase();
+	for (const def of ROUTE_DEFINITIONS) {
+		if (def.method.toUpperCase() !== want) continue;
+		if (def.path === pathname) return def;
+		if (def.path.includes("{") && templateToRegExp(def.path).test(pathname)) return def;
+	}
+}
+
+//#endregion
+exports.AZURE_DEPLOYMENT_RE = AZURE_DEPLOYMENT_RE;
+exports.BATCHES_CANCEL_RE = BATCHES_CANCEL_RE;
+exports.BATCHES_ID_RE = BATCHES_ID_RE;
+exports.BATCHES_PATH = BATCHES_PATH;
+exports.BEDROCK_CONVERSE_RE = BEDROCK_CONVERSE_RE;
+exports.BEDROCK_CONVERSE_STREAM_RE = BEDROCK_CONVERSE_STREAM_RE;
+exports.BEDROCK_INVOKE_RE = BEDROCK_INVOKE_RE;
+exports.BEDROCK_STREAM_RE = BEDROCK_STREAM_RE;
+exports.BYTEPLUS_VIDEO_STATUS_RE = BYTEPLUS_VIDEO_STATUS_RE;
+exports.BYTEPLUS_VIDEO_SUBMIT_RE = BYTEPLUS_VIDEO_SUBMIT_RE;
+exports.COHERE_CHAT_PATH = COHERE_CHAT_PATH;
+exports.COHERE_EMBED_PATH = COHERE_EMBED_PATH;
+exports.COMPLETIONS_PATH = COMPLETIONS_PATH;
+exports.CONTROL_PREFIX = CONTROL_PREFIX;
+exports.ELEVENLABS_MUSIC_RE = ELEVENLABS_MUSIC_RE;
+exports.ELEVENLABS_SOUND_GENERATION_PATH = ELEVENLABS_SOUND_GENERATION_PATH;
+exports.ELEVENLABS_TTS_RE = ELEVENLABS_TTS_RE;
+exports.ELEVENLABS_VOICE_CREATE_PATH = ELEVENLABS_VOICE_CREATE_PATH;
+exports.ELEVENLABS_VOICE_DESIGN_PATH = ELEVENLABS_VOICE_DESIGN_PATH;
+exports.ELEVENLABS_VOICE_RE = ELEVENLABS_VOICE_RE;
+exports.EMBEDDINGS_PATH = EMBEDDINGS_PATH;
+exports.FAL_QUEUE_REQUESTS_RE = FAL_QUEUE_REQUESTS_RE;
+exports.FAL_QUEUE_SUBMIT_RE = FAL_QUEUE_SUBMIT_RE;
+exports.FAL_ROUTE_RE = FAL_ROUTE_RE;
+exports.FAL_RUN_RE = FAL_RUN_RE;
+exports.FILES_CONTENT_RE = FILES_CONTENT_RE;
+exports.FILES_ID_RE = FILES_ID_RE;
+exports.FILES_PATH = FILES_PATH;
+exports.FINE_TUNING_CANCEL_RE = FINE_TUNING_CANCEL_RE;
+exports.FINE_TUNING_EVENTS_RE = FINE_TUNING_EVENTS_RE;
+exports.FINE_TUNING_ID_RE = FINE_TUNING_ID_RE;
+exports.FINE_TUNING_JOBS_PATH = FINE_TUNING_JOBS_PATH;
+exports.GEMINI_EMBED_RE = GEMINI_EMBED_RE;
+exports.GEMINI_INTERACTIONS_PATH = GEMINI_INTERACTIONS_PATH;
+exports.GEMINI_LIVE_PATH = GEMINI_LIVE_PATH;
+exports.GEMINI_PATH_RE = GEMINI_PATH_RE;
+exports.GEMINI_PREDICT_RE = GEMINI_PREDICT_RE;
+exports.GROK_VIDEO_STATUS_RE = GROK_VIDEO_STATUS_RE;
+exports.GROK_VIDEO_SUBMIT_PATH = GROK_VIDEO_SUBMIT_PATH;
+exports.HEALTH_PATH = HEALTH_PATH;
+exports.IMAGES_EDIT_PATH = IMAGES_EDIT_PATH;
+exports.IMAGES_PATH = IMAGES_PATH;
+exports.IMAGES_VARIATIONS_PATH = IMAGES_VARIATIONS_PATH;
+exports.LIVE_PATH = LIVE_PATH;
+exports.MESSAGES_PATH = MESSAGES_PATH;
+exports.METRICS_PATH = METRICS_PATH;
+exports.MODELS_PATH = MODELS_PATH;
+exports.MODERATIONS_PATH = MODERATIONS_PATH;
+exports.OLLAMA_CHAT_PATH = OLLAMA_CHAT_PATH;
+exports.OLLAMA_EMBEDDINGS_PATH = OLLAMA_EMBEDDINGS_PATH;
+exports.OLLAMA_EMBED_PATH = OLLAMA_EMBED_PATH;
+exports.OLLAMA_GENERATE_PATH = OLLAMA_GENERATE_PATH;
+exports.OLLAMA_TAGS_PATH = OLLAMA_TAGS_PATH;
+exports.OPENAI_VIDEO_STATUS_RE = OPENAI_VIDEO_STATUS_RE;
+exports.OPENROUTER_CREDITS_PATH = OPENROUTER_CREDITS_PATH;
+exports.OPENROUTER_KEY_PATH = OPENROUTER_KEY_PATH;
+exports.OPENROUTER_MODELS_PATH = OPENROUTER_MODELS_PATH;
+exports.OPENROUTER_VIDEOS_PATH = OPENROUTER_VIDEOS_PATH;
+exports.OPENROUTER_VIDEO_CONTENT_RE = OPENROUTER_VIDEO_CONTENT_RE;
+exports.OPENROUTER_VIDEO_MODELS_PATH = OPENROUTER_VIDEO_MODELS_PATH;
+exports.OPENROUTER_VIDEO_STATUS_RE = OPENROUTER_VIDEO_STATUS_RE;
+exports.READY_PATH = READY_PATH;
+exports.REALTIME_PATH = REALTIME_PATH;
+exports.REQUESTS_PATH = REQUESTS_PATH;
+exports.RERANK_PATH = RERANK_PATH;
+exports.RESPONSES_PATH = RESPONSES_PATH;
+exports.ROUTE_DEFINITIONS = ROUTE_DEFINITIONS;
+exports.SEARCH_PATH = SEARCH_PATH;
+exports.SPEECH_PATH = SPEECH_PATH;
+exports.TRANSCRIPTIONS_PATH = TRANSCRIPTIONS_PATH;
+exports.TRANSLATIONS_PATH = TRANSLATIONS_PATH;
+exports.VECTOR_STORES_BATCH_CANCEL_RE = VECTOR_STORES_BATCH_CANCEL_RE;
+exports.VECTOR_STORES_BATCH_FILES_RE = VECTOR_STORES_BATCH_FILES_RE;
+exports.VECTOR_STORES_BATCH_RE = VECTOR_STORES_BATCH_RE;
+exports.VECTOR_STORES_FILES_RE = VECTOR_STORES_FILES_RE;
+exports.VECTOR_STORES_FILE_BATCHES_RE = VECTOR_STORES_FILE_BATCHES_RE;
+exports.VECTOR_STORES_FILE_RE = VECTOR_STORES_FILE_RE;
+exports.VECTOR_STORES_ID_RE = VECTOR_STORES_ID_RE;
+exports.VECTOR_STORES_PATH = VECTOR_STORES_PATH;
+exports.VECTOR_STORES_SEARCH_RE = VECTOR_STORES_SEARCH_RE;
+exports.VEO_OPERATION_RE = VEO_OPERATION_RE;
+exports.VEO_PREDICT_LRO_RE = VEO_PREDICT_LRO_RE;
+exports.VERTEX_AI_RE = VERTEX_AI_RE;
+exports.VIDEOS_PATH = VIDEOS_PATH;
+exports.matchRouteDefinition = matchRouteDefinition;
+//# sourceMappingURL=route-registry.cjs.map