@mastra/pinecone 0.2.13-alpha.4 → 0.2.14-alpha.0

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/pinecone@0.2.13-alpha.4 build /home/runner/work/mastra/mastra/stores/pinecone
+> @mastra/pinecone@0.2.14-alpha.0 build /home/runner/work/mastra/mastra/stores/pinecone
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 TSC Build start
-TSC ⚡️ Build success in 6109ms
+TSC ⚡️ Build success in 6087ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/pinecone/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/pinecone/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 8932ms
+DTS ⚡️ Build success in 8467ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 14.09 KB
-ESM ⚡️ Build success in 548ms
-CJS dist/index.cjs 14.15 KB
-CJS ⚡️ Build success in 548ms
+CJS dist/index.cjs 15.44 KB
+CJS ⚡️ Build success in 493ms
+ESM dist/index.js 15.38 KB
+ESM ⚡️ Build success in 494ms

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @mastra/pinecone
 
+## 0.2.14-alpha.0
+
+### Patch Changes
+
+- d0ee3c6: Change all public functions and constructors in vector stores to use named args and prepare to phase out positional args
+- Updated dependencies [f53a6ac]
+- Updated dependencies [eabdcd9]
+- Updated dependencies [90be034]
+- Updated dependencies [99f050a]
+- Updated dependencies [d0ee3c6]
+- Updated dependencies [23f258c]
+- Updated dependencies [2672a05]
+  - @mastra/core@0.9.5-alpha.0
+
+## 0.2.13
+
+### Patch Changes
+
+- c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
+- Updated dependencies [396be50]
+- Updated dependencies [ab80e7e]
+- Updated dependencies [c3bd795]
+- Updated dependencies [da082f8]
+- Updated dependencies [a5810ce]
+- Updated dependencies [3e9c131]
+- Updated dependencies [3171b5b]
+- Updated dependencies [973e5ac]
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+- Updated dependencies [9e1eff5]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4
+
 ## 0.2.13-alpha.4
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -1,5 +1,9 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
+import type { DeleteIndexParams } from '@mastra/core/vector';
+import type { DeleteVectorArgs } from '@mastra/core/vector';
+import type { DeleteVectorParams } from '@mastra/core/vector';
+import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { IndexStats } from '@mastra/core/vector';
 import type { IndexStatsDescription } from '@pinecone-database/pinecone';
 import { MastraVector } from '@mastra/core/vector';
@@ -9,6 +13,8 @@ import type { QueryResult } from '@mastra/core/vector';
 import type { QueryVectorArgs } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
 import type { RecordSparseValues } from '@pinecone-database/pinecone';
+import type { UpdateVectorArgs } from '@mastra/core/vector';
+import type { UpdateVectorParams } from '@mastra/core/vector';
 import type { UpsertVectorArgs } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
@@ -21,6 +27,12 @@ declare const PINECONE_PROMPT = "When querying Pinecone, you can ONLY use the op
 export { PINECONE_PROMPT }
 export { PINECONE_PROMPT as PINECONE_PROMPT_alias_1 }
 
+declare type PineconeDeleteVectorArgs = [...DeleteVectorArgs, string?];
+
+declare interface PineconeDeleteVectorParams extends DeleteVectorParams {
+    namespace?: string;
+}
+
 export declare class PineconeFilterTranslator extends BaseFilterTranslator {
     protected getSupportedOperators(): OperatorSupport;
     translate(filter?: VectorFilter): VectorFilter;
@@ -39,6 +51,12 @@ declare interface PineconeQueryVectorParams extends QueryVectorParams {
     sparseVector?: RecordSparseValues;
 }
 
+declare type PineconeUpdateVectorArgs = [...UpdateVectorArgs, string?];
+
+declare interface PineconeUpdateVectorParams extends UpdateVectorParams {
+    namespace?: string;
+}
+
 declare type PineconeUpsertVectorArgs = [...UpsertVectorArgs, string?, RecordSparseValues[]?];
 
 declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
@@ -48,15 +66,34 @@ declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
 
 declare class PineconeVector extends MastraVector {
     private client;
+    /**
+     * @deprecated Passing apiKey and environment as positional arguments is deprecated.
+     * Use the object parameter instead. This signature will be removed on May 20th, 2025.
+     */
     constructor(apiKey: string, environment?: string);
+    /**
+     * Creates a new PineconeVector client.
+     * @param params - An object with apiKey and optional environment.
+     */
+    constructor(params: {
+        apiKey: string;
+        environment?: string;
+    });
     get indexSeparator(): string;
     createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
     upsert(...args: ParamsToArgs<PineconeUpsertVectorParams> | PineconeUpsertVectorArgs): Promise<string[]>;
     transformFilter(filter?: VectorFilter): VectorFilter;
     query(...args: ParamsToArgs<PineconeQueryVectorParams> | PineconeQueryVectorArgs): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<PineconeIndexStats>;
-    deleteIndex(indexName: string): Promise<void>;
+    /**
+     * Retrieves statistics about a vector index.
+     *
+     * @param params - The parameters for describing an index
+     * @param params.indexName - The name of the index to describe
+     * @returns A promise that resolves to the index statistics including dimension, count and metric
+     */
+    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<PineconeIndexStats>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     /**
      * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -85,10 +122,7 @@ declare class PineconeVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateVector(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }, namespace?: string): Promise<void>;
+    updateVector(...args: ParamsToArgs<PineconeUpdateVectorParams> | PineconeUpdateVectorArgs): Promise<void>;
     /**
      * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -108,7 +142,7 @@ declare class PineconeVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector(indexName: string, id: string, namespace?: string): Promise<void>;
+    deleteVector(...args: ParamsToArgs<PineconeDeleteVectorParams> | PineconeDeleteVectorArgs): Promise<void>;
 }
 export { PineconeVector }
 export { PineconeVector as PineconeVector_alias_1 }

package/dist/_tsup-dts-rollup.d.ts

@@ -1,5 +1,9 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
+import type { DeleteIndexParams } from '@mastra/core/vector';
+import type { DeleteVectorArgs } from '@mastra/core/vector';
+import type { DeleteVectorParams } from '@mastra/core/vector';
+import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { IndexStats } from '@mastra/core/vector';
 import type { IndexStatsDescription } from '@pinecone-database/pinecone';
 import { MastraVector } from '@mastra/core/vector';
@@ -9,6 +13,8 @@ import type { QueryResult } from '@mastra/core/vector';
 import type { QueryVectorArgs } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
 import type { RecordSparseValues } from '@pinecone-database/pinecone';
+import type { UpdateVectorArgs } from '@mastra/core/vector';
+import type { UpdateVectorParams } from '@mastra/core/vector';
 import type { UpsertVectorArgs } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
@@ -21,6 +27,12 @@ declare const PINECONE_PROMPT = "When querying Pinecone, you can ONLY use the op
 export { PINECONE_PROMPT }
 export { PINECONE_PROMPT as PINECONE_PROMPT_alias_1 }
 
+declare type PineconeDeleteVectorArgs = [...DeleteVectorArgs, string?];
+
+declare interface PineconeDeleteVectorParams extends DeleteVectorParams {
+    namespace?: string;
+}
+
 export declare class PineconeFilterTranslator extends BaseFilterTranslator {
     protected getSupportedOperators(): OperatorSupport;
     translate(filter?: VectorFilter): VectorFilter;
@@ -39,6 +51,12 @@ declare interface PineconeQueryVectorParams extends QueryVectorParams {
     sparseVector?: RecordSparseValues;
 }
 
+declare type PineconeUpdateVectorArgs = [...UpdateVectorArgs, string?];
+
+declare interface PineconeUpdateVectorParams extends UpdateVectorParams {
+    namespace?: string;
+}
+
 declare type PineconeUpsertVectorArgs = [...UpsertVectorArgs, string?, RecordSparseValues[]?];
 
 declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
@@ -48,15 +66,34 @@ declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
 
 declare class PineconeVector extends MastraVector {
     private client;
+    /**
+     * @deprecated Passing apiKey and environment as positional arguments is deprecated.
+     * Use the object parameter instead. This signature will be removed on May 20th, 2025.
+     */
     constructor(apiKey: string, environment?: string);
+    /**
+     * Creates a new PineconeVector client.
+     * @param params - An object with apiKey and optional environment.
+     */
+    constructor(params: {
+        apiKey: string;
+        environment?: string;
+    });
     get indexSeparator(): string;
     createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
     upsert(...args: ParamsToArgs<PineconeUpsertVectorParams> | PineconeUpsertVectorArgs): Promise<string[]>;
     transformFilter(filter?: VectorFilter): VectorFilter;
     query(...args: ParamsToArgs<PineconeQueryVectorParams> | PineconeQueryVectorArgs): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<PineconeIndexStats>;
-    deleteIndex(indexName: string): Promise<void>;
+    /**
+     * Retrieves statistics about a vector index.
+     *
+     * @param params - The parameters for describing an index
+     * @param params.indexName - The name of the index to describe
+     * @returns A promise that resolves to the index statistics including dimension, count and metric
+     */
+    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<PineconeIndexStats>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     /**
      * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -85,10 +122,7 @@ declare class PineconeVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateVector(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }, namespace?: string): Promise<void>;
+    updateVector(...args: ParamsToArgs<PineconeUpdateVectorParams> | PineconeUpdateVectorArgs): Promise<void>;
     /**
      * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -108,7 +142,7 @@ declare class PineconeVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector(indexName: string, id: string, namespace?: string): Promise<void>;
+    deleteVector(...args: ParamsToArgs<PineconeDeleteVectorParams> | PineconeDeleteVectorArgs): Promise<void>;
 }
 export { PineconeVector }
 export { PineconeVector as PineconeVector_alias_1 }

package/dist/index.cjs

@@ -85,11 +85,28 @@ var PineconeFilterTranslator = class extends filter.BaseFilterTranslator {
 // src/vector/index.ts
 var PineconeVector = class extends vector.MastraVector {
   client;
-  constructor(apiKey, environment) {
+  constructor(paramsOrApiKey, environment) {
     super();
+    let apiKey;
+    let env;
+    if (typeof paramsOrApiKey === "string") {
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          `Deprecation Warning: Passing apiKey and environment as positional arguments to PineconeVector constructor is deprecated.
+Please use an object parameter instead:
+  new PineconeVector({ apiKey, environment })
+This signature will be removed on May 20th, 2025.`
+        );
+      }
+      apiKey = paramsOrApiKey;
+      env = environment;
+    } else {
+      apiKey = paramsOrApiKey.apiKey;
+      env = paramsOrApiKey.environment;
+    }
     const opts = { apiKey };
-    if (environment) {
-      opts["controllerHostUrl"] = environment;
+    if (env) {
+      opts["controllerHostUrl"] = env;
     }
     const baseClient = new pinecone.Pinecone(opts);
     const telemetry = this.__getTelemetry();
@@ -188,7 +205,16 @@ var PineconeVector = class extends vector.MastraVector {
     const indexesResult = await this.client.listIndexes();
     return indexesResult?.indexes?.map((index) => index.name) || [];
   }
-  async describeIndex(indexName) {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @param params - The parameters for describing an index
+   * @param params.indexName - The name of the index to describe
+   * @returns A promise that resolves to the index statistics including dimension, count and metric
+   */
+  async describeIndex(...args) {
+    const params = this.normalizeArgs("describeIndex", args);
+    const { indexName } = params;
     const index = this.client.Index(indexName);
     const stats = await index.describeIndexStats();
     const description = await this.client.describeIndex(indexName);
@@ -199,7 +225,9 @@ var PineconeVector = class extends vector.MastraVector {
       namespaces: stats.namespaces
     };
   }
-  async deleteIndex(indexName) {
+  async deleteIndex(...args) {
+    const params = this.normalizeArgs("deleteIndex", args);
+    const { indexName } = params;
     try {
       await this.client.deleteIndex(indexName);
     } catch (error) {
@@ -225,7 +253,7 @@ var PineconeVector = class extends vector.MastraVector {
       Please use updateVector() instead. 
       updateIndexById() will be removed on May 20th, 2025.`
     );
-    await this.updateVector(indexName, id, update, namespace);
+    await this.updateVector({ indexName, id, update, namespace });
   }
   /**
    * Updates a vector by its ID with the provided vector and/or metadata.
@@ -238,7 +266,11 @@ var PineconeVector = class extends vector.MastraVector {
    * @returns A promise that resolves when the update is complete.
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
-  async updateVector(indexName, id, update, namespace) {
+  async updateVector(...args) {
+    const params = this.normalizeArgs("updateVector", args, [
+      "namespace"
+    ]);
+    const { indexName, id, update, namespace } = params;
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No updates provided");
@@ -272,7 +304,7 @@ var PineconeVector = class extends vector.MastraVector {
       Please use deleteVector() instead. 
       deleteIndexById() will be removed on May 20th, 2025.`
     );
-    await this.deleteVector(indexName, id, namespace);
+    await this.deleteVector({ indexName, id, namespace });
   }
   /**
    * Deletes a vector by its ID.
@@ -282,7 +314,11 @@ var PineconeVector = class extends vector.MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(indexName, id, namespace) {
+  async deleteVector(...args) {
+    const params = this.normalizeArgs("deleteVector", args, [
+      "namespace"
+    ]);
+    const { indexName, id, namespace } = params;
     try {
       const index = this.client.Index(indexName).namespace(namespace || "");
       await index.deleteOne(id);

package/dist/index.js

@@ -83,11 +83,28 @@ var PineconeFilterTranslator = class extends BaseFilterTranslator {
 // src/vector/index.ts
 var PineconeVector = class extends MastraVector {
   client;
-  constructor(apiKey, environment) {
+  constructor(paramsOrApiKey, environment) {
     super();
+    let apiKey;
+    let env;
+    if (typeof paramsOrApiKey === "string") {
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          `Deprecation Warning: Passing apiKey and environment as positional arguments to PineconeVector constructor is deprecated.
+Please use an object parameter instead:
+  new PineconeVector({ apiKey, environment })
+This signature will be removed on May 20th, 2025.`
+        );
+      }
+      apiKey = paramsOrApiKey;
+      env = environment;
+    } else {
+      apiKey = paramsOrApiKey.apiKey;
+      env = paramsOrApiKey.environment;
+    }
     const opts = { apiKey };
-    if (environment) {
-      opts["controllerHostUrl"] = environment;
+    if (env) {
+      opts["controllerHostUrl"] = env;
     }
     const baseClient = new Pinecone(opts);
     const telemetry = this.__getTelemetry();
@@ -186,7 +203,16 @@ var PineconeVector = class extends MastraVector {
     const indexesResult = await this.client.listIndexes();
     return indexesResult?.indexes?.map((index) => index.name) || [];
   }
-  async describeIndex(indexName) {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @param params - The parameters for describing an index
+   * @param params.indexName - The name of the index to describe
+   * @returns A promise that resolves to the index statistics including dimension, count and metric
+   */
+  async describeIndex(...args) {
+    const params = this.normalizeArgs("describeIndex", args);
+    const { indexName } = params;
     const index = this.client.Index(indexName);
     const stats = await index.describeIndexStats();
     const description = await this.client.describeIndex(indexName);
@@ -197,7 +223,9 @@ var PineconeVector = class extends MastraVector {
       namespaces: stats.namespaces
     };
   }
-  async deleteIndex(indexName) {
+  async deleteIndex(...args) {
+    const params = this.normalizeArgs("deleteIndex", args);
+    const { indexName } = params;
     try {
       await this.client.deleteIndex(indexName);
     } catch (error) {
@@ -223,7 +251,7 @@ var PineconeVector = class extends MastraVector {
       Please use updateVector() instead. 
       updateIndexById() will be removed on May 20th, 2025.`
     );
-    await this.updateVector(indexName, id, update, namespace);
+    await this.updateVector({ indexName, id, update, namespace });
   }
   /**
    * Updates a vector by its ID with the provided vector and/or metadata.
@@ -236,7 +264,11 @@ var PineconeVector = class extends MastraVector {
    * @returns A promise that resolves when the update is complete.
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
-  async updateVector(indexName, id, update, namespace) {
+  async updateVector(...args) {
+    const params = this.normalizeArgs("updateVector", args, [
+      "namespace"
+    ]);
+    const { indexName, id, update, namespace } = params;
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No updates provided");
@@ -270,7 +302,7 @@ var PineconeVector = class extends MastraVector {
       Please use deleteVector() instead. 
       deleteIndexById() will be removed on May 20th, 2025.`
     );
-    await this.deleteVector(indexName, id, namespace);
+    await this.deleteVector({ indexName, id, namespace });
   }
   /**
    * Deletes a vector by its ID.
@@ -280,7 +312,11 @@ var PineconeVector = class extends MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(indexName, id, namespace) {
+  async deleteVector(...args) {
+    const params = this.normalizeArgs("deleteVector", args, [
+      "namespace"
+    ]);
+    const { indexName, id, namespace } = params;
     try {
       const index = this.client.Index(indexName).namespace(namespace || "");
       await index.deleteOne(id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/pinecone",
-  "version": "0.2.13-alpha.4",
+  "version": "0.2.14-alpha.0",
   "description": "Pinecone vector store provider for Mastra",
   "type": "module",
   "main": "dist/index.js",
@@ -21,7 +21,7 @@
   "license": "MIT",
   "dependencies": {
     "@pinecone-database/pinecone": "^3.0.3",
-    "@mastra/core": "^0.9.4-alpha.4"
+    "@mastra/core": "^0.9.5-alpha.0"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",
@@ -31,7 +31,7 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
     "vitest": "^3.1.2",
-    "@internal/lint": "0.0.4"
+    "@internal/lint": "0.0.5"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",

package/src/vector/index.test.ts

@@ -36,7 +36,7 @@ function waitUntilReady(vectorDB: PineconeVector, indexName: string) {
   return new Promise(resolve => {
     const interval = setInterval(async () => {
       try {
-        const stats = await vectorDB.describeIndex(indexName);
+        const stats = await vectorDB.describeIndex({ indexName });
         if (!!stats) {
           clearInterval(interval);
           resolve(true);
@@ -86,7 +86,7 @@ function waitUntilVectorsIndexed(
 
     const interval = setInterval(async () => {
       try {
-        const stats = await vectorDB.describeIndex(indexName);
+        const stats = await vectorDB.describeIndex({ indexName });
         const check = exactCount ? stats?.count === expectedCount : stats?.count >= expectedCount;
         if (stats && check) {
           if (stats.count === lastCount) {
@@ -122,34 +122,36 @@ describe.skip('PineconeVector Integration Tests', () => {
   const dimension = 3;
 
   beforeAll(async () => {
-    vectorDB = new PineconeVector(PINECONE_API_KEY);
+    vectorDB = new PineconeVector({
+      apiKey: PINECONE_API_KEY,
+    });
     // Delete test index
     try {
-      await vectorDB.deleteIndex(testIndexName);
+      await vectorDB.deleteIndex({ indexName: testIndexName });
       await waitUntilIndexDeleted(vectorDB, testIndexName);
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameUpdate);
+      await vectorDB.deleteIndex({ indexName: indexNameUpdate });
       await waitUntilIndexDeleted(vectorDB, indexNameUpdate);
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameDelete);
+      await vectorDB.deleteIndex({ indexName: indexNameDelete });
       await waitUntilIndexDeleted(vectorDB, indexNameDelete);
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameNamespace);
+      await vectorDB.deleteIndex({ indexName: indexNameNamespace });
       await waitUntilIndexDeleted(vectorDB, indexNameNamespace);
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameHybrid);
+      await vectorDB.deleteIndex({ indexName: indexNameHybrid });
       await waitUntilIndexDeleted(vectorDB, indexNameHybrid);
     } catch {
       // Ignore errors if index doesn't exist
@@ -162,27 +164,27 @@ describe.skip('PineconeVector Integration Tests', () => {
   afterAll(async () => {
     // Cleanup: delete test index
     try {
-      await vectorDB.deleteIndex(testIndexName);
+      await vectorDB.deleteIndex({ indexName: testIndexName });
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameUpdate);
+      await vectorDB.deleteIndex({ indexName: indexNameUpdate });
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameDelete);
+      await vectorDB.deleteIndex({ indexName: indexNameDelete });
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameNamespace);
+      await vectorDB.deleteIndex({ indexName: indexNameNamespace });
     } catch {
       // Ignore errors if index doesn't exist
     }
     try {
-      await vectorDB.deleteIndex(indexNameHybrid);
+      await vectorDB.deleteIndex({ indexName: indexNameHybrid });
     } catch {
       // Ignore errors if index doesn't exist
     }
@@ -195,7 +197,7 @@ describe.skip('PineconeVector Integration Tests', () => {
     }, 500000);
 
     it('should describe index with correct properties', async () => {
-      const stats = await vectorDB.describeIndex(testIndexName);
+      const stats = await vectorDB.describeIndex({ indexName: testIndexName });
       expect(stats.dimension).toBe(dimension);
       expect(stats.metric).toBe('cosine');
       expect(typeof stats.count).toBe('number');
@@ -260,7 +262,7 @@ describe.skip('PineconeVector Integration Tests', () => {
 
       afterEach(async () => {
         try {
-          await vectorDB.deleteIndex(indexNameUpdate);
+          await vectorDB.deleteIndex({ indexName: indexNameUpdate });
           await waitUntilIndexDeleted(vectorDB, indexNameUpdate);
         } catch {
           // Ignore errors if index doesn't exist
@@ -282,7 +284,7 @@ describe.skip('PineconeVector Integration Tests', () => {
           metadata: newMetaData,
         };
 
-        await vectorDB.updateVector(indexNameUpdate, idToBeUpdated, update);
+        await vectorDB.updateVector({ indexName: indexNameUpdate, id: idToBeUpdated, update });
 
         await waitUntilVectorsIndexed(vectorDB, indexNameUpdate, 3);
 
@@ -311,7 +313,7 @@ describe.skip('PineconeVector Integration Tests', () => {
           metadata: newMetaData,
         };
 
-        await vectorDB.updateVector(indexNameUpdate, idToBeUpdated, update);
+        await vectorDB.updateVector({ indexName: indexNameUpdate, id: idToBeUpdated, update });
 
         await waitUntilVectorsIndexed(vectorDB, indexNameUpdate, 3);
 
@@ -338,7 +340,7 @@ describe.skip('PineconeVector Integration Tests', () => {
           vector: newVector,
         };
 
-        await vectorDB.updateVector(indexNameUpdate, idToBeUpdated, update);
+        await vectorDB.updateVector({ indexName: indexNameUpdate, id: idToBeUpdated, update });
 
         await waitUntilVectorsIndexed(vectorDB, indexNameUpdate, 3);
 
@@ -355,12 +357,16 @@ describe.skip('PineconeVector Integration Tests', () => {
       }, 500000);
 
       it('should throw exception when no updates are given', async () => {
-        await expect(vectorDB.updateVector(indexNameUpdate, 'id', {})).rejects.toThrow('No updates provided');
+        await expect(vectorDB.updateVector({ indexName: indexNameUpdate, id: 'id', update: {} })).rejects.toThrow(
+          'No updates provided',
+        );
       });
 
       it('should throw error for non-existent index', async () => {
         const nonExistentIndex = 'non-existent-index';
-        await expect(vectorDB.updateVector(nonExistentIndex, 'test-id', { vector: [1, 2, 3] })).rejects.toThrow();
+        await expect(
+          vectorDB.updateVector({ indexName: nonExistentIndex, id: 'test-id', update: { vector: [1, 2, 3] } }),
+        ).rejects.toThrow();
       });
 
       it('should throw error for invalid vector dimension', async () => {
@@ -371,7 +377,7 @@ describe.skip('PineconeVector Integration Tests', () => {
         });
 
         await expect(
-          vectorDB.updateVector(indexNameUpdate, id, { vector: [1, 2] }), // Wrong dimension
+          vectorDB.updateVector({ indexName: indexNameUpdate, id, update: { vector: [1, 2] } }), // Wrong dimension
         ).rejects.toThrow();
       }, 500000);
     });
@@ -390,7 +396,7 @@ describe.skip('PineconeVector Integration Tests', () => {
 
       afterEach(async () => {
         try {
-          await vectorDB.deleteIndex(indexNameDelete);
+          await vectorDB.deleteIndex({ indexName: indexNameDelete });
           await waitUntilIndexDeleted(vectorDB, indexNameDelete);
         } catch {
           // Ignore errors if index doesn't exist
@@ -402,7 +408,7 @@ describe.skip('PineconeVector Integration Tests', () => {
         expect(ids).toHaveLength(3);
         const idToBeDeleted = ids[0];
 
-        await vectorDB.deleteVector(indexNameDelete, idToBeDeleted);
+        await vectorDB.deleteVector({ indexName: indexNameDelete, id: idToBeDeleted });
         await waitUntilVectorsIndexed(vectorDB, indexNameDelete, 2, true);
 
         // Query all vectors similar to the deleted one
@@ -432,7 +438,7 @@ describe.skip('PineconeVector Integration Tests', () => {
 
     afterEach(async () => {
       try {
-        await vectorDB.deleteIndex(indexNameNamespace);
+        await vectorDB.deleteIndex({ indexName: indexNameNamespace });
         await waitUntilIndexDeleted(vectorDB, indexNameNamespace);
       } catch {
         // Ignore errors if index doesn't exist
@@ -490,7 +496,12 @@ describe.skip('PineconeVector Integration Tests', () => {
       await waitUntilVectorsIndexed(vectorDB, indexNameNamespace, 1);
 
       // Update in namespace1
-      await vectorDB.updateVector(indexNameNamespace, id, { metadata: { label: 'updated' } }, namespace1);
+      await vectorDB.updateVector({
+        indexName: indexNameNamespace,
+        id,
+        update: { metadata: { label: 'updated' } },
+        namespace: namespace1,
+      });
 
       await waitUntilVectorsIndexed(vectorDB, indexNameNamespace, 1);
 
@@ -515,7 +526,7 @@ describe.skip('PineconeVector Integration Tests', () => {
       await waitUntilVectorsIndexed(vectorDB, indexNameNamespace, 1);
 
       // Delete from namespace1
-      await vectorDB.deleteVector(indexNameNamespace, id, namespace1);
+      await vectorDB.deleteVector({ indexName: indexNameNamespace, id, namespace: namespace1 });
 
       await waitUntilVectorsIndexed(vectorDB, indexNameNamespace, 0, true);
 
@@ -545,7 +556,7 @@ describe.skip('PineconeVector Integration Tests', () => {
       });
       await waitUntilVectorsIndexed(vectorDB, indexNameNamespace, 2);
 
-      const stats = await vectorDB.describeIndex(indexNameNamespace);
+      const stats = await vectorDB.describeIndex({ indexName: indexNameNamespace });
       expect(stats.namespaces).toBeDefined();
       expect(stats.namespaces?.[namespace1]).toBeDefined();
       expect(stats.namespaces?.[namespace2]).toBeDefined();
@@ -561,7 +572,7 @@ describe.skip('PineconeVector Integration Tests', () => {
     });
 
     afterAll(async () => {
-      await vectorDB.deleteIndex(testIndexName);
+      await vectorDB.deleteIndex({ indexName: testIndexName });
     });
     it('should handle non-existent index query gracefully', async () => {
       const nonExistentIndex = 'non-existent-index';
@@ -623,7 +634,7 @@ describe.skip('PineconeVector Integration Tests', () => {
         infoSpy.mockRestore();
         warnSpy.mockRestore();
         // Cleanup
-        await vectorDB.deleteIndex(duplicateIndexName);
+        await vectorDB.deleteIndex({ indexName: duplicateIndexName });
       }
     });
   });
@@ -1402,7 +1413,7 @@ describe.skip('PineconeVector Integration Tests', () => {
 
     afterEach(async () => {
       try {
-        await vectorDB.deleteIndex(indexNameHybrid);
+        await vectorDB.deleteIndex({ indexName: indexNameHybrid });
         await waitUntilIndexDeleted(vectorDB, indexNameHybrid);
       } catch {
         // Ignore errors if index doesn't exist
@@ -1481,22 +1492,22 @@ describe.skip('PineconeVector Integration Tests', () => {
 
     beforeAll(async () => {
       try {
-        await vectorDB.deleteIndex(indexName);
+        await vectorDB.deleteIndex({ indexName });
       } catch {
         // Ignore errors if index doesn't exist
       }
       try {
-        await vectorDB.deleteIndex(indexName2);
+        await vectorDB.deleteIndex({ indexName: indexName2 });
       } catch {
         // Ignore errors if index doesn't exist
       }
       try {
-        await vectorDB.deleteIndex(indexName3);
+        await vectorDB.deleteIndex({ indexName: indexName3 });
       } catch {
         // Ignore errors if index doesn't exist
       }
       try {
-        await vectorDB.deleteIndex(indexName4);
+        await vectorDB.deleteIndex({ indexName: indexName4 });
       } catch {
         // Ignore errors if index doesn't exist
       }
@@ -1506,22 +1517,22 @@ describe.skip('PineconeVector Integration Tests', () => {
 
     afterAll(async () => {
       try {
-        await vectorDB.deleteIndex(indexName);
+        await vectorDB.deleteIndex({ indexName });
       } catch {
         // Ignore errors if index doesn't exist
       }
       try {
-        await vectorDB.deleteIndex(indexName2);
+        await vectorDB.deleteIndex({ indexName: indexName2 });
       } catch {
         // Ignore errors if index doesn't exist
       }
       try {
-        await vectorDB.deleteIndex(indexName3);
+        await vectorDB.deleteIndex({ indexName: indexName3 });
       } catch {
         // Ignore errors if index doesn't exist
       }
       try {
-        await vectorDB.deleteIndex(indexName4);
+        await vectorDB.deleteIndex({ indexName: indexName4 });
       } catch {
         // Ignore errors if index doesn't exist
       }

package/src/vector/index.ts

@@ -8,6 +8,12 @@ import type {
   ParamsToArgs,
   QueryVectorArgs,
   UpsertVectorArgs,
+  DescribeIndexParams,
+  DeleteIndexParams,
+  DeleteVectorParams,
+  DeleteVectorArgs,
+  UpdateVectorParams,
+  UpdateVectorArgs,
 } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 import { Pinecone } from '@pinecone-database/pinecone';
@@ -38,18 +44,52 @@ interface PineconeUpsertVectorParams extends UpsertVectorParams {
 
 type PineconeUpsertVectorArgs = [...UpsertVectorArgs, string?, RecordSparseValues[]?];
 
+interface PineconeUpdateVectorParams extends UpdateVectorParams {
+  namespace?: string;
+}
+
+type PineconeUpdateVectorArgs = [...UpdateVectorArgs, string?];
+
+interface PineconeDeleteVectorParams extends DeleteVectorParams {
+  namespace?: string;
+}
+
+type PineconeDeleteVectorArgs = [...DeleteVectorArgs, string?];
+
 export class PineconeVector extends MastraVector {
   private client: Pinecone;
 
-  constructor(apiKey: string, environment?: string) {
+  /**
+   * @deprecated Passing apiKey and environment as positional arguments is deprecated.
+   * Use the object parameter instead. This signature will be removed on May 20th, 2025.
+   */
+  constructor(apiKey: string, environment?: string);
+  /**
+   * Creates a new PineconeVector client.
+   * @param params - An object with apiKey and optional environment.
+   */
+  constructor(params: { apiKey: string; environment?: string });
+  constructor(paramsOrApiKey: { apiKey: string; environment?: string } | string, environment?: string) {
     super();
-
+    let apiKey: string;
+    let env: string | undefined;
+    if (typeof paramsOrApiKey === 'string') {
+      // DEPRECATION WARNING
+      if (typeof console !== 'undefined' && console.warn) {
+        console.warn(
+          `Deprecation Warning: Passing apiKey and environment as positional arguments to PineconeVector constructor is deprecated.\nPlease use an object parameter instead:\n  new PineconeVector({ apiKey, environment })\nThis signature will be removed on May 20th, 2025.`,
+        );
+      }
+      apiKey = paramsOrApiKey;
+      env = environment;
+    } else {
+      apiKey = paramsOrApiKey.apiKey;
+      env = paramsOrApiKey.environment;
+    }
     const opts: { apiKey: string; controllerHostUrl?: string } = { apiKey };
-
-    if (environment) {
-      opts['controllerHostUrl'] = environment;
+    if (env) {
+      opts['controllerHostUrl'] = env;
     }
-
     const baseClient = new Pinecone(opts);
     const telemetry = this.__getTelemetry();
     this.client =
@@ -180,7 +220,16 @@ export class PineconeVector extends MastraVector {
     return indexesResult?.indexes?.map(index => index.name) || [];
   }
 
-  async describeIndex(indexName: string): Promise<PineconeIndexStats> {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @param params - The parameters for describing an index
+   * @param params.indexName - The name of the index to describe
+   * @returns A promise that resolves to the index statistics including dimension, count and metric
+   */
+  async describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<PineconeIndexStats> {
+    const params = this.normalizeArgs<DescribeIndexParams>('describeIndex', args);
+    const { indexName } = params;
     const index = this.client.Index(indexName);
     const stats = await index.describeIndexStats();
     const description = await this.client.describeIndex(indexName);
@@ -193,7 +242,9 @@ export class PineconeVector extends MastraVector {
     };
   }
 
-  async deleteIndex(indexName: string): Promise<void> {
+  async deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void> {
+    const params = this.normalizeArgs<DeleteIndexParams>('deleteIndex', args);
+    const { indexName } = params;
     try {
       await this.client.deleteIndex(indexName);
     } catch (error: any) {
@@ -224,7 +275,7 @@ export class PineconeVector extends MastraVector {
       Please use updateVector() instead. 
       updateIndexById() will be removed on May 20th, 2025.`,
     );
-    await this.updateVector(indexName, id, update, namespace);
+    await this.updateVector({ indexName, id, update, namespace });
   }
 
   /**
@@ -238,15 +289,11 @@ export class PineconeVector extends MastraVector {
    * @returns A promise that resolves when the update is complete.
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
-  async updateVector(
-    indexName: string,
-    id: string,
-    update: {
-      vector?: number[];
-      metadata?: Record<string, any>;
-    },
-    namespace?: string,
-  ): Promise<void> {
+  async updateVector(...args: ParamsToArgs<PineconeUpdateVectorParams> | PineconeUpdateVectorArgs): Promise<void> {
+    const params = this.normalizeArgs<PineconeUpdateVectorParams, PineconeUpdateVectorArgs>('updateVector', args, [
+      'namespace',
+    ]);
+    const { indexName, id, update, namespace } = params;
     try {
       if (!update.vector && !update.metadata) {
         throw new Error('No updates provided');
@@ -286,7 +333,7 @@ export class PineconeVector extends MastraVector {
       Please use deleteVector() instead. 
       deleteIndexById() will be removed on May 20th, 2025.`,
     );
-    await this.deleteVector(indexName, id, namespace);
+    await this.deleteVector({ indexName, id, namespace });
   }
 
   /**
@@ -297,7 +344,11 @@ export class PineconeVector extends MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(indexName: string, id: string, namespace?: string): Promise<void> {
+  async deleteVector(...args: ParamsToArgs<PineconeDeleteVectorParams> | PineconeDeleteVectorArgs): Promise<void> {
+    const params = this.normalizeArgs<PineconeDeleteVectorParams, PineconeDeleteVectorArgs>('deleteVector', args, [
+      'namespace',
+    ]);
+    const { indexName, id, namespace } = params;
     try {
       const index = this.client.Index(indexName).namespace(namespace || '');
       await index.deleteOne(id);