forbocai 0.0.1

package/README.md

@@ -0,0 +1,127 @@
+<br/>
+<div align="center">
+  <img alt="ForbocAI logo" src="https://forbocai.github.io/logo.png" height="50" align="center">
+  
+  <br/>
+
+# ForbocAI SDK
+
+`Systém_Óverview // Prótocol_Init`
+
+**ᚠ ᛫ ᛟ ᛫ ᚱ ᛫ ᛒ ᛫ ᛟ ᛫ ᚲ**
+
+Autonomous AI for game NPCs.
+
+[![Documentation](https://img.shields.io/badge/docs-forbocai.docs.buildwithfern.com-blue)](https://forbocai.docs.buildwithfern.com)
+[![Discord](https://img.shields.io/discord/your-discord-id?label=Discord)](https://discord.gg/6hr2jHqnsG)
+
+</div>
+
+---
+
+## Overview
+
+`Córe_Módules // SDK_Init`
+
+The **ForbocAI SDK** is a toolkit for creating autonomous AI-powered NPCs in games. It provides:
+
+- **Local Inference** — Run quantized SLMs 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
+- **Automated QA** — Ghost Agents for headless testing at scale
+
+**᛭ ᛫ ᛬ ᛫ ᛭**
+
+---
+
+## Installation
+
+`Instáll_Séquence // Pácкage`
+
+```bash
+# JavaScript/TypeScript
+npm install forbocai
+
+# Python
+pip install forbocai
+
+# Rust
+cargo add forbocai
+```
+
+---
+
+## Quick Start
+
+`Quíck_Stárt // Éxample`
+
+```typescript
+import { Cortex, Agent } from 'forbocai';
+
+// Córtex_Init // Loćal_Inférence
+const cortex = await Cortex.init({ model: 'smollm2-135m' });
+
+// Agént_Créate // NPC_Entíty
+const npc = await Agent.create({
+  cortex,
+  persona: 'A suspicious merchant who was once cheated by adventurers.',
+  state: { inventory: ['rusty_key', 'healing_potion'], mood: 'suspicious' }
+});
+
+// Prócéss_Ínput // Dïalógue
+const response = await npc.process({
+  input: 'I want to buy a healing potion.',
+  context: { playerGold: 50 }
+});
+
+console.log(response.dialogue);
+// "Hmm, you have the coin... but how do I know you won't just take it and run?"
+```
+
+---
+
+## Core Modules
+
+`Módulátion_Máp // Sýstem_Óverview`
+
+| Module | Description |
+|--------|-------------|
+| **Cortex** | Local SLM inference engine |
+| **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) |
+| **Ghost** | Headless QA testing at scale |
+
+---
+
+## Documentation
+
+`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
+
+---
+
+## Links
+
+`Éxternal_Líns // Cónnect`
+
+- **Website:** [forbocai.github.io](https://forbocai.github.io)
+- **Documentation:** [forbocai.docs.buildwithfern.com](https://forbocai.docs.buildwithfern.com)
+- **Discord:** [discord.gg/6hr2jHqnsG](https://discord.gg/6hr2jHqnsG)
+- **Telegram:** [t.me/forbocai](https://t.me/forbocai)
+
+---
+
+**ᚠ ᛫ ᛟ ᛫ ᚱ ᛫ ᛒ ᛫ ᛟ ᛫ ᚲ**
+
+## License
+
+`Légal_Státus // Ríghts`
+
+All rights reserved. © 2026 ForbocAI

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+/**
+ * ForbocAI SDK
+ * The Infrastructure Layer for Autonomous AI Characters
+ */
+declare const init: () => void;
+
+export { init };

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ForbocAI SDK
+ * The Infrastructure Layer for Autonomous AI Characters
+ */
+declare const init: () => void;
+
+export { init };

package/dist/index.js

@@ -0,0 +1,49 @@
+"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, {
+  init: () => init
+});
+module.exports = __toCommonJS(index_exports);
+var init = () => {
+  const reset = "\x1B[0m";
+  const cyan = "\x1B[36m";
+  const blue = "\x1B[34m";
+  const dim = "\x1B[2m";
+  const bold = "\x1B[1m";
+  const runes = "\u16A0 \u16EB \u16DF \u16EB \u16B1 \u16EB \u16D2 \u16EB \u16DF \u16EB \u16B2";
+  const border = `${dim}----------------------------------------${reset}`;
+  console.log(`
+${border}
+  ${cyan}${bold}FORBOC AI SDK${reset} ${dim}v0.0.1${reset}
+  ${blue}${runes}${reset}
+${border}
+${dim}> Initializing Cortex...${reset}
+${dim}> Connecting into the Neuro-Symbolic Grid...${reset}
+${dim}> Status: ${cyan}ONLINE${reset}
+
+${cyan}Welcome to the Future of NPC Intelligence.${reset}
+`);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  init
+});

package/dist/index.mjs

@@ -0,0 +1,24 @@
+// src/index.ts
+var init = () => {
+  const reset = "\x1B[0m";
+  const cyan = "\x1B[36m";
+  const blue = "\x1B[34m";
+  const dim = "\x1B[2m";
+  const bold = "\x1B[1m";
+  const runes = "\u16A0 \u16EB \u16DF \u16EB \u16B1 \u16EB \u16D2 \u16EB \u16DF \u16EB \u16B2";
+  const border = `${dim}----------------------------------------${reset}`;
+  console.log(`
+${border}
+  ${cyan}${bold}FORBOC AI SDK${reset} ${dim}v0.0.1${reset}
+  ${blue}${runes}${reset}
+${border}
+${dim}> Initializing Cortex...${reset}
+${dim}> Connecting into the Neuro-Symbolic Grid...${reset}
+${dim}> Status: ${cyan}ONLINE${reset}
+
+${cyan}Welcome to the Future of NPC Intelligence.${reset}
+`);
+};
+export {
+  init
+};

package/package.json

@@ -0,0 +1,22 @@
+{
+    "name": "forbocai",
+    "version": "0.0.1",
+    "description": "The Infrastructure Layer for Autonomous AI Characters",
+    "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": "echo 'No tests yet'"
+    },
+    "devDependencies": {
+        "tsup": "^8.0.0",
+        "typescript": "^5.0.0"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "package.json"
+    ]
+}