External integrations: ability to create "AI vendor" type integrations

pierre-gilles · August 1, 2026, 7:45am

Ability to create external integrations that can offer AI models

Based on: Sondage : Quel est votre modèle IA préféré dans Gladys? - #26 par l.dolle

pierre-gilles · August 3, 2026, 2:52pm

The PR on Gladys’ side:

github.com/GladysAssistant/Gladys

Add generic AI provider external integration type (#2744)

master ← claude/generic-ai-provider-integration-oebx0g

ouvert 06:22AM - 02 Aug 26 UTC

Pierre-Gilles

+1021 -43

External integrations can now declare type "ai" and serve as the AI backend of t…he assistant instead of Gladys Plus. The contract is fully provider-agnostic: the whole agentic loop (MCP tool calling, prompts, history) stays in the core, and the integration only receives OpenAI-compatible chat completion requests over the integration WebSocket (external-integration.ai.chat, 120s ack) and answers with OpenAI-compatible completions — a thin adapter to Claude, DeepSeek, OpenAI, a local LLM or any other provider. Server: - manifest type "ai" (schema + validation), no device screens - ai.chat proxy service capability relayed by the supervisor - AI_PROVIDER system variable: gateway.aiChat routes all AI traffic (chat loop, intent router, weekly digest) to the selected provider, with the Gladys Plus model field stripped and no silent fallback - AI works without any Gladys Plus account (message.create) - GET/POST /api/v1/ai_provider endpoints, selection cleared on uninstall of the selected provider Front: - AI provider selection card on the AI integration page (admin) - generic external integration page branches for the ai type - install warning dedicated to AI providers, catalog placement - chat model selector hidden when an external provider is active - en/fr/de translations Spec: docs/specs/external-integrations.md B.18 + C.1/C.4/C.5/C.8 updated in the same diff (spec-first rule). Community request: https://community.gladysassistant.com/t/10421 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XhBhvoV4jdZEhxgadWwXV8 ## Summary by CodeRabbit * **New Features** * Added support for third-party AI providers using OpenAI-compatible chat completions. * Administrators can select, configure, retry, or reset the AI provider. * AI providers work without a Gladys Plus account. * Added provider availability indicators, privacy guidance, and dedicated setup flows. * **Bug Fixes** * Uninstalling the selected provider now restores the default AI service. * Improved installation routing and navigation for AI providers. * AI requests consistently use the selected provider and its configuration.

The PR on the SDK’s side:

github.com/GladysAssistant/integration-sdk-js

feat: add AI provider support (manifest type "ai", onAiChat handler) (#22)

main ← claude/sdk-changes-pr-2744-d6ltvk

ouvert 03:46PM - 03 Aug 26 UTC

Pierre-Gilles

+275 -0

SDK counterpart of GladysAssistant/Gladys#2744 (generic AI provider external int…egration, contract B.19): integrations can now declare manifest `type: "ai"` and serve as the AI backend of Gladys in place of Gladys Plus. ## What's in - **New WebSocket message type** `external-integration.ai.chat` in `WEBSOCKET_MESSAGE_TYPES.EXTERNAL_INTEGRATION.AI_CHAT`. - **New `onAiChat(cb)` handler**: receives the OpenAI-compatible chat completion request relayed by the core (`{ messages, tools?, tool_choice?, purpose?, categories? }` — the `model` field is stripped core-side, picking one is the provider's job) and resolves an OpenAI-compatible completion, acked back as the `command-result` data. The core awaits the ack under **120 s** (`AI_CHAT_TIMEOUT_MS`), not the standard 5 s. - **Client-side completion validation**, mirroring the core's contract check: the resolved value must be an object carrying an object `choices[0].message` — anything else (including `undefined`) acks the command as failed with an explicit error, instead of letting a malformed completion travel to Gladys and die at the contract boundary (`ExternalIntegrationUnavailableError`). - **TypeScript typings**: `AiChatRequest`, `AiChatRequestMessage`, `AiChatCompletion`, `AiChatCompletionChoice`, `AiChatCompletionMessage`, the `onAiChat` method and the `AI_CHAT` message type. - **README**: new "AI providers" section (fetch-based OpenAI-compatible example, 120 s ack window, no-silent-fallback doctrine) + a row in the Handlers table. - **Tests**: `test/ai.test.js` against the fake Gladys server (success with `data`, tool_calls-only completion, handler throw, malformed completions, "not implemented"), plus compile-time coverage in `test/types/api.test-d.ts`. ## Checks - `npm test`: 185/185 pass - `npm run coverage`: thresholds green (100% stmts/funcs/lines) - `npm run lint`, `npm run prettier-check`, `npm run check-types`: clean 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_018mwqzunU7Hj5yXKoAwR1hi --- _Generated by [Claude Code](https://claude.ai/code/session_018mwqzunU7Hj5yXKoAwR1hi)_

Topic		Replies	Views
Intégrations externes : Pouvoir créer des intégrations de type "Fournisseur TTS" Demande de fonctionnalités in-progress , feature-core	1	43	August 3, 2026
Gladys Assistant 4.78 : Bilan hebdomadaire de la maison par IA Actualités	6	126	June 9, 2026
Service Gradium AI Développement	5	119	August 4, 2026
IA : Demander des questions sur la consommation énergétique Demandes livrées	5	107	July 30, 2026
Concernant l'IA : luminosité/température/couleur d'une ampoule Demandes livrées	2	59	July 30, 2026

External integrations: ability to create "AI vendor" type integrations

Related topics