@forbocai/core 0.5.6 → 0.5.7

package/dist/index.d.mts

@@ -49,6 +49,7 @@ interface AgentConfig {
     persona: string;
     initialState?: Partial<AgentState>;
     apiUrl?: string;
+    apiKey?: string;
 }
 interface AgentResponse {
     dialogue: string;
@@ -100,6 +101,20 @@ interface RecalledMemory {
     importance: number;
     similarity?: number;
 }
+/** Speak Request (Simple Dialogue) */
+interface SpeakRequest {
+    speakMessage: string;
+    speakContext?: Record<string, unknown>;
+    speakAgentState: Record<string, unknown>;
+}
+/** Speak Response (Simple Dialogue) */
+interface SpeakResponse {
+    speakReply: string;
+    speakHistory: Array<{
+        role: string;
+        content: string;
+    }>;
+}
 /** Step 5: API → SDK. API returns full SLM prompt + constraints. */
 interface ContextResponse {
     prompt: string;
@@ -171,6 +186,17 @@ interface IAgent {
      * @returns A promise that resolves to the agent's response.
      */
     process(input: string, context?: Record<string, unknown>): Promise<AgentResponse>;
+    /**
+     * Generates a conversational response (bypassing the multi-round ruleset evaluation).
+     * @param message - The input message.
+     * @param context - Optional context overrides.
+     * @returns A promise resolving to the agent's textual reply.
+     */
+    speak(message: string, context?: Record<string, unknown>): Promise<string>;
+    /**
+     * Alias for `speak()`.
+     */
+    reply(message: string, context?: Record<string, unknown>): Promise<string>;
     /**
      * Retrieves the current state of the agent.
      * @returns The current AgentState.
@@ -554,7 +580,48 @@ declare const createGhost: (config: GhostConfig) => IGhost;
  * 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 const createRemoteCortex: (apiUrl: string, cortexId?: string) => ICortex;
+declare const createRemoteCortex: (apiUrl: string, cortexId?: string, apiKey?: string) => ICortex;
+
+/**
+ * Consume an async token stream, calling `onChunk` for each token.
+ * Useful for rendering typewriter effects in UI.
+ */
+declare function streamToCallback(stream: AsyncGenerator<string, void, unknown>, onChunk: (chunk: string) => void): Promise<void>;
+/**
+ * Consume an async token stream and return the full accumulated string.
+ */
+declare function streamToString(stream: AsyncGenerator<string, void, unknown>): Promise<string>;
+/**
+ * Stream tokens from a cortex directly to a callback.
+ * Convenience wrapper combining cortex.completeStream + streamToCallback.
+ *
+ * @example
+ * // Typewriter effect in a React component:
+ * await streamFromCortex(cortex, prompt, (token) => {
+ *   setDisplayText(prev => prev + token);
+ * });
+ */
+declare function streamFromCortex(cortex: ICortex, prompt: string, onChunk: (chunk: string) => void, options?: {
+    temperature?: number;
+    maxTokens?: number;
+    stop?: string[];
+}): Promise<string>;
+/**
+ * Stream tokens from a cortex with a delay between tokens (for typewriter pacing).
+ *
+ * @param delayMs - Milliseconds to wait between tokens (default: 30ms)
+ *
+ * @example
+ * await streamFromCortexWithDelay(cortex, prompt, (token) => {
+ *   setDisplayText(prev => prev + token);
+ * }, { delayMs: 25 });
+ */
+declare function streamFromCortexWithDelay(cortex: ICortex, prompt: string, onChunk: (chunk: string) => void, options?: {
+    temperature?: number;
+    maxTokens?: number;
+    stop?: string[];
+    delayMs?: number;
+}): Promise<string>;
 
 interface RPGAgentState extends AgentState {
     inventory: string[];
@@ -605,6 +672,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.6";
+declare const SDK_VERSION = "0.5.7";
 
-export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexStatus, type DirectiveRequest, type DirectiveResponse, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, 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, 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 DirectiveRequest, type DirectiveResponse, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type PromptConstraints, type RecalledMemory, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type SpeakRequest, type SpeakResponse, 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, serializeSoul, startGhostSession, stopGhostSession, streamFromCortex, streamFromCortexWithDelay, streamToCallback, streamToString, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };

package/dist/index.d.ts

@@ -49,6 +49,7 @@ interface AgentConfig {
     persona: string;
     initialState?: Partial<AgentState>;
     apiUrl?: string;
+    apiKey?: string;
 }
 interface AgentResponse {
     dialogue: string;
@@ -100,6 +101,20 @@ interface RecalledMemory {
     importance: number;
     similarity?: number;
 }
+/** Speak Request (Simple Dialogue) */
+interface SpeakRequest {
+    speakMessage: string;
+    speakContext?: Record<string, unknown>;
+    speakAgentState: Record<string, unknown>;
+}
+/** Speak Response (Simple Dialogue) */
+interface SpeakResponse {
+    speakReply: string;
+    speakHistory: Array<{
+        role: string;
+        content: string;
+    }>;
+}
 /** Step 5: API → SDK. API returns full SLM prompt + constraints. */
 interface ContextResponse {
     prompt: string;
@@ -171,6 +186,17 @@ interface IAgent {
      * @returns A promise that resolves to the agent's response.
      */
     process(input: string, context?: Record<string, unknown>): Promise<AgentResponse>;
+    /**
+     * Generates a conversational response (bypassing the multi-round ruleset evaluation).
+     * @param message - The input message.
+     * @param context - Optional context overrides.
+     * @returns A promise resolving to the agent's textual reply.
+     */
+    speak(message: string, context?: Record<string, unknown>): Promise<string>;
+    /**
+     * Alias for `speak()`.
+     */
+    reply(message: string, context?: Record<string, unknown>): Promise<string>;
     /**
      * Retrieves the current state of the agent.
      * @returns The current AgentState.
@@ -554,7 +580,48 @@ declare const createGhost: (config: GhostConfig) => IGhost;
  * 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 const createRemoteCortex: (apiUrl: string, cortexId?: string) => ICortex;
+declare const createRemoteCortex: (apiUrl: string, cortexId?: string, apiKey?: string) => ICortex;
+
+/**
+ * Consume an async token stream, calling `onChunk` for each token.
+ * Useful for rendering typewriter effects in UI.
+ */
+declare function streamToCallback(stream: AsyncGenerator<string, void, unknown>, onChunk: (chunk: string) => void): Promise<void>;
+/**
+ * Consume an async token stream and return the full accumulated string.
+ */
+declare function streamToString(stream: AsyncGenerator<string, void, unknown>): Promise<string>;
+/**
+ * Stream tokens from a cortex directly to a callback.
+ * Convenience wrapper combining cortex.completeStream + streamToCallback.
+ *
+ * @example
+ * // Typewriter effect in a React component:
+ * await streamFromCortex(cortex, prompt, (token) => {
+ *   setDisplayText(prev => prev + token);
+ * });
+ */
+declare function streamFromCortex(cortex: ICortex, prompt: string, onChunk: (chunk: string) => void, options?: {
+    temperature?: number;
+    maxTokens?: number;
+    stop?: string[];
+}): Promise<string>;
+/**
+ * Stream tokens from a cortex with a delay between tokens (for typewriter pacing).
+ *
+ * @param delayMs - Milliseconds to wait between tokens (default: 30ms)
+ *
+ * @example
+ * await streamFromCortexWithDelay(cortex, prompt, (token) => {
+ *   setDisplayText(prev => prev + token);
+ * }, { delayMs: 25 });
+ */
+declare function streamFromCortexWithDelay(cortex: ICortex, prompt: string, onChunk: (chunk: string) => void, options?: {
+    temperature?: number;
+    maxTokens?: number;
+    stop?: string[];
+    delayMs?: number;
+}): Promise<string>;
 
 interface RPGAgentState extends AgentState {
     inventory: string[];
@@ -605,6 +672,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.6";
+declare const SDK_VERSION = "0.5.7";
 
-export { type AgentAction, type AgentConfig, type AgentResponse, type AgentState, type BridgeConfig, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexStatus, type DirectiveRequest, type DirectiveResponse, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, 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, 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 DirectiveRequest, type DirectiveResponse, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostStatus, type GhostTestResult, type IAgent, type IBridge, type ICortex, type IGhost, type IMemory, type ISoul, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type PromptConstraints, type RecalledMemory, SDK_VERSION, type Soul, type SoulExportConfig, type SoulExportResult, type SoulImportConfig, type SoulListEntry, type SpeakRequest, type SpeakResponse, 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, serializeSoul, startGhostSession, stopGhostSession, streamFromCortex, streamFromCortexWithDelay, streamToCallback, streamToString, updateAgentState, uploadToArweave, validateAction, validateSoul, waitForGhostCompletion };

package/dist/index.js

@@ -284,6 +284,10 @@ __export(index_exports, {
   serializeSoul: () => serializeSoul,
   startGhostSession: () => startGhostSession,
   stopGhostSession: () => stopGhostSession,
+  streamFromCortex: () => streamFromCortex,
+  streamFromCortexWithDelay: () => streamFromCortexWithDelay,
+  streamToCallback: () => streamToCallback,
+  streamToString: () => streamToString,
   updateAgentState: () => updateAgentState,
   uploadToArweave: () => uploadToArweave,
   validateAction: () => validateAction,
@@ -317,6 +321,7 @@ var createAgent = (config) => {
   const cortex = config.cortex;
   const apiUrl = config.apiUrl || "https://api.forboc.ai";
   const agentId = config.id || "agent-" + Math.random().toString(36).substring(7);
+  const authHeaders = config.apiKey ? { "Content-Type": "application/json", "Authorization": `Bearer ${config.apiKey}` } : { "Content-Type": "application/json" };
   const getAgentState = () => {
     return { ...state };
   };
@@ -332,7 +337,7 @@ var createAgent = (config) => {
     };
     const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify(directiveBody)
     });
     if (!dirRes.ok) {
@@ -364,7 +369,7 @@ var createAgent = (config) => {
     };
     const ctxRes = await fetch(`${apiUrl}/agents/${agentId}/context`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify(contextBody)
     });
     if (!ctxRes.ok) {
@@ -383,7 +388,7 @@ var createAgent = (config) => {
     };
     const verRes = await fetch(`${apiUrl}/agents/${agentId}/verdict`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify(verdictBody)
     });
     if (!verRes.ok) {
@@ -413,6 +418,28 @@ var createAgent = (config) => {
       thought: generatedText
     };
   };
+  const speak = async (message, context = {}) => {
+    const currentState = getAgentState();
+    const speakBody = {
+      speakMessage: message,
+      speakContext: Object.keys(context).length > 0 ? context : void 0,
+      speakAgentState: currentState
+    };
+    const res = await fetch(`${apiUrl}/agents/${agentId}/speak`, {
+      method: "POST",
+      headers: authHeaders,
+      body: JSON.stringify(speakBody)
+    });
+    if (!res.ok) {
+      throw new Error(`API Speak Error: ${res.status}`);
+    }
+    const data = await res.json();
+    if (data.speakHistory) {
+      state = updateAgentState(state, { conversationHistory: data.speakHistory });
+    }
+    return data.speakReply;
+  };
+  const reply = speak;
   const exportSoul2 = async () => {
     let exportedMemories = [];
     if (config.memory && typeof config.memory.export === "function") {
@@ -426,6 +453,8 @@ var createAgent = (config) => {
   };
   return {
     process,
+    speak,
+    reply,
     getState: getAgentState,
     setState: setAgentState,
     export: exportSoul2
@@ -906,7 +935,11 @@ var createGhost = (config) => {
 };
 
 // src/cortex-remote.ts
-var createRemoteCortex = (apiUrl, cortexId = "local") => {
+var createRemoteCortex = (apiUrl, cortexId = "local", apiKey) => {
+  const authHeaders = {
+    "Content-Type": "application/json",
+    ...apiKey ? { "Authorization": `Bearer ${apiKey}` } : {}
+  };
   const init = async () => ({
     id: `remote_${Date.now()}`,
     model: "api-integrated",
@@ -916,7 +949,7 @@ var createRemoteCortex = (apiUrl, cortexId = "local") => {
   const complete = async (prompt, options) => {
     const response = await fetch(`${apiUrl}/cortex/${cortexId}/complete`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify({ prompt, ...options })
     });
     if (!response.ok) throw new Error(`Remote Cortex failed: ${response.statusText}`);
@@ -930,6 +963,42 @@ var createRemoteCortex = (apiUrl, cortexId = "local") => {
   return { init, complete, completeStream };
 };
 
+// src/stream.ts
+async function streamToCallback(stream, onChunk) {
+  for await (const chunk of stream) {
+    onChunk(chunk);
+  }
+}
+async function streamToString(stream) {
+  let fullText = "";
+  for await (const chunk of stream) {
+    fullText += chunk;
+  }
+  return fullText;
+}
+async function streamFromCortex(cortex, prompt, onChunk, options) {
+  const stream = cortex.completeStream(prompt, options);
+  let fullText = "";
+  for await (const chunk of stream) {
+    fullText += chunk;
+    onChunk(chunk);
+  }
+  return fullText;
+}
+async function streamFromCortexWithDelay(cortex, prompt, onChunk, options) {
+  const { delayMs = 30, ...completionOptions } = options ?? {};
+  const stream = cortex.completeStream(prompt, completionOptions);
+  let fullText = "";
+  for await (const chunk of stream) {
+    fullText += chunk;
+    onChunk(chunk);
+    if (delayMs > 0) {
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
+    }
+  }
+  return fullText;
+}
+
 // src/presets/index.ts
 var presets_exports = {};
 __export(presets_exports, {
@@ -1137,7 +1206,7 @@ var socialRules = [speakRule, interactRule];
 var puzzleRules = [movementRule, interactRule];
 
 // src/index.ts
-var SDK_VERSION = "0.5.6";
+var SDK_VERSION = "0.5.7";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SDK_VERSION,
@@ -1161,6 +1230,10 @@ var SDK_VERSION = "0.5.6";
   serializeSoul,
   startGhostSession,
   stopGhostSession,
+  streamFromCortex,
+  streamFromCortexWithDelay,
+  streamToCallback,
+  streamToString,
   updateAgentState,
   uploadToArweave,
   validateAction,

package/dist/index.mjs

@@ -27,6 +27,7 @@ var createAgent = (config) => {
   const cortex = config.cortex;
   const apiUrl = config.apiUrl || "https://api.forboc.ai";
   const agentId = config.id || "agent-" + Math.random().toString(36).substring(7);
+  const authHeaders = config.apiKey ? { "Content-Type": "application/json", "Authorization": `Bearer ${config.apiKey}` } : { "Content-Type": "application/json" };
   const getAgentState = () => {
     return { ...state };
   };
@@ -42,7 +43,7 @@ var createAgent = (config) => {
     };
     const dirRes = await fetch(`${apiUrl}/agents/${agentId}/directive`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify(directiveBody)
     });
     if (!dirRes.ok) {
@@ -74,7 +75,7 @@ var createAgent = (config) => {
     };
     const ctxRes = await fetch(`${apiUrl}/agents/${agentId}/context`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify(contextBody)
     });
     if (!ctxRes.ok) {
@@ -93,7 +94,7 @@ var createAgent = (config) => {
     };
     const verRes = await fetch(`${apiUrl}/agents/${agentId}/verdict`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify(verdictBody)
     });
     if (!verRes.ok) {
@@ -123,6 +124,28 @@ var createAgent = (config) => {
       thought: generatedText
     };
   };
+  const speak = async (message, context = {}) => {
+    const currentState = getAgentState();
+    const speakBody = {
+      speakMessage: message,
+      speakContext: Object.keys(context).length > 0 ? context : void 0,
+      speakAgentState: currentState
+    };
+    const res = await fetch(`${apiUrl}/agents/${agentId}/speak`, {
+      method: "POST",
+      headers: authHeaders,
+      body: JSON.stringify(speakBody)
+    });
+    if (!res.ok) {
+      throw new Error(`API Speak Error: ${res.status}`);
+    }
+    const data = await res.json();
+    if (data.speakHistory) {
+      state = updateAgentState(state, { conversationHistory: data.speakHistory });
+    }
+    return data.speakReply;
+  };
+  const reply = speak;
   const exportSoul2 = async () => {
     let exportedMemories = [];
     if (config.memory && typeof config.memory.export === "function") {
@@ -136,6 +159,8 @@ var createAgent = (config) => {
   };
   return {
     process,
+    speak,
+    reply,
     getState: getAgentState,
     setState: setAgentState,
     export: exportSoul2
@@ -616,7 +641,11 @@ var createGhost = (config) => {
 };
 
 // src/cortex-remote.ts
-var createRemoteCortex = (apiUrl, cortexId = "local") => {
+var createRemoteCortex = (apiUrl, cortexId = "local", apiKey) => {
+  const authHeaders = {
+    "Content-Type": "application/json",
+    ...apiKey ? { "Authorization": `Bearer ${apiKey}` } : {}
+  };
   const init = async () => ({
     id: `remote_${Date.now()}`,
     model: "api-integrated",
@@ -626,7 +655,7 @@ var createRemoteCortex = (apiUrl, cortexId = "local") => {
   const complete = async (prompt, options) => {
     const response = await fetch(`${apiUrl}/cortex/${cortexId}/complete`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: authHeaders,
       body: JSON.stringify({ prompt, ...options })
     });
     if (!response.ok) throw new Error(`Remote Cortex failed: ${response.statusText}`);
@@ -640,6 +669,42 @@ var createRemoteCortex = (apiUrl, cortexId = "local") => {
   return { init, complete, completeStream };
 };
 
+// src/stream.ts
+async function streamToCallback(stream, onChunk) {
+  for await (const chunk of stream) {
+    onChunk(chunk);
+  }
+}
+async function streamToString(stream) {
+  let fullText = "";
+  for await (const chunk of stream) {
+    fullText += chunk;
+  }
+  return fullText;
+}
+async function streamFromCortex(cortex, prompt, onChunk, options) {
+  const stream = cortex.completeStream(prompt, options);
+  let fullText = "";
+  for await (const chunk of stream) {
+    fullText += chunk;
+    onChunk(chunk);
+  }
+  return fullText;
+}
+async function streamFromCortexWithDelay(cortex, prompt, onChunk, options) {
+  const { delayMs = 30, ...completionOptions } = options ?? {};
+  const stream = cortex.completeStream(prompt, completionOptions);
+  let fullText = "";
+  for await (const chunk of stream) {
+    fullText += chunk;
+    onChunk(chunk);
+    if (delayMs > 0) {
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
+    }
+  }
+  return fullText;
+}
+
 // src/presets/index.ts
 var presets_exports = {};
 __export(presets_exports, {
@@ -847,7 +912,7 @@ var socialRules = [speakRule, interactRule];
 var puzzleRules = [movementRule, interactRule];
 
 // src/index.ts
-var SDK_VERSION = "0.5.6";
+var SDK_VERSION = "0.5.7";
 export {
   SDK_VERSION,
   createAgent,
@@ -870,6 +935,10 @@ export {
   serializeSoul,
   startGhostSession,
   stopGhostSession,
+  streamFromCortex,
+  streamFromCortexWithDelay,
+  streamToCallback,
+  streamToString,
   updateAgentState,
   uploadToArweave,
   validateAction,

package/package.json

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