forbocai 0.4.1 → 0.4.2

package/dist/index.d.mts

@@ -292,6 +292,13 @@ declare const getSoulList: (limit?: number, apiUrl?: string) => Promise<SoulList
  * Factory function to create Soul instance
  */
 declare const createSoulInstance: (id: string, name: string, persona: string, state: AgentState, memories?: MemoryItem[], initialApiUrl?: string) => ISoul;
+/**
+ * Pure function to validate a Soul object
+ */
+declare const validateSoul: (soul: Soul) => {
+    valid: boolean;
+    errors: string[];
+};
 
 /**
  * Interface definition for Memory operations.
@@ -686,10 +693,10 @@ declare namespace index {
   export { type index_RPGAgentState as RPGAgentState, index_RPG_MEMORY_TYPES as RPG_MEMORY_TYPES, index_RPG_MOODS as RPG_MOODS, index_attackRule as attackRule, index_createRPGState as createRPGState, index_interactRule as interactRule, index_movementRule as movementRule, index_puzzleRules as puzzleRules, index_resourceRule as resourceRule, index_rpgFallbackStrategy as rpgFallbackStrategy, index_rpgRules as rpgRules, index_socialRules as socialRules, index_spatialRules as spatialRules, index_speakRule as speakRule };
 }
 
-declare const SDK_VERSION = "0.3.17";
+declare const SDK_VERSION = "0.4.2";
 /**
  * Initializes the ForbocAI SDK, logging status to the console.
  */
 declare const init: () => void;
 
-export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type CortexConfig, type CortexStatus, type Directive, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryConfig, type MemoryItem, type MemoryModuleConfig, type MemoryType, type Mood, type Observation, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, type VectorStatus, createAgent, createBridge, createCortex, createGhost, createInitialState, createMemory, createMemoryItem, createSoul, createSoulInstance, createTable, deserializeSoul, exportSoul, exportToSoul, fromSoul, generateEmbedding, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, getVectorTable, importSoulFromArweave, init, initVectorEngine, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, waitForGhostCompletion };
+export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type CortexConfig, type CortexStatus, type Directive, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryConfig, type MemoryItem, type MemoryModuleConfig, type MemoryType, type Mood, type Observation, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, type VectorStatus, createAgent, createBridge, createCortex, createGhost, createInitialState, createMemory, createMemoryItem, createSoul, createSoulInstance, createTable, deserializeSoul, exportSoul, exportToSoul, fromSoul, generateEmbedding, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, getVectorTable, importSoulFromArweave, init, initVectorEngine, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };

package/dist/index.d.ts

@@ -292,6 +292,13 @@ declare const getSoulList: (limit?: number, apiUrl?: string) => Promise<SoulList
  * Factory function to create Soul instance
  */
 declare const createSoulInstance: (id: string, name: string, persona: string, state: AgentState, memories?: MemoryItem[], initialApiUrl?: string) => ISoul;
+/**
+ * Pure function to validate a Soul object
+ */
+declare const validateSoul: (soul: Soul) => {
+    valid: boolean;
+    errors: string[];
+};
 
 /**
  * Interface definition for Memory operations.
@@ -686,10 +693,10 @@ declare namespace index {
   export { type index_RPGAgentState as RPGAgentState, index_RPG_MEMORY_TYPES as RPG_MEMORY_TYPES, index_RPG_MOODS as RPG_MOODS, index_attackRule as attackRule, index_createRPGState as createRPGState, index_interactRule as interactRule, index_movementRule as movementRule, index_puzzleRules as puzzleRules, index_resourceRule as resourceRule, index_rpgFallbackStrategy as rpgFallbackStrategy, index_rpgRules as rpgRules, index_socialRules as socialRules, index_spatialRules as spatialRules, index_speakRule as speakRule };
 }
 
-declare const SDK_VERSION = "0.3.17";
+declare const SDK_VERSION = "0.4.2";
 /**
  * Initializes the ForbocAI SDK, logging status to the console.
  */
 declare const init: () => void;
 
-export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type CortexConfig, type CortexStatus, type Directive, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryConfig, type MemoryItem, type MemoryModuleConfig, type MemoryType, type Mood, type Observation, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, type VectorStatus, createAgent, createBridge, createCortex, createGhost, createInitialState, createMemory, createMemoryItem, createSoul, createSoulInstance, createTable, deserializeSoul, exportSoul, exportToSoul, fromSoul, generateEmbedding, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, getVectorTable, importSoulFromArweave, init, initVectorEngine, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, waitForGhostCompletion };
+export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type CortexConfig, type CortexStatus, type Directive, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryConfig, type MemoryItem, type MemoryModuleConfig, type MemoryType, type Mood, type Observation, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, type VectorStatus, createAgent, createBridge, createCortex, createGhost, createInitialState, createMemory, createMemoryItem, createSoul, createSoulInstance, createTable, deserializeSoul, exportSoul, exportToSoul, fromSoul, generateEmbedding, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, getVectorTable, importSoulFromArweave, init, initVectorEngine, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };

package/dist/index.js

@@ -62,6 +62,7 @@ __export(index_exports, {
   updateAgentState: () => updateAgentState,
   uploadToArweave: () => uploadToArweave,
   validateAction: () => validateAction,
+  validateSoul: () => validateSoul,
   waitForGhostCompletion: () => waitForGhostCompletion
 });
 module.exports = __toCommonJS(index_exports);
@@ -71,15 +72,10 @@ var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
 var https = __toESM(require("https"));
 var MODEL_URLS = {
-  "smollm2-135m": "https://huggingface.co/HuggingFaceTB/SmolLM2-135M-Instruct-GGUF/resolve/main/smollm2-135m-instruct-q4_k_m.gguf",
+  "smollm2-135m": "https://huggingface.co/bartowski/SmolLM2-135M-Instruct-GGUF/resolve/main/SmolLM2-135M-Instruct-Q4_K_M.gguf",
   "llama3-8b": "https://huggingface.co/lmstudio-community/Meta-Llama-3-8B-Instruct-GGUF/resolve/main/Meta-Llama-3-8B-Instruct-Q4_K_M.gguf"
 };
 var DEFAULT_MODEL = "smollm2-135m";
-var ensureDirectoryExists = (dirPath) => {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-};
 var downloadFile = (url, destPath) => {
   return new Promise((resolve, reject) => {
     const file = fs.createWriteStream(destPath);
@@ -115,47 +111,36 @@ var createNativeCortex = (config) => {
   let model;
   let context;
   let session;
-  let embeddingContext;
-  const createEmbeddingContext = async () => {
-    if (!model.embeddingSupported) {
-      throw new Error("Model does not support embeddings");
-    }
-    embeddingContext = await model.createEmbeddingContext();
-  };
+  let featureExtraction = null;
   const MODELS_DIR = path.join(process.cwd(), "local_infrastructure", "models");
   const init2 = async () => {
     if (status.ready) return status;
     try {
-      console.log("> Initializing Native Cortex (node-llama-cpp)...");
+      console.log("> Initializing Native Cortex...");
+      console.log("> Loading Embedding Model (all-MiniLM-L6-v2)...");
+      const { pipeline: pipeline2 } = await import("@xenova/transformers");
+      featureExtraction = await pipeline2("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+      const ensureDirectoryExists = (dirPath) => {
+        if (!fs.existsSync(dirPath)) fs.mkdirSync(dirPath, { recursive: true });
+      };
       ensureDirectoryExists(MODELS_DIR);
       const modelKey = config.model || DEFAULT_MODEL;
       const modelUrl = MODEL_URLS[modelKey] || MODEL_URLS[DEFAULT_MODEL];
       const modelFileName = path.basename(modelUrl);
       const modelPath = path.join(MODELS_DIR, modelFileName);
       if (!fs.existsSync(modelPath)) {
-        console.log(`> Downloading Model: ${modelKey}...`);
-        console.log(`> Source: ${modelUrl}`);
+        console.log(`> Downloading SLM: ${modelKey}...`);
         await downloadFile(modelUrl, modelPath);
         console.log(`> Download complete.`);
-      } else {
-        console.log(`> Using cached model: ${modelPath}`);
       }
       const { getLlama, LlamaChatSession } = await import("node-llama-cpp");
       llama = await getLlama();
-      console.log("> Loading model into memory...");
+      console.log("> Loading SLM into memory...");
       model = await llama.loadModel({
         modelPath,
         gpuLayers: config.gpu ? 99 : 0
-        // Try to use GPU if allowed
       });
-      console.log("> Creating context...");
       context = await model.createContext();
-      if (model.embeddingSupported) {
-        console.log("> Creating embedding context...");
-        embeddingContext = await model.createEmbeddingContext();
-      } else {
-        console.log("> Model does not support embeddings");
-      }
       session = new LlamaChatSession({
         contextSequence: context.getSequence()
       });
@@ -181,52 +166,17 @@ var createNativeCortex = (config) => {
   };
   const completeStream = async function* (prompt, options = {}) {
     if (!status.ready) await init2();
-    const tokenQueue = [];
-    let resolveNext = null;
-    let isComplete = false;
-    const generationPromise = session.prompt(prompt, {
-      maxTokens: options.maxTokens,
-      temperature: options.temperature,
-      onToken: (tokens) => {
-        try {
-          const text = model.detokenize(tokens);
-          if (text) {
-            tokenQueue.push(text);
-            if (resolveNext) {
-              resolveNext();
-              resolveNext = null;
-            }
-          }
-        } catch {
-          tokenQueue.push(tokens.map((t) => String.fromCharCode(t % 256)).join(""));
-        }
-      }
-    }).then(() => {
-      isComplete = true;
-      if (resolveNext) resolveNext();
-    });
-    while (!isComplete || tokenQueue.length > 0) {
-      if (tokenQueue.length > 0) {
-        yield tokenQueue.shift();
-      } else if (!isComplete) {
-        await new Promise((resolve) => {
-          resolveNext = resolve;
-        });
-      }
-    }
-    await generationPromise;
+    const result = await session.prompt(prompt, { maxTokens: options.maxTokens });
+    yield result;
   };
   const embed = async (text) => {
     if (!status.ready) await init2();
     try {
-      if (!embeddingContext) {
-        await createEmbeddingContext();
-      }
-      const embeddings = await embeddingContext.getEmbeddingFor(text);
-      return Array.from(embeddings);
+      const output = await featureExtraction(text, { pooling: "mean", normalize: true });
+      return Array.from(output.data);
     } catch (e) {
-      console.warn("Embedding generation failed, falling back to random vector:", e);
-      return new Array(384).fill(0).map(() => Math.random());
+      console.error("Embedding failed:", e);
+      return new Array(384).fill(0);
     }
   };
   return {
@@ -234,7 +184,6 @@ var createNativeCortex = (config) => {
     complete,
     completeStream,
     embed
-    // Extended interface for private use by Memory
   };
 };
 var createCortex = (config) => createNativeCortex(config);
@@ -287,9 +236,6 @@ var createAgent = (config) => {
   const process2 = async (input, context = {}) => {
     const currentState = getAgentState();
     const apiContext = Object.entries(context).map(([k, v]) => [k, String(v)]);
-    let directive = "Respond normally.";
-    let instruction = "IDLE";
-    let target;
     const timestamp = Date.now();
     apiContext.push(["timestamp", String(timestamp)]);
     let relevantMemories = [];
@@ -299,6 +245,9 @@ var createAgent = (config) => {
       } catch {
       }
     }
+    let directive = "Respond normally.";
+    let instruction = "IDLE";
+    let target;
     try {
       const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
         method: "POST",
@@ -309,7 +258,6 @@ var createAgent = (config) => {
         body: JSON.stringify({
           dirContext: apiContext,
           dirState: currentState,
-          // Full state dump
           dirMemories: relevantMemories.map((m) => ({ text: m.text, type: m.type, importance: m.importance }))
         })
       });
@@ -319,39 +267,31 @@ var createAgent = (config) => {
         instruction = data.dirInstruction;
         target = data.dirTarget;
       } else {
-        console.warn(`API Directive Error: ${dirRes.status} ${dirRes.statusText}`);
-        if (config.fallbackStrategy) {
-          const fallback = config.fallbackStrategy(currentState, context);
-          instruction = fallback.instruction;
-          directive = fallback.directive;
-        } else {
-          instruction = "IDLE";
-          directive = "Autonomous behavior";
-        }
+        throw new Error(`API Error: ${dirRes.status}`);
       }
     } catch (e) {
-      console.warn("API Directive Failed (Network), falling back to local laws.", e);
+      console.warn("API Directive Failed (Network/Offline), using fallback.", e);
       if (config.fallbackStrategy) {
         const fallback = config.fallbackStrategy(currentState, context);
         instruction = fallback.instruction;
         directive = fallback.directive;
       } else {
         instruction = "IDLE";
-        directive = "Autonomous behavior";
+        directive = "Autonomous behavior (Offline)";
       }
     }
     const memoryContext = relevantMemories.length > 0 ? `
 Memories:
 ${relevantMemories.map((m) => `- [${m.type}] ${m.text}`).join("\n")}
 ` : "";
-    const prompt = `System: Follow this directive strictly: ${instruction} (${directive}).
-To Target: ${target || "None"}${memoryContext}
+    const prompt = `System: You are ${config.persona}.
+Directive: ${instruction} (${directive}).
+Target: ${target || "None"}${memoryContext}
 User: ${input}
 Agent:`;
     const generatedText = await cortex.complete(prompt);
     let signature = "unsigned_local_fallback";
     let isValid = true;
-    const proposedAction = { type: instruction, reason: directive, target };
     try {
       const verRes = await fetch(`${apiUrl}/agents/${agentId}/verdict`, {
         method: "POST",
@@ -359,13 +299,14 @@ Agent:`;
         body: JSON.stringify({
           verDirective: {
             dirInstruction: instruction,
-            dirTarget: target,
+            dirTarget: target || "",
             dirReason: directive
           },
           verAction: {
-            actionType: instruction,
+            gaType: instruction,
+            // Map to generic action type
             actionReason: directive,
-            actionTarget: target
+            actionTarget: target || ""
           },
           verThought: generatedText
         })
@@ -376,7 +317,7 @@ Agent:`;
         signature = vData.verSignature;
       }
     } catch (e) {
-      console.warn("API Verdict Failed.", e);
+      console.warn("API Verdict Failed. Assuming valid locally.", e);
     }
     if (!isValid) {
       return {
@@ -390,8 +331,13 @@ Agent:`;
     }
     return {
       dialogue: generatedText,
-      action: { ...proposedAction, signature },
-      thought: `Directive: ${directive} | Sig: ${signature}`
+      action: {
+        type: instruction,
+        reason: directive,
+        target,
+        signature
+      },
+      thought: `Directive: ${directive}`
     };
   };
   const exportSoul2 = async () => {
@@ -399,17 +345,10 @@ Agent:`;
     if (config.memory && typeof config.memory.export === "function") {
       try {
         exportedMemories = await config.memory.export();
-      } catch (e) {
-        console.warn("Failed to export memories from module:", e);
+      } catch {
       }
     }
-    return exportToSoul(
-      agentId,
-      "Agent",
-      config.persona,
-      state,
-      exportedMemories
-    );
+    return exportToSoul(agentId, "Agent", config.persona, state, exportedMemories);
   };
   return {
     process: process2,
@@ -573,6 +512,16 @@ var createSoulInstance = (id, name, persona, state, memories = [], initialApiUrl
     toJSON: () => ({ ...soulData })
   };
 };
+var validateSoul = (soul) => {
+  const errors = [];
+  if (!soul.id) errors.push("Missing id");
+  if (!soul.persona) errors.push("Missing persona");
+  if (!soul.state) errors.push("Missing state");
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+};
 
 // src/memory.ts
 var path3 = __toESM(require("path"));
@@ -1268,7 +1217,7 @@ var socialRules = [speakRule, interactRule];
 var puzzleRules = [movementRule, interactRule];
 
 // src/index.ts
-var SDK_VERSION = "0.3.17";
+var SDK_VERSION = "0.4.2";
 var init = () => {
   console.log(`
 \x1B[36m  _  _                     _    ___      _    _
@@ -1318,5 +1267,6 @@ var init = () => {
   updateAgentState,
   uploadToArweave,
   validateAction,
+  validateSoul,
   waitForGhostCompletion
 });

package/dist/index.mjs

@@ -9,15 +9,10 @@ import * as fs from "fs";
 import * as path from "path";
 import * as https from "https";
 var MODEL_URLS = {
-  "smollm2-135m": "https://huggingface.co/HuggingFaceTB/SmolLM2-135M-Instruct-GGUF/resolve/main/smollm2-135m-instruct-q4_k_m.gguf",
+  "smollm2-135m": "https://huggingface.co/bartowski/SmolLM2-135M-Instruct-GGUF/resolve/main/SmolLM2-135M-Instruct-Q4_K_M.gguf",
   "llama3-8b": "https://huggingface.co/lmstudio-community/Meta-Llama-3-8B-Instruct-GGUF/resolve/main/Meta-Llama-3-8B-Instruct-Q4_K_M.gguf"
 };
 var DEFAULT_MODEL = "smollm2-135m";
-var ensureDirectoryExists = (dirPath) => {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-};
 var downloadFile = (url, destPath) => {
   return new Promise((resolve, reject) => {
     const file = fs.createWriteStream(destPath);
@@ -53,47 +48,36 @@ var createNativeCortex = (config) => {
   let model;
   let context;
   let session;
-  let embeddingContext;
-  const createEmbeddingContext = async () => {
-    if (!model.embeddingSupported) {
-      throw new Error("Model does not support embeddings");
-    }
-    embeddingContext = await model.createEmbeddingContext();
-  };
+  let featureExtraction = null;
   const MODELS_DIR = path.join(process.cwd(), "local_infrastructure", "models");
   const init2 = async () => {
     if (status.ready) return status;
     try {
-      console.log("> Initializing Native Cortex (node-llama-cpp)...");
+      console.log("> Initializing Native Cortex...");
+      console.log("> Loading Embedding Model (all-MiniLM-L6-v2)...");
+      const { pipeline: pipeline2 } = await import("@xenova/transformers");
+      featureExtraction = await pipeline2("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+      const ensureDirectoryExists = (dirPath) => {
+        if (!fs.existsSync(dirPath)) fs.mkdirSync(dirPath, { recursive: true });
+      };
       ensureDirectoryExists(MODELS_DIR);
       const modelKey = config.model || DEFAULT_MODEL;
       const modelUrl = MODEL_URLS[modelKey] || MODEL_URLS[DEFAULT_MODEL];
       const modelFileName = path.basename(modelUrl);
       const modelPath = path.join(MODELS_DIR, modelFileName);
       if (!fs.existsSync(modelPath)) {
-        console.log(`> Downloading Model: ${modelKey}...`);
-        console.log(`> Source: ${modelUrl}`);
+        console.log(`> Downloading SLM: ${modelKey}...`);
         await downloadFile(modelUrl, modelPath);
         console.log(`> Download complete.`);
-      } else {
-        console.log(`> Using cached model: ${modelPath}`);
       }
       const { getLlama, LlamaChatSession } = await import("node-llama-cpp");
       llama = await getLlama();
-      console.log("> Loading model into memory...");
+      console.log("> Loading SLM into memory...");
       model = await llama.loadModel({
         modelPath,
         gpuLayers: config.gpu ? 99 : 0
-        // Try to use GPU if allowed
       });
-      console.log("> Creating context...");
       context = await model.createContext();
-      if (model.embeddingSupported) {
-        console.log("> Creating embedding context...");
-        embeddingContext = await model.createEmbeddingContext();
-      } else {
-        console.log("> Model does not support embeddings");
-      }
       session = new LlamaChatSession({
         contextSequence: context.getSequence()
       });
@@ -119,52 +103,17 @@ var createNativeCortex = (config) => {
   };
   const completeStream = async function* (prompt, options = {}) {
     if (!status.ready) await init2();
-    const tokenQueue = [];
-    let resolveNext = null;
-    let isComplete = false;
-    const generationPromise = session.prompt(prompt, {
-      maxTokens: options.maxTokens,
-      temperature: options.temperature,
-      onToken: (tokens) => {
-        try {
-          const text = model.detokenize(tokens);
-          if (text) {
-            tokenQueue.push(text);
-            if (resolveNext) {
-              resolveNext();
-              resolveNext = null;
-            }
-          }
-        } catch {
-          tokenQueue.push(tokens.map((t) => String.fromCharCode(t % 256)).join(""));
-        }
-      }
-    }).then(() => {
-      isComplete = true;
-      if (resolveNext) resolveNext();
-    });
-    while (!isComplete || tokenQueue.length > 0) {
-      if (tokenQueue.length > 0) {
-        yield tokenQueue.shift();
-      } else if (!isComplete) {
-        await new Promise((resolve) => {
-          resolveNext = resolve;
-        });
-      }
-    }
-    await generationPromise;
+    const result = await session.prompt(prompt, { maxTokens: options.maxTokens });
+    yield result;
   };
   const embed = async (text) => {
     if (!status.ready) await init2();
     try {
-      if (!embeddingContext) {
-        await createEmbeddingContext();
-      }
-      const embeddings = await embeddingContext.getEmbeddingFor(text);
-      return Array.from(embeddings);
+      const output = await featureExtraction(text, { pooling: "mean", normalize: true });
+      return Array.from(output.data);
     } catch (e) {
-      console.warn("Embedding generation failed, falling back to random vector:", e);
-      return new Array(384).fill(0).map(() => Math.random());
+      console.error("Embedding failed:", e);
+      return new Array(384).fill(0);
     }
   };
   return {
@@ -172,7 +121,6 @@ var createNativeCortex = (config) => {
     complete,
     completeStream,
     embed
-    // Extended interface for private use by Memory
   };
 };
 var createCortex = (config) => createNativeCortex(config);
@@ -225,9 +173,6 @@ var createAgent = (config) => {
   const process2 = async (input, context = {}) => {
     const currentState = getAgentState();
     const apiContext = Object.entries(context).map(([k, v]) => [k, String(v)]);
-    let directive = "Respond normally.";
-    let instruction = "IDLE";
-    let target;
     const timestamp = Date.now();
     apiContext.push(["timestamp", String(timestamp)]);
     let relevantMemories = [];
@@ -237,6 +182,9 @@ var createAgent = (config) => {
       } catch {
       }
     }
+    let directive = "Respond normally.";
+    let instruction = "IDLE";
+    let target;
     try {
       const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
         method: "POST",
@@ -247,7 +195,6 @@ var createAgent = (config) => {
         body: JSON.stringify({
           dirContext: apiContext,
           dirState: currentState,
-          // Full state dump
           dirMemories: relevantMemories.map((m) => ({ text: m.text, type: m.type, importance: m.importance }))
         })
       });
@@ -257,39 +204,31 @@ var createAgent = (config) => {
         instruction = data.dirInstruction;
         target = data.dirTarget;
       } else {
-        console.warn(`API Directive Error: ${dirRes.status} ${dirRes.statusText}`);
-        if (config.fallbackStrategy) {
-          const fallback = config.fallbackStrategy(currentState, context);
-          instruction = fallback.instruction;
-          directive = fallback.directive;
-        } else {
-          instruction = "IDLE";
-          directive = "Autonomous behavior";
-        }
+        throw new Error(`API Error: ${dirRes.status}`);
       }
     } catch (e) {
-      console.warn("API Directive Failed (Network), falling back to local laws.", e);
+      console.warn("API Directive Failed (Network/Offline), using fallback.", e);
       if (config.fallbackStrategy) {
         const fallback = config.fallbackStrategy(currentState, context);
         instruction = fallback.instruction;
         directive = fallback.directive;
       } else {
         instruction = "IDLE";
-        directive = "Autonomous behavior";
+        directive = "Autonomous behavior (Offline)";
       }
     }
     const memoryContext = relevantMemories.length > 0 ? `
 Memories:
 ${relevantMemories.map((m) => `- [${m.type}] ${m.text}`).join("\n")}
 ` : "";
-    const prompt = `System: Follow this directive strictly: ${instruction} (${directive}).
-To Target: ${target || "None"}${memoryContext}
+    const prompt = `System: You are ${config.persona}.
+Directive: ${instruction} (${directive}).
+Target: ${target || "None"}${memoryContext}
 User: ${input}
 Agent:`;
     const generatedText = await cortex.complete(prompt);
     let signature = "unsigned_local_fallback";
     let isValid = true;
-    const proposedAction = { type: instruction, reason: directive, target };
     try {
       const verRes = await fetch(`${apiUrl}/agents/${agentId}/verdict`, {
         method: "POST",
@@ -297,13 +236,14 @@ Agent:`;
         body: JSON.stringify({
           verDirective: {
             dirInstruction: instruction,
-            dirTarget: target,
+            dirTarget: target || "",
             dirReason: directive
           },
           verAction: {
-            actionType: instruction,
+            gaType: instruction,
+            // Map to generic action type
             actionReason: directive,
-            actionTarget: target
+            actionTarget: target || ""
           },
           verThought: generatedText
         })
@@ -314,7 +254,7 @@ Agent:`;
         signature = vData.verSignature;
       }
     } catch (e) {
-      console.warn("API Verdict Failed.", e);
+      console.warn("API Verdict Failed. Assuming valid locally.", e);
     }
     if (!isValid) {
       return {
@@ -328,8 +268,13 @@ Agent:`;
     }
     return {
       dialogue: generatedText,
-      action: { ...proposedAction, signature },
-      thought: `Directive: ${directive} | Sig: ${signature}`
+      action: {
+        type: instruction,
+        reason: directive,
+        target,
+        signature
+      },
+      thought: `Directive: ${directive}`
     };
   };
   const exportSoul2 = async () => {
@@ -337,17 +282,10 @@ Agent:`;
     if (config.memory && typeof config.memory.export === "function") {
       try {
         exportedMemories = await config.memory.export();
-      } catch (e) {
-        console.warn("Failed to export memories from module:", e);
+      } catch {
       }
     }
-    return exportToSoul(
-      agentId,
-      "Agent",
-      config.persona,
-      state,
-      exportedMemories
-    );
+    return exportToSoul(agentId, "Agent", config.persona, state, exportedMemories);
   };
   return {
     process: process2,
@@ -511,6 +449,16 @@ var createSoulInstance = (id, name, persona, state, memories = [], initialApiUrl
     toJSON: () => ({ ...soulData })
   };
 };
+var validateSoul = (soul) => {
+  const errors = [];
+  if (!soul.id) errors.push("Missing id");
+  if (!soul.persona) errors.push("Missing persona");
+  if (!soul.state) errors.push("Missing state");
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+};
 
 // src/memory.ts
 import * as path3 from "path";
@@ -1206,7 +1154,7 @@ var socialRules = [speakRule, interactRule];
 var puzzleRules = [movementRule, interactRule];
 
 // src/index.ts
-var SDK_VERSION = "0.3.17";
+var SDK_VERSION = "0.4.2";
 var init = () => {
   console.log(`
 \x1B[36m  _  _                     _    ___      _    _
@@ -1255,5 +1203,6 @@ export {
   updateAgentState,
   uploadToArweave,
   validateAction,
+  validateSoul,
   waitForGhostCompletion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forbocai",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "license": "UNLICENSED",
   "description": "The Infrastructure Layer for Autonomous AI Characters",
   "main": "dist/index.js",
@@ -45,4 +45,4 @@
     "glob": "^11.0.0",
     "rimraf": "^5.0.0"
   }
-}
+}