Nicolas Cantu 940cf59178 Share upstream definitions in @4nk/smart-ide-upstreams, systemd user units
- Add packages/smart-ide-upstreams (versioned dist) for resolveUpstream + listUpstreamKeys
- Wire smart-ide-global-api and smart-ide-sso-gateway via file: dependency
- Add systemd user unit templates and install-smart-ide-gateway-systemd-user.sh (SSO After/Requires global API)
- Update docs and VERSION 0.0.3
2026-04-04 15:37:58 +02:00
..

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/.