smart_ide/docs/API/README.md
Nicolas Cantu 0af507143a Add smart-ide-global API layer, SSO delegates proxy, .logs access logs
- New smart-ide-global-api (127.0.0.1:37149): internal bearer, upstream proxy, X-OIDC forward
- SSO gateway calls global API with GLOBAL_API_INTERNAL_TOKEN; logs to .logs/sso-gateway/
- Aggregated config example, docs, VERSION 0.0.2, claw proxy local URL hint
2026-04-03 23:08:52 +02:00

3.1 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-global-api Bearer interne (GLOBAL_API_INTERNAL_TOKEN, sauf /health) 37149 global-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/.