wave-agent-sdk 0.17.4 → 0.17.5

package/dist/services/MarketplaceService.d.ts

@@ -33,6 +33,15 @@ export declare class MarketplaceService {
      * to user-level settings if they aren't already declared there.
      */
     private runMigration;
+    /**
+     * Seeds the builtin marketplace on first startup.
+     * Adds it to user-scope settings and marks the cache as seeded.
+     */
+    private seedBuiltinMarketplace;
+    /**
+     * Sets the builtinSeeded flag in the cache registry, preserving all other fields.
+     */
+    private setBuiltinSeeded;
     /**
      * Check if a lock file is stale by reading its PID and checking if the process is alive.
      * Returns true if the lock is stale and safe to remove.
@@ -97,6 +106,12 @@ export declare class MarketplaceService {
      * Removes a marketplace by name from the specified scope
      */
     removeMarketplace(name: string, scope?: Scope): Promise<void>;
+    /**
+     * Uninstalls all plugins belonging to a given marketplace.
+     * Removes them from installed_plugins.json, deletes cache files,
+     * and cleans up enabledPlugins entries from all scopes.
+     */
+    private uninstallPluginsByMarketplace;
     /**
      * Updates a specific marketplace or all marketplaces
      */

package/dist/services/MarketplaceService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarketplaceService.d.ts","sourceRoot":"","sources":["../../src/services/MarketplaceService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MarketplaceService.d.ts","sourceRoot":"","sources":["../../src/services/MarketplaceService.ts"],"names":[],"mappings":"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"}

package/dist/services/MarketplaceService.js

@@ -28,6 +28,9 @@ export class MarketplaceService {
         this.gitService = new GitService();
         this.ensureDirectoryStructure();
         this.runMigration();
+        // Stored dynamically to avoid widening keyof MarketplaceService
+        this._seedComplete =
+            this.seedBuiltinMarketplace();
     }
     /**
      * Ensures the required directory structure exists in ~/.wave/plugins
@@ -65,6 +68,46 @@ export class MarketplaceService {
             // Migration failure should not block startup
         }
     }
+    /**
+     * Seeds the builtin marketplace on first startup.
+     * Adds it to user-scope settings and marks the cache as seeded.
+     */
+    async seedBuiltinMarketplace() {
+        try {
+            const cache = await this.getCacheRegistry();
+            if (cache?.builtinSeeded)
+                return;
+            const builtin = MarketplaceService.BUILTIN_MARKETPLACE;
+            // Add to user-scope settings if not already in any scope
+            const scoped = this.configurationService.getMergedMarketplaces(this.workdir);
+            if (!scoped[builtin.name]) {
+                await this.configurationService.addMarketplaceToScope(this.workdir, "user", builtin.name, { source: builtin.source, autoUpdate: builtin.autoUpdate });
+            }
+            // Update cache: add entry + set builtinSeeded flag
+            await this.updateCacheMarketplace(builtin.name, {
+                source: builtin.source,
+                autoUpdate: builtin.autoUpdate,
+                isBuiltin: true,
+                declaredScope: "builtin",
+            });
+            await this.setBuiltinSeeded(true);
+        }
+        catch {
+            // Seeding failure should not block startup
+        }
+    }
+    /**
+     * Sets the builtinSeeded flag in the cache registry, preserving all other fields.
+     */
+    async setBuiltinSeeded(value) {
+        const registry = await this.getCacheRegistry();
+        const tmpPath = `${this.knownMarketplacesPath}.tmp`;
+        await fs.writeFile(tmpPath, JSON.stringify({
+            builtinSeeded: value,
+            marketplaces: registry?.marketplaces ?? [],
+        }, null, 2));
+        await fs.rename(tmpPath, this.knownMarketplacesPath);
+    }
     /**
      * Check if a lock file is stale by reading its PID and checking if the process is alive.
      * Returns true if the lock is stale and safe to remove.
@@ -192,7 +235,10 @@ export class MarketplaceService {
             });
         }
         const tmpPath = `${this.knownMarketplacesPath}.tmp`;
-        await fs.writeFile(tmpPath, JSON.stringify({ marketplaces }, null, 2));
+        await fs.writeFile(tmpPath, JSON.stringify({
+            builtinSeeded: registry?.builtinSeeded ?? false,
+            marketplaces,
+        }, null, 2));
         await fs.rename(tmpPath, this.knownMarketplacesPath);
     }
     /**
@@ -203,7 +249,10 @@ export class MarketplaceService {
         const marketplaces = registry?.marketplaces ?? [];
         const filtered = marketplaces.filter((m) => m.name !== name);
         const tmpPath = `${this.knownMarketplacesPath}.tmp`;
-        await fs.writeFile(tmpPath, JSON.stringify({ marketplaces: filtered }, null, 2));
+        await fs.writeFile(tmpPath, JSON.stringify({
+            builtinSeeded: registry?.builtinSeeded ?? false,
+            marketplaces: filtered,
+        }, null, 2));
         await fs.rename(tmpPath, this.knownMarketplacesPath);
     }
     /**
@@ -402,6 +451,8 @@ export class MarketplaceService {
     async removeMarketplace(name, scope) {
         return this.withLock(async () => {
             const targetScope = scope || this.getMarketplaceDeclaringSource(name) || "user";
+            // Uninstall all plugins from this marketplace
+            await this.uninstallPluginsByMarketplace(name);
             if (targetScope !== "builtin") {
                 await this.configurationService.removeMarketplaceFromScope(this.workdir, targetScope, name);
             }
@@ -409,6 +460,36 @@ export class MarketplaceService {
             await this.removeFromCache(name);
         });
     }
+    /**
+     * Uninstalls all plugins belonging to a given marketplace.
+     * Removes them from installed_plugins.json, deletes cache files,
+     * and cleans up enabledPlugins entries from all scopes.
+     */
+    async uninstallPluginsByMarketplace(marketplaceName) {
+        const installedRegistry = await this.getInstalledPlugins();
+        const pluginsFromMarketplace = installedRegistry.plugins.filter((p) => p.marketplace === marketplaceName);
+        if (pluginsFromMarketplace.length === 0)
+            return;
+        // Remove all plugins from this marketplace from the registry
+        installedRegistry.plugins = installedRegistry.plugins.filter((p) => p.marketplace !== marketplaceName);
+        await this.saveInstalledPlugins(installedRegistry);
+        // Delete cache files that are no longer referenced
+        const remainingCachePaths = new Set(installedRegistry.plugins.map((p) => p.cachePath));
+        for (const plugin of pluginsFromMarketplace) {
+            if (!remainingCachePaths.has(plugin.cachePath) &&
+                existsSync(plugin.cachePath)) {
+                await fs.rm(plugin.cachePath, { recursive: true, force: true });
+            }
+        }
+        // Remove enabledPlugins entries from all scopes
+        const scopes = ["user", "project", "local"];
+        for (const plugin of pluginsFromMarketplace) {
+            const pluginId = `${plugin.name}@${plugin.marketplace}`;
+            for (const s of scopes) {
+                await this.configurationService.removeEnabledPlugin(this.workdir, s, pluginId);
+            }
+        }
+    }
     /**
      * Updates a specific marketplace or all marketplaces
      */

package/dist/types/marketplace.d.ts

@@ -43,6 +43,7 @@ export interface KnownMarketplace {
     declaredScope?: "user" | "project" | "local" | "builtin";
 }
 export interface KnownMarketplacesRegistry {
+    builtinSeeded?: boolean;
     marketplaces: KnownMarketplace[];
 }
 export interface InstalledPlugin {

package/dist/types/marketplace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/types/marketplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/types/marketplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wave-agent-sdk",
-  "version": "0.17.4",
+  "version": "0.17.5",
   "description": "SDK for building AI-powered development tools and agents",
   "keywords": [
     "ai",

package/src/services/MarketplaceService.ts

@@ -68,6 +68,9 @@ export class MarketplaceService {
 
     this.ensureDirectoryStructure();
     this.runMigration();
+    // Stored dynamically to avoid widening keyof MarketplaceService
+    (this as Record<string, unknown>)._seedComplete =
+      this.seedBuiltinMarketplace();
   }
 
   /**
@@ -121,6 +124,63 @@ export class MarketplaceService {
     }
   }
 
+  /**
+   * Seeds the builtin marketplace on first startup.
+   * Adds it to user-scope settings and marks the cache as seeded.
+   */
+  private async seedBuiltinMarketplace(): Promise<void> {
+    try {
+      const cache = await this.getCacheRegistry();
+      if (cache?.builtinSeeded) return;
+
+      const builtin = MarketplaceService.BUILTIN_MARKETPLACE;
+
+      // Add to user-scope settings if not already in any scope
+      const scoped = this.configurationService.getMergedMarketplaces(
+        this.workdir,
+      );
+      if (!scoped[builtin.name]) {
+        await this.configurationService.addMarketplaceToScope(
+          this.workdir,
+          "user",
+          builtin.name,
+          { source: builtin.source, autoUpdate: builtin.autoUpdate },
+        );
+      }
+
+      // Update cache: add entry + set builtinSeeded flag
+      await this.updateCacheMarketplace(builtin.name, {
+        source: builtin.source,
+        autoUpdate: builtin.autoUpdate,
+        isBuiltin: true,
+        declaredScope: "builtin",
+      });
+      await this.setBuiltinSeeded(true);
+    } catch {
+      // Seeding failure should not block startup
+    }
+  }
+
+  /**
+   * Sets the builtinSeeded flag in the cache registry, preserving all other fields.
+   */
+  private async setBuiltinSeeded(value: boolean): Promise<void> {
+    const registry = await this.getCacheRegistry();
+    const tmpPath = `${this.knownMarketplacesPath}.tmp`;
+    await fs.writeFile(
+      tmpPath,
+      JSON.stringify(
+        {
+          builtinSeeded: value,
+          marketplaces: registry?.marketplaces ?? [],
+        },
+        null,
+        2,
+      ),
+    );
+    await fs.rename(tmpPath, this.knownMarketplacesPath);
+  }
+
   /**
    * Check if a lock file is stale by reading its PID and checking if the process is alive.
    * Returns true if the lock is stale and safe to remove.
@@ -258,7 +318,17 @@ export class MarketplaceService {
       });
     }
     const tmpPath = `${this.knownMarketplacesPath}.tmp`;
-    await fs.writeFile(tmpPath, JSON.stringify({ marketplaces }, null, 2));
+    await fs.writeFile(
+      tmpPath,
+      JSON.stringify(
+        {
+          builtinSeeded: registry?.builtinSeeded ?? false,
+          marketplaces,
+        },
+        null,
+        2,
+      ),
+    );
     await fs.rename(tmpPath, this.knownMarketplacesPath);
   }
 
@@ -272,7 +342,14 @@ export class MarketplaceService {
     const tmpPath = `${this.knownMarketplacesPath}.tmp`;
     await fs.writeFile(
       tmpPath,
-      JSON.stringify({ marketplaces: filtered }, null, 2),
+      JSON.stringify(
+        {
+          builtinSeeded: registry?.builtinSeeded ?? false,
+          marketplaces: filtered,
+        },
+        null,
+        2,
+      ),
     );
     await fs.rename(tmpPath, this.knownMarketplacesPath);
   }
@@ -536,6 +613,9 @@ export class MarketplaceService {
       const targetScope =
         scope || this.getMarketplaceDeclaringSource(name) || "user";
 
+      // Uninstall all plugins from this marketplace
+      await this.uninstallPluginsByMarketplace(name);
+
       if (targetScope !== "builtin") {
         await this.configurationService.removeMarketplaceFromScope(
           this.workdir,
@@ -549,6 +629,54 @@ export class MarketplaceService {
     });
   }
 
+  /**
+   * Uninstalls all plugins belonging to a given marketplace.
+   * Removes them from installed_plugins.json, deletes cache files,
+   * and cleans up enabledPlugins entries from all scopes.
+   */
+  private async uninstallPluginsByMarketplace(
+    marketplaceName: string,
+  ): Promise<void> {
+    const installedRegistry = await this.getInstalledPlugins();
+    const pluginsFromMarketplace = installedRegistry.plugins.filter(
+      (p) => p.marketplace === marketplaceName,
+    );
+
+    if (pluginsFromMarketplace.length === 0) return;
+
+    // Remove all plugins from this marketplace from the registry
+    installedRegistry.plugins = installedRegistry.plugins.filter(
+      (p) => p.marketplace !== marketplaceName,
+    );
+    await this.saveInstalledPlugins(installedRegistry);
+
+    // Delete cache files that are no longer referenced
+    const remainingCachePaths = new Set(
+      installedRegistry.plugins.map((p) => p.cachePath),
+    );
+    for (const plugin of pluginsFromMarketplace) {
+      if (
+        !remainingCachePaths.has(plugin.cachePath) &&
+        existsSync(plugin.cachePath)
+      ) {
+        await fs.rm(plugin.cachePath, { recursive: true, force: true });
+      }
+    }
+
+    // Remove enabledPlugins entries from all scopes
+    const scopes: Scope[] = ["user", "project", "local"];
+    for (const plugin of pluginsFromMarketplace) {
+      const pluginId = `${plugin.name}@${plugin.marketplace}`;
+      for (const s of scopes) {
+        await this.configurationService.removeEnabledPlugin(
+          this.workdir,
+          s,
+          pluginId,
+        );
+      }
+    }
+  }
+
   /**
    * Updates a specific marketplace or all marketplaces
    */

package/src/types/marketplace.ts

@@ -53,6 +53,7 @@ export interface KnownMarketplace {
 }
 
 export interface KnownMarketplacesRegistry {
+  builtinSeeded?: boolean;
   marketplaces: KnownMarketplace[];
 }