gitlab-ai-provider 5.2.0 → 5.2.1

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>5.2.1 (2026-03-20)</small>
+
+- fix: cache workflow model discovery to file and resolve model name on selection ([8ba7056](https://gitlab.com/vglafirov/gitlab-ai-provider/commit/8ba7056))
+
 ## 5.2.0 (2026-03-18)
 
 - fix: update dists ([57692b5](https://gitlab.com/vglafirov/gitlab-ai-provider/commit/57692b5))

package/dist/index.d.mts

@@ -174,6 +174,67 @@ declare class GitLabModelDiscovery {
     invalidateCache(): void;
 }
 
+/**
+ * Simple in-memory cache for GitLab project information
+ * Used to avoid repeated API calls when detecting projects from git remotes
+ */
+interface GitLabProject {
+    id: number;
+    path: string;
+    pathWithNamespace: string;
+    name: string;
+    namespaceId?: number;
+}
+/**
+ * In-memory cache for GitLab project information with TTL support
+ */
+declare class GitLabProjectCache {
+    private cache;
+    private defaultTTL;
+    /**
+     * Create a new project cache
+     * @param defaultTTL - Default time-to-live in milliseconds (default: 5 minutes)
+     */
+    constructor(defaultTTL?: number);
+    /**
+     * Get a cached project by key
+     * @param key - Cache key (typically the working directory path)
+     * @returns The cached project or null if not found or expired
+     */
+    get(key: string): GitLabProject | null;
+    /**
+     * Store a project in the cache
+     * @param key - Cache key (typically the working directory path)
+     * @param project - The project to cache
+     * @param ttl - Optional custom TTL in milliseconds
+     */
+    set(key: string, project: GitLabProject, ttl?: number): void;
+    /**
+     * Check if a key exists in the cache (and is not expired)
+     * @param key - Cache key to check
+     * @returns true if the key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Remove a specific entry from the cache
+     * @param key - Cache key to remove
+     */
+    delete(key: string): void;
+    /**
+     * Clear all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Get the number of entries in the cache (including expired ones)
+     */
+    get size(): number;
+    /**
+     * Clean up expired entries from the cache
+     * This is useful for long-running processes to prevent memory leaks
+     */
+    cleanup(): void;
+}
+
 /**
  * File-based cache for workflow model discovery results and user selection.
  *
@@ -186,6 +247,7 @@ declare class GitLabModelDiscovery {
  * that switching instances for the same workspace invalidates the cache.
  * Each value holds:
  *   - `discovery`: The full DiscoveredModels JSON from the last successful discovery
+ *   - `project`: The GitLab project detected for this workspace
  *   - `selectedModelRef`: The model ref the user last selected
  *   - `selectedModelName`: Human-readable name of the selected model
  *   - `updatedAt`: ISO timestamp of the last write
@@ -193,6 +255,7 @@ declare class GitLabModelDiscovery {
 
 interface ModelCacheEntry {
     discovery: DiscoveredModels | null;
+    project: GitLabProject | null;
     selectedModelRef: string | null;
     selectedModelName: string | null;
     updatedAt: string;
@@ -212,12 +275,19 @@ declare class GitLabModelCache {
      * Persist the full cache entry to disk.
      */
     save(entry: ModelCacheEntry): void;
+    /**
+     * Returns true if the discovery data is missing or older than DISCOVERY_TTL_MS.
+     */
+    isDiscoveryExpired(): boolean;
     /**
      * Update only the discovery portion of the cache, preserving selection.
+     * Optionally persists the associated GitLab project.
      */
-    saveDiscovery(discovery: DiscoveredModels): void;
+    saveDiscovery(discovery: DiscoveredModels, project?: GitLabProject | null): void;
     /**
      * Update only the selected model, preserving the discovery data.
+     * If name is null but ref is provided, attempts to resolve the name
+     * from the cached discovery data.
      */
     saveSelection(ref: string | null, name: string | null): void;
     /**
@@ -1170,67 +1240,6 @@ declare class GitLabOAuthManager {
     private createExpiresTimestamp;
 }
 
-/**
- * Simple in-memory cache for GitLab project information
- * Used to avoid repeated API calls when detecting projects from git remotes
- */
-interface GitLabProject {
-    id: number;
-    path: string;
-    pathWithNamespace: string;
-    name: string;
-    namespaceId?: number;
-}
-/**
- * In-memory cache for GitLab project information with TTL support
- */
-declare class GitLabProjectCache {
-    private cache;
-    private defaultTTL;
-    /**
-     * Create a new project cache
-     * @param defaultTTL - Default time-to-live in milliseconds (default: 5 minutes)
-     */
-    constructor(defaultTTL?: number);
-    /**
-     * Get a cached project by key
-     * @param key - Cache key (typically the working directory path)
-     * @returns The cached project or null if not found or expired
-     */
-    get(key: string): GitLabProject | null;
-    /**
-     * Store a project in the cache
-     * @param key - Cache key (typically the working directory path)
-     * @param project - The project to cache
-     * @param ttl - Optional custom TTL in milliseconds
-     */
-    set(key: string, project: GitLabProject, ttl?: number): void;
-    /**
-     * Check if a key exists in the cache (and is not expired)
-     * @param key - Cache key to check
-     * @returns true if the key exists and is not expired
-     */
-    has(key: string): boolean;
-    /**
-     * Remove a specific entry from the cache
-     * @param key - Cache key to remove
-     */
-    delete(key: string): void;
-    /**
-     * Clear all entries from the cache
-     */
-    clear(): void;
-    /**
-     * Get the number of entries in the cache (including expired ones)
-     */
-    get size(): number;
-    /**
-     * Clean up expired entries from the cache
-     * This is useful for long-running processes to prevent memory leaks
-     */
-    cleanup(): void;
-}
-
 interface GitLabProjectDetectorConfig {
     instanceUrl: string;
     getHeaders: () => Record<string, string>;

package/dist/index.d.ts

@@ -174,6 +174,67 @@ declare class GitLabModelDiscovery {
     invalidateCache(): void;
 }
 
+/**
+ * Simple in-memory cache for GitLab project information
+ * Used to avoid repeated API calls when detecting projects from git remotes
+ */
+interface GitLabProject {
+    id: number;
+    path: string;
+    pathWithNamespace: string;
+    name: string;
+    namespaceId?: number;
+}
+/**
+ * In-memory cache for GitLab project information with TTL support
+ */
+declare class GitLabProjectCache {
+    private cache;
+    private defaultTTL;
+    /**
+     * Create a new project cache
+     * @param defaultTTL - Default time-to-live in milliseconds (default: 5 minutes)
+     */
+    constructor(defaultTTL?: number);
+    /**
+     * Get a cached project by key
+     * @param key - Cache key (typically the working directory path)
+     * @returns The cached project or null if not found or expired
+     */
+    get(key: string): GitLabProject | null;
+    /**
+     * Store a project in the cache
+     * @param key - Cache key (typically the working directory path)
+     * @param project - The project to cache
+     * @param ttl - Optional custom TTL in milliseconds
+     */
+    set(key: string, project: GitLabProject, ttl?: number): void;
+    /**
+     * Check if a key exists in the cache (and is not expired)
+     * @param key - Cache key to check
+     * @returns true if the key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Remove a specific entry from the cache
+     * @param key - Cache key to remove
+     */
+    delete(key: string): void;
+    /**
+     * Clear all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Get the number of entries in the cache (including expired ones)
+     */
+    get size(): number;
+    /**
+     * Clean up expired entries from the cache
+     * This is useful for long-running processes to prevent memory leaks
+     */
+    cleanup(): void;
+}
+
 /**
  * File-based cache for workflow model discovery results and user selection.
  *
@@ -186,6 +247,7 @@ declare class GitLabModelDiscovery {
  * that switching instances for the same workspace invalidates the cache.
  * Each value holds:
  *   - `discovery`: The full DiscoveredModels JSON from the last successful discovery
+ *   - `project`: The GitLab project detected for this workspace
  *   - `selectedModelRef`: The model ref the user last selected
  *   - `selectedModelName`: Human-readable name of the selected model
  *   - `updatedAt`: ISO timestamp of the last write
@@ -193,6 +255,7 @@ declare class GitLabModelDiscovery {
 
 interface ModelCacheEntry {
     discovery: DiscoveredModels | null;
+    project: GitLabProject | null;
     selectedModelRef: string | null;
     selectedModelName: string | null;
     updatedAt: string;
@@ -212,12 +275,19 @@ declare class GitLabModelCache {
      * Persist the full cache entry to disk.
      */
     save(entry: ModelCacheEntry): void;
+    /**
+     * Returns true if the discovery data is missing or older than DISCOVERY_TTL_MS.
+     */
+    isDiscoveryExpired(): boolean;
     /**
      * Update only the discovery portion of the cache, preserving selection.
+     * Optionally persists the associated GitLab project.
      */
-    saveDiscovery(discovery: DiscoveredModels): void;
+    saveDiscovery(discovery: DiscoveredModels, project?: GitLabProject | null): void;
     /**
      * Update only the selected model, preserving the discovery data.
+     * If name is null but ref is provided, attempts to resolve the name
+     * from the cached discovery data.
      */
     saveSelection(ref: string | null, name: string | null): void;
     /**
@@ -1170,67 +1240,6 @@ declare class GitLabOAuthManager {
     private createExpiresTimestamp;
 }
 
-/**
- * Simple in-memory cache for GitLab project information
- * Used to avoid repeated API calls when detecting projects from git remotes
- */
-interface GitLabProject {
-    id: number;
-    path: string;
-    pathWithNamespace: string;
-    name: string;
-    namespaceId?: number;
-}
-/**
- * In-memory cache for GitLab project information with TTL support
- */
-declare class GitLabProjectCache {
-    private cache;
-    private defaultTTL;
-    /**
-     * Create a new project cache
-     * @param defaultTTL - Default time-to-live in milliseconds (default: 5 minutes)
-     */
-    constructor(defaultTTL?: number);
-    /**
-     * Get a cached project by key
-     * @param key - Cache key (typically the working directory path)
-     * @returns The cached project or null if not found or expired
-     */
-    get(key: string): GitLabProject | null;
-    /**
-     * Store a project in the cache
-     * @param key - Cache key (typically the working directory path)
-     * @param project - The project to cache
-     * @param ttl - Optional custom TTL in milliseconds
-     */
-    set(key: string, project: GitLabProject, ttl?: number): void;
-    /**
-     * Check if a key exists in the cache (and is not expired)
-     * @param key - Cache key to check
-     * @returns true if the key exists and is not expired
-     */
-    has(key: string): boolean;
-    /**
-     * Remove a specific entry from the cache
-     * @param key - Cache key to remove
-     */
-    delete(key: string): void;
-    /**
-     * Clear all entries from the cache
-     */
-    clear(): void;
-    /**
-     * Get the number of entries in the cache (including expired ones)
-     */
-    get size(): number;
-    /**
-     * Clean up expired entries from the cache
-     * This is useful for long-running processes to prevent memory leaks
-     */
-    cleanup(): void;
-}
-
 interface GitLabProjectDetectorConfig {
     instanceUrl: string;
     getHeaders: () => Record<string, string>;

package/dist/index.js

@@ -2746,6 +2746,7 @@ var fs = __toESM(require("fs"));
 var path2 = __toESM(require("path"));
 var os = __toESM(require("os"));
 var crypto = __toESM(require("crypto"));
+var DISCOVERY_TTL_MS = 10 * 60 * 1e3;
 function getCacheFilePath() {
   const cacheHome = process.env.XDG_CACHE_HOME || path2.join(os.homedir(), ".cache");
   return path2.join(cacheHome, "opencode", "gitlab-workflow-model-cache.json");
@@ -2795,13 +2796,23 @@ var GitLabModelCache = class {
     data[this.key] = entry;
     this.writeAll(data);
   }
+  /**
+   * Returns true if the discovery data is missing or older than DISCOVERY_TTL_MS.
+   */
+  isDiscoveryExpired() {
+    const entry = this.load();
+    if (!entry?.discovery || !entry.updatedAt) return true;
+    return Date.now() - new Date(entry.updatedAt).getTime() > DISCOVERY_TTL_MS;
+  }
   /**
    * Update only the discovery portion of the cache, preserving selection.
+   * Optionally persists the associated GitLab project.
    */
-  saveDiscovery(discovery) {
+  saveDiscovery(discovery, project) {
     const existing = this.load();
     this.save({
       discovery,
+      project: project !== void 0 ? project : existing?.project ?? null,
       selectedModelRef: existing?.selectedModelRef ?? null,
       selectedModelName: existing?.selectedModelName ?? null,
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -2809,13 +2820,22 @@ var GitLabModelCache = class {
   }
   /**
    * Update only the selected model, preserving the discovery data.
+   * If name is null but ref is provided, attempts to resolve the name
+   * from the cached discovery data.
    */
   saveSelection(ref, name) {
     const existing = this.load();
+    let resolved = name;
+    if (!resolved && ref && existing?.discovery) {
+      const d = existing.discovery;
+      const match = d.pinnedModel?.ref === ref ? d.pinnedModel : d.selectableModels.find((m) => m.ref === ref) ?? (d.defaultModel?.ref === ref ? d.defaultModel : null);
+      resolved = match?.name ?? null;
+    }
     this.save({
       discovery: existing?.discovery ?? null,
+      project: existing?.project ?? null,
       selectedModelRef: ref,
-      selectedModelName: name,
+      selectedModelName: resolved,
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     });
   }
@@ -2957,7 +2977,8 @@ var GitLabWorkflowLanguageModel = class _GitLabWorkflowLanguageModel {
    */
   set selectedModelRef(ref) {
     this._selectedModelRef = ref ?? void 0;
-    this.modelCache.saveSelection(ref, this._selectedModelName ?? null);
+    this._selectedModelName = void 0;
+    this.modelCache.saveSelection(ref, null);
   }
   /**
    * Get the cached selected model display name.
@@ -4497,29 +4518,8 @@ function parseModelsYml(text) {
 
 // src/gitlab-workflow-discovery.ts
 var configRegistry = new GitLabModelConfigRegistry();
-async function discoverWorkflowModels(config, options) {
-  const detector = new GitLabProjectDetector({
-    instanceUrl: config.instanceUrl,
-    getHeaders: config.getHeaders,
-    fetch: config.fetch
-  });
-  let project = null;
-  try {
-    project = await detector.detectProject(options.workingDirectory);
-  } catch {
-    return { models: [], project: null };
-  }
-  const namespaceId = project?.namespaceId;
-  if (!namespaceId) return { models: [], project };
-  const discovery = new GitLabModelDiscovery({
-    instanceUrl: config.instanceUrl,
-    getHeaders: config.getHeaders,
-    fetch: config.fetch
-  });
-  const [discovered, configs] = await Promise.all([
-    discovery.discover(`gid://gitlab/Group/${namespaceId}`),
-    configRegistry.getConfigs()
-  ]);
+async function buildModels(discovered, project) {
+  const configs = await configRegistry.getConfigs();
   const refToID = /* @__PURE__ */ new Map();
   for (const [id, mapping] of Object.entries(MODEL_MAPPINGS)) {
     if (mapping.provider === "workflow" && id !== "duo-workflow" && id !== "duo-workflow-default") {
@@ -4548,6 +4548,34 @@ async function discoverWorkflowModels(config, options) {
   }
   return { models, project };
 }
+async function discoverWorkflowModels(config, options) {
+  const cache = new GitLabModelCache(options.workingDirectory, config.instanceUrl);
+  if (!cache.isDiscoveryExpired()) {
+    const entry = cache.load();
+    return buildModels(entry.discovery, entry.project);
+  }
+  const detector = new GitLabProjectDetector({
+    instanceUrl: config.instanceUrl,
+    getHeaders: config.getHeaders,
+    fetch: config.fetch
+  });
+  let project = null;
+  try {
+    project = await detector.detectProject(options.workingDirectory);
+  } catch {
+    return { models: [], project: null };
+  }
+  const namespaceId = project?.namespaceId;
+  if (!namespaceId) return { models: [], project };
+  const discovery = new GitLabModelDiscovery({
+    instanceUrl: config.instanceUrl,
+    getHeaders: config.getHeaders,
+    fetch: config.fetch
+  });
+  const discovered = await discovery.discover(`gid://gitlab/Group/${namespaceId}`);
+  cache.saveDiscovery(discovered, project);
+  return buildModels(discovered, project);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AGENT_PRIVILEGES,