gitlab-ai-provider weekly downloads statistics

GitLab AI Provider

A comprehensive TypeScript provider for integrating GitLab Duo AI capabilities with the Vercel AI SDK. This package enables seamless access to GitLab's AI-powered features including chat, agentic workflows, and tool calling through a unified interface.

🌟 Features

• 🤖 Multi-Provider Agentic Chat: Native tool calling support via GitLab's AI Gateway (Anthropic & OpenAI) • 🔄 Duo Workflow Service: Server-side agentic loop with WebSocket streaming and dynamic model discovery • 🔐 Multiple Authentication: Support for OAuth, Personal Access Tokens, and OpenCode auth • 🌐 Self-Hosted Support: Works with both GitLab.com and self-hosted instances • 🔧 Tool Support: Native tool calling via Vercel AI SDK and MCP tools for workflows • 🔍 Project Detection: Automatic GitLab project detection from git remotes • 💾 Smart Caching: Project, token, and model discovery caching for optimal performance • 🎯 Type-Safe: Complete TypeScript definitions with Zod validation

📦 Installation

Peer Dependencies

🚀 Quick Start

Basic Chat

Agentic Chat with Tool Calling

Model Variants

The provider automatically maps specific model IDs to their corresponding provider models (Anthropic or OpenAI) and routes requests to the appropriate AI Gateway proxy:

Available Model Mappings:

| Model ID | Provider | Backend Model |

| duo-chat-fable-5-1 | Anthropic | claude-fable-5-1 | | duo-chat-fable-5 | Anthropic | claude-fable-5 | | duo-chat-opus-5-5 | Anthropic | claude-opus-5-5 | | duo-chat-opus-5 | Anthropic | claude-opus-5 | | duo-chat-opus-4-8 | Anthropic | claude-opus-4-8 | | duo-chat-opus-4-7 | Anthropic | claude-opus-4-7 | | duo-chat-opus-4-6 | Anthropic | claude-opus-4-6 | | duo-chat-sonnet-5-5 | Anthropic | claude-sonnet-5-5 | | duo-chat-sonnet-5 | Anthropic | claude-sonnet-5 | | duo-chat-sonnet-4-6 | Anthropic | claude-sonnet-4-6 | | duo-chat-opus-4-5 | Anthropic | claude-opus-4-5-20251101 | | duo-chat-sonnet-4-5 | Anthropic | claude-sonnet-4-5-20250929 | | duo-chat-haiku-5-5 | Anthropic | claude-haiku-5-5 | | duo-chat-haiku-4-5 | Anthropic | claude-haiku-4-5-20251001 | | duo-chat-gpt-6-astra | OpenAI | gpt-6-astra | | duo-chat-gpt-6-1-sol | OpenAI | gpt-6.1-sol | | duo-chat-gpt-6-sol | OpenAI | gpt-6-sol | | duo-chat-gpt-6-luna | OpenAI | gpt-6-luna | | duo-chat-gpt-5-6-sol | OpenAI | gpt-5.6-sol | | duo-chat-gpt-5-6-terra | OpenAI | gpt-5.6-terra | | duo-chat-gpt-5-6-luna | OpenAI | gpt-5.6-luna | | duo-chat-gpt-5-1 | OpenAI | gpt-5.1-2025-11-13 | | duo-chat-gpt-5-2 | OpenAI | gpt-5.2-2025-12-11 | | duo-chat-gpt-5-4 | OpenAI | gpt-5.4-2026-03-05 | | duo-chat-gpt-5-5 | OpenAI | gpt-5.5-2026-04-23 | | duo-chat-gpt-5-mini | OpenAI | gpt-5-mini-2025-08-07 | | duo-chat-gpt-5-4-mini | OpenAI | gpt-5.4-mini | | duo-chat-gpt-5-4-nano | OpenAI | gpt-5.4-nano | | duo-chat-gpt-5-codex | OpenAI | gpt-5-codex | | duo-chat-gpt-5-2-codex | OpenAI | gpt-5.2-codex | | duo-chat-gpt-5-3-codex | OpenAI | gpt-5.3-codex |

For unmapped Anthropic model IDs, the provider defaults to claude-sonnet-4-5-20250929.

OpenAI Models (GPT-5)

The provider supports OpenAI GPT-5 models through GitLab's AI Gateway proxy. OpenAI models are automatically detected based on the model ID and routed to the appropriate proxy endpoint.

OpenAI models accept reasoning efforts from none through max, depending on the selected model. The effort is sent as reasoning.effort on the Responses API models and as reasoning_effort on the Chat Completions API models. Anthropic models accept enabled thinking with a token budget, disabled thinking, or adaptive thinking with an effort level:

Adaptive thinking is serialized as thinking: { type: 'adaptive' } plus a sibling output_config: { effort }. Both settings can also be passed per request under providerOptions.gitlab. Per-request values take precedence over the model defaults, which allows hosts such as OpenCode to implement model variants.

When Anthropic thinking is active (enabled or adaptive), the provider automatically drops temperature and omits any top_p outside the [0.95, 1] range, since Anthropic rejects those sampling parameters while extended thinking is engaged. Thinking blocks returned by Anthropic are surfaced as AI SDK reasoning parts (carrying the block signature under providerOptions.gitlab) and replayed unmodified on subsequent turns, as required during tool-use loops.

OpenAI Models with Tool Calling:

Agentic Chat with Feature Flags

You can pass feature flags to enable experimental features in GitLab's AI Gateway proxy:

Duo Workflow Service (Server-Side Agentic)

The Duo Workflow Service provides a server-side agentic loop where GitLab drives the LLM and streams tool execution requests to the client via WebSocket. This enables powerful agentic workflows with dynamic model discovery and MCP tool integration.

Requirements:

• GitLab Ultimate with Duo Enterprise add-on • GitLab 18.4+ (18.5+ for pinned model support)

Dynamic Model Discovery:

The workflow service automatically discovers available models for your namespace and respects admin-pinned models:

Model Selection Priority:

1. Admin-pinned model (always used if set) 2. User-selected model (via onSelectModel callback) 3. Namespace default model

Built-in Tool Support:

The workflow service automatically maps DWS built-in tools to consumer tool names:

| DWS Tool | Consumer Tool | Description |

| runReadFile | read | Read file contents | | runWriteFile | write | Write file contents | | runEditFile | edit | Edit file with old/new string | | runShellCommand | bash | Execute shell command | | runCommand | bash | Execute structured command | | runGitCommand | bash | Execute git command | | listDirectory | read | List directory contents | | findFiles | glob | Find files by pattern | | grep | grep | Search file contents | | mkdir | bash | Create directory | | runHTTPRequest | bash | Execute HTTP request |

Server-Side Tool Visibility:…