@o-lang/olang 1.0.24 → 1.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@o-lang/olang",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "author": "Olalekan Ogundipe <info@workfily.com>",
   "description": "O-Lang: A governance language for user-directed, rule-enforced agent workflows",
   "main": "./src/index.js",

package/src/runtime.js

@@ -346,10 +346,11 @@ class RuntimeAPI {
         };
         
         // ✅ Check for Advanced Evolution Service (paid tier)
-        if (process.env.OLANG_EVOLUTION_API_KEY) {
-          evolutionResult.status = 'advanced_evolution_enabled';
-          evolution resultList.message = 'Advanced evolution service would process this request';
-        }
+      // ✅ Check for Advanced Evolution Service (paid tier)
+     if (process.env.OLANG_EVOLUTION_API_KEY) {
+      evolutionResult.status = 'advanced_evolution_enabled';
+      evolutionResult.message = 'Advanced evolution service would process this request';
+    }
         
         if (step.saveAs) {
           this.context[step.saveAs] = evolutionResult;

package/src/vector/VectorBackend.js

@@ -0,0 +1,33 @@
+/**
+ * Abstract capability-based vector backend.
+ * Backends expose what they support via `supports(capability)`
+ * and execute via `call(capability, payload, context)`.
+ */
+class VectorBackend {
+  constructor(options = {}) {
+    this.options = options;
+  }
+
+  /**
+   * Check whether a capability is supported.
+   * @param {string} capability
+   * @returns {boolean}
+   */
+  supports(capability) {
+    return false;
+  }
+
+  /**
+   * Execute a capability.
+   * @param {string} capability
+   * @param {object} payload
+   * @param {object} context
+   */
+  async call(capability, payload, context) {
+    throw new Error(
+      `Vector backend does not support capability: ${capability}`
+    );
+  }
+}
+
+module.exports = VectorBackend;

package/src/vector/backends/pgvector.js

@@ -0,0 +1,95 @@
+const { Pool } = require("pg");
+const VectorBackend = require("../VectorBackend");
+
+class PgVectorBackend extends VectorBackend {
+  constructor(options = {}) {
+    super(options);
+
+    if (!options.POSTGRES_URL) {
+      throw new Error("PgVectorBackend requires POSTGRES_URL");
+    }
+
+    this.pool = new Pool({
+      connectionString: options.POSTGRES_URL
+    });
+
+    this.table = options.table || "olang_vectors";
+    this.dimensions = options.dimensions;
+  }
+
+  supports(capability) {
+    return [
+      "vector.insert",
+      "vector.search"
+    ].includes(capability);
+  }
+
+  async call(capability, payload) {
+    switch (capability) {
+      case "vector.insert":
+        return this.insert(payload);
+      case "vector.search":
+        return this.search(payload);
+      default:
+        return super.call(capability, payload);
+    }
+  }
+
+  /* ---------------- Internal ops ---------------- */
+
+  async ensureTable() {
+    if (this._tableReady) return;
+
+    await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS ${this.table} (
+        id TEXT PRIMARY KEY,
+        vector VECTOR(${this.dimensions}),
+        content TEXT,
+        source TEXT
+      );
+    `);
+
+    this._tableReady = true;
+  }
+
+  async insert({ id, vector, content, source }) {
+    await this.ensureTable();
+
+    await this.pool.query(
+      `
+      INSERT INTO ${this.table} (id, vector, content, source)
+      VALUES ($1, $2, $3, $4)
+      ON CONFLICT (id)
+      DO UPDATE SET
+        vector = EXCLUDED.vector,
+        content = EXCLUDED.content,
+        source = EXCLUDED.source
+      `,
+      [id, vector, content, source]
+    );
+
+    return { inserted: true };
+  }
+
+  async search({ vector, topK = 5, minScore = 0 }) {
+    await this.ensureTable();
+
+    const res = await this.pool.query(
+      `
+      SELECT
+        id,
+        content,
+        source,
+        1 - (vector <=> $1) AS score
+      FROM ${this.table}
+      ORDER BY vector <=> $1
+      LIMIT $2
+      `,
+      [vector, topK]
+    );
+
+    return res.rows.filter(r => r.score >= minScore);
+  }
+}
+
+module.exports = PgVectorBackend;

package/src/vector/index.js

@@ -0,0 +1,24 @@
+const PgVectorBackend = require("./backends/pgvector");
+
+/**
+ * Vector backend factory.
+ * Kernel never imports pgvector directly.
+ */
+function createVectorBackend(context = {}) {
+  // Default backend: pgvector
+  if (!context.POSTGRES_URL) {
+    throw new Error(
+      "No vector backend available: POSTGRES_URL not provided"
+    );
+  }
+
+  return new PgVectorBackend({
+    POSTGRES_URL: context.POSTGRES_URL,
+    table: context.vector_table,
+    dimensions: context.vector_dimensions
+  });
+}
+
+module.exports = {
+  createVectorBackend
+};