@gitlab/gitlab-ai-provider 3.1.1 → 3.1.2

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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))

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
@@ -224,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
@@ -321,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
@@ -392,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
@@ -189,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;
 /**
@@ -371,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
@@ -584,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, 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 };
+/**
+ * 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
@@ -189,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;
 /**
@@ -371,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
@@ -584,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, 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 };
+/**
+ * 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 };