@gitlab/gitlab-ai-provider 3.0.9 → 3.1.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## <small>3.1.1 (2026-01-14)</small>
+
+- fix: use models mapping for Anthropic ([7b876ec](https://gitlab.com/gitlab-org/editor-extensions/gitlab-ai-provider/commit/7b876ec))
+
+## 3.1.0 (2026-01-13)
+
+- feat: improve npm metadata for better discoverability ([fc3795c](https://gitlab.com/gitlab-org/editor-extensions/gitlab-ai-provider/commit/fc3795c))
+
 ## <small>3.0.9 (2026-01-07)</small>
 
 - docs: removed unused documentation ([a5f3bdd](https://gitlab.com/gitlab-org/editor-extensions/gitlab-ai-provider/commit/a5f3bdd))

package/README.md

@@ -75,6 +75,46 @@ const { text } = await generateText({
 });
 ```
 
+### Model Variants
+
+The provider automatically maps specific model IDs to their corresponding Anthropic models:
+
+```typescript
+import { createGitLab } from '@gitlab/gitlab-ai-provider';
+import { generateText } from 'ai';
+
+const gitlab = createGitLab({
+  apiKey: process.env.GITLAB_TOKEN,
+});
+
+// Use Claude Opus 4.5
+const opusModel = gitlab.agenticChat('duo-chat-opus-4-5');
+// Automatically uses: claude-opus-4-5-20251101
+
+// Use Claude Sonnet 4.5
+const sonnetModel = gitlab.agenticChat('duo-chat-sonnet-4-5');
+// Automatically uses: claude-sonnet-4-5-20250929
+
+// Use Claude Haiku 4.5
+const haikuModel = gitlab.agenticChat('duo-chat-haiku-4-5');
+// Automatically uses: claude-haiku-4-5-20251001
+
+// You can still override with explicit anthropicModel option
+const customModel = gitlab.agenticChat('duo-chat-opus-4-5', {
+  anthropicModel: 'claude-sonnet-4-5-20250929', // Override mapping
+});
+```
+
+**Available Model Mappings:**
+
+| Model ID              | Anthropic Model              |
+| --------------------- | ---------------------------- |
+| `duo-chat-opus-4-5`   | `claude-opus-4-5-20251101`   |
+| `duo-chat-sonnet-4-5` | `claude-sonnet-4-5-20250929` |
+| `duo-chat-haiku-4-5`  | `claude-haiku-4-5-20251001`  |
+
+For unmapped model IDs, the provider defaults to `claude-sonnet-4-5-20250929`.
+
 ### Agentic Chat with Feature Flags
 
 You can pass feature flags to enable experimental features in GitLab's Anthropic proxy:

package/dist/index.d.mts

@@ -95,6 +95,24 @@ interface GitLabProvider {
     readonly specificationVersion: 'v2';
     languageModel(modelId: string): LanguageModelV2;
     chat(modelId: string): LanguageModelV2;
+    /**
+     * Create an agentic chat model with tool calling support
+     *
+     * @param modelId - GitLab model identifier. Some IDs automatically map to specific Anthropic models.
+     * @param options - Configuration options for the agentic model
+     * @returns A language model with native tool calling support via Anthropic
+     *
+     * @example
+     * // Automatic model mapping
+     * const model = gitlab.agenticChat('duo-chat-opus-4-5');
+     * // Uses claude-opus-4-5-20251101
+     *
+     * @example
+     * // Explicit model override
+     * const model = gitlab.agenticChat('duo-chat', {
+     *   anthropicModel: 'claude-sonnet-4-5-20250929'
+     * });
+     */
     agenticChat(modelId: string, options?: GitLabAgenticOptions): GitLabAgenticLanguageModel;
     textEmbeddingModel(modelId: string): never;
     imageModel(modelId: string): never;
@@ -102,7 +120,24 @@ interface GitLabProvider {
 interface GitLabAgenticOptions {
     /**
      * The Anthropic model to use
-     * @default 'claude-sonnet-4-20250514'
+     *
+     * If not specified, automatically maps from the model ID:
+     * - 'duo-chat-opus-4-5' → 'claude-opus-4-5-20251101'
+     * - 'duo-chat-sonnet-4-5' → 'claude-sonnet-4-5-20250929'
+     * - 'duo-chat-haiku-4-5' → 'claude-haiku-4-5-20251001'
+     *
+     * For unmapped model IDs, defaults to 'claude-sonnet-4-5-20250929'
+     *
+     * @default Automatically mapped from model ID, or 'claude-sonnet-4-5-20250929'
+     * @example
+     * // Use automatic mapping
+     * const model = gitlab.agenticChat('duo-chat-opus-4-5');
+     *
+     * @example
+     * // Override with explicit model
+     * const model = gitlab.agenticChat('duo-chat-opus-4-5', {
+     *   anthropicModel: 'claude-sonnet-4-5-20250929'
+     * });
      */
     anthropicModel?: string;
     /**
@@ -168,6 +203,33 @@ declare function createGitLab(options?: GitLabProviderSettings): GitLabProvider;
  */
 declare const gitlab: GitLabProvider;
 
+/**
+ * Maps GitLab model IDs to their corresponding Anthropic model identifiers.
+ *
+ * This mapping allows users to specify model variants by model ID without
+ * needing to manually configure the anthropicModel option.
+ *
+ * @example
+ * const model = gitlab.agenticChat('duo-chat-opus-4-5');
+ * // Automatically uses 'claude-opus-4-5-20251101'
+ */
+declare const MODEL_ID_TO_ANTHROPIC_MODEL: Record<string, string>;
+/**
+ * Gets the Anthropic model identifier for a given GitLab model ID.
+ *
+ * @param modelId - The GitLab model ID (e.g., 'duo-chat-opus-4-5')
+ * @returns The Anthropic model identifier, or undefined if no mapping exists
+ *
+ * @example
+ * getAnthropicModelForModelId('duo-chat-opus-4-5')
+ * // Returns: 'claude-opus-4-5-20251101'
+ *
+ * @example
+ * getAnthropicModelForModelId('duo-chat')
+ * // Returns: undefined (uses default)
+ */
+declare function getAnthropicModelForModelId(modelId: string): string | undefined;
+
 interface GitLabErrorOptions {
     message: string;
     statusCode?: number;
@@ -522,4 +584,4 @@ declare class GitLabProjectDetector {
     getCache(): GitLabProjectCache;
 }
 
-export { ANTHROPIC_TOOLS, AnthropicToolExecutor, BUNDLED_CLIENT_ID, GITLAB_API_TOOLS, GITLAB_COM_URL, type GitLabAgenticConfig, GitLabAgenticLanguageModel, type GitLabAgenticOptions, GitLabApiToolExecutor, type GitLabApiToolsConfig, GitLabError, type GitLabErrorOptions, GitLabOAuthManager, type GitLabOAuthTokenResponse, type GitLabOAuthTokens, type GitLabProject, GitLabProjectCache, GitLabProjectDetector, type GitLabProjectDetectorConfig, type GitLabProvider, type GitLabProviderSettings, OAUTH_SCOPES, type OpenCodeAuth, type OpenCodeAuthApi, type OpenCodeAuthOAuth, TOKEN_EXPIRY_SKEW_MS, type ToolInput, type ToolResult, createGitLab, gitlab, isGitLabApiTool };
+export { ANTHROPIC_TOOLS, AnthropicToolExecutor, BUNDLED_CLIENT_ID, GITLAB_API_TOOLS, GITLAB_COM_URL, type GitLabAgenticConfig, GitLabAgenticLanguageModel, type GitLabAgenticOptions, GitLabApiToolExecutor, type GitLabApiToolsConfig, GitLabError, type GitLabErrorOptions, GitLabOAuthManager, type GitLabOAuthTokenResponse, type GitLabOAuthTokens, type GitLabProject, GitLabProjectCache, GitLabProjectDetector, type GitLabProjectDetectorConfig, type GitLabProvider, type GitLabProviderSettings, MODEL_ID_TO_ANTHROPIC_MODEL, OAUTH_SCOPES, type OpenCodeAuth, type OpenCodeAuthApi, type OpenCodeAuthOAuth, TOKEN_EXPIRY_SKEW_MS, type ToolInput, type ToolResult, createGitLab, getAnthropicModelForModelId, gitlab, isGitLabApiTool };

package/dist/index.d.ts

@@ -95,6 +95,24 @@ interface GitLabProvider {
     readonly specificationVersion: 'v2';
     languageModel(modelId: string): LanguageModelV2;
     chat(modelId: string): LanguageModelV2;
+    /**
+     * Create an agentic chat model with tool calling support
+     *
+     * @param modelId - GitLab model identifier. Some IDs automatically map to specific Anthropic models.
+     * @param options - Configuration options for the agentic model
+     * @returns A language model with native tool calling support via Anthropic
+     *
+     * @example
+     * // Automatic model mapping
+     * const model = gitlab.agenticChat('duo-chat-opus-4-5');
+     * // Uses claude-opus-4-5-20251101
+     *
+     * @example
+     * // Explicit model override
+     * const model = gitlab.agenticChat('duo-chat', {
+     *   anthropicModel: 'claude-sonnet-4-5-20250929'
+     * });
+     */
     agenticChat(modelId: string, options?: GitLabAgenticOptions): GitLabAgenticLanguageModel;
     textEmbeddingModel(modelId: string): never;
     imageModel(modelId: string): never;
@@ -102,7 +120,24 @@ interface GitLabProvider {
 interface GitLabAgenticOptions {
     /**
      * The Anthropic model to use
-     * @default 'claude-sonnet-4-20250514'
+     *
+     * If not specified, automatically maps from the model ID:
+     * - 'duo-chat-opus-4-5' → 'claude-opus-4-5-20251101'
+     * - 'duo-chat-sonnet-4-5' → 'claude-sonnet-4-5-20250929'
+     * - 'duo-chat-haiku-4-5' → 'claude-haiku-4-5-20251001'
+     *
+     * For unmapped model IDs, defaults to 'claude-sonnet-4-5-20250929'
+     *
+     * @default Automatically mapped from model ID, or 'claude-sonnet-4-5-20250929'
+     * @example
+     * // Use automatic mapping
+     * const model = gitlab.agenticChat('duo-chat-opus-4-5');
+     *
+     * @example
+     * // Override with explicit model
+     * const model = gitlab.agenticChat('duo-chat-opus-4-5', {
+     *   anthropicModel: 'claude-sonnet-4-5-20250929'
+     * });
      */
     anthropicModel?: string;
     /**
@@ -168,6 +203,33 @@ declare function createGitLab(options?: GitLabProviderSettings): GitLabProvider;
  */
 declare const gitlab: GitLabProvider;
 
+/**
+ * Maps GitLab model IDs to their corresponding Anthropic model identifiers.
+ *
+ * This mapping allows users to specify model variants by model ID without
+ * needing to manually configure the anthropicModel option.
+ *
+ * @example
+ * const model = gitlab.agenticChat('duo-chat-opus-4-5');
+ * // Automatically uses 'claude-opus-4-5-20251101'
+ */
+declare const MODEL_ID_TO_ANTHROPIC_MODEL: Record<string, string>;
+/**
+ * Gets the Anthropic model identifier for a given GitLab model ID.
+ *
+ * @param modelId - The GitLab model ID (e.g., 'duo-chat-opus-4-5')
+ * @returns The Anthropic model identifier, or undefined if no mapping exists
+ *
+ * @example
+ * getAnthropicModelForModelId('duo-chat-opus-4-5')
+ * // Returns: 'claude-opus-4-5-20251101'
+ *
+ * @example
+ * getAnthropicModelForModelId('duo-chat')
+ * // Returns: undefined (uses default)
+ */
+declare function getAnthropicModelForModelId(modelId: string): string | undefined;
+
 interface GitLabErrorOptions {
     message: string;
     statusCode?: number;
@@ -522,4 +584,4 @@ declare class GitLabProjectDetector {
     getCache(): GitLabProjectCache;
 }
 
-export { ANTHROPIC_TOOLS, AnthropicToolExecutor, BUNDLED_CLIENT_ID, GITLAB_API_TOOLS, GITLAB_COM_URL, type GitLabAgenticConfig, GitLabAgenticLanguageModel, type GitLabAgenticOptions, GitLabApiToolExecutor, type GitLabApiToolsConfig, GitLabError, type GitLabErrorOptions, GitLabOAuthManager, type GitLabOAuthTokenResponse, type GitLabOAuthTokens, type GitLabProject, GitLabProjectCache, GitLabProjectDetector, type GitLabProjectDetectorConfig, type GitLabProvider, type GitLabProviderSettings, OAUTH_SCOPES, type OpenCodeAuth, type OpenCodeAuthApi, type OpenCodeAuthOAuth, TOKEN_EXPIRY_SKEW_MS, type ToolInput, type ToolResult, createGitLab, gitlab, isGitLabApiTool };
+export { ANTHROPIC_TOOLS, AnthropicToolExecutor, BUNDLED_CLIENT_ID, GITLAB_API_TOOLS, GITLAB_COM_URL, type GitLabAgenticConfig, GitLabAgenticLanguageModel, type GitLabAgenticOptions, GitLabApiToolExecutor, type GitLabApiToolsConfig, GitLabError, type GitLabErrorOptions, GitLabOAuthManager, type GitLabOAuthTokenResponse, type GitLabOAuthTokens, type GitLabProject, GitLabProjectCache, GitLabProjectDetector, type GitLabProjectDetectorConfig, type GitLabProvider, type GitLabProviderSettings, MODEL_ID_TO_ANTHROPIC_MODEL, OAUTH_SCOPES, type OpenCodeAuth, type OpenCodeAuthApi, type OpenCodeAuthOAuth, TOKEN_EXPIRY_SKEW_MS, type ToolInput, type ToolResult, createGitLab, getAnthropicModelForModelId, gitlab, isGitLabApiTool };

package/dist/index.js

@@ -40,9 +40,11 @@ __export(index_exports, {
   GitLabOAuthManager: () => GitLabOAuthManager,
   GitLabProjectCache: () => GitLabProjectCache,
   GitLabProjectDetector: () => GitLabProjectDetector,
+  MODEL_ID_TO_ANTHROPIC_MODEL: () => MODEL_ID_TO_ANTHROPIC_MODEL,
   OAUTH_SCOPES: () => OAUTH_SCOPES,
   TOKEN_EXPIRY_SKEW_MS: () => TOKEN_EXPIRY_SKEW_MS,
   createGitLab: () => createGitLab,
+  getAnthropicModelForModelId: () => getAnthropicModelForModelId,
   gitlab: () => gitlab,
   isGitLabApiTool: () => isGitLabApiTool
 });
@@ -749,6 +751,16 @@ var GitLabOAuthManager = class {
   }
 };
 
+// src/model-mappings.ts
+var MODEL_ID_TO_ANTHROPIC_MODEL = {
+  "duo-chat-opus-4-5": "claude-opus-4-5-20251101",
+  "duo-chat-sonnet-4-5": "claude-sonnet-4-5-20250929",
+  "duo-chat-haiku-4-5": "claude-haiku-4-5-20251001"
+};
+function getAnthropicModelForModelId(modelId) {
+  return MODEL_ID_TO_ANTHROPIC_MODEL[modelId];
+}
+
 // src/gitlab-provider.ts
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
@@ -895,7 +907,7 @@ function createGitLab(options = {}) {
       getHeaders,
       refreshApiKey,
       fetch: options.fetch,
-      anthropicModel: agenticOptions?.anthropicModel,
+      anthropicModel: agenticOptions?.anthropicModel ?? getAnthropicModelForModelId(modelId),
       maxTokens: agenticOptions?.maxTokens,
       featureFlags
     });
@@ -2392,9 +2404,11 @@ var GitLabProjectDetector = class {
   GitLabOAuthManager,
   GitLabProjectCache,
   GitLabProjectDetector,
+  MODEL_ID_TO_ANTHROPIC_MODEL,
   OAUTH_SCOPES,
   TOKEN_EXPIRY_SKEW_MS,
   createGitLab,
+  getAnthropicModelForModelId,
   gitlab,
   isGitLabApiTool
 });