# OmniRoute Codebase Documentation (Norsk) 🌐 **Languages:** 🇺🇸 [English](../../../../architecture/CODEBASE_DOCUMENTATION.md) · 🇪🇹 [am](../../../am/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇸🇦 [ar](../../../ar/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇦🇿 [az](../../../az/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇧🇬 [bg](../../../bg/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇧🇩 [bn](../../../bn/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇧🇦 [bs](../../../bs/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇨🇿 [cs](../../../cs/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇩🇰 [da](../../../da/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇩🇪 [de](../../../de/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇬🇷 [el](../../../el/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇪🇸 [es](../../../es/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇪🇪 [et](../../../et/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇷 [fa](../../../fa/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇫🇮 [fi](../../../fi/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇫🇷 [fr](../../../fr/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇪 [ga](../../../ga/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [gu](../../../gu/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇳🇬 [ha](../../../ha/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇱 [he](../../../he/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [hi](../../../hi/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇭🇷 [hr](../../../hr/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇭🇺 [hu](../../../hu/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇦🇲 [hy](../../../hy/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇩 [id](../../../id/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇳🇬 [ig](../../../ig/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇹 [it](../../../it/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇯🇵 [ja](../../../ja/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇬🇪 [ka](../../../ka/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇰🇭 [km](../../../km/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [kn](../../../kn/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇰🇷 [ko](../../../ko/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇱🇹 [lt](../../../lt/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇱🇻 [lv](../../../lv/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [ml](../../../ml/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [mr](../../../mr/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇲🇾 [ms](../../../ms/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇲🇹 [mt](../../../mt/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇲🇲 [my](../../../my/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇳🇵 [ne](../../../ne/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇳🇱 [nl](../../../nl/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [or](../../../or/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [pa](../../../pa/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇵🇭 [phi](../../../phi/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇵🇱 [pl](../../../pl/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇵🇹 [pt](../../../pt/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇷🇴 [ro](../../../ro/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇷🇺 [ru](../../../ru/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇱🇰 [si](../../../si/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇸🇰 [sk](../../../sk/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇸🇮 [sl](../../../sl/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇷🇸 [sr](../../../sr/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇸🇪 [sv](../../../sv/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇰🇪 [sw](../../../sw/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [ta](../../../ta/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇮🇳 [te](../../../te/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇹🇭 [th](../../../th/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇹🇷 [tr](../../../tr/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇵🇰 [ur](../../../ur/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇺🇿 [uz](../../../uz/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇻🇳 [vi](../../../vi/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇳🇬 [yo](../../../yo/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/architecture/CODEBASE_DOCUMENTATION.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/architecture/CODEBASE_DOCUMENTATION.md) --- > **Versjon:** v3.8.51 > **Sist oppdatert:** 2026-06-28 > **Målgruppe:** Utviklere som bidrar til OmniRoute eller bygger integrasjoner på toppen av det. > > For overordnede arkitekturdiagrammer og begrunnelsen bak hvert delsystem, les > [ARCHITECTURE.md](./ARCHITECTURE.md). For grundige gjennomganger av individuelle delsystemer > (Auto Combo, MCP-server, A2A-server, Skills, Memory, Cloud Agents, Resilience, > Compression osv.), se de dedikerte filene i denne `docs/`-mappen. Denne filen beskriver **hva som finnes i repositoriet i dag**, slik at en ny utvikler kan navigere i trestrukturen, forstå lagdelingen ved kjøring og vite hvor kode skal legges til uten å opprette nye moduler. --- ## 1. Teknologistakk | Område | Valg | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | Webrammeverk | **Next.js 16** (App Router, frittstående utdata, ingen global mellomvare) | | Språk | **TypeScript 6.0+** — mål `ES2022`, `module: esnext`, `moduleResolution: bundler`, `strict: false` | | Kjøremiljø | **Node.js** `>=22.22.2 <23` eller `>=24.0.0 <27` (håndheves via `engines` + `SUPPORTED_NODE_RANGE`) | | Database | **SQLite** via `better-sqlite3` (singleton, WAL-journalføring) | | Skrivebord | **Electron 41** + `electron-builder` 26.10 (separat arbeidsområde i `electron/`) | | Tester | **Nodes innebygde testkjører** (enhets-/integrasjonstester), **Vitest** (MCP, autoCombo, cache), **Playwright** (e2e + protocols-e2e) | | Bygging | Frittstående Next.js via `scripts/build/build-next-isolated.mjs` | | Lint/format | Flat ESLint-konfigurasjon + Prettier (`lint-staged` via Husky før commit) | | Modulsystem | ESM overalt (`"type": "module"`) | | Arbeidsområder | npm-arbeidsområde — `open-sse` er det eneste underarbeidsområdet | Stialiaser (`tsconfig.json`): - `@/*` → `src/*` - `@omniroute/open-sse` → `open-sse/index.ts` - `@omniroute/open-sse/*` → `open-sse/*` Standard HTTP-port: **`20128`** (API-et og kontrollpanelet deler samme prosess). Data- mappen angis med miljøvariabelen `DATA_DIR`, med `~/.omniroute/` som standard. --- ## 2. Repositoriets struktur ``` OmniRoute/ ├── src/ Next.js-applikasjon (App Router, biblioteker, domene, server, delt kode) ├── open-sse/ Arbeidsområde for strømmemotoren (@omniroute/open-sse) ├── electron/ Skrivebordsinnpakning (Electron 41-hovedprosess + preload) ├── bin/ CLI-inngangspunkter (omniroute, reset-password) ├── tests/ Enhets-, integrasjons-, e2e-, protocols-e2e-, oversetter- og sikkerhetstester samt testdata ├── scripts/ Hjelpeskript for bygging, synkronisering, kontroller, migrering og kjøring ├── docs/ Offentlig dokumentasjon (denne mappen) ├── public/ Statiske ressurser, PWA-manifest, service worker ├── config/ Eksempler på kjøretidskonfigurasjon ├── images/ Markedsførings-/skjermbilderessurser ├── _ideia/, _references/, _mono_repo/, _tasks/ Internt arbeids-/planleggingsmateriale (distribueres ikke) ├── CLAUDE.md Regler for repositoriet for Claude Code ├── AGENTS.md Grundigere arkitekturreferanse for agenter ├── package.json v3.8.51, rot for arbeidsområdet └── tsconfig.json Stialiaser + sentrale kompilatoralternativer ``` --- ## 3. `src/` — Next.js-applikasjon ``` src/ ├── app/ App Router-sider + API-ruter ├── lib/ Kjernebiblioteker (database, autentisering, OAuth, ferdigheter, minne, …) ├── domain/ Rent domenelag (policy, reserve, kostnad, låsing, …) ├── server/ Moduler kun for serveren (autorisasjon, CORS, autentisering) ├── shared/ Typer, konstanter, validering, kontrakter, verktøy (trygge på tvers av grenser) ├── mitm/ Hjelpefunksjoner for mellommannsproxy til CLI-integrasjon ├── models/ Lokale modellmetadata / aliaser ├── sse/ Eldre SSE-håndterere som fortsatt ligger under src/ (ikke open-sse/) ├── store/ Tilstandslagre på klientsiden ├── middleware/ Verktøy for mellomvare på rutenivå (ikke global Next.js-mellomvare) ├── scripts/ Skript i kodetreet som kan importeres av applikasjonskode ├── types/ Omgivende og delte TS-typer ├── i18n/ Lokaliseringspakker ├── instrumentation.ts Next.js-instrumenteringskrok ├── instrumentation-node.ts └── proxy.ts Hjelpefunksjon for oppstart av proxy på toppnivå ``` ### 3.1 `src/app/` — App Router App Router eksponerer både kontrollpanelgrensesnittet og det offentlige HTTP-API-et samt administrasjons-API-et. Det finnes **ingen global mellomvare** — oppfanging utføres per rute. Segmenter på toppnivå under `src/app/`: | Bane | Formål | | ----------------------------------------------------------------------------- | ------------------------------------------------------- | | `api/` | Alle HTTP API-ruter (se oversikten nedenfor) | | `a2a/` | A2A JSON-RPC 2.0-endepunkt (`POST /a2a`) | | `.well-known/agent.json/` | Oppdagelsesdokument for A2A Agent Card | | `(dashboard)/` | Kontrollpanelgrensesnitt (rutegruppe, uten URL-prefiks) | | `auth/`, `login/`, `forgot-password/`, `callback/` | Autentiseringsflyter | | `landing/` | Markedsførings-/landingsside | | `docs/` | Innebygd visning av API-dokumentasjon | | `status/`, `maintenance/`, `offline/` | Driftssider | | `privacy/`, `terms/` | Juridiske sider | | `400/`, `401/`, `403/`, `408/`, `429/`, `500/`, `502/`, `503/` | Statiske feilsider | | `error.tsx`, `global-error.tsx`, `not-found.tsx`, `forbidden/`, `loading.tsx` | Rammeverksgrenser for feil/lasting | | `layout.tsx`, `page.tsx`, `globals.css`, `manifest.ts` | Rotskall | #### 3.1.1 `src/app/(dashboard)/dashboard/` — Grensesnittsider `agents`, `analytics`, `api-manager`, `audit`, `auto-combo`, `batch`, `cache`, `changelog`, `cli-tools`, `cloud-agents`, `combos`, `compression`, `context`, `costs`, `endpoint`, `health`, `limits`, `logs`, `memory`, `onboarding`, `playground`, `providers`, `search-tools`, `settings`, `skills`, `system`, `translator`, `usage`, `webhooks`, samt `page.tsx`, `HomePageClient.tsx` og `BootstrapBanner.tsx` i roten. #### 3.1.2 `src/app/api/` — API-grupper på toppnivå ``` src/app/api/ ├── a2a/{status, tasks} ├── acp/ ├── admin/ ├── analytics/ ├── assess/ ├── auth/ ├── batches/ ├── cache/ ├── cli-tools/ ├── cloud/{codex-responses-ws} ├── combos/ ├── compliance/ ├── compression/ ├── context/ ├── db/, db-backups/ ├── evals/ ├── fallback/ ├── files/ ├── health/ ├── init/ ├── internal/{concurrency} ├── keys/ ├── logs/ ├── mcp/{audit, sse, status, stream, tools} ├── memory/{health, [id]/, route.ts} ├── model-combo-mappings/ ├── models/ ├── monitoring/ ├── oauth/ ├── openapi/ ├── policies/ ├── pricing/ ├── provider-metrics/, provider-models/, provider-nodes/ ├── providers/ ├── rate-limit/, rate-limits/ ├── resilience/ ├── restart/, shutdown/ ├── search/ ├── sessions/ ├── settings/ ├── skills/{executions, [id], install, marketplace, route.ts, skillssh} ├── storage/ ├── sync/, synced-available-models/ ├── system/ ├── tags/ ├── telemetry/ ├── token-health/ ├── translator/ ├── tunnels/ ├── services/ Administrasjon av innebygde tjenester (9router, cliproxy) — LOCAL_ONLY ├── upstream-proxy/ ├── usage/ ├── v1/ OpenAI-kompatibelt offentlig API ├── v1beta/ Gemini-lignende kompatibilitet ├── version-manager/ └── webhooks/ ``` #### 3.1.2a `src/app/api/services/` — Administrasjon av innebygde tjenester Ruter for installasjon, oppstart, avslutning og overvåking av 9Router og CLIProxyAPI. Alle baner er klassifisert som **LOCAL_ONLY** (kun tilbakekobling, fast regel nr. 17) fordi de kan kjøre `npm install` og opprette underprosesser. ``` src/app/api/services/ ├── 9router/ │ ├── _lib.ts getOrInitSupervisor()-hjelpefunksjon │ ├── install/route.ts POST — npm install via execFile │ ├── start/route.ts POST — supervisor.start() │ ├── stop/route.ts POST — supervisor.stop() │ ├── restart/route.ts POST — supervisor.restart() │ ├── update/route.ts POST — npm install av nyere versjon │ ├── rotate-key/route.ts POST — generer ny API-nøkkel + start på nytt │ ├── status/route.ts GET — direkte- + DB-status + versjonsmetadata │ └── auto-start/route.ts POST — veksle auto_start-flagget ├── cliproxy/ │ ├── _lib.ts getOrInitSupervisor()-hjelpefunksjon │ ├── install/route.ts POST — npm install │ ├── start/route.ts POST — supervisor.start() │ ├── stop/route.ts POST — supervisor.stop() │ ├── restart/route.ts POST — supervisor.restart() │ ├── update/route.ts POST — npm install av nyere versjon │ ├── status/route.ts GET — direkte- + DB-status + versjonsmetadata │ └── auto-start/route.ts POST — veksle auto_start-flagget └── [name]/ └── logs/route.ts GET — SSE-logghale (deles av alle tjenester) ``` Tilhørende brukergrensesnitt for kontrollpanelet: `src/app/(dashboard)/dashboard/providers/services/` — side med to faner (CLIProxyAPI + 9Router). Omvendt proxy for 9Routers innebygde brukergrensesnitt: `src/app/(dashboard)/dashboard/providers/services/[name]/embed/[[...path]]/route.ts` Fordypning: `docs/frameworks/EMBEDDED-SERVICES.md` #### 3.1.3 `src/app/api/v1/` — OpenAI-kompatibelt offentlig API ``` v1/ ├── accounts/[id]/ kontooppslag ├── agents/tasks/[id]/, agents/tasks/ A2A-inspirerte oppgaveendepunkter ├── api/ interne API-hjelpefunksjoner eksponert under v1/api ├── audio/{speech, transcriptions}/ TTS + STT ├── batches/[id]/{cancel}, batches/ OpenAI Batches API ├── chat/completions/ Chat Completions (hovedendepunktet) ├── completions/ eldre tekstfullføringer ├── embeddings/ vektorrepresentasjoner ├── files/[id]/, files/ Files API ├── _helpers/ delte rutehjelpere (ingen offentlig URL) ├── images/{edits, generations}/ bildegenerering + redigering ├── issues/ hjelpeendepunkter for kategorisering ├── management/{proxies}/ administrasjonsavgrensede ruter i v1 ├── messages/{count_tokens}/ kompatibilitet med meldinger i Anthropic-stil ├── models/ modelliste (`route.ts`, `catalog.ts`) ├── moderations/ moderering ├── music/ musikkgenerering ├── providers/[provider]/ operasjoner per leverandør ├── quotas/{check} kvotekontroller ├── registered-keys/ administrasjon av registrerte nøkler ├── rerank/ omrangering ├── responses/[...path]/ OpenAI Responses API (oppsamlingsrute) ├── search/ nettsøk ├── videos/ videogenerering ├── ws/ WebSocket-bro └── route.ts indekshåndterer ``` Hver rutefil følger samme mønster: ``` Rute → CORS-preflight → Zod-validering av innhold → valgfri autentisering → håndheving av API-nøkkelpolicy → delegering til håndterer (open-sse) ``` `v1beta/` er det Gemini-kompatible grensesnittet (en tynn innpakning som oversetter til den samme `open-sse/handlers/`-behandlingskjeden). ### 3.2 `src/lib/` — Kjernebiblioteker Importer alltid data, synkronisering, OAuth, ferdigheter, minne osv. gjennom disse modulene. Tabellen grupperer de faktiske katalogene og nevneverdige filene på toppnivå. | Modul | Formål | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `a2a/` | A2A-protokollserver: `taskManager.ts`, `streaming.ts`, `taskExecution.ts`, `routingLogger.ts`, `skills/` (6 ferdigheter: kostnadsanalyse, tilstandsrapport, leverandøroppdagelse, kvoteadministrasjon, smart ruting, oversikt over funksjoner) | | `acp/` | Agent-Control-Protocol: `index.ts`, `manager.ts`, `registry.ts` | | `api/` | Interne API-hjelpefunksjoner: `requireManagementAuth.ts`, `requireCliToolsAuth.ts`, `errorResponse.ts` | | `auth/` | `managementPassword.ts` (tilbakestilling av passord / hashing) | | `batches/` | Tjeneste for OpenAI Batches API (`service.ts`) | | `catalog/` | Synkronisering av OpenRouter-katalogen (`openrouterCatalog.ts`) | | `cloudAgent/` | Register for skyagenter: `api.ts`, `baseAgent.ts`, `db.ts`, `index.ts`, `registry.ts`, `types.ts`, `agents/{codex, devin, jules}.ts` | | `combos/` | Hjelpefunksjoner for oppslag av kombinasjoner | | `compliance/` | Revisjon + leverandørrevisjon: `index.ts`, `providerAudit.ts` | | `config/` | Koblingskode for kjøretidskonfigurasjon | | `db/` | SQLite-domenemoduler (se §3.2.1) | | `display/` | Hjelpefunksjoner for brukergrensesnitt/visning som brukes av API-svar | | `embeddings/` | Register for embedding-tjenester | | `env/` | Innlasting + introspeksjon av miljøvariabler | | `evals/` | Kjøretidsmiljø for evalueringer | | `guardrails/` | `piiMasker.ts`, `promptInjection.ts`, `visionBridge.ts`, `visionBridgeHelpers.ts`, `registry.ts`, `base.ts` | | `jobs/` | Bakgrunnsjobber (`autoUpdate.ts`, …) | | `memory/` | Vedvarende minne: `store.ts`, `cache.ts`, `retrieval.ts`, `summarization.ts`, `extraction.ts`, `injection.ts`, `qdrant.ts`, `settings.ts`, `verify.ts`, `schemas.ts`, `types.ts` | | `monitoring/` | `observability.ts` | | `oauth/` | OAuth-/importmoduler for leverandører (22): `agy`, `antigravity`, `claude`, `cline`, `codebuddy-cn`, `codex`, `cursor`, `devin-desktop`, `ghe-copilot`, `github`, `gitlab-duo`, `grok-cli-oauth`, `grok-cli`, `kilocode`, `kimi-coding`, `kiro`, `openference`, `qoder`, `trae`, `xai-oauth`, `zed-hosted`, `zed`, samt `services/`, `utils/` og `constants/oauth.ts` | | `plugins/` | Programtilleggsinnlaster (`index.ts`) | | `promptCache/` | `prefixAnalyzer.ts`, `index.ts` | | `providerModels/` | Administrert livssyklus for modeller: `modelDiscovery.ts`, `managedModelImport.ts`, `managedAvailableModels.ts`, `cursorAgent.ts` | | `providers/` | Hjelpefunksjoner for leverandører: `catalog.ts`, `validation.ts`, `imageValidation.ts`, `claudeExtraUsage.ts`, `codexConnectionDefaults.ts`, `codexFastTier.ts`, `webCookieAuth.ts`, `managedAvailableModels.ts`, `requestDefaults.ts` | | `resilience/` | `settings.ts` — innstillinger for kretsbryter, nedkjølingsperiode og låsing | | `runtime/` | Oppdagelse av kjøretidsfunksjoner | | `search/` | `executeWebSearch.ts` | | `services/` | Rammeverk for innebygde tjenester: `ServiceSupervisor.ts` (generisk overvåker for underprosesser med operasjonslås, ringbuffer og tilstandskontroll), `bootstrap.ts` (registrering på prosessnivå og automatisk oppstart), `registry.ts` (verktøy → overvåker-kart), `apiKey.ts` (AES-256-GCM-nøkkellager), `modelSync.ts` (periodisk modellsynkronisering), `ringBuffer.ts` (5 MB sirkulær loggbuffer), `healthCheck.ts` (HTTP-tilstandssjekk), `types.ts`, `embedWsProxy.ts` (WebSocket-proxy), `installers/{ninerouter,cliproxy}.ts`. Se `docs/frameworks/EMBEDDED-SERVICES.md` | | `agentSkills/` | Katalog + generator for agentferdigheter: `catalog.ts` (getCatalog/getSkillById/filterCatalog/computeCoverage), `generator.ts` (generateAgentSkills → skriver `skills/{id}/SKILL.md`), `openapiParser.ts` (henter REST-endepunkter fra OpenAPI-spesifikasjonen), `cliRegistryParser.ts` (henter CLI-underkommandoer fra bin/cli-registry), `schemas.ts` (Zod: AgentSkillSchema, SkillCoverageSchema, ListQuerySchema, GenerateBodySchema), `types.ts` (AgentSkill, SkillCoverage, SkillMarkdown, GeneratorReport). Brukes av REST-ruter (`/api/agent-skills/*`), MCP-verktøy (`omniroute_agent_skills_*`) og A2A-ferdigheten `list-capabilities`. Se [AGENT-SKILLS.md](../frameworks/AGENT-SKILLS.md). | | `skills/` | Rammeverk for ferdigheter: `registry.ts`, `executor.ts`, `interception.ts`, `injection.ts`, `sandbox.ts`, `custom.ts`, `hybrid.ts`, `builtins.ts`, `a2a.ts`, `providerSettings.ts`, `schemas.ts`, `skillssh.ts`, `types.ts`, samt `builtin/browser.ts` | | `spend/` | `batchWriter.ts` (buffer for utsatt skriving) | | `sync/` | `bundle.ts`, `tokens.ts` (Cloud Sync) | | `system/` | Hjelpefunksjoner på systemnivå | | `translator/` | Koblingskode for oversetter på toppnivå (delegerer til `open-sse/translator/`) | | `usage/` | Bruksregnskap: `costCalculator.ts`, `tokenAccounting.ts`, `usageHistory.ts`, `aggregateHistory.ts`, `usageStats.ts`, `callLogs.ts`, `callLogArtifacts.ts`, `fetcher.ts`, `providerLimits.ts`, `migrations.ts` | | `versionManager/` | Automatisk oppdatering + versjonsmanifest | | `ws/` | WebSocket-bro | | `zed-oauth/` | OAuth-flyt for Zed-redigeringsprogrammet | Filer på toppnivå i `src/lib/`: - Den gamle barrel-filen `localDb.ts` ble fjernet — konsumenter importerer spesifikke `src/lib/db/*`-moduler direkte. - `proxyHealth.ts`, `proxyLogger.ts`, `tokenHealthCheck.ts`, `localHealthCheck.ts` - `apiBridgeServer.ts`, `cacheLayer.ts`, `semanticCache.ts`, `settingsCache.ts` - `cloudSync.ts`, `initCloudSync.ts` - `cloudflaredTunnel.ts`, `ngrokTunnel.ts`, `tailscaleTunnel.ts` - `consoleInterceptor.ts`, `container.ts`, `gracefulShutdown.ts`, `idempotencyLayer.ts` - `ipUtils.ts`, `logEnv.ts`, `logPayloads.ts`, `logRotation.ts` - `modelAliasSeed.ts`, `modelCapabilities.ts`, `modelMetadataRegistry.ts`, `modelsDevSync.ts` - `piiSanitizer.ts`, `pricingSync.ts` - `apiKeyExposure.ts`, `cacheControlSettings.ts`, `dataPaths.ts`, `toolPolicy.ts` - `translatorEvents.ts`, `usageDb.ts`, `usageAnalytics.ts`, `webhookDispatcher.ts` #### 3.2.1 `src/lib/db/` Singleton SQLite-database (`getDbInstance()` i `core.ts`, WAL-journalføring). **Skriv aldri rå SQL i ruter eller handlere** — gå gjennom disse modulene. ![Oversikt over databaseskjemaet (utvalgte kjernetabeller)](../diagrams/exported/db-schema-overview.svg) > Kilde: [diagrams/db-schema-overview.mmd](../diagrams/db-schema-overview.mmd) Domenemoduler (hver av dem eier én eller flere tabeller): `apiKeys.ts`, `backup.ts`, `batches.ts`, `cleanup.ts`, `cliToolState.ts`, `combos.ts`, `commandCodeAuth.ts`, `compression.ts`, `compressionAnalytics.ts`, `compressionCacheStats.ts`, `compressionCombos.ts`, `compressionScheduler.ts`, `contextHandoffs.ts`, `core.ts`, `creditBalance.ts`, `databaseSettings.ts`, `detailedLogs.ts`, `domainState.ts`, `encryption.ts`, `evals.ts`, `files.ts`, `healthCheck.ts`, `jsonMigration.ts`, `migrationRunner.ts`, `modelComboMappings.ts`, `models.ts`, `oneproxy.ts`, `prompts.ts`, `providers.ts`, `providerLimits.ts`, `proxies.ts`, `quotaSnapshots.ts`, `readCache.ts`, `reasoningCache.ts`, `registeredKeys.ts`, `secrets.ts`, `sessionAccountAffinity.ts`, `settings.ts`, `stateReset.ts`, `stats.ts`, `syncTokens.ts`, `tierConfig.ts`, `upstreamProxy.ts`, `versionManager.ts`, `webhooks.ts`. `migrations/` inneholder 168 versjonerte `.sql`-filer (idempotente, transaksjonelle) og kjøres av `migrationRunner.ts` ved oppstart. Tabeller opprettet på tvers av migreringene (totalt 123): `a`, `account_key_limits`, `api_keys`, `batches`, `call_logs`, `combo_adaptation_state`, `combos`, `command_code_auth_sessions`, `compression_analytics`, `compression_cache_stats`, `compression_combo_assignments`, `compression_combos`, `context_handoffs`, `daily_usage_summary`, `db_meta`, `domain_budgets`, `domain_circuit_breakers`, `domain_cost_history`, `domain_fallback_chains`, `domain_lockout_state`, `eval_cases`, `eval_runs`, `eval_suites`, `files`, `hourly_usage_summary`, `key_value`, `mcp_tool_audit`, `memories`, `model_combo_mappings`, `provider_connections`, `provider_key_limits`, `provider_nodes`, `proxy_assignments`, `proxy_logs`, `proxy_registry`, `quota_snapshots`, `reasoning_cache`, `registered_keys`, `request_detail_logs`, `routing_decisions`, `semantic_cache`, `session_account_affinity`, `skill_executions`, `skills`, `sync_tokens`, `tier_assignments`, `tier_config`, `upstream_proxy_config`, `usage_history`, `version_manager`, `webhooks` (pluss virtuelle FTS5-tabeller for minnesøk). ### 3.3 `src/domain/` — Domenelag Ren forretningslogikk, ingen I/O. Importeres av ruter og handlere. | Fil | Formål | | ------------------------------------------ | -------------------------------------------------------- | | `policyEngine.ts` | Overordnet policyresolver | | `fallbackPolicy.ts` | Beslutningstre for reservealternativer | | `costRules.ts` | Regler for kostnadsberegning | | `lockoutPolicy.ts` | Beslutninger om modellutestenging | | `tagRouter.ts` | Taggbasert ruting | | `comboResolver.ts` | Kombinasjonsoppløsning fra forespørsel → målliste | | `connectionModelRules.ts` | Modellfiltre per tilkobling | | `modelAvailability.ts` | Kontroll av modelltilgjengelighet | | `degradation.ts` | Overganger til redusert modus | | `providerExpiration.ts` | Oppdagelse av utløpt konto/nøkkel | | `quotaCache.ts` | Bufrede kvotebeslutninger | | `responses.ts`, `omnirouteResponseMeta.ts` | Hjelpefunksjoner for responsformat | | `configAudit.ts` | Revisjon av konfigurasjonsendringer | | `assessment/` | Modellvurdering (i henhold til RFC, delvis implementert) | | `types.ts` | Delte domenetyper | ### 3.4 `src/server/` — Kun for server Kan ikke importeres fra klientkomponenter. ``` server/ ├── auth/loginGuard.ts ├── authz/ │ ├── classify.ts Klassifiserer ruter som offentlige eller administrasjonsruter │ ├── assertAuth.ts Hjelpefunksjon for validering │ ├── context.ts Autorisasjonskontekst per forespørsel │ ├── headers.ts │ ├── pipeline.ts Autorisasjonskjede │ ├── policies/ Konkrete policyer │ └── types.ts └── cors/origins.ts Tillatelsesliste for CORS-opprinnelser ``` ### 3.5 `src/shared/` — Trygt å dele Delt inn i fokuserte undermapper: - `constants/` — `providers.ts` (Zod-validert leverandørkatalog), `models.ts`, `modelSpecs.ts`, `modelCompat.ts`, `pricing.ts`, `cliTools.ts`, `cliCompatProviders.ts`, `routingStrategies.ts`, `comboConfigMode.ts`, `headers.ts`, `upstreamHeaders.ts` (blokkeringsliste), `mcpScopes.ts`, `errorCodes.ts`, `publicApiRoutes.ts`, `batch.ts`, `batchEndpoints.ts`, `bodySize.ts`, `colors.ts`, `appConfig.ts`, `config.ts`, `sidebarVisibility.ts`, `visionBridgeDefaults.ts`. - `validation/` — `schemas.ts` (~80 Zod-skjemaer), `compressionConfigSchemas.ts`, `providerSchema.ts`, `settingsSchemas.ts`, `helpers.ts`. - `contracts/` — offentlige API-kontrakter publisert på npm. - `types/` — delte TS-typer. - `utils/` — `circuitBreaker.ts`, `apiAuth.ts`, `apiKey.ts`, `apiKeyPolicy.ts`, `api.ts`, `classify429.ts`, `cliCompat.ts`, `clipboard.ts`, `cloud.ts`, `cn.ts`, `cors.ts`, `featureFlags.ts`, `fetchTimeout.ts`, `formatting.ts`, `inputSanitizer.ts`, `logger.ts`, `machine.ts`, `machineId.ts`, `maskEmail.ts`, `modelCatalogSearch.ts`, `nodeRuntimeSupport.ts`, `parseApiKeys.ts`, `providerHints.ts`, `providerModelAliases.ts`, `rateLimiter.ts`, `releaseNotes.ts`, `a11yAudit.ts`, samt kontrollpanel-hooks/-komponenter under `services/`, `network/`, `middleware/`, `schemas/`, `hooks/`, `components/`. --- ## 4. `open-sse/` — Arbeidsområde for strømmemotoren Separat npm-arbeidsområde publisert som `@omniroute/open-sse`. Eier behandling av forespørsler, eksekutorer, oversettere, tjenester, transformatoren og MCP-serveren. ``` open-sse/ ├── index.ts Offentlige eksporter ├── package.json Arbeidsområdemanifest ├── tsconfig.json ├── types.d.ts ├── config/ Leverandørregistre, headerprofiler, identitet, … ├── handlers/ Forespørselshåndterere (chat, embeddings, lyd, bilde, …) ├── executors/ 108 leverandørspesifikke HTTP-eksekutorer ├── translator/ Formatkonvertering (OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro) ├── transformer/ Responses API ↔ Chat Completions-strømtransformator ├── services/ Over 80 tjenestemoduler (kombinasjoner, reserve, kvoter, identitet, …) ├── utils/ Strømmehjelpere, TLS-klient, AWS SigV4, proxyhenting, … └── mcp-server/ MCP-server (3 transporter, 33 omfang, 110 verktøy) ``` ### 4.1 `open-sse/handlers/` | Håndterer | Formål | | ----------------------- | ----------------------------------------------------------------------------------------------- | | `chatCore.ts` | Hovedflyt for chat (hurtigbuffer, hastighetsbegrensning, kombinasjonsruting, eksekutordispatch) | | `responsesHandler.ts` | Inngangspunkt for OpenAI Responses API | | `embeddings.ts` | Embeddings | | `imageGeneration.ts` | Bildegenerering | | `audioSpeech.ts` | Tekst-til-tale | | `audioTranscription.ts` | Tale-til-tekst | | `videoGeneration.ts` | Videogenerering | | `musicGeneration.ts` | Musikkgenerering | | `rerank.ts` | Omrangering | | `moderations.ts` | Moderering | | `search.ts` | Nettsøk | | `sseParser.ts` | SSE-hendelsesparser | | `usageExtractor.ts` | Henter tokenantall fra oppstrømsstrømmer | | `responseSanitizer.ts` | Fjerner leverandørspesifikk støy | | `responseTranslator.ts` | Bindeledd mellom leverandørresponsen og oversetterlaget | ### 4.2 `open-sse/executors/` 108 leverandøreksekutorer, som alle utvider `BaseExecutor` (`base.ts`): `antigravity`, `azure-openai`, `blackbox-web`, `cliproxyapi`, `chatgpt-web-codex`, `cloudflare-ai`, `codex`, `commandCode`, `cursor`, `default`, `devin-cli`, `muse-spark-web`, `nlpcloud`, `opencode`, `perplexity-web`, `petals`, `pollinations`, `qoder`, `vertex`, `devin-desktop`, samt `claudeIdentity.ts` (delt identitetshjelper) og `index.ts` (register). > Merk: Leverandører som ikke er oppført her, betjenes av `default.ts` ved hjelp av den generiske > OpenAI-kompatible eksekutoren. Den fullstendige leverandørkatalogen (355 leverandører) finnes i > `src/shared/constants/providers.ts`. ### 4.3 `open-sse/translator/` Nav-og-eike-oversettelse (OpenAI er navet). - **9 forespørselsoversettere** (`translator/request/`): `antigravity-to-openai`, `claude-to-gemini`, `claude-to-openai`, `gemini-to-openai`, `openai-responses`, `openai-to-claude`, `openai-to-cursor`, `openai-to-gemini`, `openai-to-kiro`. - **9 responsoversettere** (`translator/response/`): `claude-to-openai`, `cursor-to-openai`, `gemini-to-claude`, `gemini-to-openai`, `kiro-to-openai`, `openai-responses`, `openai-to-antigravity`, `openai-to-claude`. - **9 hjelpere** (`translator/helpers/`): `claudeHelper`, `geminiHelper`, `geminiToolsSanitizer`, `maxTokensHelper`, `openaiHelper`, `responsesApiHelper`, `schemaCoercion`, `toolCallHelper`, samt hjelpetester. - **Bildehjelpere** (`translator/image/sizeMapper.ts`). - På toppnivå: `bootstrap.ts`, `formats.ts`, `registry.ts`, `index.ts`. ### 4.4 `open-sse/transformer/` - `responsesTransformer.ts` — `TransformStream`-basert Responses API ↔ Chat Completions-konverterer (brukes av oppsamlingsruten `responses/`). ### 4.5 `open-sse/services/` Høydepunkter (fullstendig liste under `open-sse/services/`): | Område | Filer | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Kombinasjonsruting | `combo.ts` (19 strategier), `comboConfig.ts`, `comboMetrics.ts`, `comboManifestMetrics.ts`, `comboAgentMiddleware.ts` | | Auto Combo-motor | `autoCombo/` — `engine.ts`, `scoring.ts`, `taskFitness.ts`, `virtualFactory.ts`, `modePacks.ts`, `autoPrefix.ts`, `persistence.ts`, `providerDiversity.ts`, `providerRegistryAccessor.ts`, `routerStrategy.ts`, `selfHealing.ts`, `index.ts` | | Robusthet | `accountFallback.ts` (nedkjøling + sperring), `errorClassifier.ts`, `requestRejectedStreak.ts`, `emergencyFallback.ts`, `rateLimitManager.ts`, `rateLimitSemaphore.ts`, `accountSemaphore.ts`, `accountSelector.ts` | | Kvoter | `quotaMonitor.ts`, `quotaPreflight.ts`, `bailianQuotaFetcher.ts`, `codexQuotaFetcher.ts`, `deepseekQuotaFetcher.ts`, `openrouterQuotaFetcher.ts`, `openrouterFreeWindow.ts`, `llmgatewayQuotaFetcher.ts`, `crofUsageFetcher.ts`, `antigravityCredits.ts` | | Hurtigbufring | `reasoningCache.ts`, `searchCache.ts`, `signatureCache.ts`, `requestDedup.ts` | | Rutingsintelligens | `intentClassifier.ts`, `taskAwareRouter.ts`, `backgroundTaskDetector.ts`, `volumeDetector.ts`, `wildcardRouter.ts`, `workflowFSM.ts`, `specificityDetector.ts`, `specificityRules.ts`, `specificityTypes.ts` | | Modellhåndtering | `modelCapabilities.ts`, `modelDeprecation.ts`, `modelFamilyFallback.ts`, `modelStrip.ts`, `model.ts`, `provider.ts`, `providerRequestDefaults.ts`, `providerCostData.ts`, `payloadRules.ts` | | Komprimering | `compression/` — fullstendig oppkobling av komprimeringsmotoren | | Token + økt | `tokenRefresh.ts`, `sessionManager.ts`, `apiKeyRotator.ts`, `contextManager.ts`, `contextHandoff.ts`, `systemPrompt.ts`, `roleNormalizer.ts`, `responsesInputSanitizer.ts`, `toolSchemaSanitizer.ts`, `toolLimitDetector.ts`, `thinkingBudget.ts` | | Nivå / manifest | `tierResolver.ts`, `tierConfig.ts`, `tierDefaults.json`, `tierTypes.ts`, `manifestAdapter.ts` | | IP / nettverk | `ipFilter.ts`, `webSearchFallback.ts` | | Batcher | `batchProcessor.ts` | | Bruk | `usage.ts` | ### 4.6 `open-sse/mcp-server/` - **110 unike verktøy** koblet opp i `server.ts` (45 kanoniske i `schemas/tools.ts` + minne-, ferdighets-, GitHub-ferdighets-, pool-, spillifiserings-, plugin-, Notion-, Obsidian-, lokalkorpus- og komprimeringsmoduler — unionen telles av `countUniqueMcpTools`). - **3 transporter**: stdio, HTTP Streamable, SSE. - **33 tilganger** håndheves under kjøring — grunnlisten finnes i `src/shared/constants/mcpScopes.ts`, og hele settet er unionen av tilgangene som deklareres av hver verktøymodul. - Revisjonstabell: `mcp_tool_audit` (fylles ut av `audit.ts`). - Filer: `server.ts`, `index.ts`, `httpTransport.ts`, `audit.ts`, `scopeEnforcement.ts`, `runtimeHeartbeat.ts`, `descriptionCompressor.ts`, `schemas/{tools, a2a, audit, index}.ts`, `tools/{advancedTools, compressionTools, memoryTools, skillTools}.ts`, samt tester under `__tests__/`. - Se [MCP-SERVER.md](../frameworks/MCP-SERVER.md) for den fullstendige verktøykatalogen. ### 4.7 `open-sse/config/` Leverandørregistre (`providerRegistry.ts`, `providerModels.ts`, `providerHeaderProfiles.ts`), modellregistre per format (`audioRegistry.ts`, `embeddingRegistry.ts`, `imageRegistry.ts`, `moderationRegistry.ts`, `musicRegistry.ts`, `rerankRegistry.ts`, `searchRegistry.ts`, `videoRegistry.ts`), identitetshjelpere (`codexIdentity.ts`, `codexInstructions.ts`, `anthropicHeaders.ts`, `antigravityUpstream.ts`, `antigravityModelAliases.ts`, `cliFingerprints.ts`, `toolCloaking.ts`, `defaultThinkingSignature.ts`), legitimasjonshjelpere (`credentialLoader.ts`, `codexClient.ts`) og skyadaptere (`azureAi.ts`, `bedrock.ts`, `datarobot.ts`, `glmProvider.ts`, `maritalk.ts`, `oci.ts`, `petals.ts`, `runway.ts`, `sap.ts`, `watsonx.ts`, `ollamaModels.ts`, `errorConfig.ts`, `constants.ts`, `registryUtils.ts`). ### 4.8 `open-sse/utils/` Strømmingsprimitiver og hjelpefunksjoner for leverandører: `stream.ts`, `streamHandler.ts`, `streamHelpers.ts`, `streamPayloadCollector.ts`, `streamReadiness.ts`, `sseHeartbeat.ts`, `proxyFetch.ts`, `proxyDispatcher.ts`, `tlsClient.ts`, `networkProxy.ts`, `awsSigV4.ts`, `cacheControlPolicy.ts`, `cursorChecksum.ts`, `cursorAgentProtobuf.ts`, `cursorVersionDetector.ts`, `comfyuiClient.ts`, `kieTask.ts`, `bypassHandler.ts`, `aiSdkCompat.ts`, `thinkTagParser.ts`, `urlSanitize.ts`, `usageTracking.ts`, `requestLogger.ts`, `progressTracker.ts`, `cors.ts`, `error.ts`, `logger.ts`, `sleep.ts`, `ollamaTransform.ts`. --- ## 5. `electron/` — Skrivebordsinnpakning ``` electron/ ├── main.js Electron-hovedprosess ├── preload.js Forhåndslastingsbro (contextIsolation aktivert) ├── types.d.ts ├── package.json electron-builder-konfigurasjon, versjon 3.8.51 ├── README.md ├── assets/ Byggeressurser (ikoner, rettigheter, …) ├── node_modules/ Dedikert node_modules (better-sqlite3, electron-updater) └── dist-electron/ Byggresultat (ikke sjekket inn) ``` Fem npm-skript i roten av arbeidsområdet: `electron:dev`, `electron:build`, `electron:build:{win,mac,linux}`, `electron:smoke:packaged`. Automatisk oppdatering skjer via `electron-updater`, som peker til utgivelsesfeeden på GitHub. --- ## 6. `bin/` — CLI ``` bin/ ├── omniroute.mjs Hovedinngangspunkt for CLI (Node ESM) ├── reset-password.mjs Tilbakestill administrasjonspassordet fra CLI ├── mcp-server.mjs MCP-serverstarter (stdio) ├── nodeRuntimeSupport.mjs Kontroll av Node-versjon └── cli/ ├── program.mjs Bygger for Commander-programmet ├── runtime.mjs withRuntime-hjelper (server først/database som reserve) ├── output.mjs Utdataformaterere (json/jsonl/table/csv) ├── i18n.mjs t()-hjelper med nasjonale innstillinger ├── api.mjs Hjelper for API-henting ├── data-dir.mjs ├── encryption.mjs ├── sqlite.mjs └── commands/ ├── registry.mjs Kommandoregistrering ├── setup.mjs ├── doctor.mjs ├── providers.mjs └── ... (én fil per kommando/gruppe) ``` To binærfiler eksponeres i `package.json` → `bin`: - `omniroute` → `bin/omniroute.mjs` - `omniroute-reset-password` → `bin/reset-password.mjs` --- ## 7. `tests/` | Mappe | Type | | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | `tests/unit/` | Enhetstester via Nodes innebygde testkjører (1821 filer samt undermappene `api/`, `auth/`, `authz/`) | | `tests/integration/` | Tester på tvers av moduler og databasetilstander | | `tests/e2e/` | Playwright-tester av brukergrensesnittet | | `tests/e2e/protocol-clients.test.ts` | E2E for MCP/A2A-protokoller | | `tests/translator/` | Oversetterspesifikke tester | | `tests/security/` | Sikkerhetsregresjoner | | `tests/load/` | Belastnings-/stresstester | | `tests/golden-set/` | Referanseresultater for oversetterregresjoner | | `tests/helpers/`, `tests/fixtures/`, `tests/manual/` | Støtte | Vanlige kommandoer: | Kommando | Hva den kjører | | -------------------------------------------------------- | ------------------------------------------------------------------------- | | `npm run test:unit` | Alle `tests/unit/*.test.ts` via Nodes testkjører (10 samtidige kjøringer) | | `npm run test:vitest` | Vitest-testpakken (MCP, autoCombo, hurtigbuffer) | | `npm run test:e2e` | Playwright-testpakken for brukergrensesnittet | | `npm run test:protocols:e2e` | E2E for MCP- og A2A-protokollene | | `npm run test:coverage` | Dekningskrav (≥60 % linjer/uttrykk/funksjoner/grener) | | `node --import tsx/esm --test tests/unit/.test.ts` | Kjøring av én enkelt fil | --- ## 8. `scripts/` Organisert i 6 undermapper etter formål. - **`scripts/build/`** — `build-next-isolated.mjs`, `prepublish.ts`, `prepare-electron-standalone.mjs`, `pack-artifact-policy.ts`, `validate-pack-artifact.ts`, `postinstall.mjs`, `postinstallSupport.mjs`, `uninstall.mjs`, `bootstrap-env.mjs`, `runtime-env.mjs`, `native-binary-compat.mjs`. - **`scripts/dev/`** — `run-next.mjs`, `run-next-playwright.mjs`, `run-standalone.mjs`, `standalone-server-ws.mjs`, `responses-ws-proxy.mjs`, `v1-ws-bridge.mjs`, `smoke-electron-packaged.mjs`, `run-playwright-tests.mjs`, `run-ecosystem-tests.mjs`, `run-protocol-clients-tests.mjs`, `sync-env.mjs`, `healthcheck.mjs`, `system-info.mjs`. - **`scripts/check/`** — `check-cycles.mjs`, `check-docs-sync.mjs`, `check-docs-counts-sync.mjs`, `check-env-doc-sync.mjs`, `check-deprecated-versions.mjs`, `check-route-validation.mjs`, `check-t11-any-budget.mjs`, `check-pr-test-policy.mjs`, `check-supported-node-runtime.ts`, `test-report-summary.mjs`. - **`scripts/docs/`** — `generate-docs-index.mjs`, `gen-provider-reference.ts`. - **`scripts/i18n/`** — `generate-multilang.mjs`, `run-visual-qa.mjs`, `generate-qa-checklist.mjs`, `apply-priority-overrides.mjs`, `validate_translation.py`, `check_translations.py`, `i18n_autotranslate.py`, `untranslatable-keys.json`. - **`scripts/ad-hoc/`** — `cursor-tap.cjs`, `sync-cursor-models.mjs`, `migrate-env.mjs`, `dbsetup.js`. --- ## 9. Forespørselspipeline (sammendrag) ![Forespørselspipeline (/v1/chat/completions)](../diagrams/exported/request-pipeline.svg) > Kilde: [diagrams/request-pipeline.mmd](../diagrams/request-pipeline.mmd) ``` Klientforespørsel → /v1/chat/completions (route.ts) CORS-preflightkontroll Zod-validering (chatCompletionsSchema i shared/validation/schemas.ts) Autentisering (extractApiKey + isValidApiKey ELLER requireManagementAuth) Regelmotor (src/server/authz/pipeline.ts) Sikkerhetsmekanismer (PII-maskering, promptinjeksjon, vision-bro) → handleChatCore() (open-sse/handlers/chatCore.ts) Hurtigbufferkontroll (semantisk hurtigbuffer + lesehurtigbuffer) Hastighetsbegrensning (rateLimitManager, accountSemaphore) Kombinasjonsruting (hvis modellen løses til en kombinasjon) comboResolver → løkke per mål → handleSingleModel() translateRequest() (open-sse/translator/request/*) getExecutor(providerId).execute() (open-sse/executors/*) hent fra oppstrøms → nytt forsøk/eksponentiell venting via accountFallback translateResponse() (open-sse/translator/response/*) SSE-strøm ELLER JSON-respons Hvis Responses API: TransformStream via open-sse/transformer/responsesTransformer.ts → Samsvarsrevisjon (src/lib/compliance/) → Respons til klienten ``` ### Kjøretidstilstand for robusthet (tre mekanismer) | Mekanisme | Omfang | Hvor | | --------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------- | | Kretsbryter for leverandør | Hele leverandøren | `src/shared/utils/circuitBreaker.ts`, lagret i `domain_circuit_breakers` | | Nedkjølingsperiode for tilkobling | Én konto/nøkkel | `markAccountUnavailable()` i `src/sse/services/auth.ts`; brukes av `accountFallback.checkFallbackError()` | | Modellutestengelse | Leverandør + tilkobling + modell | `open-sse/services/accountFallback.ts`, lagret i `domain_lockout_state` | Se [RESILIENCE_GUIDE.md](./RESILIENCE_GUIDE.md) og den dedikerte delen i [CLAUDE.md](../../CLAUDE.md). --- ## 10. Slik bidrar du ### Legg til en ny leverandør 1. Registrer den i `src/shared/constants/providers.ts` (Zod-validert ved innlasting). 2. Legg til en eksekverer i `open-sse/executors/` hvis egendefinert logikk er nødvendig (utvid `BaseExecutor`). 3. Legg til en oversetter i `open-sse/translator/` hvis den ikke bruker OpenAI-formatet. 4. Hvis den er OAuth-basert, legg til konfigurasjon under `src/lib/oauth/providers/` og `src/lib/oauth/services/`. 5. Registrer modeller i `open-sse/config/providerRegistry.ts` (eller det formatspesifikke registeret under `open-sse/config/`). 6. Skriv tester under `tests/unit/`. ### Legg til en ny API-rute 1. Opprett `src/app/api/your-route/route.ts`. 2. Følg mønsteret: CORS → Zod-validering av forespørselskroppen → autentisering → delegering til håndterer. 3. Ved en ny forespørselsstruktur: legg til Zod-skjemaet i `src/shared/validation/schemas.ts`. 4. Hvis den kun er for administrasjon: legg til banen i `src/shared/constants/publicApiRoutes.ts` (blokkeringsliste for den offentlige API-overflaten). 5. Legg til tester under `tests/unit/`. 6. Oppdater `docs/reference/API_REFERENCE.md` og `docs/openapi.yaml`. ### Legg til en ny DB-modul 1. Opprett `src/lib/db/yourModule.ts` og importer `getDbInstance()` fra `./core.ts`. 2. Eksporter CRUD-funksjoner for domenet ditt. 3. Ved nye tabeller: legg til en migrering under `src/lib/db/migrations/`, nummerert sekvensielt, idempotent og transaksjonell. 4. Importører bruker direkte import fra `@/lib/db/yourModule` (ingen samleeksport — det gamle reeksportlaget `localDb.ts` ble fjernet). 5. Legg til tester under `tests/unit/`. ### Legg til et nytt MCP-verktøy 1. Legg til verktøydefinisjonen under `open-sse/mcp-server/tools/` (eller utvid `open-sse/mcp-server/schemas/tools.ts`). 2. Tilordne passende omfang i `src/shared/constants/mcpScopes.ts`. 3. Registrer verktøyet i `open-sse/mcp-server/server.ts`. 4. Legg til tester under `open-sse/mcp-server/__tests__/`. 5. Oppdater [MCP-SERVER.md](../frameworks/MCP-SERVER.md). ### Legg til en ny A2A-ferdighet Se [A2A-SERVER.md § Legge til en ny ferdighet](../frameworks/A2A-SERVER.md). Ferdigheter ligger i `src/lib/a2a/skills/` og registreres gjennom A2A-oppgavebehandleren. --- ## 11. Konvensjoner - **Kodestil**: innrykk med 2 mellomrom, doble anførselstegn, linjebredde på 100 tegn, semikolon, etterfølgende komma i `es5`-stil — håndheves av Prettier via `lint-staged`. - **Importer**: eksterne → interne (`@/`, `@omniroute/open-sse`) → relative. - **Navngivning**: filer bruker `camelCase` eller `kebab-case`, komponenter bruker `PascalCase`, konstanter bruker `UPPER_SNAKE`. - **ESLint**: `no-eval`, `no-implied-eval`, `no-new-func` = `error` overalt; `no-explicit-any` = `warn` i `open-sse/` og `tests/`, ellers `error`. - **TypeScript**: `strict: false` (eldre praksis). Foretrekk eksplisitte typer fremfor inferens ved grenser mellom moduler. - **Database**: skriv aldri rå SQL i ruter eller håndterere — gå alltid gjennom modulene i `src/lib/db/`. Bruk aldri samleimport — bruk spesifikke `src/lib/db/*`-moduler direkte. - **Typing av DB-entiteter (#3512)**: En funksjon som skriver eller leser radstrukturen til en DB-tabell, skal ta imot/returnere et navngitt TS-grensesnitt som gjenspeiler tabellens kolonner 1:1, ikke `any` eller en innebygd anonym type på kallstedet. Plasser grensesnittet ved siden av funksjonen (f.eks. `export interface UsageEntry` i `src/lib/usage/usageHistory.ts` over `saveRequestUsage`), behold enkeltfelt som valgfrie/nullbare når ulike skrivere fyller ut raden trinnvis, og foretrekk `unknown` fremfor `any` for et felt hvis struktur varierer mellom kallere (dokumentert på feltet, f.eks. at `UsageEntry.tokens` godtar både rå leverandørstrukturert bruk og den normaliserte strukturen). Når antallet `any` i en fil på denne måten når null, legger du den til i tillatelseslisten for `check:any-budget:t11` (`scripts/check/check-t11-any-budget.mjs`, `maxAny: 0`), slik at dette ikke kan gå tilbake. Dette er en konvensjon for den første delen — den bredere oppryddingen av «ingen anonym `any`» utføres iterativt i resten av kodebasen. - **Feil**: bruk try/catch med spesifikke feiltyper, og logg med pino-kontekst. Aldri ignorer feil i SSE-strømmer uten varsel; bruk avbruddssignaler til opprydding. - **Sikkerhet**: bruk aldri `eval()` / `new Function()` / implisitt eval. Valider alle inndata med Zod. Krypter legitimasjon ved lagring (AES-256-GCM). Hold blokkeringslisten i `src/shared/constants/upstreamHeaders.ts` synkronisert med laget for rensing/validering. - **Commits**: Conventional Commits — `feat(scope): subject`. Tillatte omfang: `db`, `sse`, `oauth`, `dashboard`, `api`, `cli`, `docker`, `ci`, `mcp`, `a2a`, `memory`, `skills`. - **Grener**: prefiksene `feat/`, `fix/`, `refactor/`, `docs/`, `test/`, `chore/`. Aldri commit direkte til `main`. - **Husky**: før commit kjøres `lint-staged` + `check:docs-sync` + `check:any-budget:t11`; før push kjøres `check:any-budget:t11` + `check:tracked-artifacts` (raske kontrollporter; utelater `test:unit`). --- ## 12. Ufravikelige regler (fra CLAUDE.md) 1. Aldri legg inn hemmeligheter eller påloggingsopplysninger i versjonskontrollen. 2. Aldri bruk samleimporter — bruk spesifikke `src/lib/db/*`-moduler direkte. 3. Aldri bruk `eval()` / `new Function()` / implisitt eval. 4. Aldri legg inn endringer direkte i `main`. 5. Aldri skriv rå SQL i ruter — gå alltid gjennom modulene i `src/lib/db/`. 6. Aldri ignorer feil i SSE-strømmer uten varsel. 7. Valider alltid inndata med Zod-skjemaer. 8. Inkluder alltid tester når produksjonskode endres. 9. Testdekningen må være ≥ 60 % (setninger, linjer, funksjoner, grener). --- ## 13. Se også - [ARCHITECTURE.md](./ARCHITECTURE.md) — overordnet arkitektur og modulenes ansvarsområder. - [API_REFERENCE.md](../reference/API_REFERENCE.md) — referanse for offentlig API og administrasjons-API. - [FEATURES.md](../guides/FEATURES.md) — funksjonsmatrise og versjonshøydepunkter. - [RESILIENCE_GUIDE.md](./RESILIENCE_GUIDE.md) — detaljert gjennomgang av kretsbryter, nedkjøling og sperring. - [AUTO-COMBO.md](../routing/AUTO-COMBO.md) — poengberegning og strategier for Auto Combo. - [MCP-SERVER.md](../frameworks/MCP-SERVER.md) — komplett katalog over MCP-verktøy og transportmekanismer. - [A2A-SERVER.md](../frameworks/A2A-SERVER.md) — ferdigheter og oppdagelse i A2A-protokollen. - [COMPRESSION_GUIDE.md](../compression/COMPRESSION_GUIDE.md) — RTK- og Caveman-komprimering. - [CLI-TOOLS.md](../reference/CLI-TOOLS.md) — CLI-integrasjoner. - [ELECTRON_GUIDE.md](../guides/ELECTRON_GUIDE.md) (hvis den finnes), [DOCKER_GUIDE.md](../guides/DOCKER_GUIDE.md), [FLY_IO_DEPLOYMENT_GUIDE.md](../ops/FLY_IO_DEPLOYMENT_GUIDE.md), [VM_DEPLOYMENT_GUIDE.md](../ops/VM_DEPLOYMENT_GUIDE.md), [TERMUX_GUIDE.md](../guides/TERMUX_GUIDE.md), [PWA_GUIDE.md](../guides/PWA_GUIDE.md) — distribusjonsmål. - [TROUBLESHOOTING.md](../guides/TROUBLESHOOTING.md) — vanlige driftsproblemer. - [CONTRIBUTING.md](../../CONTRIBUTING.md) — arbeidsflyt for bidragsytere. - [CLAUDE.md](../../CLAUDE.md) — regler for Claude Code i kodebasen (den autoritative kilden for mange av konvensjonene ovenfor). - [AGENTS.md](../../AGENTS.md) — mer detaljert arkitekturreferanse som brukes av agenter.