@forbocai/core 0.5.0 → 0.5.2

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 /**
  * ForbocAI Core Types
- * The foundational interfaces for the Neuro-Symbolic Protocol.
+ * The foundational interfaces for the Multi-Round Protocol.
  */
 interface CortexConfig {
-    /** The model to load (e.g., 'smollm2-135m', 'llama3-8b-q4') */
-    model: string;
+    /** Internal — runtime-specific model override. Not intended for game developers. */
+    model?: string;
     /** Optional overrides for model parameters */
     temperature?: number;
     maxTokens?: number;
@@ -87,6 +87,67 @@ interface AgentAction {
     confidence?: number;
     signature?: string;
 }
+/** Step 2: SDK → API. SDK sends observation + agent state. */
+interface DirectiveRequest {
+    observation: string;
+    agentState: AgentState;
+    context?: Record<string, unknown>;
+}
+/** Step 3: API → SDK. API returns memory recall instructions. */
+interface DirectiveResponse {
+    memoryRecall: MemoryRecallInstruction;
+}
+/** API tells SDK exactly what to recall from local vector DB. */
+interface MemoryRecallInstruction {
+    query: string;
+    limit: number;
+    threshold: number;
+}
+/** Step 4: SDK → API. SDK sends recalled memories. */
+interface ContextRequest {
+    memories: RecalledMemory[];
+    observation: string;
+    agentState: AgentState;
+}
+/** A memory item as recalled by the SDK's local vector DB. */
+interface RecalledMemory {
+    text: string;
+    type: string;
+    importance: number;
+    similarity?: number;
+}
+/** Step 5: API → SDK. API returns full SLM prompt + constraints. */
+interface ContextResponse {
+    prompt: string;
+    constraints: PromptConstraints;
+}
+/** Constraints the API sends to control SLM generation. */
+interface PromptConstraints {
+    maxTokens?: number;
+    temperature?: number;
+    stop?: string[];
+    jsonSchema?: object;
+}
+/** Step 7: SDK → API. SDK sends generated output. */
+interface VerdictRequest {
+    generatedOutput: string;
+    observation: string;
+    agentState: AgentState;
+}
+/** Step 8: API → SDK. API returns verdict + storage/state instructions. */
+interface VerdictResponse {
+    valid: boolean;
+    signature?: string;
+    memoryStore: MemoryStoreInstruction[];
+    stateDelta: Record<string, unknown>;
+    action?: AgentAction;
+}
+/** API tells SDK exactly what to store in local vector DB. */
+interface MemoryStoreInstruction {
+    text: string;
+    type: string;
+    importance: number;
+}
 interface ValidationContext {
     agentState?: Record<string, unknown>;
     worldState?: Record<string, unknown>;
@@ -114,15 +175,13 @@ interface Soul {
     signature?: string;
 }
 
-/**
- * Interface for Agent operations
- */
 /**
  * Interface for Agent operations
  */
 interface IAgent {
     /**
      * Processes an input string with optional context to generate a response.
+     * Follows the multi-round protocol: directive → context → verdict.
      * @param input - The input string from the user or system.
      * @param context - Optional context data to influence the agent's response.
      * @returns A promise that resolves to the agent's response.
@@ -178,6 +237,7 @@ declare const processAgentInput: (currentState: AgentState, input: string, conte
 declare const exportToSoul: (agentId: string, name: string, persona: string, state: AgentState, memories: MemoryItem[]) => Soul;
 /**
  * Factory function to create Agent (Functional/Closure based)
+ * Implements the multi-round protocol where the SDK is a dumb executor.
  * @param config - The configuration object for creating the agent.
  * @returns An instance of IAgent.
  */
@@ -532,16 +592,10 @@ declare const getGhostHistory: (limit?: number, apiUrl?: string) => Promise<Ghos
 declare const createGhost: (config: GhostConfig) => IGhost;
 
 /**
- * Remote Cortex implementation that proxies inference to the ForbocAI API.
+ * Creates a remote Cortex instance that proxies inference to the ForbocAI API.
  * This is environment-agnostic as it only uses the standard fetch API.
  */
-declare class RemoteCortex implements ICortex {
-    private apiUrl;
-    constructor(apiUrl: string);
-    init(): Promise<CortexStatus>;
-    complete(prompt: string, options?: CompletionOptions): Promise<string>;
-    completeStream(prompt: string, options?: CompletionOptions): AsyncGenerator<string>;
-}
+declare const createRemoteCortex: (apiUrl: string) => ICortex;
 
 interface RPGAgentState extends AgentState {
     inventory: string[];
@@ -592,6 +646,6 @@ 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_rpgRules as rpgRules, index_socialRules as socialRules, index_spatialRules as spatialRules, index_speakRule as speakRule };
 }
 
-declare const SDK_VERSION = "0.5.0";
+declare const SDK_VERSION = "0.5.2";
 
-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 ISoul, type MemoryConfig, type MemoryItem, type MemoryType, type Mood, type Observation, RemoteCortex, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, createAgent, createBridge, createGhost, createInitialState, createSoul, createSoulInstance, deserializeSoul, exportSoul, exportToSoul, fromSoul, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, importSoulFromArweave, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };
+export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexStatus, type Directive, type DirectiveRequest, type DirectiveResponse, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type ISoul, type MemoryConfig, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type MemoryType, type Mood, type Observation, type PromptConstraints, type RecalledMemory, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, type VerdictRequest, type VerdictResponse, createAgent, createBridge, createGhost, createInitialState, createRemoteCortex, createSoul, createSoulInstance, deserializeSoul, exportSoul, exportToSoul, fromSoul, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, importSoulFromArweave, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * ForbocAI Core Types
- * The foundational interfaces for the Neuro-Symbolic Protocol.
+ * The foundational interfaces for the Multi-Round Protocol.
  */
 interface CortexConfig {
-    /** The model to load (e.g., 'smollm2-135m', 'llama3-8b-q4') */
-    model: string;
+    /** Internal — runtime-specific model override. Not intended for game developers. */
+    model?: string;
     /** Optional overrides for model parameters */
     temperature?: number;
     maxTokens?: number;
@@ -87,6 +87,67 @@ interface AgentAction {
     confidence?: number;
     signature?: string;
 }
+/** Step 2: SDK → API. SDK sends observation + agent state. */
+interface DirectiveRequest {
+    observation: string;
+    agentState: AgentState;
+    context?: Record<string, unknown>;
+}
+/** Step 3: API → SDK. API returns memory recall instructions. */
+interface DirectiveResponse {
+    memoryRecall: MemoryRecallInstruction;
+}
+/** API tells SDK exactly what to recall from local vector DB. */
+interface MemoryRecallInstruction {
+    query: string;
+    limit: number;
+    threshold: number;
+}
+/** Step 4: SDK → API. SDK sends recalled memories. */
+interface ContextRequest {
+    memories: RecalledMemory[];
+    observation: string;
+    agentState: AgentState;
+}
+/** A memory item as recalled by the SDK's local vector DB. */
+interface RecalledMemory {
+    text: string;
+    type: string;
+    importance: number;
+    similarity?: number;
+}
+/** Step 5: API → SDK. API returns full SLM prompt + constraints. */
+interface ContextResponse {
+    prompt: string;
+    constraints: PromptConstraints;
+}
+/** Constraints the API sends to control SLM generation. */
+interface PromptConstraints {
+    maxTokens?: number;
+    temperature?: number;
+    stop?: string[];
+    jsonSchema?: object;
+}
+/** Step 7: SDK → API. SDK sends generated output. */
+interface VerdictRequest {
+    generatedOutput: string;
+    observation: string;
+    agentState: AgentState;
+}
+/** Step 8: API → SDK. API returns verdict + storage/state instructions. */
+interface VerdictResponse {
+    valid: boolean;
+    signature?: string;
+    memoryStore: MemoryStoreInstruction[];
+    stateDelta: Record<string, unknown>;
+    action?: AgentAction;
+}
+/** API tells SDK exactly what to store in local vector DB. */
+interface MemoryStoreInstruction {
+    text: string;
+    type: string;
+    importance: number;
+}
 interface ValidationContext {
     agentState?: Record<string, unknown>;
     worldState?: Record<string, unknown>;
@@ -114,15 +175,13 @@ interface Soul {
     signature?: string;
 }
 
-/**
- * Interface for Agent operations
- */
 /**
  * Interface for Agent operations
  */
 interface IAgent {
     /**
      * Processes an input string with optional context to generate a response.
+     * Follows the multi-round protocol: directive → context → verdict.
      * @param input - The input string from the user or system.
      * @param context - Optional context data to influence the agent's response.
      * @returns A promise that resolves to the agent's response.
@@ -178,6 +237,7 @@ declare const processAgentInput: (currentState: AgentState, input: string, conte
 declare const exportToSoul: (agentId: string, name: string, persona: string, state: AgentState, memories: MemoryItem[]) => Soul;
 /**
  * Factory function to create Agent (Functional/Closure based)
+ * Implements the multi-round protocol where the SDK is a dumb executor.
  * @param config - The configuration object for creating the agent.
  * @returns An instance of IAgent.
  */
@@ -532,16 +592,10 @@ declare const getGhostHistory: (limit?: number, apiUrl?: string) => Promise<Ghos
 declare const createGhost: (config: GhostConfig) => IGhost;
 
 /**
- * Remote Cortex implementation that proxies inference to the ForbocAI API.
+ * Creates a remote Cortex instance that proxies inference to the ForbocAI API.
  * This is environment-agnostic as it only uses the standard fetch API.
  */
-declare class RemoteCortex implements ICortex {
-    private apiUrl;
-    constructor(apiUrl: string);
-    init(): Promise<CortexStatus>;
-    complete(prompt: string, options?: CompletionOptions): Promise<string>;
-    completeStream(prompt: string, options?: CompletionOptions): AsyncGenerator<string>;
-}
+declare const createRemoteCortex: (apiUrl: string) => ICortex;
 
 interface RPGAgentState extends AgentState {
     inventory: string[];
@@ -592,6 +646,6 @@ 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_rpgRules as rpgRules, index_socialRules as socialRules, index_spatialRules as spatialRules, index_speakRule as speakRule };
 }
 
-declare const SDK_VERSION = "0.5.0";
+declare const SDK_VERSION = "0.5.2";
 
-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 ISoul, type MemoryConfig, type MemoryItem, type MemoryType, type Mood, type Observation, RemoteCortex, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, createAgent, createBridge, createGhost, createInitialState, createSoul, createSoulInstance, deserializeSoul, exportSoul, exportToSoul, fromSoul, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, importSoulFromArweave, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };
+export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexStatus, type Directive, type DirectiveRequest, type DirectiveResponse, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type ISoul, type MemoryConfig, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type MemoryType, type Mood, type Observation, type PromptConstraints, type RecalledMemory, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type ValidationContext, type ValidationResult, type ValidationRule, type VerdictRequest, type VerdictResponse, createAgent, createBridge, createGhost, createInitialState, createRemoteCortex, createSoul, createSoulInstance, deserializeSoul, exportSoul, exportToSoul, fromSoul, getGhostHistory, getGhostResults, getGhostStatus, getSoulList, importSoulFromArweave, index as presets, processAgentInput, serializeSoul, startGhostSession, stopGhostSession, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };

package/dist/index.js

@@ -30,12 +30,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  RemoteCortex: () => RemoteCortex,
   SDK_VERSION: () => SDK_VERSION,
   createAgent: () => createAgent,
   createBridge: () => createBridge,
   createGhost: () => createGhost,
   createInitialState: () => createInitialState,
+  createRemoteCortex: () => createRemoteCortex,
   createSoul: () => createSoul,
   createSoulInstance: () => createSoulInstance,
   deserializeSoul: () => deserializeSoul,
@@ -88,9 +88,7 @@ var exportToSoul = (agentId, name, persona, state, memories) => {
     name,
     persona,
     memories: [...memories],
-    // Copy array for immutability
     state: { ...state }
-    // Copy state for immutability
   };
 };
 var createAgent = (config) => {
@@ -107,96 +105,91 @@ var createAgent = (config) => {
   };
   const process = async (input, context = {}) => {
     const currentState = getAgentState();
-    const apiContext = Object.entries(context).map(([k, v]) => [k, String(v)]);
-    const timestamp = Date.now();
-    apiContext.push(["timestamp", String(timestamp)]);
-    let relevantMemories = [];
+    const directiveBody = {
+      observation: input,
+      agentState: currentState,
+      context
+    };
+    const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(directiveBody)
+    });
+    if (!dirRes.ok) {
+      throw new Error(`API Directive Error: ${dirRes.status}`);
+    }
+    const directiveData = await dirRes.json();
+    let recalledMemories = [];
     if (config.memory && typeof config.memory.recall === "function") {
       try {
-        relevantMemories = await config.memory.recall(input, 5);
+        const rawMemories = await config.memory.recall(
+          directiveData.memoryRecall.query,
+          directiveData.memoryRecall.limit
+        );
+        recalledMemories = rawMemories.map((m) => ({
+          text: m.text,
+          type: m.type,
+          importance: m.importance,
+          similarity: void 0
+        }));
       } catch {
       }
     }
-    let directive = "Respond normally.";
-    let instruction = "IDLE";
-    let target;
-    try {
-      const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "X-Request-Timestamp": String(timestamp)
-        },
-        body: JSON.stringify({
-          dirContext: apiContext,
-          dirState: currentState,
-          dirMemories: relevantMemories.map((m) => ({ text: m.text, type: m.type, importance: m.importance }))
-        })
-      });
-      if (dirRes.ok) {
-        const data = await dirRes.json();
-        directive = data.dirReason;
-        instruction = data.dirInstruction;
-        target = data.dirTarget;
-      } else {
-        throw new Error(`API Error: ${dirRes.status}`);
-      }
-    } catch (e) {
-      throw new Error(`API Directive Failed: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    const memoryContext = relevantMemories.length > 0 ? `
-Memories:
-${relevantMemories.map((m) => `- [${m.type}] ${m.text}`).join("\n")}
-` : "";
-    const prompt = `System: You are ${config.persona}.
-Directive: ${instruction} (${directive}).
-Target: ${target || "None"}${memoryContext}
-User: ${input}
-Agent:`;
-    const generatedText = await cortex.complete(prompt);
+    const contextBody = {
+      memories: recalledMemories,
+      observation: input,
+      agentState: currentState
+    };
+    const ctxRes = await fetch(`${apiUrl}/agents/${agentId}/context`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(contextBody)
+    });
+    if (!ctxRes.ok) {
+      throw new Error(`API Context Error: ${ctxRes.status}`);
+    }
+    const contextData = await ctxRes.json();
+    const generatedText = await cortex.complete(contextData.prompt, {
+      maxTokens: contextData.constraints.maxTokens,
+      temperature: contextData.constraints.temperature,
+      stop: contextData.constraints.stop
+    });
+    const verdictBody = {
+      generatedOutput: generatedText,
+      observation: input,
+      agentState: currentState
+    };
     const verRes = await fetch(`${apiUrl}/agents/${agentId}/verdict`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        verDirective: {
-          dirInstruction: instruction,
-          dirTarget: target || "",
-          dirReason: directive
-        },
-        verAction: {
-          gaType: instruction,
-          // Map to generic action type
-          actionReason: directive,
-          actionTarget: target || ""
-        },
-        verThought: generatedText
-      })
+      body: JSON.stringify(verdictBody)
     });
     if (!verRes.ok) {
       throw new Error(`API Verdict Error: ${verRes.status}`);
     }
-    const vData = await verRes.json();
-    const isValid = vData.verValid;
-    const signature = vData.verSignature;
-    if (!isValid) {
+    const verdictData = await verRes.json();
+    if (!verdictData.valid) {
       return {
         dialogue: "... [Action Blocked by Protocol]",
         action: { type: "BLOCKED", reason: "API Validation Failed" }
       };
     }
-    if (config.memory && typeof config.memory.store === "function") {
-      config.memory.store(`Input: "${input}" \u2192 Action: ${instruction}`, "experience", 0.5).catch(() => {
-      });
+    if (config.memory && typeof config.memory.store === "function" && verdictData.memoryStore) {
+      for (const instruction of verdictData.memoryStore) {
+        config.memory.store(instruction.text, instruction.type, instruction.importance).catch(() => {
+        });
+      }
+    }
+    if (verdictData.stateDelta && Object.keys(verdictData.stateDelta).length > 0) {
+      state = updateAgentState(state, verdictData.stateDelta);
     }
     return {
       dialogue: generatedText,
-      action: {
-        type: instruction,
-        reason: directive,
-        target,
-        signature
-      },
-      thought: `Directive: ${directive}`
+      action: verdictData.action ? {
+        ...verdictData.action,
+        signature: verdictData.signature
+      } : void 0,
+      thought: generatedText
     };
   };
   const exportSoul2 = async () => {
@@ -227,8 +220,7 @@ var fromSoul = async (soul, cortex, memory) => {
   if (memory && soul.memories && soul.memories.length > 0 && typeof memory.import === "function") {
     try {
       await memory.import(soul.memories);
-    } catch (e) {
-      console.warn("Failed to import memories into module:", e);
+    } catch {
     }
   }
   return agent;
@@ -692,20 +684,15 @@ var createGhost = (config) => {
 };
 
 // src/cortex-remote.ts
-var RemoteCortex = class {
-  constructor(apiUrl) {
-    this.apiUrl = apiUrl;
-  }
-  async init() {
-    return {
-      id: `remote_${Date.now()}`,
-      model: "api-integrated",
-      ready: true,
-      engine: "remote"
-    };
-  }
-  async complete(prompt, options) {
-    const response = await fetch(`${this.apiUrl}/cortex/complete`, {
+var createRemoteCortex = (apiUrl) => {
+  const init = async () => ({
+    id: `remote_${Date.now()}`,
+    model: "api-integrated",
+    ready: true,
+    engine: "remote"
+  });
+  const complete = async (prompt, options) => {
+    const response = await fetch(`${apiUrl}/cortex/complete`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ prompt, ...options })
@@ -713,11 +700,12 @@ var RemoteCortex = class {
     if (!response.ok) throw new Error(`Remote Cortex failed: ${response.statusText}`);
     const data = await response.json();
     return data.text;
-  }
-  async *completeStream(prompt, options) {
-    const result = await this.complete(prompt, options);
+  };
+  const completeStream = async function* (prompt, options) {
+    const result = await complete(prompt, options);
     yield result;
-  }
+  };
+  return { init, complete, completeStream };
 };
 
 // src/presets/index.ts
@@ -927,15 +915,15 @@ var socialRules = [speakRule, interactRule];
 var puzzleRules = [movementRule, interactRule];
 
 // src/index.ts
-var SDK_VERSION = "0.5.0";
+var SDK_VERSION = "0.5.2";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  RemoteCortex,
   SDK_VERSION,
   createAgent,
   createBridge,
   createGhost,
   createInitialState,
+  createRemoteCortex,
   createSoul,
   createSoulInstance,
   deserializeSoul,

package/dist/index.mjs

@@ -32,9 +32,7 @@ var exportToSoul = (agentId, name, persona, state, memories) => {
     name,
     persona,
     memories: [...memories],
-    // Copy array for immutability
     state: { ...state }
-    // Copy state for immutability
   };
 };
 var createAgent = (config) => {
@@ -51,96 +49,91 @@ var createAgent = (config) => {
   };
   const process = async (input, context = {}) => {
     const currentState = getAgentState();
-    const apiContext = Object.entries(context).map(([k, v]) => [k, String(v)]);
-    const timestamp = Date.now();
-    apiContext.push(["timestamp", String(timestamp)]);
-    let relevantMemories = [];
+    const directiveBody = {
+      observation: input,
+      agentState: currentState,
+      context
+    };
+    const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(directiveBody)
+    });
+    if (!dirRes.ok) {
+      throw new Error(`API Directive Error: ${dirRes.status}`);
+    }
+    const directiveData = await dirRes.json();
+    let recalledMemories = [];
     if (config.memory && typeof config.memory.recall === "function") {
       try {
-        relevantMemories = await config.memory.recall(input, 5);
+        const rawMemories = await config.memory.recall(
+          directiveData.memoryRecall.query,
+          directiveData.memoryRecall.limit
+        );
+        recalledMemories = rawMemories.map((m) => ({
+          text: m.text,
+          type: m.type,
+          importance: m.importance,
+          similarity: void 0
+        }));
       } catch {
       }
     }
-    let directive = "Respond normally.";
-    let instruction = "IDLE";
-    let target;
-    try {
-      const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "X-Request-Timestamp": String(timestamp)
-        },
-        body: JSON.stringify({
-          dirContext: apiContext,
-          dirState: currentState,
-          dirMemories: relevantMemories.map((m) => ({ text: m.text, type: m.type, importance: m.importance }))
-        })
-      });
-      if (dirRes.ok) {
-        const data = await dirRes.json();
-        directive = data.dirReason;
-        instruction = data.dirInstruction;
-        target = data.dirTarget;
-      } else {
-        throw new Error(`API Error: ${dirRes.status}`);
-      }
-    } catch (e) {
-      throw new Error(`API Directive Failed: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    const memoryContext = relevantMemories.length > 0 ? `
-Memories:
-${relevantMemories.map((m) => `- [${m.type}] ${m.text}`).join("\n")}
-` : "";
-    const prompt = `System: You are ${config.persona}.
-Directive: ${instruction} (${directive}).
-Target: ${target || "None"}${memoryContext}
-User: ${input}
-Agent:`;
-    const generatedText = await cortex.complete(prompt);
+    const contextBody = {
+      memories: recalledMemories,
+      observation: input,
+      agentState: currentState
+    };
+    const ctxRes = await fetch(`${apiUrl}/agents/${agentId}/context`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(contextBody)
+    });
+    if (!ctxRes.ok) {
+      throw new Error(`API Context Error: ${ctxRes.status}`);
+    }
+    const contextData = await ctxRes.json();
+    const generatedText = await cortex.complete(contextData.prompt, {
+      maxTokens: contextData.constraints.maxTokens,
+      temperature: contextData.constraints.temperature,
+      stop: contextData.constraints.stop
+    });
+    const verdictBody = {
+      generatedOutput: generatedText,
+      observation: input,
+      agentState: currentState
+    };
     const verRes = await fetch(`${apiUrl}/agents/${agentId}/verdict`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        verDirective: {
-          dirInstruction: instruction,
-          dirTarget: target || "",
-          dirReason: directive
-        },
-        verAction: {
-          gaType: instruction,
-          // Map to generic action type
-          actionReason: directive,
-          actionTarget: target || ""
-        },
-        verThought: generatedText
-      })
+      body: JSON.stringify(verdictBody)
     });
     if (!verRes.ok) {
       throw new Error(`API Verdict Error: ${verRes.status}`);
     }
-    const vData = await verRes.json();
-    const isValid = vData.verValid;
-    const signature = vData.verSignature;
-    if (!isValid) {
+    const verdictData = await verRes.json();
+    if (!verdictData.valid) {
       return {
         dialogue: "... [Action Blocked by Protocol]",
         action: { type: "BLOCKED", reason: "API Validation Failed" }
       };
     }
-    if (config.memory && typeof config.memory.store === "function") {
-      config.memory.store(`Input: "${input}" \u2192 Action: ${instruction}`, "experience", 0.5).catch(() => {
-      });
+    if (config.memory && typeof config.memory.store === "function" && verdictData.memoryStore) {
+      for (const instruction of verdictData.memoryStore) {
+        config.memory.store(instruction.text, instruction.type, instruction.importance).catch(() => {
+        });
+      }
+    }
+    if (verdictData.stateDelta && Object.keys(verdictData.stateDelta).length > 0) {
+      state = updateAgentState(state, verdictData.stateDelta);
     }
     return {
       dialogue: generatedText,
-      action: {
-        type: instruction,
-        reason: directive,
-        target,
-        signature
-      },
-      thought: `Directive: ${directive}`
+      action: verdictData.action ? {
+        ...verdictData.action,
+        signature: verdictData.signature
+      } : void 0,
+      thought: generatedText
     };
   };
   const exportSoul2 = async () => {
@@ -171,8 +164,7 @@ var fromSoul = async (soul, cortex, memory) => {
   if (memory && soul.memories && soul.memories.length > 0 && typeof memory.import === "function") {
     try {
       await memory.import(soul.memories);
-    } catch (e) {
-      console.warn("Failed to import memories into module:", e);
+    } catch {
     }
   }
   return agent;
@@ -636,20 +628,15 @@ var createGhost = (config) => {
 };
 
 // src/cortex-remote.ts
-var RemoteCortex = class {
-  constructor(apiUrl) {
-    this.apiUrl = apiUrl;
-  }
-  async init() {
-    return {
-      id: `remote_${Date.now()}`,
-      model: "api-integrated",
-      ready: true,
-      engine: "remote"
-    };
-  }
-  async complete(prompt, options) {
-    const response = await fetch(`${this.apiUrl}/cortex/complete`, {
+var createRemoteCortex = (apiUrl) => {
+  const init = async () => ({
+    id: `remote_${Date.now()}`,
+    model: "api-integrated",
+    ready: true,
+    engine: "remote"
+  });
+  const complete = async (prompt, options) => {
+    const response = await fetch(`${apiUrl}/cortex/complete`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ prompt, ...options })
@@ -657,11 +644,12 @@ var RemoteCortex = class {
     if (!response.ok) throw new Error(`Remote Cortex failed: ${response.statusText}`);
     const data = await response.json();
     return data.text;
-  }
-  async *completeStream(prompt, options) {
-    const result = await this.complete(prompt, options);
+  };
+  const completeStream = async function* (prompt, options) {
+    const result = await complete(prompt, options);
     yield result;
-  }
+  };
+  return { init, complete, completeStream };
 };
 
 // src/presets/index.ts
@@ -871,14 +859,14 @@ var socialRules = [speakRule, interactRule];
 var puzzleRules = [movementRule, interactRule];
 
 // src/index.ts
-var SDK_VERSION = "0.5.0";
+var SDK_VERSION = "0.5.2";
 export {
-  RemoteCortex,
   SDK_VERSION,
   createAgent,
   createBridge,
   createGhost,
   createInitialState,
+  createRemoteCortex,
   createSoul,
   createSoulInstance,
   deserializeSoul,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forbocai/core",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "license": "UNLICENSED",
   "description": "Core agnostic logic for ForbocAI SDK",
   "main": "dist/index.js",