@gitlab/gitlab-ai-provider 3.1.0 → 3.1.2

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.2 (2026-01-18)</small>
+
+- fix: removed API tools and added new env variable ([a64ef6d](https://gitlab.com/gitlab-org/editor-extensions/gitlab-ai-provider/commit/a64ef6d))
+
+## <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))

package/README.md

@@ -7,7 +7,7 @@ A comprehensive TypeScript provider for integrating GitLab Duo AI capabilities w
 - **🤖 Agentic Chat**: Native tool calling support via GitLab's Anthropic proxy
 - **🔐 Multiple Authentication**: Support for OAuth, Personal Access Tokens, and OpenCode auth
 - **🌐 Self-Hosted Support**: Works with both GitLab.com and self-hosted instances
-- **📦 Tool Executors**: Built-in Anthropic and GitLab API tool executors
+- **🔧 Tool Support**: Native tool calling via Vercel AI SDK
 - **🔍 Project Detection**: Automatic GitLab project detection from git remotes
 - **💾 Smart Caching**: Project and token caching for optimal performance
 - **🎯 Type-Safe**: Complete TypeScript definitions with Zod validation
@@ -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:
@@ -184,33 +224,6 @@ Provides native tool calling through GitLab's Anthropic proxy.
 - Direct access token management
 - Supports all Anthropic tool calling features
 
-### Tool Executors
-
-#### AnthropicToolExecutor
-
-Executes local file system and command tools:
-
-- `list_dir` - List directory contents
-- `read_file` - Read file contents
-- `write_file` - Write to files
-- `edit_file` - Edit file with find/replace
-- `find_files` - Find files by pattern
-- `mkdir` - Create directories
-- `grep` - Search file contents
-- `run_command` - Execute shell commands
-- `run_git_command` - Execute git commands
-
-#### GitLabApiToolExecutor
-
-Executes GitLab API operations:
-
-- Merge Requests: get, list, changes, discussions, notes
-- Issues: get, list, notes
-- Pipelines: list, get, jobs, logs
-- Repository: files, commits, branches
-- Search: global and project search
-- Projects: get, members
-
 ### Supporting Utilities
 
 #### GitLabProjectDetector
@@ -281,9 +294,17 @@ interface GitLabProviderSettings {
   name?: string; // Provider name prefix
   headers?: Record<string, string>; // Custom headers
   fetch?: typeof fetch; // Custom fetch implementation
+  aiGatewayUrl?: string; // AI Gateway URL (default: 'https://cloud.gitlab.com')
 }
 ```
 
+### Environment Variables
+
+| Variable                | Description                                 | Default                    |
+| ----------------------- | ------------------------------------------- | -------------------------- |
+| `GITLAB_TOKEN`          | GitLab Personal Access Token or OAuth token | -                          |
+| `GITLAB_AI_GATEWAY_URL` | AI Gateway URL for Anthropic proxy          | `https://cloud.gitlab.com` |
+
 ### Agentic Chat Options
 
 ```typescript
@@ -352,8 +373,6 @@ gitlab-ai-provider/
 │   ├── gitlab-oauth-types.ts             # OAuth types
 │   ├── gitlab-project-detector.ts        # Project detection
 │   ├── gitlab-project-cache.ts           # Project caching
-│   ├── gitlab-anthropic-tools.ts         # Anthropic tool executor
-│   ├── gitlab-api-tools.ts               # GitLab API tool executor
 │   ├── gitlab-api-types.ts               # API types
 │   ├── gitlab-error.ts                   # Error handling
 │   └── gitlab-workflow-debug.ts          # Debug logging

package/dist/index.d.mts

@@ -1,6 +1,5 @@
 import { LanguageModelV2, LanguageModelV2CallOptions, LanguageModelV2Content, LanguageModelV2FinishReason, LanguageModelV2Usage, LanguageModelV2CallWarning, LanguageModelV2StreamPart } from '@ai-sdk/provider';
 import { z } from 'zod';
-import { Tool } from '@anthropic-ai/sdk/resources/messages';
 
 interface GitLabAgenticConfig {
     provider: string;
@@ -29,6 +28,12 @@ interface GitLabAgenticConfig {
     featureFlags?: {
         DuoAgentPlatformNext: true;
     } & Record<string, boolean>;
+    /**
+     * AI Gateway URL for the Anthropic proxy.
+     * Can also be set via GITLAB_AI_GATEWAY_URL environment variable.
+     * @default 'https://cloud.gitlab.com'
+     */
+    aiGatewayUrl?: string;
 }
 /**
  * GitLab Agentic Language Model
@@ -95,6 +100,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 +125,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;
     /**
@@ -154,6 +194,12 @@ interface GitLabProviderSettings {
      * Default feature flags to pass to the GitLab API for all agentic chat models
      */
     featureFlags?: Record<string, boolean>;
+    /**
+     * AI Gateway URL for the Anthropic proxy.
+     * Can also be set via GITLAB_AI_GATEWAY_URL environment variable.
+     * @default 'https://cloud.gitlab.com'
+     */
+    aiGatewayUrl?: string;
 }
 declare function createGitLab(options?: GitLabProviderSettings): GitLabProvider;
 /**
@@ -168,6 +214,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;
@@ -309,89 +382,6 @@ declare class GitLabOAuthManager {
     private createExpiresTimestamp;
 }
 
-/**
- * Tool definitions for Anthropic Claude
- */
-declare const ANTHROPIC_TOOLS: Tool[];
-interface ToolResult {
-    result: string;
-    error?: string;
-}
-interface ToolInput {
-    [key: string]: unknown;
-}
-/**
- * Tool executor for local file and command operations
- */
-declare class AnthropicToolExecutor {
-    private readonly workingDirectory;
-    constructor(workingDirectory: string);
-    /**
-     * Execute a tool by name with given input
-     */
-    execute(toolName: string, input: ToolInput): Promise<ToolResult>;
-    private resolvePath;
-    private listDir;
-    private readFile;
-    private writeFile;
-    private editFile;
-    private findFiles;
-    private mkdir;
-    private grep;
-    private runCommand;
-    private runGitCommand;
-    private executeCommand;
-}
-
-/**
- * GitLab API tools for interacting with GitLab resources
- * These tools allow the AI to access merge requests, issues, pipelines, etc.
- */
-declare const GITLAB_API_TOOLS: Tool[];
-interface GitLabApiToolsConfig {
-    instanceUrl: string;
-    token: string;
-    fetch?: typeof fetch;
-}
-/**
- * Executor for GitLab API tools
- */
-declare class GitLabApiToolExecutor {
-    private readonly config;
-    constructor(config: GitLabApiToolsConfig);
-    private get headers();
-    private fetchApi;
-    private encodeProjectId;
-    /**
-     * Execute a GitLab API tool by name
-     */
-    execute(toolName: string, input: ToolInput): Promise<ToolResult>;
-    private getMergeRequest;
-    private listMergeRequests;
-    private getMrChanges;
-    private listMrDiscussions;
-    private createMrNote;
-    private getIssue;
-    private listIssues;
-    private createIssueNote;
-    private listPipelines;
-    private getPipeline;
-    private listPipelineJobs;
-    private getJobLog;
-    private retryJob;
-    private getFile;
-    private listCommits;
-    private getCommitDiff;
-    private listBranches;
-    private search;
-    private getProject;
-    private listProjectMembers;
-}
-/**
- * Check if a tool name is a GitLab API tool
- */
-declare function isGitLabApiTool(toolName: string): boolean;
-
 /**
  * Simple in-memory cache for GitLab project information
  * Used to avoid repeated API calls when detecting projects from git remotes
@@ -522,4 +512,66 @@ 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 };
+/**
+ * Response from /api/v4/ai/third_party_agents/direct_access
+ */
+declare const directAccessTokenSchema: z.ZodObject<{
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    headers?: Record<string, string>;
+    token?: string;
+}, {
+    headers?: Record<string, string>;
+    token?: string;
+}>;
+type DirectAccessToken = z.infer<typeof directAccessTokenSchema>;
+declare const DEFAULT_AI_GATEWAY_URL = "https://cloud.gitlab.com";
+interface GitLabDirectAccessConfig {
+    instanceUrl: string;
+    getHeaders: () => Record<string, string>;
+    fetch?: typeof fetch;
+    /**
+     * Optional callback to refresh the API key when a 401 error occurs.
+     * Should clear cached credentials and re-fetch from auth provider.
+     */
+    refreshApiKey?: () => Promise<void>;
+    /**
+     * Feature flags to pass to the GitLab API
+     */
+    featureFlags?: Record<string, boolean>;
+    /**
+     * AI Gateway URL for the Anthropic proxy.
+     * Can also be set via GITLAB_AI_GATEWAY_URL environment variable.
+     * @default 'https://cloud.gitlab.com'
+     */
+    aiGatewayUrl?: string;
+}
+/**
+ * Client for GitLab's third-party agents direct access API.
+ * This allows routing requests through GitLab's proxy to Anthropic.
+ */
+declare class GitLabDirectAccessClient {
+    private readonly config;
+    private readonly fetchFn;
+    private readonly aiGatewayUrl;
+    private cachedToken;
+    private tokenExpiresAt;
+    constructor(config: GitLabDirectAccessConfig);
+    /**
+     * Get a direct access token for the Anthropic proxy.
+     * Tokens are cached for 25 minutes (they expire after 30 minutes).
+     * @param forceRefresh - If true, ignores the cache and fetches a new token
+     */
+    getDirectAccessToken(forceRefresh?: boolean): Promise<DirectAccessToken>;
+    /**
+     * Get the Anthropic proxy base URL
+     */
+    getAnthropicProxyUrl(): string;
+    /**
+     * Invalidate the cached token
+     */
+    invalidateToken(): void;
+}
+
+export { BUNDLED_CLIENT_ID, DEFAULT_AI_GATEWAY_URL, type DirectAccessToken, GITLAB_COM_URL, type GitLabAgenticConfig, GitLabAgenticLanguageModel, type GitLabAgenticOptions, GitLabDirectAccessClient, type GitLabDirectAccessConfig, 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, createGitLab, getAnthropicModelForModelId, gitlab };

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { LanguageModelV2, LanguageModelV2CallOptions, LanguageModelV2Content, LanguageModelV2FinishReason, LanguageModelV2Usage, LanguageModelV2CallWarning, LanguageModelV2StreamPart } from '@ai-sdk/provider';
 import { z } from 'zod';
-import { Tool } from '@anthropic-ai/sdk/resources/messages';
 
 interface GitLabAgenticConfig {
     provider: string;
@@ -29,6 +28,12 @@ interface GitLabAgenticConfig {
     featureFlags?: {
         DuoAgentPlatformNext: true;
     } & Record<string, boolean>;
+    /**
+     * AI Gateway URL for the Anthropic proxy.
+     * Can also be set via GITLAB_AI_GATEWAY_URL environment variable.
+     * @default 'https://cloud.gitlab.com'
+     */
+    aiGatewayUrl?: string;
 }
 /**
  * GitLab Agentic Language Model
@@ -95,6 +100,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 +125,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;
     /**
@@ -154,6 +194,12 @@ interface GitLabProviderSettings {
      * Default feature flags to pass to the GitLab API for all agentic chat models
      */
     featureFlags?: Record<string, boolean>;
+    /**
+     * AI Gateway URL for the Anthropic proxy.
+     * Can also be set via GITLAB_AI_GATEWAY_URL environment variable.
+     * @default 'https://cloud.gitlab.com'
+     */
+    aiGatewayUrl?: string;
 }
 declare function createGitLab(options?: GitLabProviderSettings): GitLabProvider;
 /**
@@ -168,6 +214,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;
@@ -309,89 +382,6 @@ declare class GitLabOAuthManager {
     private createExpiresTimestamp;
 }
 
-/**
- * Tool definitions for Anthropic Claude
- */
-declare const ANTHROPIC_TOOLS: Tool[];
-interface ToolResult {
-    result: string;
-    error?: string;
-}
-interface ToolInput {
-    [key: string]: unknown;
-}
-/**
- * Tool executor for local file and command operations
- */
-declare class AnthropicToolExecutor {
-    private readonly workingDirectory;
-    constructor(workingDirectory: string);
-    /**
-     * Execute a tool by name with given input
-     */
-    execute(toolName: string, input: ToolInput): Promise<ToolResult>;
-    private resolvePath;
-    private listDir;
-    private readFile;
-    private writeFile;
-    private editFile;
-    private findFiles;
-    private mkdir;
-    private grep;
-    private runCommand;
-    private runGitCommand;
-    private executeCommand;
-}
-
-/**
- * GitLab API tools for interacting with GitLab resources
- * These tools allow the AI to access merge requests, issues, pipelines, etc.
- */
-declare const GITLAB_API_TOOLS: Tool[];
-interface GitLabApiToolsConfig {
-    instanceUrl: string;
-    token: string;
-    fetch?: typeof fetch;
-}
-/**
- * Executor for GitLab API tools
- */
-declare class GitLabApiToolExecutor {
-    private readonly config;
-    constructor(config: GitLabApiToolsConfig);
-    private get headers();
-    private fetchApi;
-    private encodeProjectId;
-    /**
-     * Execute a GitLab API tool by name
-     */
-    execute(toolName: string, input: ToolInput): Promise<ToolResult>;
-    private getMergeRequest;
-    private listMergeRequests;
-    private getMrChanges;
-    private listMrDiscussions;
-    private createMrNote;
-    private getIssue;
-    private listIssues;
-    private createIssueNote;
-    private listPipelines;
-    private getPipeline;
-    private listPipelineJobs;
-    private getJobLog;
-    private retryJob;
-    private getFile;
-    private listCommits;
-    private getCommitDiff;
-    private listBranches;
-    private search;
-    private getProject;
-    private listProjectMembers;
-}
-/**
- * Check if a tool name is a GitLab API tool
- */
-declare function isGitLabApiTool(toolName: string): boolean;
-
 /**
  * Simple in-memory cache for GitLab project information
  * Used to avoid repeated API calls when detecting projects from git remotes
@@ -522,4 +512,66 @@ 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 };
+/**
+ * Response from /api/v4/ai/third_party_agents/direct_access
+ */
+declare const directAccessTokenSchema: z.ZodObject<{
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    headers?: Record<string, string>;
+    token?: string;
+}, {
+    headers?: Record<string, string>;
+    token?: string;
+}>;
+type DirectAccessToken = z.infer<typeof directAccessTokenSchema>;
+declare const DEFAULT_AI_GATEWAY_URL = "https://cloud.gitlab.com";
+interface GitLabDirectAccessConfig {
+    instanceUrl: string;
+    getHeaders: () => Record<string, string>;
+    fetch?: typeof fetch;
+    /**
+     * Optional callback to refresh the API key when a 401 error occurs.
+     * Should clear cached credentials and re-fetch from auth provider.
+     */
+    refreshApiKey?: () => Promise<void>;
+    /**
+     * Feature flags to pass to the GitLab API
+     */
+    featureFlags?: Record<string, boolean>;
+    /**
+     * AI Gateway URL for the Anthropic proxy.
+     * Can also be set via GITLAB_AI_GATEWAY_URL environment variable.
+     * @default 'https://cloud.gitlab.com'
+     */
+    aiGatewayUrl?: string;
+}
+/**
+ * Client for GitLab's third-party agents direct access API.
+ * This allows routing requests through GitLab's proxy to Anthropic.
+ */
+declare class GitLabDirectAccessClient {
+    private readonly config;
+    private readonly fetchFn;
+    private readonly aiGatewayUrl;
+    private cachedToken;
+    private tokenExpiresAt;
+    constructor(config: GitLabDirectAccessConfig);
+    /**
+     * Get a direct access token for the Anthropic proxy.
+     * Tokens are cached for 25 minutes (they expire after 30 minutes).
+     * @param forceRefresh - If true, ignores the cache and fetches a new token
+     */
+    getDirectAccessToken(forceRefresh?: boolean): Promise<DirectAccessToken>;
+    /**
+     * Get the Anthropic proxy base URL
+     */
+    getAnthropicProxyUrl(): string;
+    /**
+     * Invalidate the cached token
+     */
+    invalidateToken(): void;
+}
+
+export { BUNDLED_CLIENT_ID, DEFAULT_AI_GATEWAY_URL, type DirectAccessToken, GITLAB_COM_URL, type GitLabAgenticConfig, GitLabAgenticLanguageModel, type GitLabAgenticOptions, GitLabDirectAccessClient, type GitLabDirectAccessConfig, 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, createGitLab, getAnthropicModelForModelId, gitlab };