forbocai 0.0.5 → 0.0.7

package/README.md

@@ -23,9 +23,9 @@ Autonomous AI for game NPCs.
 
 `Córe_Módules // SDK_Init`
 
-The **ForbocAI SDK** is a toolkit for creating autonomous AI-powered NPCs in games. It provides:
+The **ForbocAI SDK** is an **Engine-Agnostic** toolkit for creating autonomous AI-powered NPCs in any game or application. It runs anywhere (Node, Browser, Python, Rust).
 
-- **Local Inference** — Run quantized SLMs in your environment
+- **Local SLM Cortex** — Run quantized Small Language Models in your environment
 - **Autonomous NPCs** — Create agents with persona, memory, and validated actions
 - **Persistent Memory** — RAG pipeline for semantic recall across sessions
 - **Portable Souls** — Export agent state to IPFS for cross-application use
@@ -87,15 +87,42 @@ console.log(response.dialogue);
 
 | Module | Description |
 |--------|-------------|
-| **Cortex** | Local SLM inference engine |
+| **Cortex** | Local SLM inference engine (Engine Agnostic) |
 | **Agent** | Autonomous entities with persona, state, memory |
 | **Memory** | RAG pipeline for persistent semantic recall |
 | **Bridge** | Neuro-symbolic action validation |
-| **Soul** | Portable agent state (IPFS/ERC-7007) |
+| **Soul** | Portable agent state on Solana (Metaplex Core) |
 | **Ghost** | Headless QA testing at scale |
 
 ---
 
+## The Neural Grid
+
+`Systém_Architécture // Cónnection`
+
+The **ForbocAI Protocol** enables agents to understand the world they inhabit.
+
+1.  **Synthetic Intuition**: Agents "feel" the state of the world through standardized Observations.
+2.  **Valid Action**: Agents express their intent through validated Actions, ensuring they never break the rules of physics.
+3.  **Engine Agnostic**: Whether in a text adventure or a 3D simulation, the Agent's soul remains consistent.
+
+This ensures that NPCs are **smart** (thanks to LLMs) but **reliable** (thanks to the Grid).
+
+---
+
+## Digital Souls (Solana/Metaplex)
+
+`Assét_Cláss // The_Sóul`
+
+In the ForbocAI ecosystem, an NFT is not just a receipt—it is an **Encapsulated Soul**.
+
+*   **The Container**: A standardized bundle containing the Agent's Personality, Memories, and State.
+*   **The Chain**: The NFT is the *Deed of Ownership* pointing to this digital life.
+*   **Portability**: Take your trained NPC from *Forboc* to a sequel or entirely different world. Uses IPFS for decentralized persistence.
+*   **Economy**: Train a specialist NPC and sell it on the open market. The value is in the *Experience*, not just the skin.
+
+---
+
 ## Documentation
 
 `Dócs_Máp // Référence`
@@ -119,6 +146,19 @@ console.log(response.dialogue);
 ---
 
 **ᚠ ᛫ ᛟ ᛫ ᚱ ᛫ ᛒ ᛫ ᛟ ᛫ ᚲ**
+ 
+ ## Developers
+ 
+ `Dev_Ops // Releáse_Cycles`
+ 
+ To redeploy the SDK to NPM:
+ 
+ 1.  **Bump Version**: Update `version` in `package.json`.
+ 2.  **Build**: `npm run build` (Generates `dist/`).
+ 3.  **Publish**: `npm publish --access public`.
+ 
+ > **Note**: You must be authenticated with `npm adduser` or have an `.npmrc` with a valid token.
+
 
 ## License
 

package/dist/cli.js

@@ -25,12 +25,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli.ts
 var import_https = __toESM(require("https"));
-var API_URL = "https://api-iptznd9tt-seandinwiddie1s-projects.vercel.app";
+var API_URL = "https://forbocai-api.onrender.com/status";
 var args = process.argv.slice(2);
 var command = args[0];
 var subcommand = args[1];
 if (command === "api" && subcommand === "status") {
-  console.log(`> Checking API Status (${API_URL})...`);
+  console.log(`> Checking API Status (https://forbocai-api.onrender.com)...`);
   import_https.default.get(API_URL, (res) => {
     let data = "";
     res.on("data", (chunk) => data += chunk);

package/dist/cli.mjs

@@ -2,12 +2,12 @@
 
 // src/cli.ts
 import https from "https";
-var API_URL = "https://api-iptznd9tt-seandinwiddie1s-projects.vercel.app";
+var API_URL = "https://forbocai-api.onrender.com/status";
 var args = process.argv.slice(2);
 var command = args[0];
 var subcommand = args[1];
 if (command === "api" && subcommand === "status") {
-  console.log(`> Checking API Status (${API_URL})...`);
+  console.log(`> Checking API Status (https://forbocai-api.onrender.com)...`);
   https.get(API_URL, (res) => {
     let data = "";
     res.on("data", (chunk) => data += chunk);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "forbocai",
-    "version": "0.0.5",
+    "version": "0.0.7",
     "description": "The Infrastructure Layer for Autonomous AI Characters",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -24,4 +24,4 @@
         "package.json",
         "postinstall.js"
     ]
-}
+}

package/postinstall.js

@@ -13,7 +13,7 @@ try {
 > Connecting into the Neuro-Symbolic Grid...
 > Status: ONLINE
 
-Run 'forbocai api status' to verify connection.
+Run 'npx forbocai api status' to verify connection.
 
 Welcome to the Future of NPC Intelligence.
 `;