mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-09-20 22:02:19 +03:00
58f88a83e4
Batch 3 (last) of the locale-expansion plan: ha, yo, ig, am, uz, ka, hy on every surface â dashboard catalog, docs mirror (22-file core + llm.txt + CHANGELOG), CLI catalog, README flag block, locale tables and đ language bars. Also closes the key gap the batch-1 (43 keys) and batch-2 (10 keys) catalogs carried since their base merges, fixes the Igbo "Model" copy and allowlists the Uzbek cognate. Translation-ratio baseline covers 65 locales. â ď¸ base-red inherited: #12732
114 KiB
114 KiB
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 ¡ đ°đ km ¡ đŽđł kn ¡ đ°đˇ ko ¡ đąđš lt ¡ đąđť lv ¡ đŽđł ml ¡ đŽđł mr ¡ đ˛đž ms ¡ đ˛đš mt ¡ đ˛đ˛ my ¡ đłđľ ne ¡ đłđą nl ¡ đłđ´ no ¡ đŽđł or ¡ đŽđł 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 áĄáá ááá á, A2A áĄáá ááá á, Skills, Memory, Cloud Agents, Resilience, Compression áá á.á¨.) áĄááŚá áááĄááŁááá áááĄááŞááááá ááŽáááá ááááááᥠáááááŁáááááá á¤áááááá áá
docs/ááá ááĽá˘áá ááá¨á.
áᥠá¤áááá ááŚáŹáá áĄ, á á áá áᥠááŚáᥠá áááááá˘áá ááá¨á, á ááá ááŽáááá ááááááá áá á¨ááŤááᥠáŽáᥠáĄá˘á áŁáĽá˘áŁá áá¨á áá áááá˘áá ááá, á¨ááĄá áŁááááᥠááá áááᥠá¨á ááááᥠáááááá áá áááᥠáŞáááá, áĄáá áááááá˘áᥠáááá ááŽááá ááááŁááááᥠááááááááááᥠááá áá¨á.
1. á˘ááĽáááááááŁá á áĄá˘ááá
| ááĄáááĽá˘á | áá áŠááááá |
|---|---|
| ááá-á¤á áááááá áá | Next.js 16 (App Router, áááááŁáááááááá áááááááááá, áááááááŁá á middleware-áᥠááá áá¨á) |
| ááá | 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, cache), Playwright (e2e + protocols-e2e) |
| ááááá | Next.js-áᥠáááááŁáááááááá áááááááááá scripts/build/build-next-isolated.mjs-áᥠááá¨áááááá |
| áááá˘áááá/á¤áá ááá˘áá ááá | ESLint-áᥠáá á˘á§ááá áááá¤áááŁá ááŞáá + Prettier (lint-staged Husky-áᥠpre-commit-áᥠááá¨áááááá) |
| ááááŁááááᥠáĄááĄá˘ááá | á§áááááá ESM ("type": "module") |
| áĄáááŁá¨áá áĄááá áŞáááá | npm workspace â open-sse áá ááááá áá áĽáá-áĄáááŁá¨áá áĄááá áŞáá |
áááááᥠá¤áĄáááááááááá (tsconfig.json):
@/*âsrc/*@omniroute/open-sseâopen-sse/index.ts@omniroute/open-sse/*âopen-sse/*
ááááŁáááĄáŽáááá HTTP ááá á˘á: 20128 (API áá ááá áááᥠáááááá áá ááĄá áá ááááá áá ááŞááĄáĄ áá§áááááĄ). áááááŞáááá
ááá ááĽá˘áá áá áááááĄáááŚáá ááá DATA_DIR ááá áááᥠáŞáááááá, áŽááá ááááŁáááĄáŽáááá áááá¨áááááááá ~/.omniroute/.
2. á áááááá˘áá ááᥠáĄá˘á áŁáĽá˘áŁá á
OmniRoute/
âââ src/ Next.js áááááááŞáá (App Router, áááááááááááá, áááááá, áĄáá ááá á, áĄááááá á á ááĄáŁá áĄááá)
âââ open-sse/ ááááááŁá á áááááŞáááᥠáŤá áááᥠáĄáááŁá¨áá áĄááá áŞá (@omniroute/open-sse)
âââ electron/ áááĄáá˘áá-ááá áĄá (Electron 41-áᥠáááááá á áááŹááá + preload)
âââ bin/ CLI-áᥠá¨ááĄáááᥠáŹáá á˘ááááá (omniroute, reset-password)
âââ tests/ ááááŁááŁá á, ááá˘ááá ááŞááŁáá, e2e, protocols-e2e, áááá áááááááĄ, áŁáĄáá¤á ááŽááááᥠá˘ááĄá˘ááá áá á¤ááĽáĄá˘áŁá ááá
âââ 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/ â Next.js áááááááŞáá
src/
âââ app/ App Router-áᥠáááá áááá + API ááá á¨á áŁá˘ááá
âââ lib/ áŤáá ááááá áááááááááááá (DB, ááá˘áá ááááŞáá, OAuth, áŁááá ááá, áááŽáĄááá ááá, âŚ)
âââ domain/ áĄáŁá¤áá ááááááŁá á á¨á á (ááááá˘ááá, áĄáá áááá áá áááĽáááááá, áŚáá áááŁáááá, áááááááá, âŚ)
âââ server/ ááŽáááá áĄáá ááá áᥠááááŁáááá (ááá˘áá ááááŞáá, cors, áááááá˘áá¤ááááŞáá)
âââ shared/ á˘ááááá, ááŁááááááá, áááááááŞáá, áááá˘á ááĽá˘ááá, ááááŽááá á á¤áŁááĽáŞáááá (áŁáĄáá¤á ááŽáá áĄáááŚáá ááᥠá¨áá ááĄ)
âââ mitm/ á¨áŁááááááá áá ááĽáĄáᥠááááŽááá á á¤áŁááĽáŞáááá CLI-áĄááá ááá˘ááá ááŞáááĄááááĄ
âââ models/ ááááááŁá á ááááááááᥠááá˘ááááááŞááááá / á¤áĄáááááááááá
âââ sse/ áŤáááá SSE áááááŁá¨áááááááá, á áááááá᪠áŻáá ááááá src/-á¨áá (áá áá á open-sse/-á¨á)
âââ store/ áááááá˘áᥠááŽáá áᥠááááááá ááááᥠáĄááŞááááá
âââ middleware/ ááá á¨á áŁá˘áᥠááááᥠmiddleware-áᥠááááŽááá á á¤áŁááĽáŞáááá (áá á Next.js-áᥠáááááááŁá á middleware)
âââ scripts/ ááááᥠáŽáá¨á áá áĄáááŁáá áĄáá ááá˘ááá, á áááááá ááááá á˘áá ááá᪠áááááááŞááᥠáááᥠá¨ááŁáŤááá
âââ types/ ááá ááááĄááŁáá áá áááááá áááŁáá TS á˘ááááá
âââ i18n/ ááááááááᥠááááá˘ááá
âââ instrumentation.ts Next.js-áᥠáááĄá˘á áŁáááá˘ááŞááᥠá°áŁáá
âââ instrumentation-node.ts
âââ proxy.ts áŁáááŚáááĄá ááááᥠáá ááĽáĄáᥠááááŞáááááááŞááᥠááááŽááá á
3.1 src/app/ â App Router
App Router áŽáááááĄááŹááááᥠáŽááᥠá áááá ᪠ááá áááᥠááááááᥠááá˘áá á¤áááĄáĄ, ááĄá áĄááŻáá á/ááá áááᥠHTTP API-áĄ. áááááááŁá á middleware áá áá áĄááááᥠâ áŠáááá á ááááááŁáá ááá á¨á áŁá˘áᥠáááááá áŽáá áŞááááááá.
áŁáááŚáááĄá ááááᥠáĄáááááá˘ááá src/app/-á¨á:
| ááá | ááááá¨ááŁáááá |
|---|---|
api/ |
á§áááá HTTP API ááá á¨á áŁá˘á (ááŽáááá áĽááááá ááá§áá¤á) |
a2a/ |
A2A JSON-RPC 2.0 áááá áŹáá á˘ááá (POST /a2a) |
.well-known/agent.json/ |
A2A Agent Card-áᥠááŚáááŠáááᥠááááŁáááá˘á |
(dashboard)/ |
ááá áááᥠááááááᥠááá˘áá á¤áááĄá (ááá á¨á áŁá˘áááᥠáŻááŁá¤á, 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/ â ááá˘áá á¤áááĄáᥠáááá áááá
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) â LOCAL_ONLY
âââ upstream-proxy/
âââ usage/
âââ v1/ OpenAI-áĄááá ááááĄááááá áĄááŻáá á API
âââ v1beta/ Gemini-áᥠáĄá˘áááᥠááááĄááááááá
âââ version-manager/
âââ webhooks/
3.1.2a src/app/api/services/ â áŠáá¨áááááŁáá áĄáá áááĄáááᥠááá ááá
9Router-ááĄá áá CLIProxyAPI-áᥠáááĄá˘ááááŞáááĄ, ááá¨áááááĄ, áááŠáá ááááĄá áá ááááá˘áá ááááᥠááá á¨á áŁá˘ááá.
á§áááá ááá ááááĄáá¤ááŞáá áááŁááá á áááá ᪠LOCAL_ONLY (ááŽáááá loopback, ááááŞá á áŹááĄá #17), á ááááá ááá
á¨ááŁáŤáááá ááááááŤááŽáá npm install áá á¨áááááááá áá ááŞááĄááá á¨ááĽáááá.
src/app/api/services/
âââ 9router/
â âââ _lib.ts getOrInitSupervisor() ááááŽááá á á¤áŁááĽáŞáá
â âââ install/route.ts POST â npm install 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 áŁá¤á á ááŽááá ááá áĄáááĄááááĄ
â âââ rotate-key/route.ts POST â ááŽááá API áááĄááŚáááᥠááááá áá ááá + ááááá˘ááá ááá
â âââ status/route.ts GET â áááááááá á + DB áĄá˘áá˘áŁáĄá + ááá áĄááᥠááá˘ááááááŞááááá
â âââ 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 â áááááááá á + DB áĄá˘áá˘áŁáĄá + ááá áĄááᥠááá˘ááááááŞááááá
â âââ 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/ â OpenAI-ááá ááááĄááááá áĄááŻáá á API
v1/
âââ accounts/[id]/ ááááá áá¨áᥠáááŤáááá
âââ agents/tasks/[id]/, agents/tasks/ A2A-áĄá˘áááᥠááááŞáááááᥠáĄáááááá áŹáá á˘ááááá
âââ api/ v1/api-áᥠáĽááᨠáŽáááááĄááŹááááá á¨ááá API-áᥠááááŽááá á á¤áŁááĽáŞáááá
âââ audio/{speech, transcriptions}/ TTS + STT
âââ batches/[id]/{cancel}, batches/ OpenAI Batches API
âââ chat/completions/ áŠáá˘áᥠáááĄá áŁáááááá (áááááá á áĄáááááá áŹáá á˘ááá)
âââ completions/ áááŤááááááŁáá á˘ááĽáĄá˘áŁá á áááĄá áŁáááááá
âââ embeddings/ áŠáá¨ááááááá
âââ files/[id]/, files/ Files API
âââ _helpers/ ááá á¨á áŁá˘áááᥠáĄááá áá ááááŽááá á á¤áŁááĽáŞáááá (áĄááŻáá á URL-áᥠááá áá¨á)
âââ images/{edits, generations}/ áááááĄááŽáŁááááᥠááááá áá ááá + á ááááĽá˘áá ááá
âââ issues/ áá ááááááááᥠáááŽáá ááĄáŽáááᥠááááŽááá á áĄáááááá áŹáá á˘ááááá
âââ management/{proxies}/ ááá áááᥠáá ááááá á¨áááŚáŁááŁáá ááá á¨á áŁá˘ááá v1-áᥠá¨ááááá
âââ messages/{count_tokens}/ Anthropic-áᥠáĄá˘áááᥠá¨áá˘á§ááááááááááá ááááĄááááááá
âââ models/ ááááááááᥠáŠáááááááááá (`route.ts`, `catalog.ts`)
âââ moderations/ ááááá ááŞáá
âââ music/ ááŁáĄáááᥠááááá áá ááá
âââ providers/[provider]/ ááááááŁáá áá ááááááá áᥠáááá ááŞáááá
âââ quotas/{check} áááá˘áᥠá¨ááááŹáááááá
âââ registered-keys/ á ááááĄá˘á áá áááŁáá áááĄááŚáááááᥠáááááááĄá˘á áá ááá
âââ rerank/ áŽááááŽááá á ááááá ááá
âââ responses/[...path]/ OpenAI Responses API (á§ááááá¤á áᥠááááŞáááá)
âââ search/ ááááŤáááá
âââ videos/ áááááᥠááááá áá ááá
âââ ws/ WebSocket áŽááá
âââ route.ts áááááĽáĄáᥠáááááŁá¨ááááááá
á§áááá ááá á¨á áŁá˘áᥠá¤áááá áá ááĄá áá ááááá á¨áááááᥠááá°á§áááá:
ááá á¨á áŁá˘á â CORS-áᥠáŹááááĄáŹáá á ááááŽáááá â ááááŽááááᥠáĄáŽááŁááᥠZod-áá áááááááŞáá â áá ááĄááááááááŁáá áááááá˘áá¤ááááŞáá
â API áááĄááŚáááᥠááááá˘áááᥠááŚáĄá áŁáááá â áááááŁá¨áááááááá ááááááá ááá (open-sse)
v1beta/ áá áᥠGemini-áᥠáĄá˘ááááá ááááĄááááá ááááááá á (ááŽááá ááá áĄá, á ááááá᪠ááááŽááááááĄ
ááááá open-sse/handlers/ áááááááá á¨á ááá áááĽááááĄ).
3.2 src/lib/ â áŤáá ááááá áááááááááááá
áááááŞááááá, áĄáááĽá ááááááŞáá, OAuth, áŁááá ááá, áááŽáĄááá ááá áá áĄáŽáá á§áááááááᥠáá ááááŁááááᥠáááááá áááááááá á˘áá. áŞáŽá ááá ááŻááŁá¤ááᥠá ááááŁá ááá ááĽá˘áá ááááĄá áá áááá¨áááááááá áááá ááááᥠá¤ááááááĄ.
| ááááŁáá | ááááá¨ááŁáááá |
|---|---|
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/ |
OpenAI Batches API-áᥠáĄáá áááĄá (service.ts) |
catalog/ |
OpenRouter-áᥠááá˘áááááᥠáĄáááĽá ááááááŞáá (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/ |
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 (WebSocket áá ááĽáĄá), 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/ |
WebSocket áŽááá |
zed-oauth/ |
Zed á ááááĽá˘áá áᥠOAuth áááááá |
áŁáááŚáááĄá ááááᥠá¤áááááá src/lib/-á¨á:
- áŤáááá
localDb.tsbarrel áŹááá¨ááá â ááááŽááá áááááá ááá ááááá ááŽáá áŞááááááá ááááá áá˘áŁáásrc/lib/db/*ááááŁááááᥠááááá á˘áĄ. proxyHealth.ts,proxyLogger.ts,tokenHealthCheck.ts,localHealthCheck.tsapiBridgeServer.ts,cacheLayer.ts,semanticCache.ts,settingsCache.tscloudSync.ts,initCloudSync.tscloudflaredTunnel.ts,ngrokTunnel.ts,tailscaleTunnel.tsconsoleInterceptor.ts,container.ts,gracefulShutdown.ts,idempotencyLayer.tsipUtils.ts,logEnv.ts,logPayloads.ts,logRotation.tsmodelAliasSeed.ts,modelCapabilities.ts,modelMetadataRegistry.ts,modelsDevSync.tspiiSanitizer.ts,pricingSync.tsapiKeyExposure.ts,cacheControlSettings.ts,dataPaths.ts,toolPolicy.tstranslatorEvents.ts,usageDb.ts,usageAnalytics.ts,webhookDispatcher.ts
3.2.1 src/lib/db/
Singleton SQLite áááááŞáááá áááá (getDbInstance() core.ts-á¨á, 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 ááááááŁáá ááááŽááááᥠauthz áááá˘ááĽáĄá˘á
â âââ headers.ts
â âââ pipeline.ts Authz áááááááá á
â âââ 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/â áĄááááá á TS á˘ááááá.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/ â áĄá˘á ááááááᥠáŤá áááᥠáĄáááŁá¨áá áĄááá áŞá
áŞáááá npm áĄáááŁá¨áá áĄááá áŞá, á ááááá᪠áááááĽááá§ááááŁááá á áááá ᪠@omniroute/open-sse. áááĄáŁáŽááĄáááááááá ááááŽáááááááĄ
ááááŁá¨ááááááá, á¨áááĄá áŁáááááááá, áááá ááááááááá, áĄáá áááĄáááá, á˘á áááĄá¤áá ááá áĄá áá 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, áá ááĽáĄáá áááŁáá fetch, âŚ
âââ 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 ááá á¨á áŁá˘ááááŞáá | combo.ts (19 áĄá˘á áá˘áááá), comboConfig.ts, comboMetrics.ts, comboManifestMetrics.ts, comboAgentMiddleware.ts |
| Auto Combo áŤá ááá | 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 (cooldown + lockout), 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-ááĄ, ááááááŁá á ááá ááŁáĄááĄá áá á¨áááŁáá¨ááᥠááááŁáááá â áááá ááááááá ááááááááá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. ááá˘áááá˘áŁá á áááááŽáááá
áŽáá áŞááááááá electron-updater-áᥠááá¨áááááá, á ááááá᪠GitHub-áᥠááááá¨ááááááᥠáá áŽáá áááŁááááááĄ.
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-áá áĄáá áááá áá áááááĄááá)
âââ output.mjs ááááá˘áááᥠá¤áá ááá˘áá ááá (json/jsonl/table/csv)
âââ i18n.mjs t() ááááŽááá á á¤áŁááĽáŞáá ááááááááá
âââ api.mjs API fetch ááááŽááá á á¤áŁááĽáŞáá
âââ data-dir.mjs
âââ encryption.mjs
âââ sqlite.mjs
âââ commands/
âââ registry.mjs áá áŤáááááááᥠá ááááĄá˘á ááŞáá
âââ setup.mjs
âââ doctor.mjs
âââ providers.mjs
âââ ... (áááá á¤áááá áááá áá áŤááááááá/áŻááŁá¤áá)
package.json â bin-á¨á áá á áá ááááá á¤ááááá áááááĽááá§ááááŁáá:
omnirouteâbin/omniroute.mjsomniroute-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 |
á§áááá tests/unit/*.test.ts á˘ááĄá˘áĄ Node-áᥠá˘ááĄá˘áááᥠáááá¨ááááá (ááá áááááŁá ááá 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-áááááááŞáá (chatCompletionsSchema á¤áááá¨á shared/validation/schemas.ts)
áááááá˘áá¤ááááŞáá (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 áááááá§ááááá: TransformStream open-sse/transformer/responsesTransformer.ts-áᥠááá¨áááááá
â á¨ááĄááááááĄáááᥠááŁááá˘á (src/lib/compliance/)
â áááĄáŁáŽá áááááá˘áĄ
áááá áááááᥠááá¨ááááᥠááááááá áááá (áĄááá áááĽáááááá)
| áááĽáááááá | áááĽááááááᥠáá áááá | áááááá áááá |
|---|---|---|
| áá ááááááá áᥠáŹá áááᥠááááá ááááá | ááááá áá ááááááá á | src/shared/utils/circuitBreaker.ts, ááááŽááá domain_circuit_breakers-á¨á |
| áááá¨áá áᥠááá§ááááááᥠááá áááá | áá áá ááááá áá¨á/áááĄááŚááá | markAccountUnavailable() á¤áááá¨á src/sse/services/auth.ts; áááááá§ááááá accountFallback.checkFallbackError()-áᥠáááá |
| ááááááᥠáááááá ááá | áá ááááááá á + áááá¨áá á + áááááá | open-sse/services/accountFallback.ts, ááááŽááá domain_lockout_state-á¨á |
ááŽáááá RESILIENCE_GUIDE.md áá á¨ááĄááááááĄá áááá§áá¤ááááá CLAUDE.md-á¨á.
10. á áááá á¨áááá˘áááá áŹááááá
ááŽááá áá ááááááá áᥠááááá˘ááá
- áááá ááááĄá˘á áá áá
src/shared/constants/providers.ts-á¨á (áŠáá˘ááá ááááĄáᥠáááŹááááá Zod-áá). - áᣠáĄáááá áá ááá ááááŁáá áááááá, áááááá˘áá á¨áááĄá áŁáááááá
open-sse/executors/-á¨á (áááá¤áá ááááBaseExecutor). - áᣠáá ááááááá á OpenAI-áᥠá¤áá ááá˘áĄ áá áá§áááááĄ, áááááá˘áá áááá áááááá
open-sse/translator/-á¨á. - áᣠáᥠOAuth-ááá ááá¤áŁáŤááááŁáá, áááááá˘áá áááá¤áááŁá ááŞáá
src/lib/oauth/providers/-áĄá áásrc/lib/oauth/services/-á¨á. - áááá ááááĄá˘á áá áá áááááááá
open-sse/config/providerRegistry.ts-á¨á (áá á¤áá ááá˘áᥠá¨ááĄáááááᥠá áááĄá˘á á¨á,open-sse/config/-áᥠáĽááá¨). - áááŹáá áá á˘ááĄá˘ááá
tests/unit/-á¨á.
ááŽááá API ááá á¨á áŁá˘áᥠááááá˘ááá
- á¨ááĽááááá
src/app/api/your-route/route.ts. - ááááŞáááá á¨áááááá: CORS â ááááŽááááᥠáĄáŽááŁááᥠáááááááŞáá Zod-áá â áááááá˘áá¤ááááŞáá â áááááŁá¨áááááááá ááááááá ááá.
- áᣠááááŽááááᥠáĄá˘á áŁáĽá˘áŁá á ááŽáááá: áááááá˘áá Zod-áᥠáĄáĽááá
src/shared/validation/schemas.ts-á¨á. - áᣠááá á¨á áŁá˘á ááŽáááá ááá ááááĄááááĄáá: áááááá˘áá ááá
src/shared/constants/publicApiRoutes.ts-á¨á (áĄááŻáá á API-áᥠááááááá áᥠááá áŤáááŁáá áááááᥠáĄáá). - áááááá˘áá á˘ááĄá˘ááá
tests/unit/-á¨á. - ááááááŽááá
docs/reference/API_REFERENCE.mdáádocs/openapi.yaml.
ááŽááá DB ááááŁááᥠááááá˘ááá
- á¨ááĽááááá
src/lib/db/yourModule.tsáá á¨ááááá˘áááágetDbInstance()./core.ts-ááá. - ááĽáááá áááááááĄáááᥠáááá˘áááá CRUD á¤áŁááĽáŞáááá.
- ááŽááá áŞáŽá áááááᥠá¨ááááŽááááá¨á: áááááá˘áá áááá ááŞáá
src/lib/db/migrations/-á¨á, áááááááááá áŁáá áááá áá; áᥠáŁááá áá§áᥠááááááá˘ááá˘áŁá á áá á˘á áááááĽáŞááŁáá. - áááááá§ááááááááá ááá ááááá áŁááá á¨ááááá˘áááá
@/lib/db/yourModule-ááá (barrel-áᥠááá áá¨á â áŤáááálocalDb.tsá áááĽáĄááá á˘áᥠá¤ááá áŹáá¨ááááá). - áááááá˘áá á˘ááĄá˘ááá
tests/unit/-á¨á.
ááŽááá MCP áááĄá˘á áŁáááá˘áᥠááááá˘ááá
- áááááá˘áá áááĄá˘á áŁáááá˘áᥠááááĄáááŚáá ááá
open-sse/mcp-server/tools/-á¨á (áá áááá¤áá ááááopen-sse/mcp-server/schemas/tools.ts). - áááááááá á¨ááĄááááááĄá áááĽááááááᥠáá á(ááá)
src/shared/constants/mcpScopes.ts-á¨á. - áááá ááááĄá˘á áá áá áááĄá˘á áŁáááá˘á
open-sse/mcp-server/server.ts-á¨á. - áááááá˘áá á˘ááĄá˘ááá
open-sse/mcp-server/__tests__/-á¨á. - ááááááŽááá MCP-SERVER.md.
ááŽááá A2A áŁááá áᥠááááá˘ááá
ááŽáááá A2A-SERVER.md § ááŽááá áŁááá áᥠááááá˘ááá. áŁááá ááá áááááááĄáááŁááá
src/lib/a2a/skills/-á¨á áá á ááááĄá˘á áá áááá A2A ááááŞáááááᥠáááá áááááᥠááá¨áááááá.
11. á¨áááááŽáááááá
- ááááᥠáĄá˘ááá: 2-á°áá áááá á¨ááŹááá, áá áááá áá áá§ááááá, 100-áĄáááááááááá áĄááááá, áŹáá á˘áá-ááŤáááááá,
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=warnopen-sse/-áĄá áátests/-á¨á, áŽááá áĄáŽááááá â á¨ááŞáááá. - TypeScript:
strict: false(áááááááá áááááá ááááááá). ááááŁáááá¨áá áᥠáĄáááŚáá áááá á˘áááááᥠááááá˘áááᥠáááááááá áŁááá áá˘ááĄááá áá¨ááá á á˘áááááĄ. - áááááŞáááá áááá: áá ááĄáááᥠáááŹáá áá áááŁááŁá¨ááááááá SQL ááá á¨á áŁá˘áááĄá áá áááááŁá¨áááááááá¨á â á§áááááááᥠáááááá§áááá
src/lib/db/ááááŁáááá. áá ááĄáááᥠáááááá§áááá barrel-ááááá á˘á â áŁá¨áŁáááá áááááá§áááá ááááá áá˘áŁáásrc/lib/db/*ááááŁáááá. - DB áá áááŁááááᥠá˘ááááááŞáá (#3512): á¤áŁááĽáŞááá, á ááááá᪠DB áŞáŽá ááááĄ
áĄá˘á ááĽáááᥠáĄá˘á áŁáĽá˘áŁá áᥠáŹáá ᥠáá ááááŽáŁááááĄ, áŁááá ááááŚááĄ/ááááá áŁááᥠáááĄááŽáááááŁáá TS ááá˘áá á¤áááĄá, á ááááá᪠áá áŞáŽá ááááĄ
áĄááá˘ááᥠ1:1-áá ááĄááŽáááĄ, áá áá á
anyáá áááááŤááŽáááᥠááááááá áŠáá¨áááááŁáá áááááááŁá á á˘ááá. ááááááááĄáá ááá˘áá á¤áááĄá á¤áŁááĽáŞááᥠáááá ááá (ááá.,export interface UsageEntrysrc/lib/usage/usageHistory.ts-á¨á,saveRequestUsage-áᥠááááá), ááá˘áááá áŞáááááŁáá áááááá áá ááĄááááááááŁáá/nullable, á ááááĄá᪠áĄáŽáááááĄáŽáá áŠáááŹáá á áĄá˘á ááĽááᥠáá˘ááááá áááá áááĄáááĄ, áá ááááááááunknown-ᥠáŁááá áá˘ááĄáááany-áĄááá á¨áááá áááá áá áááááĄááááĄ, á ááááᥠáĄá˘á áŁáĽá˘áŁá á᪠ááááááŤááŽááááááᥠáááŽááááá ááŞááááá (áááááááŁáááá˘áá áá áááá¨á, ááá.,UsageEntry.tokensááŚááᥠá áááá ᪠áá ááááááá áᥠáááŁááŁá¨ááááááá á¤áá ááᥠááááá§áááááᥠáááááŞáááááĄ, ááĄá ááá ááááááááŁá á¤áá áááĄ). á ááááĄá᪠á¤áááá¨áany-áᥠá áááááááá áá áááá ááŁáᥠááááŚáŹáááĄ, áááááá˘áá ááĄcheck:any-budget:t11-áᥠááá¨ááááŁá áĄááá¨á (scripts/check/check-t11-any-budget.mjs,maxAny: 0), á ááá áŁááŁáĄááá áááŚáá áááŽáááĄ. áᥠááá áááá áá˘áááᥠá¨áááááŽááááá â áŁá¤á á á¤áá áá âáááááááŁá áany-áᥠááá áá¨áâ áááĄáŁá¤áááááá ááááᥠááááá áŠáá ááááá¨á áá˘áá ááŞááŁááá áááááááá ááááĄ. - á¨ááŞáááááá: áááááá§áááá try/catch ááááá áá˘áŁáá á¨ááŞááááᥠá˘áááááá áá ááŁá áááá¨á áŠááŹáá áá pino-ᥠáááá˘ááĽáĄá˘áá. áá ááĄáááᥠáŁááŁáááááá§áá á¨ááŞáááááá áŠáŁááá 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: pre-commit áŁá¨ááááĄ
lint-staged+check:docs-sync+check:any-budget:t11; pre-push áŁá¨ááááĄcheck:any-budget:t11+check:tracked-artifacts(áĄáŹá áá¤á á¨ááááŹáááááá; áá ááááŞáááĄtest:unit-áĄ).
12. ááááŞá á áŹááĄááá (CLAUDE.md-ááá)
- áá ááĄáááᥠá¨ááá˘áááá commit-á¨á áĄááááŁáááááá áá ááá˘áá ááááŞááᥠáááááŞááááá.
- áá ááĄáááᥠáááááá§áááá barrel import â áŁá¨áŁáááá áááááá§áááá ááááá áá˘áŁáá
src/lib/db/*ááááŁáááá. - áá ááĄáááᥠáááááá§áááá
eval()/new Function()/ ááááŁáááĄáŽáááá eval. - áá ááĄáááᥠá¨ááá˘áááá commit ááá ááááá
main-á¨á. - áá ááĄáááᥠáááŹáá áá áááŁááŁá¨ááááááá SQL ááá á¨á áŁá˘ááá¨á â á§áááááááᥠáááááá§áááá
src/lib/db/ááááŁáááá. - áá ááĄáááᥠáŁááŁáááááá§áá á¨ááŞáááááá áŁáŽááá SSE áááááááá¨á.
- á§áááááááᥠá¨áááááŹááá á¨ááááááá áááááŞááááá Zod áĄáĽáááááá.
- áĄááŹáá ááá ááááᥠá¨ááŞááááĄáᥠá§áááááááᥠáááááá˘áá á˘ááĄá˘ááá.
- ááá¤áá áá áŁááá ááá áŠáᥠ⼠60% (áááĄá˘á áŁáĽáŞáááá, áŽááááá, á¤áŁááĽáŞáááá, áááá¨á˘áááááá).
13. ááá áááá ááŽáááá
- ARCHITECTURE.md â áááŚááá ááááᥠáá áĽáá˘ááĽá˘áŁá á áá ááááŁááááᥠáááĄáŁáŽááĄáááááááááá.
- API_REFERENCE.md â áĄááŻáá á áá ááá áááᥠAPI-áᥠáŞááááá á.
- FEATURES.md â á¤áŁááĽáŞááááᥠááá˘á ááŞá áá ááá áĄááááᥠáááá¨ááááááááá áĄáááŽááááá.
- RESILIENCE_GUIDE.md â circuit breaker-ááĄ, cooldown-ááĄá áá lockout-áᥠááá˘áááŁá á áááááŽáááá.
- AUTO-COMBO.md â Auto Combo-ᥠá¨áá¤ááĄááá áá áĄá˘á áá˘áááááá.
- MCP-SERVER.md â MCP áááĄá˘á áŁáááá˘áááᥠáĄá áŁáá ááá˘ááááá áá á˘á áááĄááá á˘ááá.
- A2A-SERVER.md â A2A áá áá˘áááááᥠáŁááá ááá áá ááŚáááŠááá.
- COMPRESSION_GUIDE.md â RTK áá Caveman á¨áááŁáá¨áá.
- 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 â ááááá˘áááᥠáááá ááááá§áááááŁáá áá áĽáá˘ááĽá˘áŁá áᥠáŁá¤á á áĄááŚá áááĄááŁáá áŞááááá á.