@forbocai/browser 0.4.4

package/dist/index.d.mts

@@ -0,0 +1,25 @@
+import { CortexConfig, ICortex, MemoryType, MemoryItem, MemoryConfig } from '@forbocai/core';
+
+declare const createBrowserCortex: (config: CortexConfig) => ICortex;
+declare const createCortex: (config: CortexConfig) => ICortex;
+
+interface IBrowserMemory {
+    store(text: string, type?: MemoryType, importance?: number): Promise<MemoryItem>;
+    recall(query: string, limit?: number): Promise<MemoryItem[]>;
+    clear(): Promise<void>;
+}
+declare const createBrowserMemory: (config?: MemoryConfig) => {
+    store: (text: string, type?: MemoryType, importance?: number) => Promise<MemoryItem>;
+    recall: (query: string, limit?: number) => Promise<MemoryItem[]>;
+    clear: () => Promise<void>;
+};
+declare const createMemory: (config?: MemoryConfig) => {
+    store: (text: string, type?: MemoryType, importance?: number) => Promise<MemoryItem>;
+    recall: (query: string, limit?: number) => Promise<MemoryItem[]>;
+    clear: () => Promise<void>;
+};
+
+declare const initVectorEngine: () => Promise<void>;
+declare const generateEmbedding: (text: string) => Promise<number[]>;
+
+export { type IBrowserMemory, createBrowserCortex, createBrowserMemory, createCortex, createMemory, generateEmbedding, initVectorEngine };

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { CortexConfig, ICortex, MemoryType, MemoryItem, MemoryConfig } from '@forbocai/core';
+
+declare const createBrowserCortex: (config: CortexConfig) => ICortex;
+declare const createCortex: (config: CortexConfig) => ICortex;
+
+interface IBrowserMemory {
+    store(text: string, type?: MemoryType, importance?: number): Promise<MemoryItem>;
+    recall(query: string, limit?: number): Promise<MemoryItem[]>;
+    clear(): Promise<void>;
+}
+declare const createBrowserMemory: (config?: MemoryConfig) => {
+    store: (text: string, type?: MemoryType, importance?: number) => Promise<MemoryItem>;
+    recall: (query: string, limit?: number) => Promise<MemoryItem[]>;
+    clear: () => Promise<void>;
+};
+declare const createMemory: (config?: MemoryConfig) => {
+    store: (text: string, type?: MemoryType, importance?: number) => Promise<MemoryItem>;
+    recall: (query: string, limit?: number) => Promise<MemoryItem[]>;
+    clear: () => Promise<void>;
+};
+
+declare const initVectorEngine: () => Promise<void>;
+declare const generateEmbedding: (text: string) => Promise<number[]>;
+
+export { type IBrowserMemory, createBrowserCortex, createBrowserMemory, createCortex, createMemory, generateEmbedding, initVectorEngine };

package/dist/index.js

@@ -0,0 +1,173 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createBrowserCortex: () => createBrowserCortex,
+  createBrowserMemory: () => createBrowserMemory,
+  createCortex: () => createCortex,
+  createMemory: () => createMemory,
+  generateEmbedding: () => generateEmbedding,
+  initVectorEngine: () => initVectorEngine
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cortex.ts
+var import_web_llm = require("@mlc-ai/web-llm");
+var import_meta = {};
+var createBrowserCortex = (config) => {
+  let engine = null;
+  let status = {
+    id: "browser-init",
+    model: config.model || "smollm2-135m",
+    ready: false,
+    engine: "web-llm"
+  };
+  const init = async (onProgress) => {
+    if (status.ready) return status;
+    const initProgressCallback = (report) => {
+      console.log(report.text);
+      if (onProgress) {
+      }
+    };
+    const modelId = config.model || "SmolLM2-135M-Instruct-q4f16_1-MLC";
+    engine = await (0, import_web_llm.CreateWebWorkerMLCEngine)(
+      new Worker(new URL("./worker.ts", import_meta.url), { type: "module" }),
+      modelId,
+      { initProgressCallback }
+    );
+    status = {
+      id: `ctx_web_${Date.now()}`,
+      model: modelId,
+      ready: true,
+      engine: "web-llm"
+    };
+    return status;
+  };
+  const complete = async (prompt, options = {}) => {
+    if (!status.ready) await init();
+    const reply = await engine.chat.completions.create({
+      messages: [{ role: "user", content: prompt }],
+      max_gen_len: options.maxTokens,
+      temperature: options.temperature
+    });
+    return reply.choices[0].message.content || "";
+  };
+  const completeStream = async function* (prompt, options = {}) {
+    if (!status.ready) await init();
+    const chunks = await engine.chat.completions.create({
+      messages: [{ role: "user", content: prompt }],
+      max_gen_len: options.maxTokens,
+      temperature: options.temperature,
+      stream: true
+    });
+    for await (const chunk of chunks) {
+      const content = chunk.choices[0]?.delta?.content || "";
+      if (content) yield content;
+    }
+  };
+  return {
+    init,
+    complete,
+    completeStream
+  };
+};
+var createCortex = (config) => createBrowserCortex(config);
+
+// src/memory.ts
+var import_orama = require("@orama/orama");
+
+// src/vector.ts
+var import_transformers = require("@xenova/transformers");
+var embedder = null;
+var initVectorEngine = async () => {
+  if (embedder) return;
+  console.log("> Initializing Browser Vector Engine...");
+  embedder = await (0, import_transformers.pipeline)("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+};
+var generateEmbedding = async (text) => {
+  if (!embedder) await initVectorEngine();
+  const result = await embedder(text, { pooling: "mean", normalize: true });
+  return Array.from(result.data);
+};
+
+// src/memory.ts
+var createBrowserMemory = (config = {}) => {
+  let db = null;
+  const init = async () => {
+    if (db) return db;
+    db = await (0, import_orama.create)({
+      schema: {
+        id: "string",
+        text: "string",
+        timestamp: "number",
+        type: "string",
+        importance: "number",
+        embedding: "vector[384]"
+        // all-MiniLM-L6-v2
+      }
+    });
+    return db;
+  };
+  const store = async (text, type = "observation", importance = 0.5) => {
+    const instance = await init();
+    const item = {
+      id: `mem_br_${Date.now()}_${Math.random().toString(36).substring(7)}`,
+      text,
+      timestamp: Date.now(),
+      type,
+      importance
+    };
+    const embedding = await generateEmbedding(text);
+    await (0, import_orama.insert)(instance, {
+      ...item,
+      embedding
+    });
+    return item;
+  };
+  const recall = async (query, limit = 5) => {
+    const instance = await init();
+    const embedding = await generateEmbedding(query);
+    const results = await (0, import_orama.search)(instance, {
+      mode: "vector",
+      vector: {
+        value: embedding,
+        property: "embedding"
+      },
+      similarity: 0.5,
+      limit
+    });
+    return results.hits.map((hit) => hit.document);
+  };
+  const clear = async () => {
+    db = null;
+  };
+  return { store, recall, clear };
+};
+var createMemory = (config = {}) => createBrowserMemory(config);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createBrowserCortex,
+  createBrowserMemory,
+  createCortex,
+  createMemory,
+  generateEmbedding,
+  initVectorEngine
+});

package/dist/index.mjs

@@ -0,0 +1,140 @@
+// src/cortex.ts
+import { CreateWebWorkerMLCEngine } from "@mlc-ai/web-llm";
+var createBrowserCortex = (config) => {
+  let engine = null;
+  let status = {
+    id: "browser-init",
+    model: config.model || "smollm2-135m",
+    ready: false,
+    engine: "web-llm"
+  };
+  const init = async (onProgress) => {
+    if (status.ready) return status;
+    const initProgressCallback = (report) => {
+      console.log(report.text);
+      if (onProgress) {
+      }
+    };
+    const modelId = config.model || "SmolLM2-135M-Instruct-q4f16_1-MLC";
+    engine = await CreateWebWorkerMLCEngine(
+      new Worker(new URL("./worker.ts", import.meta.url), { type: "module" }),
+      modelId,
+      { initProgressCallback }
+    );
+    status = {
+      id: `ctx_web_${Date.now()}`,
+      model: modelId,
+      ready: true,
+      engine: "web-llm"
+    };
+    return status;
+  };
+  const complete = async (prompt, options = {}) => {
+    if (!status.ready) await init();
+    const reply = await engine.chat.completions.create({
+      messages: [{ role: "user", content: prompt }],
+      max_gen_len: options.maxTokens,
+      temperature: options.temperature
+    });
+    return reply.choices[0].message.content || "";
+  };
+  const completeStream = async function* (prompt, options = {}) {
+    if (!status.ready) await init();
+    const chunks = await engine.chat.completions.create({
+      messages: [{ role: "user", content: prompt }],
+      max_gen_len: options.maxTokens,
+      temperature: options.temperature,
+      stream: true
+    });
+    for await (const chunk of chunks) {
+      const content = chunk.choices[0]?.delta?.content || "";
+      if (content) yield content;
+    }
+  };
+  return {
+    init,
+    complete,
+    completeStream
+  };
+};
+var createCortex = (config) => createBrowserCortex(config);
+
+// src/memory.ts
+import { create, insert, search } from "@orama/orama";
+
+// src/vector.ts
+import { pipeline } from "@xenova/transformers";
+var embedder = null;
+var initVectorEngine = async () => {
+  if (embedder) return;
+  console.log("> Initializing Browser Vector Engine...");
+  embedder = await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+};
+var generateEmbedding = async (text) => {
+  if (!embedder) await initVectorEngine();
+  const result = await embedder(text, { pooling: "mean", normalize: true });
+  return Array.from(result.data);
+};
+
+// src/memory.ts
+var createBrowserMemory = (config = {}) => {
+  let db = null;
+  const init = async () => {
+    if (db) return db;
+    db = await create({
+      schema: {
+        id: "string",
+        text: "string",
+        timestamp: "number",
+        type: "string",
+        importance: "number",
+        embedding: "vector[384]"
+        // all-MiniLM-L6-v2
+      }
+    });
+    return db;
+  };
+  const store = async (text, type = "observation", importance = 0.5) => {
+    const instance = await init();
+    const item = {
+      id: `mem_br_${Date.now()}_${Math.random().toString(36).substring(7)}`,
+      text,
+      timestamp: Date.now(),
+      type,
+      importance
+    };
+    const embedding = await generateEmbedding(text);
+    await insert(instance, {
+      ...item,
+      embedding
+    });
+    return item;
+  };
+  const recall = async (query, limit = 5) => {
+    const instance = await init();
+    const embedding = await generateEmbedding(query);
+    const results = await search(instance, {
+      mode: "vector",
+      vector: {
+        value: embedding,
+        property: "embedding"
+      },
+      similarity: 0.5,
+      limit
+    });
+    return results.hits.map((hit) => hit.document);
+  };
+  const clear = async () => {
+    db = null;
+  };
+  return { store, recall, clear };
+};
+var createMemory = (config = {}) => createBrowserMemory(config);
+export {
+  createBrowserCortex,
+  createBrowserMemory,
+  createCortex,
+  createMemory,
+  generateEmbedding,
+  initVectorEngine
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+    "name": "@forbocai/browser",
+    "version": "0.4.4",
+    "license": "UNLICENSED",
+    "description": "Web Browser implementation for ForbocAI SDK",
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsup src/index.ts --format cjs,esm --dts",
+        "dev": "tsup src/index.ts --watch",
+        "test": "vitest"
+    },
+    "dependencies": {
+        "@forbocai/core": "*",
+        "@mlc-ai/web-llm": "^0.2.46",
+        "@orama/orama": "^2.0.26",
+        "@xenova/transformers": "^2.17.2"
+    },
+    "devDependencies": {
+        "tsup": "^8.5.1",
+        "typescript": "^5.9.3",
+        "vitest": "^1.0.0"
+    },
+    "files": [
+        "dist",
+        "package.json"
+    ]
+}