@rcrsr/rill-ext-pinecone 0.9.0 → 0.16.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 // Generated by dts-bundle-generator v9.5.1
 
-import { ExtensionConfigSchema, ExtensionResult } from '@rcrsr/rill';
+import { ExtensionConfigSchema, ExtensionManifest, ExtensionResult } from '@rcrsr/rill';
 
 /**
  * Type definitions for Pinecone extension.
@@ -83,7 +83,8 @@ export type PineconeExtensionConfig = PineconeConfig;
  * ```
  */
 export declare function createPineconeExtension(config: PineconeConfig): ExtensionResult;
-export declare const VERSION = "0.0.1";
+export declare const VERSION: string;
 export declare const configSchema: ExtensionConfigSchema;
+export declare const extensionManifest: ExtensionManifest;
 
 export {};

package/dist/index.js

@@ -1,9 +1,13 @@
+// src/index.ts
+import { createRequire } from "module";
+
 // src/factory.ts
 import { Pinecone } from "@pinecone-database/pinecone";
 import {
-  RuntimeError as RuntimeError4,
+  RuntimeError as RuntimeError6,
   emitExtensionEvent as emitExtensionEvent3,
-  createVector
+  createVector,
+  rillTypeToTypeValue
 } from "@rcrsr/rill";
 
 // ../../shared/ext-vector/dist/errors.js
@@ -111,18 +115,158 @@ function assertRequired(value, fieldName) {
 // ../../shared/ext-vector/dist/wrapper.js
 import { emitExtensionEvent as emitExtensionEvent2 } from "@rcrsr/rill";
 
+// ../../shared/ext-vector/dist/param.js
+import { RuntimeError as RuntimeError4 } from "@rcrsr/rill";
+function validateParamName(name) {
+  if (name === "")
+    throw new RuntimeError4("RILL-R001", "param name must not be empty");
+  if (/\s/.test(name))
+    throw new RuntimeError4("RILL-R001", "param name must be a valid identifier");
+}
+function vectorParam(name) {
+  validateParamName(name);
+  return {
+    name,
+    type: { type: "vector" },
+    defaultValue: void 0,
+    annotations: {}
+  };
+}
+
+// ../../shared/ext-param/dist/param.js
+import { RuntimeError as RuntimeError5 } from "@rcrsr/rill";
+function validateParamName2(name) {
+  if (name === "") {
+    throw new RuntimeError5("RILL-R001", "param name must not be empty");
+  }
+  if (/\s/.test(name)) {
+    throw new RuntimeError5("RILL-R001", "param name must be a valid identifier");
+  }
+}
+function buildAnnotations(desc) {
+  if (desc !== void 0) {
+    return { description: desc };
+  }
+  return {};
+}
+var p = {
+  /**
+   * IR-1: Creates a string parameter descriptor.
+   *
+   * @param name - Parameter name (must be a valid identifier)
+   * @param desc - Optional description
+   * @returns RillParam with type 'string'
+   */
+  str(name, desc) {
+    validateParamName2(name);
+    return {
+      name,
+      type: { type: "string" },
+      defaultValue: void 0,
+      annotations: buildAnnotations(desc)
+    };
+  },
+  /**
+   * IR-2: Creates a number parameter descriptor.
+   *
+   * @param name - Parameter name (must be a valid identifier)
+   * @param desc - Optional description
+   * @param def - Optional default value
+   * @returns RillParam with type 'number'
+   */
+  num(name, desc, def) {
+    validateParamName2(name);
+    return {
+      name,
+      type: { type: "number" },
+      defaultValue: def,
+      annotations: buildAnnotations(desc)
+    };
+  },
+  /**
+   * IR-3: Creates a boolean parameter descriptor.
+   *
+   * @param name - Parameter name (must be a valid identifier)
+   * @param desc - Optional description
+   * @param def - Optional default value
+   * @returns RillParam with type 'bool'
+   */
+  bool(name, desc, def) {
+    validateParamName2(name);
+    return {
+      name,
+      type: { type: "bool" },
+      defaultValue: def,
+      annotations: buildAnnotations(desc)
+    };
+  },
+  /**
+   * IR-4: Creates a dict parameter descriptor.
+   *
+   * @param name - Parameter name (must be a valid identifier)
+   * @param desc - Optional description
+   * @param def - Optional default value
+   * @param fields - Optional structural field definitions (RillFieldDef with type and optional defaultValue)
+   * @returns RillParam with type 'dict' (with fields if provided)
+   */
+  dict(name, desc, def, fields) {
+    validateParamName2(name);
+    const type = fields !== void 0 ? { type: "dict", fields } : { type: "dict" };
+    return {
+      name,
+      type,
+      defaultValue: def,
+      annotations: buildAnnotations(desc)
+    };
+  },
+  /**
+   * IR-5: Creates a list parameter descriptor.
+   *
+   * @param name - Parameter name (must be a valid identifier)
+   * @param itemType - Optional element type; omitted when not provided
+   * @param desc - Optional description
+   * @returns RillParam with type 'list' (with element if itemType provided)
+   */
+  list(name, itemType, desc) {
+    validateParamName2(name);
+    const type = itemType !== void 0 ? { type: "list", element: itemType } : { type: "list" };
+    return {
+      name,
+      type,
+      defaultValue: void 0,
+      annotations: buildAnnotations(desc)
+    };
+  },
+  /**
+   * IR-6: Creates a callable parameter descriptor.
+   *
+   * @param name - Parameter name (must be a valid identifier)
+   * @param desc - Optional description
+   * @returns RillParam with type 'closure'
+   */
+  callable(name, desc) {
+    validateParamName2(name);
+    return {
+      name,
+      type: { type: "closure" },
+      defaultValue: void 0,
+      annotations: buildAnnotations(desc)
+    };
+  }
+};
+
 // src/factory.ts
 function mapPineconeError(error) {
   if (error instanceof Error) {
     const message = error.message;
     if (message.toLowerCase().includes("authentication")) {
-      return new RuntimeError4(
+      return new RuntimeError6(
         "RILL-R004",
         "pinecone: authentication failed (401)"
       );
     }
     if (message.toLowerCase().includes("index") && message.toLowerCase().includes("not found")) {
-      return new RuntimeError4("RILL-R004", "pinecone: collection not found");
+      return new RuntimeError6("RILL-R004", "pinecone: collection not found");
     }
   }
   return mapVectorError("pinecone", error);
@@ -157,15 +301,15 @@ function createPineconeExtension(config) {
     // IR-1: pinecone::upsert
     upsert: {
       params: [
-        { name: "id", type: "string" },
-        { name: "vector", type: "vector" },
-        { name: "metadata", type: "dict", defaultValue: {} }
+        p.str("id"),
+        vectorParam("vector"),
+        p.dict("metadata", void 0, {})
       ],
       fn: async (args, ctx) => {
         checkDisposed2();
-        const id = args[0];
-        const vector = args[1];
-        const metadataArg = args[2] ?? {};
+        const id = args["id"];
+        const vector = args["vector"];
+        const metadataArg = args["metadata"] ?? {};
         const metadata = convertMetadata(metadataArg);
         return withEventEmission(
           ctx,
@@ -190,17 +334,17 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "Insert or update single vector with metadata",
-      returnType: "dict"
+      annotations: { description: "Insert or update single vector with metadata" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { id: { type: { type: "string" } }, success: { type: { type: "bool" } } } })
     },
     // IR-2: pinecone::upsert_batch
     upsert_batch: {
-      params: [{ name: "items", type: "list" }],
+      params: [p.list("items")],
       fn: async (args, ctx) => {
         const startTime = Date.now();
         try {
           checkDisposed2();
-          const items = args[0];
+          const items = args["items"];
           let succeeded = 0;
           const index = client.Index(factoryIndex);
           for (let i = 0; i < items.length; i++) {
@@ -275,19 +419,23 @@ function createPineconeExtension(config) {
           throw rillError;
         }
       },
-      description: "Batch insert/update vectors",
-      returnType: "dict"
+      annotations: { description: "Batch insert/update vectors" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { succeeded: { type: { type: "number" } }, failed: { type: { type: "string" } }, error: { type: { type: "string" } } } })
     },
     // IR-3: pinecone::search
     search: {
       params: [
-        { name: "vector", type: "vector" },
-        { name: "options", type: "dict", defaultValue: {} }
+        vectorParam("vector"),
+        p.dict("options", void 0, {}, {
+          k: { type: { type: "number" }, defaultValue: 10 },
+          filter: { type: { type: "dict" }, defaultValue: {} },
+          score_threshold: { type: { type: "number" }, defaultValue: 0 }
+        })
       ],
       fn: async (args, ctx) => {
         checkDisposed2();
-        const vector = args[0];
-        const options = args[1] ?? {};
+        const vector = args["vector"];
+        const options = args["options"] ?? {};
         const k = typeof options["k"] === "number" ? options["k"] : 10;
         const filter = options["filter"] ?? {};
         const scoreThreshold = typeof options["score_threshold"] === "number" ? options["score_threshold"] : void 0;
@@ -347,15 +495,15 @@ function createPineconeExtension(config) {
           throw rillError;
         }
       },
-      description: "Search k nearest neighbors",
-      returnType: "list"
+      annotations: { description: "Search k nearest neighbors" },
+      returnType: rillTypeToTypeValue({ type: "list", element: { type: "dict", fields: { id: { type: { type: "string" } }, score: { type: { type: "number" } }, metadata: { type: { type: "dict" } } } } })
     },
     // IR-4: pinecone::get
     get: {
-      params: [{ name: "id", type: "string" }],
+      params: [p.str("id")],
       fn: async (args, ctx) => {
         checkDisposed2();
-        const id = args[0];
+        const id = args["id"];
         return withEventEmission(
           ctx,
           "pinecone",
@@ -365,12 +513,12 @@ function createPineconeExtension(config) {
             const index = client.Index(factoryIndex);
             const response = await index.namespace(factoryNamespace).fetch({ ids: [id] });
             if (!response.records || response.records[id] === void 0) {
-              throw new RuntimeError4("RILL-R004", "pinecone: id not found");
+              throw new RuntimeError6("RILL-R004", "pinecone: id not found");
             }
             const record = response.records[id];
             const vectorData = record.values;
             if (!vectorData || !Array.isArray(vectorData)) {
-              throw new RuntimeError4(
+              throw new RuntimeError6(
                 "RILL-R004",
                 "pinecone: invalid vector format"
               );
@@ -385,15 +533,15 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "Fetch vector by ID",
-      returnType: "dict"
+      annotations: { description: "Fetch vector by ID" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { id: { type: { type: "string" } }, vector: { type: { type: "vector" } }, metadata: { type: { type: "dict" } } } })
     },
     // IR-5: pinecone::delete
     delete: {
-      params: [{ name: "id", type: "string" }],
+      params: [p.str("id")],
       fn: async (args, ctx) => {
         checkDisposed2();
-        const id = args[0];
+        const id = args["id"];
         return withEventEmission(
           ctx,
           "pinecone",
@@ -410,17 +558,17 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "Delete vector by ID",
-      returnType: "dict"
+      annotations: { description: "Delete vector by ID" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { id: { type: { type: "string" } }, deleted: { type: { type: "bool" } } } })
     },
     // IR-6: pinecone::delete_batch
     delete_batch: {
-      params: [{ name: "ids", type: "list" }],
+      params: [p.list("ids")],
       fn: async (args, ctx) => {
         const startTime = Date.now();
         try {
           checkDisposed2();
-          const ids = args[0];
+          const ids = args["ids"];
           let succeeded = 0;
           const index = client.Index(factoryIndex);
           for (let i = 0; i < ids.length; i++) {
@@ -467,8 +615,8 @@ function createPineconeExtension(config) {
           throw rillError;
         }
       },
-      description: "Batch delete vectors",
-      returnType: "dict"
+      annotations: { description: "Batch delete vectors" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { succeeded: { type: { type: "number" } }, failed: { type: { type: "string" } }, error: { type: { type: "string" } } } })
     },
     // IR-7: pinecone::count
     count: {
@@ -488,23 +636,26 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "Return total vector count in collection",
-      returnType: "number"
+      annotations: { description: "Return total vector count in collection" },
+      returnType: rillTypeToTypeValue({ type: "number" })
     },
     // IR-8: pinecone::create_collection
     create_collection: {
       params: [
-        { name: "name", type: "string" },
-        { name: "options", type: "dict", defaultValue: {} }
+        p.str("name"),
+        p.dict("options", void 0, {}, {
+          dimensions: { type: { type: "number" } },
+          distance: { type: { type: "string" }, defaultValue: "cosine" }
+        })
       ],
       fn: async (args, ctx) => {
         checkDisposed2();
-        const name = args[0];
-        const options = args[1] ?? {};
+        const name = args["name"];
+        const options = args["options"] ?? {};
         const dimensions = options["dimensions"];
         const distance = options["distance"] ?? "cosine";
         if (!dimensions || typeof dimensions !== "number" || dimensions <= 0) {
-          throw new RuntimeError4(
+          throw new RuntimeError6(
             "RILL-R004",
             "pinecone: dimensions must be a positive integer"
           );
@@ -541,15 +692,15 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "Create new vector collection",
-      returnType: "dict"
+      annotations: { description: "Create new vector collection" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { name: { type: { type: "string" } }, created: { type: { type: "bool" } } } })
     },
     // IR-9: pinecone::delete_collection
     delete_collection: {
-      params: [{ name: "name", type: "string" }],
+      params: [p.str("name")],
       fn: async (args, ctx) => {
         checkDisposed2();
-        const name = args[0];
+        const name = args["name"];
         return withEventEmission(
           ctx,
           "pinecone",
@@ -564,8 +715,8 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "Delete vector collection",
-      returnType: "dict"
+      annotations: { description: "Delete vector collection" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { name: { type: { type: "string" } }, deleted: { type: { type: "bool" } } } })
     },
     // IR-10: pinecone::list_collections
     list_collections: {
@@ -584,8 +735,8 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "List all collection names",
-      returnType: "list"
+      annotations: { description: "List all collection names" },
+      returnType: rillTypeToTypeValue({ type: "list", element: { type: "string" } })
     },
     // IR-11: pinecone::describe
     describe: {
@@ -621,8 +772,8 @@ function createPineconeExtension(config) {
           }
         );
       },
-      description: "Describe configured collection",
-      returnType: "dict"
+      annotations: { description: "Describe configured collection" },
+      returnType: rillTypeToTypeValue({ type: "dict", fields: { name: { type: { type: "string" } }, count: { type: { type: "number" } }, dimensions: { type: { type: "number" } }, distance: { type: { type: "string" } } } })
     }
   };
   result.dispose = dispose2;
@@ -630,15 +781,23 @@ function createPineconeExtension(config) {
 }
 
 // src/index.ts
-var VERSION = "0.0.1";
+var _require = createRequire(import.meta.url);
+var _pkg = _require("../package.json");
+var VERSION = _pkg.version;
 var configSchema = {
   apiKey: { type: "string", required: true, secret: true },
   index: { type: "string", required: true },
   namespace: { type: "string" },
   timeout: { type: "number" }
 };
+var extensionManifest = {
+  factory: createPineconeExtension,
+  configSchema,
+  version: VERSION
+};
 export {
   VERSION,
   configSchema,
-  createPineconeExtension
+  createPineconeExtension,
+  extensionManifest
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcrsr/rill-ext-pinecone",
-  "version": "0.9.0",
+  "version": "0.16.0",
   "description": "rill extension for Pinecone vector database integration",
   "license": "MIT",
   "author": "Andre Bremer",
@@ -17,10 +17,10 @@
     "scripting"
   ],
   "peerDependencies": {
-    "@rcrsr/rill": "^0.9.0"
+    "@rcrsr/rill": "~0.16.0"
   },
   "devDependencies": {
-    "@rcrsr/rill": "^0.9.0",
+    "@rcrsr/rill": "~0.16.0",
     "@types/node": "^25.3.0",
     "dts-bundle-generator": "^9.5.1",
     "tsup": "^8.5.1",
@@ -43,7 +43,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pinecone-database/pinecone": "^7.1.0"
+    "@pinecone-database/pinecone": "^7.1.0",
+    "@rcrsr/rill-ext-param-shared": "^0.0.1"
   },
   "scripts": {
     "build": "tsup && dts-bundle-generator --config dts-bundle-generator.config.cjs",