smart_ide/docs/API/README.md
Nicolas Cantu 68cb5737c5 feat(sso-gateway): add OIDC JWT gateway and proxy to micro-services
- New service smart-ide-sso-gateway (port 37148): JWKS verify, /health,
  /v1/token/verify, /v1/upstreams, /proxy/<key>/...
- CORS on JSON responses when SSO_CORS_ORIGIN is set; optional empty
  bearer for langextract upstream
- Docs: feature, API, repo index; wire sso-docv-enso and services scope
- Extend config/services.local.env.example with OIDC and gateway vars
2026-04-03 22:42:44 +02:00

3.0 KiB
Raw Blame History

Référence API — services smart_ide

Documentation des API HTTP exposées par les services sous services/. Chaque service écoute en principe sur 127.0.0.1 ; ports et variables denvironnement sont rappelés par fiche.

Périmètre fonctionnel et consommation (IDE, automation, backends produit) : services-functional-scope.md.

Service Auth Port défaut Fiche
repos-devtools-server Authorization: Bearer 37140 repos-devtools-server.md
langextract-api Bearer optionnel 37141 langextract-api.md
claw-harness-api (proxy) Bearer 37142 claw-harness-proxy.md
agent-regex-search-api Bearer (sauf /health) 37143 agent-regex-search-api.md
local-office X-API-Key 8000 (exemple run) local-office.md
ia-dev-gateway Bearer 37144 (spécification) ia-dev-gateway.md
smart_ide-orchestrator Bearer (spécification) 37145 (spécification) orchestrator.md
anythingllm-devtools Bearer 37146 anythingllm-devtools-api.md
smart-ide-tools-bridge Bearer (sauf /health) 37147 smart-ide-tools-bridge-api.md
smart-ide-sso-gateway Bearer utilisateur OIDC (sauf /health) 37148 sso-gateway-api.md
docv (externe) selon dépôt Enso selon déploiement docv.md

OpenAPI : FastAPI expose une spec interactive pour langextract-api (/docs) et local-office (/docs) une fois le service démarré.

Amont claw-code : le binaire / serveur HTTP réel est hors de ce dépôt ; seul le proxy documenté ici fait partie du monorepo.

docv : serveur HTTP et OpenAPI dans le dépôt docv ; smart_ide ne les duplique pas — voir docv.md.

Implémentation minimale : ia-dev-gateway et smart_ide-orchestrator ont un serveur Node/TS dans le monorepo (npm run build dans chaque dossier). Le branchement runner ia_dev et le proxy HTTP complet de lorchestrateur restent à étendre.

Données sur environnements déployés : les services qui lisent des fichiers ou index (ex. agent-regex-search-api sous REGEX_SEARCH_ROOT, langextract-api, usages futurs côté orchestrateur) doivent pouvoir consommer un répertoire local alimenté par SSH depuis test / pprod / prod ; la déclaration des alias et chemins distants est dans projects/<id>/conf.jsonsmart_ide.remote_data_accessfeatures/remote-deployed-data-ssh.md.

Voir aussi : services.md, system-architecture.md, README de chaque dossier sous services/.