OmniRoute/docs/i18n/or/docs/architecture/CODEBASE_DOCUMENTATION.md

CODEBASE_DOCUMENTATION (ଓଡ଼ିଆ)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

---

title: "OmniRoute କୋଡବେସ୍ ଡକୁମେଣ୍ଟେସନ୍" version: 3.8.40 lastUpdated: 2026-06-28

OmniRoute କୋଡବେସ୍ ଡକୁମେଣ୍ଟେସନ୍

ସଂସ୍କରଣ: v3.8.51 ଶେଷ ଅଦ୍ୟତନ: 2026-06-28 ଦର୍ଶକ: OmniRoute ରେ ଯୋଗଦାନ କରୁଥିବା ଇଞ୍ଜିନିୟର କିମ୍ବା ଏହା ଉପରେ ଇଣ୍ଟିଗ୍ରେସନ୍ ନିର୍ମାଣ କରୁଥିବା।

ଉଚ୍ଚ-ସ୍ତରୀୟ ଆର୍କିଟେକ୍ଚର ଡାଏଗ୍ରାମ୍ ଏବଂ ପ୍ରତ୍ୟେକ ସବସିଷ୍ଟମ ପଛର ଯୁକ୍ତି ପାଇଁ, ARCHITECTURE.md ପଢ଼ନ୍ତୁ। ବ୍ୟକ୍ତିଗତ ସବସିଷ୍ଟମ (Auto Combo, MCP server, A2A server, Skills, Memory, Cloud Agents, Resilience, Compression, ଇତ୍ୟାଦି) ର ଗଭୀର ଡାଇଭ୍ ପାଇଁ ଏହି docs/ ଡାଇରେକ୍ଟୋରୀରେ ସେମାନଙ୍କ ନିର୍ଦ୍ଦିଷ୍ଟ ଫାଇଲ୍ ଦେଖନ୍ତୁ।

ଏହି ଫାଇଲ୍ ବର୍ଣ୍ଣନା କରେ ଆଜି ରିପୋଜିଟୋରୀରେ କଣ ଅଛି ଯେପରି କି ଜଣେ ନୂଆ ଇଞ୍ଜିନିୟର ଟ୍ରୀରେ ନାଭିଗେଟ୍ କରିପାରିବେ, ରନଟାଇମ୍ ଲେୟାରିଂ ବୁଝିପାରିବେ, ଏବଂ ନୂଆ ମୋଡ୍ୟୁଲ୍ ଆବିଷ୍କାର ନ କରି କୋଡ୍ କୁଆଡେ ଯୋଗ କରିବେ ତାହା ଜାଣିପାରିବେ।

---

୧. ଟେକ୍ ଷ୍ଟ୍ୟାକ୍

ଚିନ୍ତାଧାରା	ପସନ୍ଦ
ୱେବ୍ ଫ୍ରେମୱାର୍କ	Next.js 16 (ଆପ୍ ରାଉଟର୍, ଷ୍ଟାଣ୍ଡ-ଅଲୋନ୍ ଆଉଟପୁଟ୍, କୌଣସି ଗ୍ଲୋବାଲ୍ ମିଡୱେୟାର୍ ନାହିଁ)
ଭାଷା	TypeScript 6.0+ — ଟାର୍ଗେଟ୍ ES2022, module: esnext, moduleResolution: bundler, strict: false
ରନଟାଇମ୍	Node.js >=22.22.2 <23 କିମ୍ବା >=24.0.0 <27 (engines + SUPPORTED_NODE_RANGE ମାଧ୍ୟମରେ ଲାଗୁ)
ଡାଟାବେସ୍	SQLite better-sqlite3 ମାଧ୍ୟମରେ (ସିଙ୍ଗଲଟନ୍, WAL ଜର୍ଣ୍ଣାଲିଂ)
ଡେସ୍କଟପ୍	Electron 41 + electron-builder 26.10 (electron/ ରେ ଅଲଗା ୱାର୍କସ୍ପେସ୍)
ପରୀକ୍ଷଣ	Node ନେଟିଭ୍ ଟେଷ୍ଟ୍ ରନର୍ (ୟୁନିଟ୍/ଇଣ୍ଟିଗ୍ରେସନ୍), Vitest (MCP, autoCombo, କ୍ୟାଶ୍), Playwright (e2e + protocols-e2e)
ନିର୍ମାଣ	Next.js ଷ୍ଟାଣ୍ଡ-ଅଲୋନ୍ scripts/build/build-next-isolated.mjs ମାଧ୍ୟମରେ
ଲିଣ୍ଟ୍/ଫର୍ମାଟ୍	ESLint ଫ୍ଲାଟ୍ କନ୍ଫିଗ୍ + Prettier (lint-staged ପ୍ରି-କମିଟ୍ Husky ମାଧ୍ୟମରେ)
ମୋଡ୍ୟୁଲ୍ ସିଷ୍ଟମ	ସର୍ବତ୍ର ESM ("type": "module")
ୱାର୍କସ୍ପେସ୍	npm ୱାର୍କସ୍ପେସ୍ — open-sse ହେଉଛି ଏକମାତ୍ର ସବ୍-ୱାର୍କସ୍ପେସ୍

ପାଥ୍ ଏଲିଆସ୍ (tsconfig.json):

• @/* → src/*
• @omniroute/open-sse → open-sse/index.ts
• @omniroute/open-sse/* → open-sse/*

ଡିଫଲ୍ଟ HTTP ପୋର୍ଟ: 20128 (API ଏବଂ ଡ୍ୟାସବୋର୍ଡ ସମାନ ପ୍ରକ୍ରିୟା ବାଣ୍ଟନ୍ତି)। ଡାଟା ଡାଇରେକ୍ଟୋରୀ ହେଉଛି DATA_DIR env var, ଡିଫଲ୍ଟରେ ~/.omniroute/ ରେ।

---

୨. ରିପୋଜିଟୋରୀ ଲେଆଉଟ୍

OmniRoute/
├── src/                  Next.js ଆପ୍ଲିକେସନ୍ (ଆପ୍ ରାଉଟର୍, libs, domain, server, shared)
├── open-sse/             ଷ୍ଟ୍ରିମିଂ ଇଞ୍ଜିନ୍ ୱାର୍କସ୍ପେସ୍ (@omniroute/open-sse)
├── electron/             ଡେସ୍କଟପ୍ ର୍ୟାପର୍ (Electron 41 main + preload)
├── bin/                  CLI ଏଣ୍ଟ୍ରୀ ପଏଣ୍ଟ୍ (omniroute, reset-password)
├── tests/                ୟୁନିଟ୍, ଇଣ୍ଟିଗ୍ରେସନ୍, e2e, protocols-e2e, translator, security, fixtures
├── scripts/              ନିର୍ମାଣ, ସିଙ୍କ, ଚେକ୍, ମାଇଗ୍ରେସନ୍, ଏବଂ ରନଟାଇମ୍ ସାହାଯ୍ୟକାରୀ ସ୍କ୍ରିପ୍ଟ
├── docs/                 ସାର୍ବଜନୀନ ଡକୁମେଣ୍ଟେସନ୍ (ଏହି ଡାଇରେକ୍ଟୋରୀ)
├── public/               ସ୍ଥିର ସମ୍ପତ୍ତି, PWA ମ୍ୟାନିଫେଷ୍ଟ, ସର୍ଭିସ୍ ୱାର୍କର୍
├── config/               ରନଟାଇମ୍ କନ୍ଫିଗ୍ ନମୁନା
├── images/               ମାର୍କେଟିଂ/ସ୍କ୍ରିନସଟ୍ ସମ୍ପତ୍ତି
├── _ideia/, _references/, _mono_repo/, _tasks/   ଆଭ୍ୟନ୍ତରୀଣ ସ୍କ୍ରାଚ୍ / ଯୋଜନା (ପଠାଯାଏ ନାହିଁ)
├── CLAUDE.md             Claude Code ପାଇଁ ରିପୋ ନିୟମ
├── AGENTS.md             ଏଜେଣ୍ଟ୍ ପାଇଁ ଗଭୀର ଆର୍କିଟେକ୍ଚର ରେଫରେନ୍ସ
├── package.json          v3.8.51, ୱାର୍କସ୍ପେସ୍ ମୂଳ
└── tsconfig.json         ପାଥ୍ ଏଲିଆସ୍ + ମୂଳ କମ୍ପାଇଲର୍ ବିକଳ୍ପ

---

3. src/ — ନେକ୍ସ୍ଟ.ଜେ.ଏସ୍ ଆପ୍ଲିକେସନ

src/
├── app/                  ଆପ୍ ରୁଟର ପୃଷ୍ଠା + ଏପିଆଇ ରୁଟ୍
├── lib/                  ମୂଳ ଲାଇବ୍ରେରୀ (ଡିବି, ଅଥ, ଓ.ଆଥ., ସ୍କିଲ୍, ସ୍ମୃତି, ...)
├── domain/               ବିଶୁଦ୍ଧ ଡୋମେନ୍ ସ୍ତର (ନୀତି, ଫଲବ୍ୟାକ୍, ଖର୍ଚ୍ଚ, ଲକ୍ଆଉଟ୍, ...)
├── server/               ସର୍ଭର-ମାତ୍ର ମଡ୍ୟୁଲ୍ (ଅଥରାଇଜେସନ, କୋର୍ସ, ଅଥ)
├── shared/               ଟାଇପ୍, ଧାରା, ଯାଞ୍ଚ, ଚୁକ୍ତି, ୟୁଟିଲ୍ (କ୍ରସ୍-ବାଉଣ୍ଡାରୀ ସୁରକ୍ଷିତ)
├── mitm/                 ସିଏଲଆଇ ଇଣ୍ଟେଗ୍ରେସନ୍ ପାଇଁ ମ୍ୟାନ୍-ଇନ୍-ଦି-ମିଡଲ୍ ପ୍ରକ୍ସି ସହାୟକ
├── models/               ସ୍ଥାନୀୟ ମଡେଲ୍ ମେଟାଡାଟା / ଉପନାମ
├── sse/                  ପୁରୁଣା ଏସଏସଇ ହ୍ୟାଣ୍ଡଲର ଯାହା ଏବେ ବି ସ୍ରୋତ/ନାମାଙ୍କନ/ ଅଧୀନରେ ଅଛି (ନୋପେନ୍-ସଏସଇ/)
├── store/                କ୍ଲାଏଣ୍ଟ୍ ପାଖ ରାଜ୍ୟ ଷ୍ଟୋର୍
├── middleware/           ରୁଟ୍-ସ୍ତର ମିଡୱେୟାର୍ ୟୁଟିଲ୍ (ନେକ୍ସ୍ଟ.ଜେ.ଏସ୍ ଗ୍ଲୋବାଲ୍ ମିଡୱେୟାର୍ ନୁହେଁ)
├── scripts/              ଆପ୍ କୋଡ୍ ଦ୍ୱାରା ଆମଦାନୀ କରାଯାଇପାରୁଥିବା ଟ୍ରି-ଇନ୍ ସ୍କ୍ରିପ୍ଟ୍
├── types/                ଏମ୍ବିଏଣ୍ଟ୍ ଏବଂ ସାଝା ଟିଏସ୍ ଟାଇପ୍
├── i18n/                 ସ୍ଥାନୀୟ ବଣ୍ଡଲ୍
├── instrumentation.ts    ନେକ୍ସ୍ଟ.ଜେ.ଏସ୍ ଇନ୍ଷ୍ଟ୍ରୁମେଣ୍ଟେସନ୍ ହୁକ୍
├── instrumentation-node.ts
└── proxy.ts              ଟପ୍-ଲେଭଲ୍ ପ୍ରକ୍ସି ବୁଟ୍ଷ୍ଟ୍ରାପ୍ ସହାୟକ

3.1 src/app/ — ଆପ୍ ରୁଟର

ଆପ୍ ରୁଟର ଡ୍ୟାସବୋର୍ଡ୍ UI ଏବଂ ସାର୍ବଜନୀନ/ପରିଚାଳନା HTTP API ଦୁଇଟି ଉପସ୍ଥାପିତ କରେ। କୌଣସି ଗ୍ଲୋବାଲ୍ ମିଡୱେୟାର୍ ନାହିଁ — ଇଣ୍ଟରସେପସନ୍ ପ୍ରତ୍ୟେକ ରୁଟ୍ରେ କରାଯାଏ।

src/app/ ଅଧୀନରେ ଥିବା ଟପ୍-ଲେଭଲ୍ ସେଗମେଣ୍ଟ୍:

ପାଥ	ଉଦ୍ଦେଶ୍ୟ
api/	ସମସ୍ତ HTTP API ରୁଟ୍ (ନିମ୍ନରେ ବିଭାଜନ ଦେଖନ୍ତୁ)
a2a/	A2A JSON-RPC 2.0 ଏଣ୍ଡପଏଣ୍ଟ୍ (POST /a2a)
.well-known/agent.json/	A2A ଏଜେଣ୍ଟ୍ କାର୍ଡ୍ ଆବିଷ୍କାର ଡକୁମେଣ୍ଟ
(dashboard)/	ଡ୍ୟାସବୋର୍ଡ୍ UI (ରୁଟ୍ ଗ୍ରୁପ୍, କୌଣସି URL ଉପସର୍ଗ ନାହିଁ)
auth/, login/, forgot-password/, callback/	ଅଥ ପ୍ରବାହ
landing/	ମାର୍କେଟିଙ୍ଗ/ଲ୍ୟାଣ୍ଡିଙ୍ଗ୍ ପୃଷ୍ଠା
docs/	ଏମ୍ବେଡେଡ୍ API ଡକ୍ସ ଭ୍ୟୁଅର
status/, maintenance/, offline/	ଅପରେସନାଲ୍ ପୃଷ୍ଠା
privacy/, terms/	ଆଇନଗତ ପୃଷ୍ଠା
400/, 401/, 403/, 408/, 429/, 500/, 502/, 503/	ସ୍ଥାପିତ ତ୍ରୁଟି ପୃଷ୍ଠା
error.tsx, global-error.tsx, not-found.tsx, forbidden/, loading.tsx	ଫ୍ରେମୱାର୍କ ତ୍ରୁଟି/ଲୋଡିଙ୍ଗ୍ ସୀମା
layout.tsx, page.tsx, globals.css, manifest.ts	ମୂଳ ଶେଲ୍

3.1.1 src/app/(dashboard)/dashboard/ — UI ପୃଷ୍ଠା

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, ସହ ମୂଳ page.tsx, HomePageClient.tsx, BootstrapBanner.tsx।

3.1.2 src/app/api/ — ଟପ୍-ଲେଭଲ୍ API ଗ୍ରୁପ୍

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/   ଏମ୍ବେଡେଡ୍ ସେବା ପରିଚାଳନା (9router, cliproxy) — କେବଳ ସ୍ଥାନୀୟ
├── upstream-proxy/
├── usage/
├── v1/         ଓପନଏଆଇ-ସୁସଙ୍ଗତ ସାର୍ବଜନୀନ API
├── v1beta/     ଜେମିନାଇ-ଷ୍ଟାଇଲ୍ ସୁସଙ୍ଗତତା
├── version-manager/
└── webhooks/

3.1.2a src/app/api/services/ — ଏମ୍ବେଡେଡ୍ ସେବା ପରିଚାଳନା

9Router ଏବଂ CLIProxyAPI ଇନ୍<E0ACA8>୍ଟଲ୍, ଆରମ୍ଭ, ବନ୍ଦ ଏବଂ ମନିଟର କରିବା ପାଇଁ ରୁଟ୍। ସମସ୍ତ ପାଥ କେବଳ ସ୍ଥାନୀୟ ବର୍ଗୀକୃତ (ଲୁପବ୍ୟାକ୍ ମାତ୍ର, କଠୋର ନିୟମ #17) କାରଣ ସେମାନେ npm install ଡାକିପାରିବେ ଏବଂ ଚାଇଲ୍ଡ ପ୍ରୋସେସ୍ ସୃଷ୍ଟି କରିପାରିବେ।

src/app/api/services/
├── 9router/
│   ├── _lib.ts             getOrInitSupervisor() ସହାୟକ
│   ├── install/route.ts    POST — execFile ମାଧ୍ୟମରେ 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 ନୂତନ ସଂସ୍କରଣ
│   ├── rotate-key/route.ts POST — ନୂତନ API କୀ ସୃଷ୍ଟି + ପୁନରାରମ୍ଭ
│   ├── status/route.ts     GET  — ଲାଇଭ୍ + ଡିବି ସ୍ଥିତି + ସଂସ୍କରଣ ମେଟାଡାଟା
│   └── auto-start/route.ts POST — auto_start ଫ୍ଲାଗ୍ ଟୋଗଲ୍ କରନ୍ତୁ
├── cliproxy/
│   ├── _lib.ts             getOrInitSupervisor() ସହାୟକ
│   ├── 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 ନୂତନ ସଂସ୍କରଣ
│   ├── status/route.ts     GET  — ଲାଇଭ୍ + ଡିବି ସ୍ଥିତି + ସଂସ୍କରଣ ମେଟାଡାଟା
│   └── auto-start/route.ts POST — auto_start ଫ୍ଲାଗ୍ ଟୋଗଲ୍ କରନ୍ତୁ
└── [name]/
    └── logs/route.ts       GET  — SSE ଲଗ୍ ଟେଲ୍ (ସମସ୍ତ ସେବା ଦ୍ୱାରା ସାଝା)

ସମ୍ବନ୍ଧୀୟ ଡ୍ୟାସବୋର୍ଡ୍ UI: src/app/(dashboard)/dashboard/providers/services/ — ଦୁଇ-ଟ୍ୟାବ୍ ପୃଷ୍ଠା (CLIProxyAPI + 9Router)। 9Router ଏମ୍ବେଡେଡ୍ UI ପାଇଁ ରିଭର୍ସ୍ ପ୍ରକ୍ସି: src/app/(dashboard)/dashboard/providers/services/[name]/embed/[[...path]]/route.ts

ଗଭୀର ଅନୁସନ୍ଧାନ: docs/frameworks/EMBEDDED-SERVICES.md

3.1.3 src/app/api/v1/ — ଓପନଏଆଇ-ସୁସଙ୍ଗତ ସାର୍ବଜନୀନ API

v1/
├── accounts/[id]/                       ଆକାଉଣ୍ଟ୍ ଖୋଜ
├── agents/tasks/[id]/, agents/tasks/    A2A-ଷ୍ଟାଇଲ୍ କାର୍ଯ୍ୟ ଏଣ୍ଡପଏଣ୍ଟ୍
├── api/                                 v1/api ଅଧୀନରେ ଉପସ୍ଥାପିତ ଆଭ୍ୟନ୍ତରୀଣ API ସହାୟକ
├── audio/{speech, transcriptions}/      TTS + STT
├── batches/[id]/{cancel}, batches/      ଓପନଏଆଇ Batches API
├── chat/completions/                    ଚାଟ୍ କମ୍ପ୍ଲେସନ୍ସ (ମୁଖ୍ୟ ଏଣ୍ଡପଏଣ୍ଟ୍)
├── completions/                         ପୁରୁଣା ଟେକ୍ସଟ୍ କମ୍ପ୍ଲେସନ୍ସ
├── embeddings/                          ଏମ୍ବେଡିଂଗ୍ସ
├── files/[id]/, files/                  ଫାଇଲ୍ API
├── _helpers/                            ସାଝା ରୁଟ୍ ସହାୟକ (ସାର୍ବଜନୀନ URL ନାହିଁ)
├── images/{edits, generations}/         ଛବି ସୃଷ୍ଟି + ସମ୍ପାଦନା
├── issues/                              ଟ୍ରାଇଏଜ୍ ସହାୟକ ଏଣ୍ଡପଏଣ୍ଟ୍
├── management/{proxies}/                v1 ଭିତରେ ପରିଚାଳନା-ସ୍କୋପ୍ ରୁଟ୍
├── messages/{count_tokens}/             ଆନ୍ଥ୍ରୋପିକ୍-ଷ୍ଟାଇଲ୍ ସନ୍ଦେଶ ସୁସଙ୍ଗତତା
├── models/                              ମଡେଲ୍ ତାଲିକା (`route.ts`, `catalog.ts`)
├── moderations/                         ମଡେରେସନ୍
├── music/                               ସଙ୍ଗୀତ ସୃଷ୍ଟି
├── providers/[provider]/                ପ୍ରତ୍ୟେକ ପ୍ରଦାନକାରୀ ଅପରେସନ୍
├── quotas/{check}                       କୋଟା ପ୍ରୋବ
├── registered-keys/                     ପଞ୍ଜିକୃତ କୀ ପରିଚାଳନା
├── rerank/                              ପୁନରାୟୋଜନ
├── responses/[...path]/                 ଓପନଏଆଇ Responses API (ସମସ୍ତ-ଗ୍ରହଣ)
├── search/                              ୱେବ୍ ଖୋଜ
├── videos/                              ଭିଡିଓ ସୃଷ୍ଟି
├── ws/                                  ୱେବସକେଟ୍ ବ୍ରିଜ୍
└── route.ts                             ସୂଚକ ହ୍ୟାଣ୍ଡଲର

ପ୍ରତ୍ୟେକ ରୁଟ୍ ଫାଇଲ୍ ସମାନ ପ୍ୟାଟର୍ନ ଅନୁସରଣ କରେ:

ରୁଟ୍ → CORS ପ୍ରିଫ୍ଲାଇଟ୍ → Zod ବଡି ଯାଞ୍ଚ → ବୈକଳ୍ପିକ ଅଥ
      → API କୀ ନୀତି ପ୍ରଯୋଗ → ହ୍ୟାଣ୍ଡଲର ପ୍ରତିନିଦେଶ (open-sse)

v1beta/ ହେଉଛି ଜେମିନାଇ-ଷ୍ଟାଇଲ୍ ସୁସଙ୍ଗତତା ପୃଷ୍ଠ (ଏକ ପତ୍ଳ ୱ୍ରାପର ଯାହା ସମାନ open-sse/handlers/ ପାଇପ୍ଲାଇନ୍କୁ ଅନୁବାଦ କରେ)।

3.2 src/lib/ — ମୂଳ ଲାଇବ୍ରେରୀ

ସର୍ବଦା ଏହି ମଡ୍ୟୁଲ୍ ମାଧ୍ୟମରେ ଡାଟା, ସିଙ୍କ, ଓ.ଆଥ., ସ୍କିଲ୍, ସ୍ମୃତି ଇତ୍ୟାଦି ଆମଦାନୀ କରନ୍ତୁ। ସାରଣୀ ପ୍ରକୃତ ନିର୍ଦ୍ଦେଶିକା ଏବଂ ଉଲ୍ଲେଖନୀୟ ଟପ୍-ଲେଭଲ୍ ଫାଇଲ୍ ଗୁଡିକୁ ଗ୍ରୁପ୍ କରେ।

ମଡ୍ୟୁଲ୍	ଉଦ୍ଦେଶ୍ୟ
a2a/	A2A ପ୍ରୋଟୋକଲ୍ ସର୍ଭର: taskManager.ts, streaming.ts, taskExecution.ts, routingLogger.ts, skills/ (6ଟି ସ୍କିଲ୍: ଖର୍ଚ୍ଚ ବିଶ୍ଳେଷଣ, ସ୍ୱାସ୍ଥ୍ୟ ରିପୋର୍ଟ, ପ୍ରଦାନକାରୀ ଆବିଷ୍କାର, କୋଟା ପରିଚାଳନା, ସ୍ମାର୍ଟ ରୁଟିଙ୍ଗ୍, ତାଲିକା-କ୍ଷମତା)
acp/	ଏଜେଣ୍ଟ୍-କଣ୍ଟ୍ରୋଲ୍-ପ୍ରୋଟୋକଲ୍: index.ts, manager.ts, registry.ts
api/	ଆଭ୍ୟନ୍ତରୀଣ API ସହାୟକ: requireManagementAuth.ts, requireCliToolsAuth.ts, errorResponse.ts
auth/	managementPassword.ts (ପାସ୍ୱାର୍ଡ ରିସେଟ୍ / ହ୍ୟାସିଂ)
batches/	ଓପନଏଆଇ Batches API ସେବା (service.ts)
catalog/	ଓପନରୁଟର କ୍ୟାଟାଲଗ୍ ସିଙ୍କ (openrouterCatalog.ts)
cloudAgent/	କ୍ଲାଉଡ୍ ଏଜେଣ୍ଟ୍ ରଜିଷ୍ଟ୍ରୀ: api.ts, baseAgent.ts, db.ts, index.ts, registry.ts, types.ts, agents/{codex, devin, jules}.ts
combos/	କମ୍ବୋ ସମାଧାନ ସହାୟକ
compliance/	ଅଡିଟ୍ + ପ୍ରଦାନକାରୀ ଅଡିଟ୍: index.ts, providerAudit.ts
config/	ରନଟାଇମ୍ କନ୍ଫିଗ୍ ଗ୍ଲୁ
db/	SQLite ଡୋମେନ୍ ମଡ୍ୟୁଲ୍ (§3.2.1 ଦେଖନ୍ତୁ)
display/	API ପ୍ରତିକ୍ରିୟା ଦ୍ୱାରା ବ୍ୟବହୃତ UI/ପ୍ରଦର୍ଶନ ସହାୟକ
embeddings/	ଏମ୍ବେଡିଂଗ୍ ସେବା ରଜିଷ୍ଟ୍ରୀ
env/	ଏନ୍ଭିରନ୍ମେଣ୍ଟ୍ ଲୋଡିଂ + ଇଣ୍ଟ୍ରୋସ୍ପେକସନ୍
evals/	ମୂଲ୍ୟାଙ୍କନ ରନଟାଇମ୍
guardrails/	piiMasker.ts, promptInjection.ts, visionBridge.ts, visionBridgeHelpers.ts, registry.ts, base.ts
jobs/	ପୃଷ୍ଠଭୂମି କାର୍ଯ୍ୟ (autoUpdate.ts, ...)
memory/	ସ୍ଥାୟୀ ସ୍ମୃତି: 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/	ଓ.ଆଥ./ଆମଦାନୀ ପ୍ରଦାନକାରୀ ମଡ୍ୟୁଲ୍ (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, ସହ services/, utils/, ଏବଂ constants/oauth.ts
plugins/	ପ୍ଲଗିନ୍ ଲୋଡର (index.ts)
promptCache/	prefixAnalyzer.ts, index.ts
providerModels/	ପରିଚାଳିତ ମଡେଲ୍ ଜୀବନଚକ୍ର: modelDiscovery.ts, managedModelImport.ts, managedAvailableModels.ts, cursorAgent.ts
providers/	ପ୍ରଦାନକାରୀ ସହାୟକ: catalog.ts, validation.ts, imageValidation.ts, claudeExtraUsage.ts, codexConnectionDefaults.ts, codexFastTier.ts, webCookieAuth.ts, managedAvailableModels.ts, requestDefaults.ts
resilience/	settings.ts — ସର୍କିଟ୍ ବ୍ରେକର, କୁଲଡାଉନ୍, ଲକ୍ଆଉଟ୍ ପାଇଁ ସେଟିଂସ୍
runtime/	ରନଟାଇମ୍ ବୈଶିଷ୍ଟ୍ୟ ସନ୍ଧାନ
search/	executeWebSearch.ts
services/	ଏମ୍ବେଡେଡ୍ ସେବା ଫ୍ରେମୱାର୍କ: ServiceSupervisor.ts (ଅପରେସନ୍ ଲକ୍, ରିଙ୍ଗ ବଫର୍, ସ୍ୱାସ୍ଥ୍ୟ ପରୀକ୍ଷକ ସହ ସାଧାରଣ ଚାଇଲ୍ଡ-ପ୍ରୋସେସ୍ ସୁପରଭାଇଜର), bootstrap.ts (ପ୍ରୋସେସ୍-ସ୍ତର ପଞ୍ଜୀକରଣ ଏବଂ ସ୍ୱୟଂଚାଳିତ ଆରମ୍ଭ), registry.ts (ଟୁଲ୍ → ସୁପରଭାଇଜର ମ୍ୟାପ୍), apiKey.ts (AES-256-GCM କୀ ଷ୍ଟୋର୍), modelSync.ts (ନିୟମିତ ମଡେଲ୍ ସିଙ୍କ), ringBuffer.ts (5 MB ବୃତ୍ତାକାର ଲଗ୍ ବଫର୍), healthCheck.ts (HTTP ସ୍ୱାସ୍ଥ୍ୟ ପ୍ରୋବ), types.ts, embedWsProxy.ts (ୱେବସକେଟ୍ ପ୍ରକ୍ସି), installers/{ninerouter,cliproxy}.ts। docs/frameworks/EMBEDDED-SERVICES.md ଦେଖନ୍ତୁ
agentSkills/	ଏଜେଣ୍ଟ୍ ସ୍କିଲ୍ କ୍ୟାଟାଲଗ୍ + ଜେନେରେଟର: catalog.ts (getCatalog/getSkillById/filterCatalog/computeCoverage), generator.ts (generateAgentSkills → skills/{id}/SKILL.md ଲେଖେ), openapiParser.ts (OpenAPI ସ୍ପେକ୍ ରୁ REST ଏଣ୍ଡପଏଣ୍ଟ୍ ବାହାର କରେ), cliRegistryParser.ts (bin/cli-registry ରୁ CLI ଉପ-କମାଣ୍ଡ ବାହାର କରେ), schemas.ts (Zod: AgentSkillSchema, SkillCoverageSchema, ListQuerySchema, GenerateBodySchema), types.ts (AgentSkill, SkillCoverage, SkillMarkdown, GeneratorReport)। REST ରୁଟ୍ (/api/agent-skills/*), MCP ଟୁଲ୍ (omniroute_agent_skills_*), ଏବଂ A2A ସ୍କିଲ୍ list-capabilities ଦ୍ୱାରା ଖାଇଲ। AGENT-SKILLS.md ଦେଖନ୍ତୁ।
skills/	ସ୍କିଲ୍ ଫ୍ରେମୱାର୍କ: 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, ସହ builtin/browser.ts
spend/	batchWriter.ts (ରାଇଟ୍-ବିହାଇଣ୍ଡ୍ ବଫର୍)
sync/	bundle.ts, tokens.ts (କ୍ଲାଉଡ୍ ସିଙ୍କ)
system/	ସିଷ୍ଟମ୍-ସ୍ତର ସହାୟକ
translator/	ଟପ୍-ଲେଭଲ୍ ଅନୁବାଦକ ଗ୍ଲୁ (open-sse/translator/ ଭିତରେ ପ୍ରତିନିଦେଶ କରେ)
usage/	ବ୍ୟବହାର ହିସାବ: costCalculator.ts, tokenAccounting.ts, usageHistory.ts, aggregateHistory.ts, usageStats.ts, callLogs.ts, callLogArtifacts.ts, fetcher.ts, providerLimits.ts, migrations.ts
versionManager/	ସ୍ୱୟଂଚାଳିତ ଅପଡେଟ୍ + ସଂସ୍କରଣ ମ୍ୟାନିଫେଷ୍ଟ୍
ws/	ୱେବସକେଟ୍ ବ୍ରିଜ୍
zed-oauth/	Zed ସମ୍ପାଦକ ଓ.ଆଥ. ପ୍ରବାହ

src/lib/ ର ଟପ୍-ଲେଭଲ୍ ଫାଇଲ୍:

• ପୁରୁଣା localDb.ts ବ୍ୟାରେଲ୍ ହଟାଯାଇଛି — ବ୍ୟବହାରକାରୀ ସିଧାସଳଖ src/lib/db/* ମଡ୍ୟୁଲ୍ ଆମଦାନୀ କରନ୍ତି।
• 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/

ସିଙ୍ଗଲଟନ୍ SQLite ଡାଟାବେସ୍ (core.ts ରେ getDbInstance(), WAL ଜର୍ନାଲିଂ)। ରୁଟ୍ ବା ହ୍ୟାଣ୍ଡଲରରେ କୌଣସି କଞ୍ଚା SQL ଲେଖନ୍ତୁ ନାହିଁ — ଏହି ମଡ୍ୟୁଲ୍ ମାଧ୍ୟମରେ ଯାଅ।

ସ୍ରୋତ: diagrams/db-schema-overview.mmd

ଡୋମେନ୍ ମଡ୍ୟୁଲ୍ (ପ୍ରତ୍ୟେକ ଗୋଟିଏ ବା ଅଧିକ ଟେବୁଲ୍ ମାଲିକ): 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/ 168ଟି ସଂସ୍କରଣଭୁକ୍ତ .sql ଫାଇଲ୍ ଧାରଣ କରେ (ବିରାମୀମୁକ୍ତ, ଲେଣ୍ଡାଚାଣ) ଏବଂ ବୁଟ୍ ସମୟରେ migrationRunner.ts ଦ୍ୱାରା ଚଳାଯାଏ।

ମାଇଗ୍ରେସନ୍ ସାରା ସୃଷ୍ଟି ଟେବୁଲ୍ (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 (ସ୍ମୃତି ଖୋଜ ପାଇଁ FTS5 ଭର୍ଚୁଆଲ୍ ଟେବୁଲ୍ ସହ)।

3.3 src/domain/ — ଡୋମେନ୍ ସ୍ତର

ବିଶୁଦ୍ଧ ବ୍ୟବସାୟ ଯୁକ୍ତି, କୌଣସି I/O ନାହିଁ। ରୁଟ୍ ଏବଂ ହ୍ୟାଣ୍ଡଲର ଦ୍ୱାରା ଆମଦାନୀ କରାଯାଏ।

ଫାଇଲ୍	ଉଦ୍ଦେଶ୍ୟ
policyEngine.ts	ଟପ୍-ଲେଭଲ୍ ନୀତି ସମାଧାନକାରୀ
fallbackPolicy.ts	ଫଲବ୍ୟାକ୍ ନିର୍ଣ୍ଣୟ ଟ୍ରୀ
costRules.ts	ଖର୍ଚ୍ଚ ଗଣନା ନିୟମ
lockoutPolicy.ts	ମଡେଲ୍ ଲକ୍ଆଉଟ୍ ନିର୍ଣ୍ଣୟ
tagRouter.ts	ଟ୍ୟାଗ୍-ଆଧାରିତ ରୁଟିଙ୍ଗ୍
comboResolver.ts	ଅନୁରୋଧ → ଲକ୍ଷ୍ୟ ତାଲିକା ଠାରୁ କମ୍ବୋ ସମାଧାନ
connectionModelRules.ts	ପ୍ରତ୍ୟେକ ସଂଯୋଗ ମଡେଲ୍ ଫିଲ୍ଟର
modelAvailability.ts	ମଡେଲ୍ ଉପଲବ୍ଧତା ପରୀକ୍ଷା
degradation.ts	ଡିଗ୍ରେଡେଡ୍-ମୋଡ୍ ସଂକ୍ରମଣ
providerExpiration.ts	ମିଆଦ୍ ସରିଯାଇଥିବା ଆକାଉଣ୍ଟ୍/କୀ ଚିହ୍ନଟ
quotaCache.ts	କ୍ୟାଚ୍ କରାଯାଇଥିବା କୋଟା ନିର୍ଣ୍ଣୟ
responses.ts, omnirouteResponseMeta.ts	ପ୍ରତିକ୍ରିୟା ଆକାର ସହାୟକ
configAudit.ts	କନ୍ଫିଗ୍ ପରିବର୍ତ୍ତନ ଅଡିଟ୍
assessment/	ମଡେଲ୍ ମୂଲ୍ୟାୟନ (RFC ଅନୁଯାୟୀ, ଆଂଶିକ କାର୍ଯ୍ୟକାରୀ)
types.ts	ସାଝା ଡୋମେନ୍ ଟାଇପ୍

3.4 src/server/ — କେବଳ ସର୍ଭର

କ୍ଲାଏଣ୍ଟ୍ କମ୍ପୋନେଣ୍ଟ୍ ଦ୍ୱାରା ଆମଦାନୀ କରାଯାଇପାରିବ ନାହିଁ।

server/
├── auth/loginGuard.ts
├── authz/
│   ├── classify.ts        ରୁଟ୍ କୁ ସାର୍ବଜନୀନ ବନାମ ପରିଚାଳନା ବର୍ଗୀକୃତ କରେ
│   ├── assertAuth.ts      ଦାବି ସହାୟକ
│   ├── context.ts         ପ୍ରତ୍ୟେକ ଅନୁରୋଧ ଅଥରାଇଜେସନ୍ ସନ୍ଦର୍ଭ
│   ├── headers.ts
│   ├── pipeline.ts        ଅଥରାଇଜେସନ୍ ପାଇପ୍ଲାଇନ୍
│   ├── policies/          ବାସ୍ତବ ନୀତି
│   └── types.ts
└── cors/origins.ts        CORS ମୂଳ ଅନୁମୋଦନ ତାଲିକା

3.5 src/shared/ — ସାଝା କରିବା ସୁରକ୍ଷିତ

କେନ୍ଦ୍ରୀକୃତ ଉପ-ନିର୍ଦ୍ଦେଶିକା ରେ ବିଭକ୍ତ:

• constants/ — providers.ts (Zod-ଯାଞ୍ଚିତ ପ୍ରଦାନକାରୀ କ୍ୟାଟାଲଗ୍), models.ts, modelSpecs.ts, modelCompat.ts, pricing.ts, cliTools.ts, cliCompatProviders.ts, routingStrategies.ts, comboConfigMode.ts, headers.ts, upstreamHeaders.ts (ନିଷେଧ ତାଲିକା), 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 ସ୍କିମା), compressionConfigSchemas.ts, providerSchema.ts, settingsSchemas.ts, helpers.ts।
• contracts/ — npm ରେ ସାର୍ବଜନୀନ API ଚୁକ୍ତି।
• types/ — ସାଝା ଟିଏସ୍ ଟାଇପ୍।
• 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, ସହ services/, network/, middleware/, schemas/, hooks/, components/ ଅଧୀନରେ ଡ୍ୟାସବୋର୍ଡ୍ ହୁକ୍/କମ୍ପୋନେଣ୍ଟ୍।

---

4. open-sse/ — ଷ୍ଟ୍ରିମିଙ୍ଗ୍ ଇଞ୍ଜିନ୍ ଓୱାର୍କସ୍ପେସ୍

@omniroute/open-sse ନାମରେ ପ୍ରକାଶିତ ସ୍ଵତନ୍ତ୍ର npm ଓୱାର୍କସ୍ପେସ୍। ଅନୁରୋଧ ପ୍ରକ୍ରିୟାକରଣ, ଏକ୍ଜିକ୍ୟୁଟର୍, ଅନୁବାଦକ, ସେବା, ଟ୍ରାନ୍ସଫର୍ମର୍, ଏବଂ MCP ସର୍ଭରର ମାଲିକ।

open-sse/
├── index.ts                ସାର୍ଵଜନୀନ ରପ୍ତାନୀ
├── package.json            ଓୱାର୍କସ୍ପେସ୍ ମାନିଫେଷ୍ଟ
├── tsconfig.json
├── types.d.ts
├── config/                 ପ୍ରଦାତା ରଜିଷ୍ଟ୍ରୀ, ହେଡର୍ ପ୍ରୋଫାଇଲ୍, ପରିଚୟ, …
├── handlers/               ଅନୁରୋଧ ହ୍ୟାଣ୍ଡଲର୍ (ଚାଟ୍, ଏମ୍ବେଡିଂଗ୍ସ୍, ଅଡିଓ, ଇମେଜ୍, …)
├── executors/              108 ପ୍ରଦାତା-ବିଶେଷ HTTP ଏକ୍ଜିକ୍ୟୁଟର୍
├── translator/             ଫର୍ମାଟ୍ ରୂପାନ୍ତର (OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro)
├── transformer/            Responses API ↔ Chat Completions ଷ୍ଟ୍ରିମ୍ ଟ୍ରାନ୍ସଫର୍ମର୍
├── services/               80+ ସେବା ମଡ୍ୟୁଲ୍ (କମ୍ବୋ, ଫଲବ୍ୟାକ୍, କୋଟା, ପରିଚୟ, …)
├── utils/                  ଷ୍ଟ୍ରିମିଙ୍ଗ୍ ସାହାଯ୍ୟକାରୀ, TLS କ୍ଲାଏଣ୍ଟ୍, AWS SigV4, ପ୍ରକ୍ସି ଫେଚ୍, …
└── mcp-server/             MCP ସର୍ଭର (3 ଟ୍ରାନ୍ସପୋର୍ଟ, 33 ସ୍କୋପ୍, 110 ଟୁଲ୍)

4.1 open-sse/handlers/

ହ୍ୟାଣ୍ଡଲର୍	ଉଦ୍ଦେଶ୍ୟ
chatCore.ts	ମୁଖ୍ୟ ଚାଟ୍ ପାଇପଲାଇନ୍ (କ୍ୟାଚ୍, ରେଟ୍ ଲିମିଟ୍, କମ୍ବୋ ରୁଟିଂଗ୍, ଏକ୍ଜିକ୍ୟୁଟର୍ ଡିସ୍ପ୍ୟାଚ୍)
responsesHandler.ts	OpenAI Responses API ଏଣ୍ଟ୍ରି ପଏଣ୍ଟ
embeddings.ts	ଏମ୍ବେଡିଂଗ୍ସ୍
imageGeneration.ts	ଇମେଜ୍ ଜେନେରେସନ୍
audioSpeech.ts	ଟେକ୍ସଟ୍-ଟୁ-ସ୍ପିଚ୍
audioTranscription.ts	ସ୍ପିଚ୍-ଟୁ-ଟେକ୍ସଟ୍
videoGeneration.ts	ଭିଡିଓ ଜେନେରେସନ୍
musicGeneration.ts	ସଂଗୀତ ଜେନେରେସନ୍
rerank.ts	ପୁନଃର୍ୟାଙ୍କିଂଗ୍
moderations.ts	ମଡେରେସନ୍
search.ts	ଓୱେବ୍ ସର୍ଚ୍ଚ
sseParser.ts	SSE ଇଭେଣ୍ଟ୍ ପାର୍ସର୍
usageExtractor.ts	ଅପ୍ଷ୍ଟ୍ରିମ୍ ଷ୍ଟ୍ରିମ୍ରୁ ଟୋକନ୍ ଗଣନା ବାହାର କରନ୍ତୁ
responseSanitizer.ts	ପ୍ରଦାତା-ବିଶେଷ ଶବ୍ଦ ହଟାନ୍ତୁ
responseTranslator.ts	ପ୍ରଦାତା ଉତ୍ତର ଏବଂ ଅନୁବାଦକ ସ୍ତର ମଧ୍ୟରେ ସଞ୍ଜାଳ

4.2 open-sse/executors/

108 ପ୍ରଦାତା ଏକ୍ଜିକ୍ୟୁଟର୍, ପ୍ରତ୍ୟେକ 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, ସହ claudeIdentity.ts (ସାଝା ପରିଚୟ ସାହାଯ୍ୟକାରୀ) ଏବଂ index.ts (ରଜିଷ୍ଟ୍ରୀ)।

ଟିପ୍ପଣୀ: ଏଠାରେ ତାଲିକାଭୁକ୍ତ ନ ଥିବା ପ୍ରଦାତାମାନଙ୍କୁ default.ts ସାଧାରଣ OpenAI-ସୁସଙ୍ଗତ ଏକ୍ଜିକ୍ୟୁଟର୍ ବ୍ୟବହାର କରି ସେବା ଯୋଗାଯାଏ। ସମ୍ପୂର୍ଣ୍ଣ ପ୍ରଦାତା ତାଲିକା (355 ପ୍ରଦାତା) src/shared/constants/providers.ts ରେ ଥାଏ।

4.3 open-sse/translator/

ହବ୍-ଆଣ୍ଡ-ସ୍ପୋକ୍ ଅନୁବାଦ (OpenAI ହେଉଛି ହବ୍)।

• 9 ଅନୁରୋଧ ଅନୁବାଦକ (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 ଉତ୍ତର ଅନୁବାଦକ (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 ସାହାଯ୍ୟକାରୀ (translator/helpers/): claudeHelper, geminiHelper, geminiToolsSanitizer, maxTokensHelper, openaiHelper, responsesApiHelper, schemaCoercion, toolCallHelper, ସହ ସାହାଯ୍ୟକାରୀ ପରୀକ୍ଷା।
• ଇମେଜ୍ ସାହାଯ୍ୟକାରୀ (translator/image/sizeMapper.ts)।
• ଶୀର୍ଷ ସ୍ତର: bootstrap.ts, formats.ts, registry.ts, index.ts।

4.4 open-sse/transformer/

• responsesTransformer.ts — TransformStream-ଆଧାରିତ Responses API ↔ Chat Completions ରୂପାନ୍ତରକ (responses/ ରୁଟ୍ କ୍ୟାଚ୍-ଅଲ୍ ଦ୍ୱାରା ବ୍ୟବହୃତ)।

4.5 open-sse/services/

ମୁଖ୍ୟ ଆକର୍ଷଣ (open-sse/services/ ଅଧୀନରେ ସମ୍ପୂର୍ଣ୍ଣ ତାଲିକା):

ଚିନ୍ତା ବିଷୟ	ଫାଇଲ୍ଗୁଡ଼ିକ
କମ୍ବୋ ରୁଟିଂଗ୍	combo.ts (19 କୌଶଳ), comboConfig.ts, comboMetrics.ts, comboManifestMetrics.ts, autoComboAgentMiddleware.ts
ଅଟୋ କମ୍ବୋ ଇଞ୍ଜିନ୍	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
ସ୍ଥାୟିତତା	accountFallback.ts (କୁଲଡାଉନ୍ + ଲକଆଉଟ୍), errorClassifier.ts, emergencyFallback.ts, rateLimitManager.ts, rateLimitSemaphore.ts, accountSemaphore.ts, accountSelector.ts
କୋଟା	quotaMonitor.ts, quotaPreflight.ts, bailianQuotaFetcher.ts, codexQuotaFetcher.ts, deepseekQuotaFetcher.ts, openrouterQuotaFetcher.ts, openrouterFreeWindow.ts, crofUsageFetcher.ts, antigravityCredits.ts
କ୍ୟାଚିଂଗ୍	reasoningCache.ts, searchCache.ts, signatureCache.ts, requestDedup.ts
ରୁଟିଂଗ୍ ବୁଦ୍ଧିମତ୍ତା	intentClassifier.ts, taskAwareRouter.ts, backgroundTaskDetector.ts, volumeDetector.ts, wildcardRouter.ts, workflowFSM.ts, specificityDetector.ts, specificityRules.ts, specificityTypes.ts
ମଡେଲ୍ ହ୍ୟାଣ୍ଡଲିଂଗ୍	modelCapabilities.ts, modelDeprecation.ts, modelFamilyFallback.ts, modelStrip.ts, model.ts, provider.ts, providerRequestDefaults.ts, providerCostData.ts, payloadRules.ts
ସଂକୋଚନ	compression/ — ସମ୍ପୂର୍ଣ୍ଣ ସଂକୋଚନ ଇଞ୍ଜିନ୍ ୱାୟରିଂ
ଟୋକନ୍ + ସେସନ୍	tokenRefresh.ts, sessionManager.ts, apiKeyRotator.ts, contextManager.ts, contextHandoff.ts, systemPrompt.ts, roleNormalizer.ts, responsesInputSanitizer.ts, toolSchemaSanitizer.ts, toolLimitDetector.ts, thinkingBudget.ts
ସ୍ତର / ମାନିଫେଷ୍ଟ	tierResolver.ts, tierConfig.ts, tierDefaults.json, tierTypes.ts, manifestAdapter.ts
IP / ନେଟୱର୍କ	ipFilter.ts, webSearchFallback.ts
ବ୍ୟାଚ୍	batchProcessor.ts
ବ୍ୟବହାର	usage.ts

4.6 open-sse/mcp-server/

• 110 ଅନନ୍ୟ ଟୁଲ୍ server.ts ରେ ୱାୟାର୍ ହୋଇଛି (45 କାନୋନିକାଲ schemas/tools.ts + ମେମୋରୀ, ସ୍କିଲ୍, GitHub-skills, ପୁଲ୍, ଗେମିଫିକେସନ୍, ପ୍ଲଗିନ୍, Notion, Obsidian, local-corpus ଏବଂ ସଂକୋଚନ ମଡ୍ୟୁଲ୍ — countUniqueMcpTools ଦ୍ୱାରା ଗଣିତ ସଂଘ)।
• 3 ଟ୍ରାନ୍ସପୋର୍ଟ: stdio, HTTP Streamable, SSE।
• 33 ସ୍କୋପ୍ ରନ୍ଟାଇମ୍ରେ ପ୍ରଯୋଗ କରାଯାଏ — ମୌଳିକ ତାଲିକା src/shared/constants/mcpScopes.ts ରେ, ସମ୍ପୂର୍ଣ୍ଣ ସେଟ୍ ହେଉଛି ପ୍ରତ୍ୟେକ ଟୁଲ୍ ମଡ୍ୟୁଲ୍ ଦ୍ୱାରା ଘୋଷିତ ସ୍କୋପ୍ର ସଂଘ।
• ସମୀକ୍ଷା ଟେବୁଲ୍: mcp_tool_audit (audit.ts ଦ୍ୱାରା ପୂରଣ କରାଯାଏ)।
• ଫାଇଲ୍ଗୁଡ଼ିକ: 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, ସହ __tests__/ ଅଧୀନରେ ପରୀକ୍ଷା।
• ସମ୍ପୂର୍ଣ୍ଣ ଟୁଲ୍ ତାଲିକା ପାଇଁ MCP-SERVER.md ଦେଖନ୍ତୁ।

4.7 open-sse/config/

ପ୍ରଦାତା ରଜିଷ୍ଟ୍ରୀ (providerRegistry.ts, providerModels.ts, providerHeaderProfiles.ts), ପ୍ରତି-ଫର୍ମାଟ୍ ମଡେଲ୍ ରଜିଷ୍ଟ୍ରୀ (audioRegistry.ts, embeddingRegistry.ts, imageRegistry.ts, moderationRegistry.ts, musicRegistry.ts, rerankRegistry.ts, searchRegistry.ts, videoRegistry.ts), ପରିଚୟ ସାହାଯ୍ୟକାରୀ (codexIdentity.ts, codexInstructions.ts, anthropicHeaders.ts, antigravityUpstream.ts, antigravityModelAliases.ts, cliFingerprints.ts, toolCloaking.ts, defaultThinkingSignature.ts), ପ୍ରମାଣପତ୍ର ସାହାଯ୍ୟକାରୀ (credentialLoader.ts, codexClient.ts), ଏବଂ କ୍ଲାଉଡ୍ ଏଡାପ୍ଟର୍ (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/

ଷ୍ଟ୍ରିମିଙ୍ଗ୍ ପ୍ରାଇମିଟିଭ୍ ଏବଂ ପ୍ରଦାତା ସାହାଯ୍ୟକାରୀ: 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/ — ଡେସ୍କଟପ୍ ର୍ୟାପର

electron/
├── main.js                  Electron ମୁଖ୍ୟ ପ୍ରକ୍ରିୟା
├── preload.js               ପ୍ରୀଲୋଡ୍ ବ୍ରିଜ୍ (contextIsolation ସକ୍ରିୟ)
├── types.d.ts
├── package.json             electron-builder କନ୍ଫିଗ୍, ସଂସ୍କରଣ 3.8.51
├── README.md
├── assets/                  ବିଲ୍ଡ ସମ୍ବଳ (ଆଇକନ୍, ଏଣ୍ଟାଇଟେଲମେଣ୍ଟ୍, ...)
├── node_modules/            ସମର୍ପିତ node_modules (better-sqlite3, electron-updater)
└── dist-electron/           ବିଲ୍ଡ ଆଉଟପୁଟ୍ (କମିଟ୍ ହୋଇନାହିଁ)

ୱାର୍କସ୍ପେସ୍ ରୁଟ୍ରେ ପାଞ୍ଚଟି npm ସ୍କ୍ରିପ୍ଟ୍: electron:dev, electron:build, electron:build:{win,mac,linux}, electron:smoke:packaged। ସ୍ୱୟଂଚାଳିତ ଅପଡେଟ୍ GitHub ରିଲିଜ୍ ଫିଡ୍ ଆଡ଼କୁ ଇଙ୍ଗିତ କରୁଥିବା electron-updater ମାଧ୍ୟମରେ ହୁଏ।

---

6. bin/ — CLI

bin/
├── omniroute.mjs           ମୁଖ୍ୟ CLI ଏଣ୍ଟ୍ରି (Node ESM)
├── reset-password.mjs      CLI ରୁ ପ୍ରବନ୍ଧନ ପାସ୍ୱାର୍ଡ ରିସେଟ୍ କରନ୍ତୁ
├── mcp-server.mjs          MCP ସର୍ଭର ଲଞ୍ଚର (stdio)
├── nodeRuntimeSupport.mjs  Node ସଂସ୍କରଣ ଗାର୍ଡ
└── cli/
    ├── program.mjs         Commander ପ୍ରୋଗ୍ରାମ୍ ନିର୍ମାତା
    ├── runtime.mjs         withRuntime ସାହାଯ୍ୟକାରୀ (ସର୍ଭର-ପ୍ରଥମ/db-fallback)
    ├── output.mjs          ଆଉଟପୁଟ୍ ଫର୍ମାଟର୍ (json/jsonl/table/csv)
    ├── i18n.mjs            ଲୋକାଲ୍ ସହିତ t() ସାହାଯ୍ୟକାରୀ
    ├── api.mjs             API ଫେଚ୍ ସାହାଯ୍ୟକାରୀ
    ├── data-dir.mjs
    ├── encryption.mjs
    ├── sqlite.mjs
    └── commands/
        ├── registry.mjs    କମାଣ୍ଡ ପଞ୍ଜିକରଣ
        ├── setup.mjs
        ├── doctor.mjs
        ├── providers.mjs
        └── ...             (ପ୍ରତ୍ୟେକ କମାଣ୍ଡ/ଗୋଷ୍ଠୀ ପାଇଁ ଗୋଟିଏ ଫାଇଲ୍)

package.json → bin ରେ ଦୁଇଟି ବାଇନାରୀ ପ୍ରଦାନ କରାଯାଇଛି:

• omniroute → bin/omniroute.mjs
• omniroute-reset-password → bin/reset-password.mjs

---

7. tests/

ନିର୍ଦ୍ଦେଶିକା	ପ୍ରକାର
tests/unit/	Node ନେଟିଭ୍ ପରୀକ୍ଷଣ ରନର୍ ମାଧ୍ୟମରେ ୟୁନିଟ୍ ପରୀକ୍ଷଣ (1821 ଫାଇଲ୍, api/, auth/, authz/ ଉପ-ନିର୍ଦ୍ଦେଶିକା ସହିତ)
tests/integration/	ମଡ୍ୟୁଲ୍-କ୍ରସ୍ + DB-ଅବସ୍ଥା ପରୀକ୍ଷଣ
tests/e2e/	Playwright UI ପରୀକ୍ଷଣ
tests/e2e/protocol-clients.test.ts	MCP/A2A ପ୍ରୋଟୋକଲ୍ e2e
tests/translator/	ଅନୁବାଦକ-ନିର୍ଦ୍ଦିଷ୍ଟ ପରୀକ୍ଷଣ
tests/security/	ସୁରକ୍ଷା ପ୍ରତିଗମନ
tests/load/	ଲୋଡ୍ / ସ୍ଟ୍ରେସ୍ ପରୀକ୍ଷଣ
tests/golden-set/	ଅନୁବାଦକ ପ୍ରତିଗମନ ପାଇଁ ରେଫରେନ୍ସ୍ ଆଉଟପୁଟ୍
tests/helpers/, tests/fixtures/, tests/manual/	ସମର୍ଥନ

ସାଧାରଣ କମାଣ୍ଡ:

କମାଣ୍ଡ	ଯାହା ଚଳାଏ
npm run test:unit	Node ପରୀକ୍ଷଣ ରନର୍ ମାଧ୍ୟମରେ ସମସ୍ତ tests/unit/*.test.ts (ସମାନାନ୍ତରତା 10)
npm run test:vitest	Vitest ସୁଇଟ୍ (MCP, autoCombo, cache)
npm run test:e2e	Playwright UI ସୁଇଟ୍
npm run test:protocols:e2e	MCP + A2A ପ୍ରୋଟୋକଲ୍ e2e
npm run test:coverage	କୋଭରେଜ୍ ଗେଟ୍ (≥60% ଲାଇନ୍/ଷ୍ଟେଟମେଣ୍ଟ/ଫଙ୍କ୍ସନ/ବ୍ରାଞ୍ଚ)
node --import tsx/esm --test tests/unit/<file>.test.ts	ଏକକ ଫାଇଲ୍ ଚଳାନ୍ତୁ

---

8. scripts/

ଉଦ୍ଦେଶ୍ୟ ଅନୁସାରେ 6 ଉପ-ଫୋଲଡରେ ସଂଗଠିତ।

• 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. ଅନୁରୋଧ ପାଇପଲାଇନ (ସାରାଂଶ)

ଉତ୍ସ: diagrams/request-pipeline.mmd

କ୍ଲାଏଣ୍ଟ ଅନୁରୋଧ
  → /v1/chat/completions (route.ts)
     CORS ପ୍ରିଫ୍ଲାଇଟ୍ ଯାଞ୍ଚ
     Zod ସାର୍ଥକତା ଯାଞ୍ଚ (shared/validation/schemas.ts ର chatCompletionsSchema)
     ପ୍ରମାଣୀକରଣ (extractApiKey + isValidApiKey ଅଥବା requireManagementAuth)
     ନୀତି ଇଞ୍ଜିନ (src/server/authz/pipeline.ts)
     ସୁରକ୍ଷାଗାର୍ଡ (PII ମାସ୍କର, ପ୍ରମ୍ପ୍ଟ ଇଞ୍ଜେକ୍ସନ, ଦୃଷ୍ଟି ବ୍ରିଜ)
  → handleChatCore() (open-sse/handlers/chatCore.ts)
     ୟାଚ୍ ଯାଞ୍ଚ (ଅର୍ଥଗତ + ପଠନ ୟାଚ୍)
     ହାର ସୀମା (rateLimitManager, accountSemaphore)
     କମ୍ବୋ ରୁଟିଂ (ଯଦି ମଡେଲ ଏକ କମ୍ବୋକୁ ସମାଧାନ କରେ)
       comboResolver → ପ୍ରତ୍ୟେକ ଲକ୍ଷ୍ୟ ପାଇଁ ଲୁପ୍ → handleSingleModel()
     translateRequest()  (open-sse/translator/request/*)
     getExecutor(providerId).execute()  (open-sse/executors/*)
       accountFallback ମାଧ୍ୟମରେ ଅପ୍ଷ୍ଟ୍ରିମ୍ ଫେଚ୍ → ପୁନର୍ଚେଷ୍ଟ/ବ୍ୟାକଅଫ୍
     translateResponse() (open-sse/translator/response/*)
     SSE ଷ୍ଟ୍ରିମ୍ ଅଥବା JSON ପ୍ରତିକ୍ରିୟା
     ଯଦି Responses API: open-sse/transformer/responsesTransformer.ts ମାଧ୍ୟମରେ TransformStream
  → ଅନୁପାଳନ ଅଡିଟ୍ (src/lib/compliance/)
  → କ୍ଲାଏଣ୍ଟକୁ ପ୍ରତିକ୍ରିୟା

ସ୍ଥାୟୀତ୍ୱ ରନ୍ଟାଇମ୍ ଅବସ୍ଥା (ତିନୋଟି ମେକାନିଜମ୍)

ମେକାନିଜମ୍	ପରିସର	ସ୍ଥାନ
ପ୍ରଦାତା ସର୍କିଟ୍ ବ୍ରେକର	ସମ୍ପୂର୍ଣ୍ଣ ପ୍ରଦାତା	src/shared/utils/circuitBreaker.ts, domain_circuit_breakers ରେ ସଂରକ୍ଷିତ
ସଂଯୋଗ କୁଲଡାଉନ୍	ଗୋଟିଏ ଆକାଉଣ୍ଟ/କୀ	src/sse/services/auth.ts ରେ markAccountUnavailable(); accountFallback.checkFallbackError() ଦ୍ୱାରା ବ୍ୟବହୃତ
ମଡେଲ ଲକ୍ଆଉଟ୍	ପ୍ରଦାତା + ସଂଯୋଗ + ମଡେଲ	open-sse/services/accountFallback.ts, domain_lockout_state ରେ ସଂରକ୍ଷିତ

RESILIENCE_GUIDE.md ଏବଂ CLAUDE.md ର ସମର୍ପିତ ଅନୁଭାଗ ଦେଖନ୍ତୁ।

---

୧୦. ଯୋଗଦାନ କିପରି କରିବେ

ଏକ ନୂତନ ପ୍ରଦାତା ଯୋଗ କରନ୍ତୁ

1. src/shared/constants/providers.ts ରେ ପଞ୍ଜିକୃତ କରନ୍ତୁ (ଲୋଡ୍ ସମୟରେ Zod-ଦ୍ୱାରା ଯାଞ୍ଚ ହୋଇଥାଏ)।
2. ଯଦି କଷ୍ଟମ ଯୁକ୍ତି ଆବଶ୍ୟକ, open-sse/executors/ ରେ ଏକ ଏକ୍ଜିକ୍ୟୁଟର ଯୋଗ କରନ୍ତୁ (BaseExecutor କୁ ବିସ୍ତାର କରନ୍ତୁ)।
3. ଯଦି ଏହା OpenAI ଫର୍ମାଟ ବୋଲି ନ ପାରେ, open-sse/translator/ ରେ ଏକ ଅନୁବାଦକ ଯୋଗ କରନ୍ତୁ।
4. ଯଦି OAuth-ଆଧାରିତ, src/lib/oauth/providers/ ଏବଂ src/lib/oauth/services/ ଅଧୀନରେ କନ୍ଫିଗ ଯୋଗ କରନ୍ତୁ।
5. ମଡେଲଗୁଡ଼ିକୁ open-sse/config/providerRegistry.ts (ବା open-sse/config/ ଅଧୀନରେ ଫର୍ମାଟ-ନିର୍ଦ୍ଦିଷ୍ଟ ରଜିଷ୍ଟ୍ରି) ରେ ପଞ୍ଜିକୃତ କରନ୍ତୁ।
6. tests/unit/ ଅଧୀନରେ ପରୀକ୍ଷା ଲେଖନ୍ତୁ।

ଏକ ନୂତନ API ରୁଟ ଯୋଗ କରନ୍ତୁ

1. src/app/api/your-route/route.ts ସୃଷ୍ଟି କରନ୍ତୁ।
2. ନିମ୍ନଲିଖିତ ଢାଞ୍ଚା ଅନୁସରଣ କରନ୍ତୁ: CORS → Zod ବଡି ଯାଞ୍ଚ → ପ୍ରମାଣୀକରଣ → ହ୍ୟାଣ୍ଡଲର ପ୍ରତିନିଧିକରଣ।
3. ଯଦି ନୂତନ ଅନୁରୋଧ ଆକୃତି: src/shared/validation/schemas.ts ରେ Zod ସ୍କିମା ଯୋଗ କରନ୍ତୁ।
4. ଯଦି କେବଳ ପରିଚାଳନା-ପ୍ରକାର: src/shared/constants/publicApiRoutes.ts ରେ ପାଥ ଯୋଗ କରନ୍ତୁ (ସାର୍ବଜନୀନ API ସରଫେସ୍ ପାଇଁ ଅସ୍ୱୀକୃତ ତାଲିକା)।
5. tests/unit/ ଅଧୀନରେ ପରୀକ୍ଷା ଯୋଗ କରନ୍ତୁ।
6. docs/reference/API_REFERENCE.md ଏବଂ docs/openapi.yaml ଅଦ୍ୟତନ କରନ୍ତୁ।

ଏକ ନୂତନ DB ମଡ୍ୟୁଲ ଯୋଗ କରନ୍ତୁ

1. src/lib/db/yourModule.ts ସୃଷ୍ଟି କରନ୍ତୁ ଏବଂ ./core.ts ରୁ getDbInstance() ଆମଦାନୀ କରନ୍ତୁ।
2. ଆପଣଙ୍କ ଡୋମେନ୍ ପାଇଁ CRUD ଫଙ୍କସନ ରପ୍ତାନୀ କରନ୍ତୁ।
3. ଯଦି ନୂତନ ଟେବୁଲ: src/lib/db/migrations/ ଅଧୀନରେ ଏକ ମାଇଗ୍ରେସନ୍ ଯୋଗ କରନ୍ତୁ, ଯାହା କ୍ରମିକ ସଂଖ୍ୟାକ୍ରମିକ, ସମାନ ପରିଣାମ, ଲେଣ୍ଡେନ ଯୋଗ୍ୟ ଅଟେ।
4. ଆମଦାନୀକାରୀମାନେ @/lib/db/yourModule ରୁ ସିଧାସଳଖ ଆମଦାନୀ ବ୍ୟବହାର କରନ୍ତୁ (ବ୍ୟାରେଲ ନୁହେଁ — ପୁରୁଣା localDb.ts ରି-ଏକ୍ସପୋର୍ଟ ସ୍ତର ଅପସାରିତ ହୋଇଛି)।
5. tests/unit/ ଅଧୀନରେ ପରୀକ୍ଷା ଯୋଗ କରନ୍ତୁ।

ଏକ ନୂତନ MCP ଟୁଲ ଯୋଗ କରନ୍ତୁ

1. open-sse/mcp-server/tools/ ଅଧୀନରେ ଟୁଲ ସଂଜ୍ଞା ଯୋଗ କରନ୍ତୁ (ବା open-sse/mcp-server/schemas/tools.ts କୁ ବିସ୍ତାର କରନ୍ତୁ)।
2. src/shared/constants/mcpScopes.ts ରେ ଉପଯୁକ୍ତ ପରିସର(ଗୁଡ଼ିକୁ) ନିର୍ଦ୍ଧାରଣ କରନ୍ତୁ।
3. open-sse/mcp-server/server.ts ରେ ଟୁଲ ପଞ୍ଜିକୃତ କରନ୍ତୁ।
4. open-sse/mcp-server/__tests__/ ଅଧୀନରେ ପରୀକ୍ଷା ଯୋଗ କରନ୍ତୁ।
5. MCP-SERVER.md ଅଦ୍ୟତନ କରନ୍ତୁ।

ଏକ ନୂତନ A2A ସ୍କିଲ୍ ଯୋଗ କରନ୍ତୁ

A2A-SERVER.md § ନୂତନ ସ୍କିଲ୍ ଯୋଗ କରିବା ଦେଖନ୍ତୁ। ସ୍କିଲ୍ଗୁଡ଼ିକ src/lib/a2a/skills/ ରେ ଥାଏ ଏବଂ A2A ଟାସ୍କ ମ୍ୟାନେଜର୍ ମାଧ୍ୟମରେ ପଞ୍ଜିକୃତ ହୋଇଥାଏ।

---

୧୧. ସମ୍ମେଳନ

• କୋଡ୍ ଶୈଳୀ: 2-ସ୍ଥାନ ଇନ୍ଡେଣ୍ଟ, ଦ୍ୱିଗୁଣ ଉଦ୍ଧୃତି, ୧୦୦ ଅକ୍ଷର ପ୍ରସ୍ଥ, ସେମିକୋଲନ, es5 ଟ୍ରେଲିଙ୍ଗ କମା — Prettier ଦ୍ୱାରା lint-staged ମାଧ୍ୟମରେ ପ୍ରୟୋଗ କରାଯାଏ।
• ଆମଦାନୀ: ବାହ୍ୟ → ଅନ୍ତଃ (@/, @omniroute/open-sse) → ସମ୍ପର୍କିତ।
• ନାମକରଣ: ଫାଇଲ camelCase ବା kebab-case, କମ୍ପୋନେଣ୍ଟ PascalCase, ଧାରାବାହିକ UPPER_SNAKE।
• ESLint: no-eval, no-implied-eval, no-new-func = ସର୍ବତ୍ର error; no-explicit-any = open-sse/ ଏବଂ tests/ ରେ warn, ଅନ୍ୟତ୍ର error।
• TypeScript: strict: false (ପୁରୁଣା ସ୍ଥିତି)। କ୍ରସ-ମଡ୍ୟୁଲ ସୀମାରେ ଅନୁମାନ ଅପେକ୍ଷା ସ୍ପଷ୍ଟ ପ୍ରକାର ପସନ୍ଦ କରନ୍ତୁ।
• ଡାଟାବେସ୍: ରୁଟ ବା ହ୍ୟାଣ୍ଡଲରରେ କେବେ ହେଲେ କଞ୍ଚା SQL ଲେଖନ୍ତୁ ନାହିଁ — ସର୍ବଦା src/lib/db/ ମଡ୍ୟୁଲ ମାଧ୍ୟମରେ ଯାଆନ୍ତୁ। କେବେ ହେଲେ ବ୍ୟାରେଲ-ଆମଦାନୀ ନ କରନ୍ତୁ — ସିଧାସଳଖ ନିର୍ଦ୍ଦିଷ୍ଟ src/lib/db/* ମଡ୍ୟୁଲ ବ୍ୟବହାର କରନ୍ତୁ।
• DB-entity ପ୍ରକାର (#3512): ଏକ ଡାଟାବେସ୍ ଟେବୁଲର ଧାରା ଆକୃତି ଲେଖୁ ବା ପଢ଼ୁଥିବା ଫଙ୍କସନ ସେହି ଟେବୁଲର ସ୍ତମ୍ଭ 1:1 ପ୍ରତିବିମ୍ବିତ କରୁଥିବା ଏକ ନାମିତ TS ଇଣ୍ଟରଫେସ୍ ନେବା/ଫେରାଇବା ଉଚିତ୍, any ବା କଲ-ସାଇଟରେ ଏକ ଇନଲାଇନ ବେନାମୀ ପ୍ରକାର ନୁହେଁ। ଫଙ୍କସନ ପାଖରେ ଇଣ୍ଟରଫେସ୍ ଅବସ୍ଥାପିତ କରନ୍ତୁ (ଯେପରି src/lib/usage/usageHistory.ts ରେ saveRequestUsage ଉପରେ export interface UsageEntry), ବିଭିନ୍ନ ଲେଖକ ଧାରାକୁ କ୍ରମିକ ଭାବେ ପୂରଣ କଲେ ବ୍ୟକ୍ତିଗତ କ୍ଷେତ୍ରଗୁଡ଼ିକୁ ବିକଳ୍ପ/ଶୂନ୍ୟ ରଖନ୍ତୁ, ଏବଂ କଲରମାନଙ୍କ ମଧ୍ୟରେ ଆକୃତି ଭିନ୍ନ ଥିବା କ୍ଷେତ୍ର ପାଇଁ unknown କୁ any ଅପେକ୍ଷା ପସନ୍ଦ କରନ୍ତୁ (କ୍ଷେତ୍ର ଉପରେ ଡକୁମେଣ୍ଟ କରାଯାଇଛି, ଯେପରି UsageEntry.tokens ଉଭୟ କଞ୍ଚା ପ୍ରଦାତା-ଆକୃତି ବ୍ୟବହାର ଏବଂ ସାମାନ୍ୟୀକୃତ ଆକୃତି ଗ୍ରହଣ କରେ)। ଏକ ଫାଇଲର any ଗଣନା ଏହି ପ୍ରକାରେ ଶୂନ୍ୟ ସ୍ପର୍ଶ କଲେ, ଏହାକୁ check:any-budget:t11 ଅନୁମତି ତାଲିକା (scripts/check/check-t11-any-budget.mjs, maxAny: 0) ରେ ଯୋଗ କରନ୍ତୁ ଯାହାଦ୍ୱାରା ଏହା ପଛକୁ ଯାଇ ନ ପାରେ। ଏହା ଏକ ପ୍ରଥମ-ଖଣ୍ଡ ସମ୍ମେଳନ — ବ୍ୟାପକ "ବେନାମୀ any ନାହିଁ" ସଫା ବାକି କୋଡ୍ବେସରେ ପୁନରାବୃତ୍ତି ଅଟେ।
• ତ୍ରୁଟି: ନିର୍ଦ୍ଦିଷ୍ଟ ତ୍ରୁଟି ପ୍ରକାର ସହିତ try/catch, piro ସାନ୍ଦର୍ଭ ସହିତ ଲଗ୍ କରନ୍ତୁ। କେବେ ହେଲେ SSE ଷ୍ଟ୍ରିମରେ ଚୁପ୍ ହୋଇ ତ୍ରୁଟି ନ ଗିଳନ୍ତୁ; ସଫା ପାଇଁ ଅବରଟ ସିଗ୍ନାଲ ବ୍ୟବହାର କରନ୍ତୁ।
• ସୁରକ୍ଷା: କେବେ ହେଲେ eval() / new Function() / ଅନୁବିନ୍ଧିତ eval ବ୍ୟବହାର ନ କରନ୍ତୁ। ସମସ୍ତ ଇନପୁଟ୍ Zod ସହିତ ଯାଞ୍ଚ କରନ୍ତୁ। ସ୍ଥିର ସମୟରେ ପ୍ରମାଣ ସାଖି (AES-256-GCM) ଏନ୍କ୍ରିପ୍ଟ କରନ୍ତୁ। src/shared/constants/upstreamHeaders.ts ଅସ୍ୱୀକୃତ ତାଲିକାକୁ ସେନିଟାଇଜ/ଯାଞ୍ଚ ସ୍ତର ସହିତ ସମାନ ରଖନ୍ତୁ।
• କମିଟ: Conventional Commits — feat(scope): subject। ଅନୁମୋଦିତ ପରିସର: db, sse, oauth, dashboard, api, cli, docker, ci, mcp, a2a, memory, skills।
• ଶାଖା: ଉପସର୍ଗ feat/, fix/, refactor/, docs/, test/, chore/। ସିଧାସଳଖ main ରେ କେବେ ହେଲେ କମିଟ ନ କରନ୍ତୁ।
• Husky: ପ୍ରି-କମିଟ lint-staged + check:docs-sync + check:any-budget:t11 ଚଲାଏ; ପ୍ରି-ପୁଶ check:any-budget:t11 + check:tracked-artifacts ଚଲାଏ (ଦ୍ରୁତ ଗେଟ୍; test:unit ବାଦ ଦିଏ)।

---

୧୨. ହାର୍ଡ ରୁଲ୍ସ (CLAUDE.md ରୁ)

୧. କଦାଚିତ୍ ସିକ୍ରେଟ୍ସ କିମ୍ବା କ୍ରେଡେନ୍ସିଆଲ୍ସ କମିଟ୍ କରନ୍ତୁ ନାହିଁ। ୨. କଦାଚିତ୍ ବ୍ୟାରଲ୍-ଇମ୍ପୋର୍ଟ କରନ୍ତୁ ନାହିଁ — ସିଧାସଳଖ src/lib/db/* ମୋଡ୍ୟୁଲ୍ସ ବ୍ୟବହାର କରନ୍ତୁ। ୩. କଦାଚିତ୍ eval() / new Function() / ଅଲୋଚିତ eval ବ୍ୟବହାର କରନ୍ତୁ ନାହିଁ। ୪. କଦାଚିତ୍ ସିଧାସଳଖ main ରେ କମିଟ୍ କରନ୍ତୁ ନାହିଁ। ୫. କଦାଚିତ୍ ରୁଟ୍ସରେ କଞ୍ଚା SQL ଲେଖନ୍ତୁ ନାହିଁ — ସର୍ବଦା src/lib/db/ ମୋଡ୍ୟୁଲ୍ସ ମାଧ୍ୟମରେ ଯାଆନ୍ତୁ। ୬. କଦାଚିତ୍ SSE ଷ୍ଟ୍ରିମ୍ସରେ ଚୁପ୍ ଚାପ୍ ତୃଟି ଗ୍ରାସ କରନ୍ତୁ ନାହିଁ। ୭. ସର୍ବଦା Zod ସ୍କିମା ସହ ଇନ୍ପୁଟ୍ସ ଯାଞ୍ଚ କରନ୍ତୁ। ୮. ପ୍ରୋଡକ୍ସନ୍ କୋଡ୍ ପରିବର୍ତ୍ତନ କରିବା ସମୟରେ ସର୍ବଦା ପରୀକ୍ଷା ଅନ୍ତର୍ଭୁକ୍ତ କରନ୍ତୁ। ୯. କଭରେଜ୍ ≥ ୬୦% (ଷ୍ଟେଟମେଣ୍ଟ୍ସ, ଲାଇନ୍ସ, ଫଙ୍କ୍ସନ୍ସ, ବ୍ରାଞ୍ଚେସ୍) ରେ ରହିବା ଉଚିତ୍।

---

୧୩. ମଧ୍ୟ ଦେଖନ୍ତୁ

• ARCHITECTURE.md — ଉଚ୍ଚ-ସ୍ତରର ସ୍ଥାପତ୍ୟ ଏବଂ ମୋଡ୍ୟୁଲ୍ <0A>ାଧ୍ୟତା।
• API_REFERENCE.md — ସାର୍ବଜନୀନ + ପ୍ରଶାସନିକ API ରେଫରେନ୍ସ।
• FEATURES.md — ଫିଚର୍ ମ୍ୟାଟ୍ରିକ୍ସ ଏବଂ ସଂସ୍କରଣ ହାଇଲାଇଟ୍ସ।
• RESILIENCE_GUIDE.md — ସର୍କିଟ୍ ବ୍ରେକର୍, କୁଲଡାଉନ୍, ଲକଆଉଟ୍ ଗଭୀର ଅନୁସନ୍ଧାନ।
• AUTO-COMBO.md — ଅଟୋ କମ୍ବୋ ସ୍କୋରିଂ ଏବଂ ରଣନୀତି।
• MCP-SERVER.md — ସମ୍ପୂର୍ଣ୍ଣ MCP ଟୁଲ୍ କ୍ୟାଟାଲଗ୍ + ପରିବହନ।
• A2A-SERVER.md — A2A ପ୍ରୋଟୋକଲ୍ ସ୍କିଲ୍ସ ଏବଂ ଆବିଷ୍କାର।
• COMPRESSION_GUIDE.md — RTK + କେଭମ୍ୟାନ୍ ସଞ୍ଚେତନ।
• CLI-TOOLS.md — CLI ଏକୀକରଣ।
• ELECTRON_GUIDE.md (ଯଦି ଉପସ୍ଥିତ), DOCKER_GUIDE.md, FLY_IO_DEPLOYMENT_GUIDE.md, VM_DEPLOYMENT_GUIDE.md, TERMUX_GUIDE.md, PWA_GUIDE.md — ପ୍ରଦର୍ଶନ ଲକ୍ଷ୍ୟ।
• TROUBLESHOOTING.md — ସାଧାରଣ ପରିଚାଳନା ସମସ୍ୟା।
• CONTRIBUTING.md — ଯୋଗଦାନକାରୀ କାର୍ଯ୍ୟପ୍ରବାହ।
• CLAUDE.md — Claude Code ପାଇଁ ରେପୋ ନିୟମ (ଅନେକ ଉପରୋକ୍ତ ପରମ୍ପରାର ସତ୍ୟ ଉତ୍ସ)।
• AGENTS.md — ଏଜେଣ୍ଟ୍ସ ଦ୍ୱାରା ବ୍ୟବହୃତ ଗଭୀର ସ୍ଥାପତ୍ୟ ରେଫରେନ୍ସ।