forbocai 0.3.4 → 0.3.6

package/README.md

@@ -12,7 +12,7 @@
 
 Autonomous AI for game NPCs.
 
-[![Documentation](https://img.shields.io/badge/docs-forbocai.docs.buildwithfern.com-blue)](https://forbocai.docs.buildwithfern.com)
+[![Documentation](https://img.shields.io/badge/docs-docs.forboc.ai-blue)](https://docs.forboc.ai)
 [![npm](https://img.shields.io/npm/v/forbocai)](https://www.npmjs.com/package/forbocai)
 [![Discord](https://img.shields.io/discord/your-discord-id?label=Discord)](https://discord.gg/6hr2jHqnsG)
 
@@ -99,6 +99,8 @@ AI state (memories, personality, mood) is complex and sensitive. Classes encoura
 npm install forbocai
 ```
 
+**Windows:** The SDK requires **CMake** (and Visual Studio Build Tools) to build the native Cortex (`node-llama-cpp`). If `npm install` fails with a CMake message, install [CMake](https://cmake.org/download/) (add to PATH) and [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) (Desktop development with C++), then run `npm install forbocai` again.
+
 ---
 
 ## CLI Reference
@@ -122,7 +124,7 @@ npx forbocai status
 npx forbocai doctor
 ```
 
-See [full CLI documentation](https://forbocai.docs.buildwithfern.com/docs/pages/cli).
+See [full CLI documentation](https://docs.forboc.ai/docs/pages/cli).
 
 ---
 
@@ -405,10 +407,10 @@ In the ForbocAI ecosystem, an NFT is not just a receipt—it is an **Encapsulate
 
 `Dócs_Máp // Référence`
 
-- **[Introduction](https://forbocai.docs.buildwithfern.com)** — SDK overview and quick start
-- **[User Stories](https://forbocai.docs.buildwithfern.com/user-stories)** — BDD specifications for all features
-- **[Concepts](https://forbocai.docs.buildwithfern.com/concepts)** — Architecture and core abstractions
-- **[API Reference](https://forbocai.docs.buildwithfern.com/api-reference)** — Complete endpoint documentation
+- **[Introduction](https://docs.forboc.ai)** — SDK overview and quick start
+- **[User Stories](https://docs.forboc.ai/user-stories)** — BDD specifications for all features
+- **[Concepts](https://docs.forboc.ai/concepts)** — Architecture and core abstractions
+- **[API Reference](https://docs.forboc.ai/api-reference)** — Complete endpoint documentation
 
 ---
 
@@ -417,7 +419,7 @@ In the ForbocAI ecosystem, an NFT is not just a receipt—it is an **Encapsulate
 `Éxternal_Líns // Cónnect`
 
 - **Website:** [forboc.ai](https://forboc.ai)
-- **Documentation:** [forbocai.docs.buildwithfern.com](https://forbocai.docs.buildwithfern.com)
+- **Documentation:** [docs.forboc.ai](https://docs.forboc.ai)
 - **Discord:** [discord.gg/6hr2jHqnsG](https://discord.gg/6hr2jHqnsG)
 - **Telegram:** [t.me/forbocai](https://t.me/forbocai)
 
@@ -461,7 +463,7 @@ To verify the full end-to-end loop (SDK <-> NPM <-> Render API):
     Use the CLI to check connection to the production API:
     ```bash
     npx forbocai api status
-    # > Checking API Status (https://forbocai-api.onrender.com)...
+    # > Checking API Status (https://api.forboc.ai)...
     # > Status: ONLINE
     ```
 

package/dist/cli.js

@@ -29,8 +29,8 @@ var import_https = __toESM(require("https"));
 var readline = __toESM(require("readline"));
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
-var VERSION = "0.3.3";
-var DEFAULT_API_URL = "https://forbocai-api.onrender.com";
+var VERSION = "0.3.5";
+var DEFAULT_API_URL = "https://api.forboc.ai";
 var CONFIG_PATH = path.join(process.env.HOME || ".", ".forbocai.json");
 var config = {};
 try {

package/dist/cli.mjs

@@ -6,8 +6,8 @@ import https from "https";
 import * as readline from "readline";
 import * as fs from "fs";
 import * as path from "path";
-var VERSION = "0.3.3";
-var DEFAULT_API_URL = "https://forbocai-api.onrender.com";
+var VERSION = "0.3.5";
+var DEFAULT_API_URL = "https://api.forboc.ai";
 var CONFIG_PATH = path.join(process.env.HOME || ".", ".forbocai.json");
 var config = {};
 try {

package/dist/index.js

@@ -436,7 +436,7 @@ var exportSoulToIPFS = async (agentId, soul, config = {}) => {
       }
     }
   }
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${apiUrl}/agents/${agentId}/soul/export`, {
       method: "POST",
@@ -471,7 +471,7 @@ var importSoulFromIPFS = async (cid, config = {}) => {
       }
     }
   }
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${apiUrl}/souls/${cid}`, {
       method: "GET",
@@ -494,7 +494,7 @@ var importSoulFromIPFS = async (cid, config = {}) => {
   }
 };
 var getSoulList = async (limit = 50, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/souls?limit=${limit}`, {
       method: "GET",
@@ -516,7 +516,7 @@ var getSoulList = async (limit = 50, apiUrl) => {
   }
 };
 var createAgentFromSoul = async (cid, cortexId, config = {}) => {
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   const response = await fetch(`${apiUrl}/agents/import`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -533,7 +533,7 @@ var createAgentFromSoul = async (cid, cortexId, config = {}) => {
 };
 var createSoulInstance = (id, name, persona, state, memories = [], initialApiUrl) => {
   const soulData = createSoul(id, name, persona, state, memories);
-  const defaultApiUrl = initialApiUrl || "https://forbocai-api.onrender.com";
+  const defaultApiUrl = initialApiUrl || "https://api.forboc.ai";
   const exportSoul = async (config) => {
     return exportSoulToIPFS(soulData.id, soulData, {
       ...config,
@@ -936,7 +936,7 @@ var validateAction = (action, rules, context = {}) => {
 
 // src/ghost.ts
 var startGhostSession = async (config) => {
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${apiUrl}/ghost/run`, {
       method: "POST",
@@ -963,7 +963,7 @@ var startGhostSession = async (config) => {
   }
 };
 var getGhostStatus = async (sessionId, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/${sessionId}/status`, {
       method: "GET",
@@ -993,7 +993,7 @@ var getGhostStatus = async (sessionId, apiUrl) => {
   }
 };
 var getGhostResults = async (sessionId, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/${sessionId}/results`, {
       method: "GET",
@@ -1060,7 +1060,7 @@ var waitForGhostCompletion = async (sessionId, pollIntervalMs = 5e3, timeoutMs =
   throw new Error(`Ghost session timed out after ${timeoutMs}ms`);
 };
 var stopGhostSession = async (sessionId, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/${sessionId}/stop`, {
       method: "POST",
@@ -1082,7 +1082,7 @@ var stopGhostSession = async (sessionId, apiUrl) => {
   }
 };
 var getGhostHistory = async (limit = 10, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/history?limit=${limit}`, {
       method: "GET",
@@ -1106,7 +1106,7 @@ var getGhostHistory = async (limit = 10, apiUrl) => {
 };
 var createGhost = (config) => {
   let sessionId = null;
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   const run = async () => {
     const result = await startGhostSession(config);
     sessionId = result.sessionId;
@@ -1161,7 +1161,7 @@ var init = () => {
  | .  / -_) || | '_ / _ \\/ _ \\  | || ' \\|  _| | |
  |_|\\_\\___|\\_,_| ._\\___/_/ \\_\\ |___|_||_|\\__|_|_|
                |_|                                \x1B[0m
-  Neuro-Symbolic Grid SDK v0.3.3
+  Neuro-Symbolic Grid SDK v0.3.5
   ---------------------------------
   Vessel: ACTIVE
   Memory: LOCAL (LanceDB)

package/dist/index.mjs

@@ -364,7 +364,7 @@ var exportSoulToIPFS = async (agentId, soul, config = {}) => {
       }
     }
   }
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${apiUrl}/agents/${agentId}/soul/export`, {
       method: "POST",
@@ -399,7 +399,7 @@ var importSoulFromIPFS = async (cid, config = {}) => {
       }
     }
   }
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${apiUrl}/souls/${cid}`, {
       method: "GET",
@@ -422,7 +422,7 @@ var importSoulFromIPFS = async (cid, config = {}) => {
   }
 };
 var getSoulList = async (limit = 50, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/souls?limit=${limit}`, {
       method: "GET",
@@ -444,7 +444,7 @@ var getSoulList = async (limit = 50, apiUrl) => {
   }
 };
 var createAgentFromSoul = async (cid, cortexId, config = {}) => {
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   const response = await fetch(`${apiUrl}/agents/import`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -461,7 +461,7 @@ var createAgentFromSoul = async (cid, cortexId, config = {}) => {
 };
 var createSoulInstance = (id, name, persona, state, memories = [], initialApiUrl) => {
   const soulData = createSoul(id, name, persona, state, memories);
-  const defaultApiUrl = initialApiUrl || "https://forbocai-api.onrender.com";
+  const defaultApiUrl = initialApiUrl || "https://api.forboc.ai";
   const exportSoul = async (config) => {
     return exportSoulToIPFS(soulData.id, soulData, {
       ...config,
@@ -864,7 +864,7 @@ var validateAction = (action, rules, context = {}) => {
 
 // src/ghost.ts
 var startGhostSession = async (config) => {
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${apiUrl}/ghost/run`, {
       method: "POST",
@@ -891,7 +891,7 @@ var startGhostSession = async (config) => {
   }
 };
 var getGhostStatus = async (sessionId, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/${sessionId}/status`, {
       method: "GET",
@@ -921,7 +921,7 @@ var getGhostStatus = async (sessionId, apiUrl) => {
   }
 };
 var getGhostResults = async (sessionId, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/${sessionId}/results`, {
       method: "GET",
@@ -988,7 +988,7 @@ var waitForGhostCompletion = async (sessionId, pollIntervalMs = 5e3, timeoutMs =
   throw new Error(`Ghost session timed out after ${timeoutMs}ms`);
 };
 var stopGhostSession = async (sessionId, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/${sessionId}/stop`, {
       method: "POST",
@@ -1010,7 +1010,7 @@ var stopGhostSession = async (sessionId, apiUrl) => {
   }
 };
 var getGhostHistory = async (limit = 10, apiUrl) => {
-  const url = apiUrl || "https://forbocai-api.onrender.com";
+  const url = apiUrl || "https://api.forboc.ai";
   try {
     const response = await fetch(`${url}/ghost/history?limit=${limit}`, {
       method: "GET",
@@ -1034,7 +1034,7 @@ var getGhostHistory = async (limit = 10, apiUrl) => {
 };
 var createGhost = (config) => {
   let sessionId = null;
-  const apiUrl = config.apiUrl || "https://forbocai-api.onrender.com";
+  const apiUrl = config.apiUrl || "https://api.forboc.ai";
   const run = async () => {
     const result = await startGhostSession(config);
     sessionId = result.sessionId;
@@ -1089,7 +1089,7 @@ var init = () => {
  | .  / -_) || | '_ / _ \\/ _ \\  | || ' \\|  _| | |
  |_|\\_\\___|\\_,_| ._\\___/_/ \\_\\ |___|_||_|\\__|_|_|
                |_|                                \x1B[0m
-  Neuro-Symbolic Grid SDK v0.3.3
+  Neuro-Symbolic Grid SDK v0.3.5
   ---------------------------------
   Vessel: ACTIVE
   Memory: LOCAL (LanceDB)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "forbocai",
-    "version": "0.3.4",
+    "version": "0.3.6",
     "description": "The Infrastructure Layer for Autonomous AI Characters",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -13,10 +13,13 @@
         "dev": "tsup src/index.ts --watch",
         "test": "vitest",
         "test:watch": "vitest --watch",
+        "preinstall": "node scripts/check-cmake.js",
         "postinstall": "node postinstall.js"
     },
     "dependencies": {
         "@helia/json": "^5.0.6",
+        "@lancedb/lancedb": "^0.23.0",
+        "@mlc-ai/web-llm": "^0.2.80",
         "@xenova/transformers": "^2.17.2",
         "apache-arrow": "^18.1.0",
         "axios": "^1.6.2",
@@ -24,13 +27,9 @@
         "datastore-core": "^11.0.2",
         "helia": "^6.0.18",
         "idb": "^8.0.3",
-        "zod": "^3.22.4"
-    },
-    "optionalDependencies": {
-        "@lancedb/lancedb": "^0.23.0",
-        "@mlc-ai/web-llm": "^0.2.80",
         "node-llama-cpp": "^3.15.1",
-        "onnxruntime-node": "^1.23.2"
+        "onnxruntime-node": "^1.23.2",
+        "zod": "^3.22.4"
     },
     "devDependencies": {
         "@types/node": "^20.0.0",
@@ -42,6 +41,7 @@
         "dist",
         "README.md",
         "package.json",
-        "postinstall.js"
+        "postinstall.js",
+        "scripts"
     ]
-}
+}

package/scripts/check-cmake.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+// Preinstall check: CMake is required for node-llama-cpp (native Cortex).
+// If missing, fail with clear instructions so the user knows what to install.
+
+const { execSync, spawnSync } = require('child_process');
+const isWindows = process.platform === 'win32';
+
+function cmakeAvailable() {
+  try {
+    if (isWindows) {
+      const r = spawnSync('cmake', ['--version'], { stdio: 'pipe', shell: true });
+      return r.status === 0;
+    }
+    execSync('which cmake', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+if (!cmakeAvailable()) {
+  const msg = isWindows
+    ? [
+        '',
+        'ForbocAI SDK requires CMake to build the native Cortex (node-llama-cpp).',
+        '',
+        'On Windows:',
+        '  1. Install CMake: https://cmake.org/download/',
+        '     - Run the installer and check "Add CMake to the system PATH".',
+        '  2. Install Visual Studio Build Tools: https://visualstudio.microsoft.com/visual-cpp-build-tools/',
+        '     - Select "Desktop development with C++".',
+        '  3. Close and reopen your terminal, then run: npm install forbocai',
+        '',
+        'Or install via Chocolatey: choco install cmake visualstudio2022buildtools',
+        ''
+      ]
+    : [
+        '',
+        'ForbocAI SDK requires CMake to build the native Cortex (node-llama-cpp).',
+        '',
+        'Install CMake, then run: npm install forbocai',
+        '  macOS (Homebrew): brew install cmake',
+        '  Linux (apt):      sudo apt install cmake',
+        ''
+      ];
+  console.error(msg.join('\n'));
+  process.exit(1);
+}

package/scripts/download_slm.ts

@@ -0,0 +1,37 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as https from "https";
+
+async function download(url: string, dest: string) {
+    console.log(`Downloading from ${url}...`);
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, (response) => {
+            if (response.statusCode === 301 || response.statusCode === 302) {
+                console.log(`Redirecting to ${response.headers.location}...`);
+                download(response.headers.location!, dest).then(resolve).catch(reject);
+                return;
+            }
+            if (response.statusCode !== 200) {
+                reject(new Error(`Failed to download: ${response.statusCode}`));
+                return;
+            }
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                console.log("File saved.");
+                resolve(true);
+            });
+        }).on('error', (err) => {
+            fs.unlink(dest, () => { });
+            reject(err);
+        });
+    });
+}
+
+const url = "https://huggingface.co/bartowski/SmolLM2-135M-Instruct-GGUF/resolve/main/SmolLM2-135M-Instruct-Q4_K_M.gguf?download=true";
+const dest = path.join(process.cwd(), "local_infrastructure", "models", "smollm2-135m.gguf");
+
+download(url, dest)
+    .then(() => console.log("SLM Download Complete."))
+    .catch(console.error);

package/scripts/init_infra.ts

@@ -0,0 +1,20 @@
+import * as lancedb from '@lancedb/lancedb';
+import * as path from 'path';
+
+async function main() {
+    const dbPath = path.join(process.cwd(), 'local_infrastructure', 'vectors', 'forbocai.lance');
+    console.log(`Initializing DB at ${dbPath}...`);
+
+    // Connect to LanceDB
+    const db = await lancedb.connect(dbPath);
+
+    // Create a dummy table with a vector column
+    const data = [
+        { id: "init", text: "Database Initialized", vector: new Array(384).fill(0).map(() => Math.random()) }
+    ];
+
+    await db.createTable("memories", data, { mode: 'overwrite' });
+    console.log("DB File Created successfully.");
+}
+
+main().catch(console.error);