npm - @forbocai/core - Versions diffs - 0.6.1 → 0.6.2 - Mend

@forbocai/core 0.6.1 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -37,6 +37,7 @@ interface MemoryItem {
     timestamp: number;
     type: string;
     importance: number;
+    similarity?: number;
 }
 interface IMemory {
     store(text: string, type?: string, importance?: number): Promise<MemoryItem>;
@@ -121,6 +122,95 @@ interface VerdictResponse {
     action?: NPCAction;
     dialogue: string;
 }
+/**
+ * User Story: As the SDK runtime, I need one accumulated "tape" payload that
+ * is echoed to the API each turn so orchestration remains stateless.
+ * ᚠ the tape hums like a cold star map passed hand to hand in the dark.
+ */
+interface ProcessTape {
+    observation: string;
+    context: Record<string, unknown>;
+    npcState: Record<string, unknown>;
+    persona?: string;
+    actor?: {
+        npcId: string;
+        persona: string;
+        data?: Record<string, unknown>;
+    };
+    memories: RecalledMemory[];
+    prompt?: string;
+    constraints?: PromptConstraints;
+    generatedOutput?: string;
+    rulesetId?: string;
+    vectorQueried?: boolean;
+}
+/**
+ * User Story: As the API orchestrator, I need the SDK to perform actor lookup
+ * as an explicit atomic side-effect.
+ * A tiny identity ping echoes through the hull before the engines spin.
+ */
+interface IdentifyActorInstruction {
+    type: 'IdentifyActor';
+}
+/**
+ * User Story: As the API orchestrator, I need vector recall to be an explicit
+ * instruction with concrete query parameters.
+ * ᚢ one sharp memory sweep, like scanning ruins with a single beam.
+ */
+interface QueryVectorInstruction {
+    type: 'QueryVector';
+    query: string;
+    limit: number;
+    threshold: number;
+}
+/**
+ * User Story: As the API orchestrator, I need local inference to execute from
+ * an API-provided prompt and constraints with zero SDK initiative.
+ * The body stays quiet and obedient while the mind scripts the pulse.
+ */
+interface ExecuteInferenceInstruction {
+    type: 'ExecuteInference';
+    prompt: string;
+    constraints: PromptConstraints;
+}
+/**
+ * User Story: As the API orchestrator, I need a terminal instruction that
+ * carries validated output plus persistence instructions for the SDK.
+ * ᚱ this is the seal at the airlock when the cycle clicks shut.
+ */
+interface FinalizeInstruction {
+    type: 'Finalize';
+    valid: boolean;
+    signature?: string;
+    memoryStore: MemoryStoreInstruction[];
+    stateTransform: Record<string, unknown>;
+    action?: NPCAction;
+    dialogue: string;
+}
+/**
+ * User Story: As protocol typing, I need one discriminated union for atomic
+ * instructions so handler dispatch is deterministic.
+ * Every branch gets its own rune and none of the wires pretend to be another.
+ */
+type NPCInstruction = IdentifyActorInstruction | QueryVectorInstruction | ExecuteInferenceInstruction | FinalizeInstruction;
+/**
+ * User Story: As the API loop transport, I need request shape consistency for
+ * the full tape and previous side-effect result.
+ * The packet stays rigid so the void between hops does not eat context.
+ */
+interface NPCProcessRequest {
+    tape: ProcessTape;
+    lastResult?: Record<string, unknown>;
+}
+/**
+ * User Story: As the SDK interpreter, I need the next instruction packaged
+ * with the updated tape every round-trip.
+ * ᚲ each return frame is one breadcrumb and one command rune forward.
+ */
+interface NPCProcessResponse {
+    instruction: NPCInstruction;
+    tape: ProcessTape;
+}
 interface ValidationContext {
     npcState?: Record<string, unknown>;
@@ -1071,6 +1161,12 @@ declare const selectNPCById: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1273,6 +1369,12 @@ declare const selectNPCIds: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1464,6 +1566,12 @@ declare const selectNPCEntities: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1655,6 +1763,12 @@ declare const selectAllNPCs: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1846,6 +1960,12 @@ declare const selectTotalNPCs: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2286,6 +2406,12 @@ declare const selectDirectiveById: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2491,6 +2617,12 @@ declare const selectAllDirectives: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2694,6 +2826,12 @@ declare const createSDKStore: <S extends ReducersMapObject>(extraReducers?: S) =
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2885,6 +3023,12 @@ declare const createSDKStore: <S extends ReducersMapObject>(extraReducers?: S) =
                 apiUrl: string;
                 apiKey?: string;
             }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+            postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+                npcId: string;
+                request: NPCProcessRequest;
+                apiUrl: string;
+                apiKey?: string;
+            }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
             postDirective: _reduxjs_toolkit_query.MutationDefinition<{
                 npcId: string;
                 request: DirectiveRequest;
@@ -3077,6 +3221,12 @@ declare const store: _reduxjs_toolkit.EnhancedStore<{
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -3268,6 +3418,12 @@ declare const store: _reduxjs_toolkit.EnhancedStore<{
                 apiUrl: string;
                 apiKey?: string;
             }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+            postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+                npcId: string;
+                request: NPCProcessRequest;
+                apiUrl: string;
+                apiKey?: string;
+            }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
             postDirective: _reduxjs_toolkit_query.MutationDefinition<{
                 npcId: string;
                 request: DirectiveRequest;
@@ -3460,6 +3616,12 @@ declare const dispatch: ((action: redux.Action<"listenerMiddleware/add">) => _re
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -3738,6 +3900,7 @@ declare const soulSlice: _reduxjs_toolkit.Slice<SoulState, {
                     timestamp: number;
                     type: string;
                     importance: number;
+                    similarity?: number | undefined;
                 }[];
                 state: {
                     [x: string]: unknown;
@@ -3757,6 +3920,7 @@ declare const soulSlice: _reduxjs_toolkit.Slice<SoulState, {
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             }[];
             state: {
                 [x: string]: unknown;
@@ -3811,7 +3975,7 @@ declare const streamFromCortexWithDelay: (cortex: ICortex, prompt: string, onChu
     delayMs?: number;
 }) => Promise<string>;
-declare const SDK_VERSION = "0.6.0";
+declare const SDK_VERSION = "0.6.1";
 /**
  * User Story: As NPC creation flows, I need lightweight id generation that
@@ -3846,6 +4010,17 @@ declare const sdkApi: _reduxjs_toolkit_query.Api<_reduxjs_toolkit_query.BaseQuer
         apiUrl: string;
         apiKey?: string;
     }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+    /**
+     * User Story: As the SDK protocol loop, I need a single process endpoint
+     * that returns one atomic instruction per turn while echoing full tape state.
+     * ᚹ one hop in, one hop out, like passing a lit shard through vacuum.
+     */
+    postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+        npcId: string;
+        request: NPCProcessRequest;
+        apiUrl: string;
+        apiKey?: string;
+    }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
     postDirective: _reduxjs_toolkit_query.MutationDefinition<{
         npcId: string;
         request: DirectiveRequest;
@@ -4022,6 +4197,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4039,6 +4215,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4056,6 +4233,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4073,6 +4251,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4090,6 +4269,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4107,6 +4287,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4124,6 +4305,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4159,6 +4341,12 @@ declare const selectMemoryById: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -4341,6 +4529,7 @@ declare const selectMemoryById: (state: {
     timestamp: number;
     type: string;
     importance: number;
+    similarity?: number | undefined;
 };
 declare const selectAllMemories: (state: {
     [x: string]: /*elided*/ any;
@@ -4357,6 +4546,12 @@ declare const selectAllMemories: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -4645,4 +4840,4 @@ declare const clearMemoryRemoteThunk: _reduxjs_toolkit.AsyncThunk<any, {
     rejectedMeta?: unknown;
 }>;
-export { type AgentConfig, type AgentResponse, type ApiStatusResponse, type BridgeRule, type BridgeState, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexInitResponse, type CortexInternalState, type CortexModelInfo, type CortexStatus, type DirectiveRequest, type DirectiveResponse, type DirectiveRuleSet, type DirectiveRun, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostRunResponse, type GhostState, type GhostStatus, type ICortex, type IMemory, type INPC, type ImportedNpc, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type NPCAction, type NPCInternalState, type NPCState, type PromptConstraints, type RecalledMemory, type SDKDispatch, type SDKState, type SDKStore, SDK_VERSION, type Soul, type SoulConfig, type SoulExportResponse, type SoulExportResult, type SoulListResponse, type SoulState, type SoulVerifyResult, type ValidationContext, type ValidationResult, type ValidationRule, type VerdictRequest, type VerdictResponse, addToHistory, blockAction, bridgeSlice, checkApiStatusThunk, clearBlock, clearBridgeValidation, clearDirectivesForNpc, clearGhostSession, clearMemoryRemoteThunk, clearSoulState, completeRemoteThunk, contextComposed, cortexInitFailed, cortexInitStart, cortexInitSuccess, cortexSlice, createInitialState, createSDKStore, delay, deleteRulesetThunk, directiveReceived, directiveRunFailed, directiveRunStarted, directiveSlice, dispatch, exportToSoul, generateNPCId, getBridgeRulesThunk, getGhostHistoryThunk, getGhostResultsThunk, getGhostStatusThunk, getSoulListThunk, ghostSlice, importNpcFromSoulThunk, importSoulFromArweaveThunk, initRemoteCortexThunk, listCortexModelsThunk, listMemoryRemoteThunk, listRulePresetsThunk, listRulesetsThunk, loadBridgePresetThunk, localExportSoulThunk, memoise, memoiseAsync, memoryClear, memoryRecallFailed, memoryRecallStart, memoryRecallSuccess, memorySlice, memoryStoreFailed, memoryStoreStart, memoryStoreSuccess, npcSlice, pipe, processNPC, recallMemoryRemoteThunk, registerRulesetThunk, remoteExportSoulThunk, removeNPC, sdkApi, selectActiveDirective, selectActiveDirectiveId, selectActiveNPC, selectActiveNpcId, selectAllDirectives, selectAllMemories, selectAllNPCs, selectDirectiveById, selectLastRecalledMemories, selectMemoryById, selectNPCById, selectNPCEntities, selectNPCIds, selectTotalNPCs, setActiveNPC, setCortexStatus, setHistory, setLastAction, setNPCInfo, setNPCState, soulSlice, startGhostThunk, stopGhostThunk, store, storeMemoryRemoteThunk, streamFromCortex, streamFromCortexWithDelay, streamToCallback, streamToString, updateNPCState, updateNPCStateLocally, validateBridgeThunk, verdictValidated, verifySoulThunk };
+export { type AgentConfig, type AgentResponse, type ApiStatusResponse, type BridgeRule, type BridgeState, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexInitResponse, type CortexInternalState, type CortexModelInfo, type CortexStatus, type DirectiveRequest, type DirectiveResponse, type DirectiveRuleSet, type DirectiveRun, type ExecuteInferenceInstruction, type FinalizeInstruction, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostRunResponse, type GhostState, type GhostStatus, type ICortex, type IMemory, type INPC, type IdentifyActorInstruction, type ImportedNpc, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type NPCAction, type NPCInstruction, type NPCInternalState, type NPCProcessRequest, type NPCProcessResponse, type NPCState, type ProcessTape, type PromptConstraints, type QueryVectorInstruction, type RecalledMemory, type SDKDispatch, type SDKState, type SDKStore, SDK_VERSION, type Soul, type SoulConfig, type SoulExportResponse, type SoulExportResult, type SoulListResponse, type SoulState, type SoulVerifyResult, type ValidationContext, type ValidationResult, type ValidationRule, type VerdictRequest, type VerdictResponse, addToHistory, blockAction, bridgeSlice, checkApiStatusThunk, clearBlock, clearBridgeValidation, clearDirectivesForNpc, clearGhostSession, clearMemoryRemoteThunk, clearSoulState, completeRemoteThunk, contextComposed, cortexInitFailed, cortexInitStart, cortexInitSuccess, cortexSlice, createInitialState, createSDKStore, delay, deleteRulesetThunk, directiveReceived, directiveRunFailed, directiveRunStarted, directiveSlice, dispatch, exportToSoul, generateNPCId, getBridgeRulesThunk, getGhostHistoryThunk, getGhostResultsThunk, getGhostStatusThunk, getSoulListThunk, ghostSlice, importNpcFromSoulThunk, importSoulFromArweaveThunk, initRemoteCortexThunk, listCortexModelsThunk, listMemoryRemoteThunk, listRulePresetsThunk, listRulesetsThunk, loadBridgePresetThunk, localExportSoulThunk, memoise, memoiseAsync, memoryClear, memoryRecallFailed, memoryRecallStart, memoryRecallSuccess, memorySlice, memoryStoreFailed, memoryStoreStart, memoryStoreSuccess, npcSlice, pipe, processNPC, recallMemoryRemoteThunk, registerRulesetThunk, remoteExportSoulThunk, removeNPC, sdkApi, selectActiveDirective, selectActiveDirectiveId, selectActiveNPC, selectActiveNpcId, selectAllDirectives, selectAllMemories, selectAllNPCs, selectDirectiveById, selectLastRecalledMemories, selectMemoryById, selectNPCById, selectNPCEntities, selectNPCIds, selectTotalNPCs, setActiveNPC, setCortexStatus, setHistory, setLastAction, setNPCInfo, setNPCState, soulSlice, startGhostThunk, stopGhostThunk, store, storeMemoryRemoteThunk, streamFromCortex, streamFromCortexWithDelay, streamToCallback, streamToString, updateNPCState, updateNPCStateLocally, validateBridgeThunk, verdictValidated, verifySoulThunk };

package/dist/index.d.ts CHANGED Viewed

@@ -37,6 +37,7 @@ interface MemoryItem {
     timestamp: number;
     type: string;
     importance: number;
+    similarity?: number;
 }
 interface IMemory {
     store(text: string, type?: string, importance?: number): Promise<MemoryItem>;
@@ -121,6 +122,95 @@ interface VerdictResponse {
     action?: NPCAction;
     dialogue: string;
 }
+/**
+ * User Story: As the SDK runtime, I need one accumulated "tape" payload that
+ * is echoed to the API each turn so orchestration remains stateless.
+ * ᚠ the tape hums like a cold star map passed hand to hand in the dark.
+ */
+interface ProcessTape {
+    observation: string;
+    context: Record<string, unknown>;
+    npcState: Record<string, unknown>;
+    persona?: string;
+    actor?: {
+        npcId: string;
+        persona: string;
+        data?: Record<string, unknown>;
+    };
+    memories: RecalledMemory[];
+    prompt?: string;
+    constraints?: PromptConstraints;
+    generatedOutput?: string;
+    rulesetId?: string;
+    vectorQueried?: boolean;
+}
+/**
+ * User Story: As the API orchestrator, I need the SDK to perform actor lookup
+ * as an explicit atomic side-effect.
+ * A tiny identity ping echoes through the hull before the engines spin.
+ */
+interface IdentifyActorInstruction {
+    type: 'IdentifyActor';
+}
+/**
+ * User Story: As the API orchestrator, I need vector recall to be an explicit
+ * instruction with concrete query parameters.
+ * ᚢ one sharp memory sweep, like scanning ruins with a single beam.
+ */
+interface QueryVectorInstruction {
+    type: 'QueryVector';
+    query: string;
+    limit: number;
+    threshold: number;
+}
+/**
+ * User Story: As the API orchestrator, I need local inference to execute from
+ * an API-provided prompt and constraints with zero SDK initiative.
+ * The body stays quiet and obedient while the mind scripts the pulse.
+ */
+interface ExecuteInferenceInstruction {
+    type: 'ExecuteInference';
+    prompt: string;
+    constraints: PromptConstraints;
+}
+/**
+ * User Story: As the API orchestrator, I need a terminal instruction that
+ * carries validated output plus persistence instructions for the SDK.
+ * ᚱ this is the seal at the airlock when the cycle clicks shut.
+ */
+interface FinalizeInstruction {
+    type: 'Finalize';
+    valid: boolean;
+    signature?: string;
+    memoryStore: MemoryStoreInstruction[];
+    stateTransform: Record<string, unknown>;
+    action?: NPCAction;
+    dialogue: string;
+}
+/**
+ * User Story: As protocol typing, I need one discriminated union for atomic
+ * instructions so handler dispatch is deterministic.
+ * Every branch gets its own rune and none of the wires pretend to be another.
+ */
+type NPCInstruction = IdentifyActorInstruction | QueryVectorInstruction | ExecuteInferenceInstruction | FinalizeInstruction;
+/**
+ * User Story: As the API loop transport, I need request shape consistency for
+ * the full tape and previous side-effect result.
+ * The packet stays rigid so the void between hops does not eat context.
+ */
+interface NPCProcessRequest {
+    tape: ProcessTape;
+    lastResult?: Record<string, unknown>;
+}
+/**
+ * User Story: As the SDK interpreter, I need the next instruction packaged
+ * with the updated tape every round-trip.
+ * ᚲ each return frame is one breadcrumb and one command rune forward.
+ */
+interface NPCProcessResponse {
+    instruction: NPCInstruction;
+    tape: ProcessTape;
+}
 interface ValidationContext {
     npcState?: Record<string, unknown>;
@@ -1071,6 +1161,12 @@ declare const selectNPCById: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1273,6 +1369,12 @@ declare const selectNPCIds: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1464,6 +1566,12 @@ declare const selectNPCEntities: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1655,6 +1763,12 @@ declare const selectAllNPCs: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -1846,6 +1960,12 @@ declare const selectTotalNPCs: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2286,6 +2406,12 @@ declare const selectDirectiveById: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2491,6 +2617,12 @@ declare const selectAllDirectives: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2694,6 +2826,12 @@ declare const createSDKStore: <S extends ReducersMapObject>(extraReducers?: S) =
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -2885,6 +3023,12 @@ declare const createSDKStore: <S extends ReducersMapObject>(extraReducers?: S) =
                 apiUrl: string;
                 apiKey?: string;
             }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+            postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+                npcId: string;
+                request: NPCProcessRequest;
+                apiUrl: string;
+                apiKey?: string;
+            }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
             postDirective: _reduxjs_toolkit_query.MutationDefinition<{
                 npcId: string;
                 request: DirectiveRequest;
@@ -3077,6 +3221,12 @@ declare const store: _reduxjs_toolkit.EnhancedStore<{
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -3268,6 +3418,12 @@ declare const store: _reduxjs_toolkit.EnhancedStore<{
                 apiUrl: string;
                 apiKey?: string;
             }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+            postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+                npcId: string;
+                request: NPCProcessRequest;
+                apiUrl: string;
+                apiKey?: string;
+            }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
             postDirective: _reduxjs_toolkit_query.MutationDefinition<{
                 npcId: string;
                 request: DirectiveRequest;
@@ -3460,6 +3616,12 @@ declare const dispatch: ((action: redux.Action<"listenerMiddleware/add">) => _re
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -3738,6 +3900,7 @@ declare const soulSlice: _reduxjs_toolkit.Slice<SoulState, {
                     timestamp: number;
                     type: string;
                     importance: number;
+                    similarity?: number | undefined;
                 }[];
                 state: {
                     [x: string]: unknown;
@@ -3757,6 +3920,7 @@ declare const soulSlice: _reduxjs_toolkit.Slice<SoulState, {
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             }[];
             state: {
                 [x: string]: unknown;
@@ -3811,7 +3975,7 @@ declare const streamFromCortexWithDelay: (cortex: ICortex, prompt: string, onChu
     delayMs?: number;
 }) => Promise<string>;
-declare const SDK_VERSION = "0.6.0";
+declare const SDK_VERSION = "0.6.1";
 /**
  * User Story: As NPC creation flows, I need lightweight id generation that
@@ -3846,6 +4010,17 @@ declare const sdkApi: _reduxjs_toolkit_query.Api<_reduxjs_toolkit_query.BaseQuer
         apiUrl: string;
         apiKey?: string;
     }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+    /**
+     * User Story: As the SDK protocol loop, I need a single process endpoint
+     * that returns one atomic instruction per turn while echoing full tape state.
+     * ᚹ one hop in, one hop out, like passing a lit shard through vacuum.
+     */
+    postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+        npcId: string;
+        request: NPCProcessRequest;
+        apiUrl: string;
+        apiKey?: string;
+    }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
     postDirective: _reduxjs_toolkit_query.MutationDefinition<{
         npcId: string;
         request: DirectiveRequest;
@@ -4022,6 +4197,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4039,6 +4215,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4056,6 +4233,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4073,6 +4251,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4090,6 +4269,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4107,6 +4287,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4124,6 +4305,7 @@ declare const memorySlice: _reduxjs_toolkit.Slice<_reduxjs_toolkit.EntityState<M
                 timestamp: number;
                 type: string;
                 importance: number;
+                similarity?: number | undefined;
             };
         };
         storageStatus: "idle" | "storing" | "error";
@@ -4159,6 +4341,12 @@ declare const selectMemoryById: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -4341,6 +4529,7 @@ declare const selectMemoryById: (state: {
     timestamp: number;
     type: string;
     importance: number;
+    similarity?: number | undefined;
 };
 declare const selectAllMemories: (state: {
     [x: string]: /*elided*/ any;
@@ -4357,6 +4546,12 @@ declare const selectAllMemories: (state: {
             apiUrl: string;
             apiKey?: string;
         }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", CortexInitResponse, "forbocApi", unknown>;
+        postNpcProcess: _reduxjs_toolkit_query.MutationDefinition<{
+            npcId: string;
+            request: NPCProcessRequest;
+            apiUrl: string;
+            apiKey?: string;
+        }, _reduxjs_toolkit_query.BaseQueryFn<string | _reduxjs_toolkit_query.FetchArgs, unknown, _reduxjs_toolkit_query.FetchBaseQueryError, {}, _reduxjs_toolkit_query.FetchBaseQueryMeta>, "NPC" | "Memory" | "Cortex" | "Ghost" | "Soul" | "Bridge" | "Rule", NPCProcessResponse, "forbocApi", unknown>;
         postDirective: _reduxjs_toolkit_query.MutationDefinition<{
             npcId: string;
             request: DirectiveRequest;
@@ -4645,4 +4840,4 @@ declare const clearMemoryRemoteThunk: _reduxjs_toolkit.AsyncThunk<any, {
     rejectedMeta?: unknown;
 }>;
-export { type AgentConfig, type AgentResponse, type ApiStatusResponse, type BridgeRule, type BridgeState, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexInitResponse, type CortexInternalState, type CortexModelInfo, type CortexStatus, type DirectiveRequest, type DirectiveResponse, type DirectiveRuleSet, type DirectiveRun, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostRunResponse, type GhostState, type GhostStatus, type ICortex, type IMemory, type INPC, type ImportedNpc, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type NPCAction, type NPCInternalState, type NPCState, type PromptConstraints, type RecalledMemory, type SDKDispatch, type SDKState, type SDKStore, SDK_VERSION, type Soul, type SoulConfig, type SoulExportResponse, type SoulExportResult, type SoulListResponse, type SoulState, type SoulVerifyResult, type ValidationContext, type ValidationResult, type ValidationRule, type VerdictRequest, type VerdictResponse, addToHistory, blockAction, bridgeSlice, checkApiStatusThunk, clearBlock, clearBridgeValidation, clearDirectivesForNpc, clearGhostSession, clearMemoryRemoteThunk, clearSoulState, completeRemoteThunk, contextComposed, cortexInitFailed, cortexInitStart, cortexInitSuccess, cortexSlice, createInitialState, createSDKStore, delay, deleteRulesetThunk, directiveReceived, directiveRunFailed, directiveRunStarted, directiveSlice, dispatch, exportToSoul, generateNPCId, getBridgeRulesThunk, getGhostHistoryThunk, getGhostResultsThunk, getGhostStatusThunk, getSoulListThunk, ghostSlice, importNpcFromSoulThunk, importSoulFromArweaveThunk, initRemoteCortexThunk, listCortexModelsThunk, listMemoryRemoteThunk, listRulePresetsThunk, listRulesetsThunk, loadBridgePresetThunk, localExportSoulThunk, memoise, memoiseAsync, memoryClear, memoryRecallFailed, memoryRecallStart, memoryRecallSuccess, memorySlice, memoryStoreFailed, memoryStoreStart, memoryStoreSuccess, npcSlice, pipe, processNPC, recallMemoryRemoteThunk, registerRulesetThunk, remoteExportSoulThunk, removeNPC, sdkApi, selectActiveDirective, selectActiveDirectiveId, selectActiveNPC, selectActiveNpcId, selectAllDirectives, selectAllMemories, selectAllNPCs, selectDirectiveById, selectLastRecalledMemories, selectMemoryById, selectNPCById, selectNPCEntities, selectNPCIds, selectTotalNPCs, setActiveNPC, setCortexStatus, setHistory, setLastAction, setNPCInfo, setNPCState, soulSlice, startGhostThunk, stopGhostThunk, store, storeMemoryRemoteThunk, streamFromCortex, streamFromCortexWithDelay, streamToCallback, streamToString, updateNPCState, updateNPCStateLocally, validateBridgeThunk, verdictValidated, verifySoulThunk };
+export { type AgentConfig, type AgentResponse, type ApiStatusResponse, type BridgeRule, type BridgeState, type CompletionOptions, type ContextRequest, type ContextResponse, type CortexConfig, type CortexInitResponse, type CortexInternalState, type CortexModelInfo, type CortexStatus, type DirectiveRequest, type DirectiveResponse, type DirectiveRuleSet, type DirectiveRun, type ExecuteInferenceInstruction, type FinalizeInstruction, type GhostConfig, type GhostHistoryEntry, type GhostResults, type GhostRunResponse, type GhostState, type GhostStatus, type ICortex, type IMemory, type INPC, type IdentifyActorInstruction, type ImportedNpc, type MemoryItem, type MemoryRecallInstruction, type MemoryStoreInstruction, type NPCAction, type NPCInstruction, type NPCInternalState, type NPCProcessRequest, type NPCProcessResponse, type NPCState, type ProcessTape, type PromptConstraints, type QueryVectorInstruction, type RecalledMemory, type SDKDispatch, type SDKState, type SDKStore, SDK_VERSION, type Soul, type SoulConfig, type SoulExportResponse, type SoulExportResult, type SoulListResponse, type SoulState, type SoulVerifyResult, type ValidationContext, type ValidationResult, type ValidationRule, type VerdictRequest, type VerdictResponse, addToHistory, blockAction, bridgeSlice, checkApiStatusThunk, clearBlock, clearBridgeValidation, clearDirectivesForNpc, clearGhostSession, clearMemoryRemoteThunk, clearSoulState, completeRemoteThunk, contextComposed, cortexInitFailed, cortexInitStart, cortexInitSuccess, cortexSlice, createInitialState, createSDKStore, delay, deleteRulesetThunk, directiveReceived, directiveRunFailed, directiveRunStarted, directiveSlice, dispatch, exportToSoul, generateNPCId, getBridgeRulesThunk, getGhostHistoryThunk, getGhostResultsThunk, getGhostStatusThunk, getSoulListThunk, ghostSlice, importNpcFromSoulThunk, importSoulFromArweaveThunk, initRemoteCortexThunk, listCortexModelsThunk, listMemoryRemoteThunk, listRulePresetsThunk, listRulesetsThunk, loadBridgePresetThunk, localExportSoulThunk, memoise, memoiseAsync, memoryClear, memoryRecallFailed, memoryRecallStart, memoryRecallSuccess, memorySlice, memoryStoreFailed, memoryStoreStart, memoryStoreSuccess, npcSlice, pipe, processNPC, recallMemoryRemoteThunk, registerRulesetThunk, remoteExportSoulThunk, removeNPC, sdkApi, selectActiveDirective, selectActiveDirectiveId, selectActiveNPC, selectActiveNpcId, selectAllDirectives, selectAllMemories, selectAllNPCs, selectDirectiveById, selectLastRecalledMemories, selectMemoryById, selectNPCById, selectNPCEntities, selectNPCIds, selectTotalNPCs, setActiveNPC, setCortexStatus, setHistory, setLastAction, setNPCInfo, setNPCState, soulSlice, startGhostThunk, stopGhostThunk, store, storeMemoryRemoteThunk, streamFromCortex, streamFromCortexWithDelay, streamToCallback, streamToString, updateNPCState, updateNPCStateLocally, validateBridgeThunk, verdictValidated, verifySoulThunk };

package/dist/index.js CHANGED Viewed

@@ -169,6 +169,21 @@ var sdkApi = (0, import_query.createApi)({
       transformResponse: (response) => response
     }),
     // NPC Endpoints
+    /**
+     * User Story: As the SDK protocol loop, I need a single process endpoint
+     * that returns one atomic instruction per turn while echoing full tape state.
+     * ᚹ one hop in, one hop out, like passing a lit shard through vacuum.
+     */
+    postNpcProcess: builder.mutation({
+      query: ({ npcId, request, apiUrl, apiKey }) => ({
+        url: `${apiUrl}/npcs/${npcId}/process`,
+        method: "POST",
+        headers: apiKey ? { "Authorization": `Bearer ${apiKey}` } : {},
+        body: request
+      }),
+      invalidatesTags: (result, error, { npcId }) => [{ type: "NPC", id: npcId }],
+      transformResponse: (response) => response
+    }),
     postDirective: builder.mutation({
       query: ({ npcId, request, apiUrl, apiKey }) => ({
         url: `${apiUrl}/npcs/${npcId}/directive`,
@@ -863,7 +878,7 @@ var { clearGhostSession } = ghostSlice.actions;
 var ghostSlice_default = ghostSlice.reducer;
 // src/utils/sdkVersion.ts
-var SDK_VERSION = "0.6.0";
+var SDK_VERSION = "0.6.1";
 // src/utils/generateNPCId.ts
 var generateNPCId = () => `ag_${Date.now().toString(36)}`;
@@ -1304,6 +1319,13 @@ var dispatch = store.dispatch;
 // src/thunks.ts
 var import_toolkit10 = require("@reduxjs/toolkit");
+var extractThunkErrorMessage = (e) => {
+  if (typeof e === "string") return e;
+  if (e?.data?.message) return String(e.data.message);
+  if (e?.error) return String(e.error);
+  if (e?.message) return String(e.message);
+  return "Protocol processing failed";
+};
 var processNPC = (0, import_toolkit10.createAsyncThunk)(
   "npc/process",
   async ({ npcId: argNpcId, text, context = {}, apiUrl, apiKey, memory, cortex, persona: argPersona }, { getState, dispatch: dispatch2, rejectWithValue }) => {
@@ -1327,61 +1349,111 @@ var processNPC = (0, import_toolkit10.createAsyncThunk)(
     const directiveId = `${npcId}:${Date.now()}`;
     dispatch2(directiveRunStarted({ id: directiveId, npcId, observation: text }));
     try {
-      const directiveResult = await dispatch2(
-        sdkApi.endpoints.postDirective.initiate({ npcId, request: { observation: text, npcState: currentState, context }, apiUrl, apiKey })
-      ).unwrap();
-      dispatch2(directiveReceived({ id: directiveId, response: directiveResult }));
-      if (directiveResult.memoryRecall && !memory) {
-        return rejectWithValue("API requested memory recall, but no memory engine is configured");
-      }
-      const recalledMemories = memory && directiveResult.memoryRecall ? (await memory.recall(
-        directiveResult.memoryRecall.query,
-        directiveResult.memoryRecall.limit,
-        directiveResult.memoryRecall.threshold
-      )).map((m) => ({ text: m.text, type: m.type, importance: m.importance })) : [];
-      const contextResult = await dispatch2(
-        sdkApi.endpoints.postContext.initiate({ npcId, request: { memories: recalledMemories, observation: text, npcState: currentState, persona }, apiUrl, apiKey })
-      ).unwrap();
-      dispatch2(contextComposed({ id: directiveId, prompt: contextResult.prompt, constraints: contextResult.constraints }));
-      const generatedText = await cortex.complete(contextResult.prompt, {
-        maxTokens: contextResult.constraints.maxTokens,
-        temperature: contextResult.constraints.temperature,
-        stop: contextResult.constraints.stop
-      });
-      const verdictResult = await dispatch2(
-        sdkApi.endpoints.postVerdict.initiate({ npcId, request: { generatedOutput: generatedText, observation: text, npcState: currentState }, apiUrl, apiKey })
-      ).unwrap();
-      dispatch2(verdictValidated({ id: directiveId, verdict: verdictResult }));
-      if (!verdictResult.valid) {
-        dispatch2(blockAction({ id: npcId, reason: verdictResult.dialogue || "Validation Failed" }));
-        return {
-          dialogue: verdictResult.dialogue,
-          action: verdictResult.action,
-          thought: verdictResult.dialogue
-        };
-      }
-      if (verdictResult.memoryStore?.length && !memory) {
-        return rejectWithValue("API returned memoryStore instructions, but no memory engine is configured");
-      }
-      if (memory && verdictResult.memoryStore) {
-        for (const inst of verdictResult.memoryStore) {
-          await memory.store(inst.text, inst.type, inst.importance);
+      const initialTape = {
+        observation: text,
+        context,
+        npcState: currentState,
+        persona,
+        memories: [],
+        vectorQueried: false
+      };
+      const maxTurns = 12;
+      const persistMemoryInstructionsRecursively = async (instructions, index = 0) => {
+        if (!memory || index >= instructions.length) {
+          return;
         }
-      }
-      if (verdictResult.stateDelta) {
-        dispatch2(updateNPCState({ id: npcId, delta: verdictResult.stateDelta }));
-      }
-      const action = verdictResult.action;
-      dispatch2(setLastAction({ id: npcId, action }));
-      dispatch2(addToHistory({ id: npcId, role: "user", content: text }));
-      dispatch2(addToHistory({ id: npcId, role: "assistant", content: verdictResult.dialogue }));
-      return {
-        dialogue: verdictResult.dialogue,
-        action,
-        thought: verdictResult.dialogue
+        const inst = instructions[index];
+        await memory.store(inst.text, inst.type, inst.importance);
+        await persistMemoryInstructionsRecursively(instructions, index + 1);
+      };
+      const runProtocolRecursively = async (tape, lastResult, turn) => {
+        if (turn >= maxTurns) {
+          return rejectWithValue(`Protocol loop exceeded max turns (${maxTurns})`);
+        }
+        const request = { tape, lastResult };
+        const processResult = await dispatch2(
+          sdkApi.endpoints.postNpcProcess.initiate({ npcId, request, apiUrl, apiKey })
+        ).unwrap();
+        const nextTape = processResult.tape;
+        const instruction = processResult.instruction;
+        if (instruction.type === "IdentifyActor") {
+          return runProtocolRecursively(nextTape, {
+            type: "IdentifyActorResult",
+            actor: {
+              npcId,
+              persona,
+              data: nextTape.npcState
+            }
+          }, turn + 1);
+        }
+        if (instruction.type === "QueryVector") {
+          dispatch2(directiveReceived({
+            id: directiveId,
+            response: { memoryRecall: { query: instruction.query, limit: instruction.limit, threshold: instruction.threshold } }
+          }));
+          if (!memory) {
+            return rejectWithValue("API requested memory recall, but no memory engine is configured");
+          }
+          const recalled = await memory.recall(instruction.query, instruction.limit, instruction.threshold);
+          return runProtocolRecursively(nextTape, {
+            type: "QueryVectorResult",
+            memories: recalled.map((m) => ({ text: m.text, type: m.type, importance: m.importance, similarity: m.similarity }))
+          }, turn + 1);
+        }
+        if (instruction.type === "ExecuteInference") {
+          dispatch2(contextComposed({ id: directiveId, prompt: instruction.prompt, constraints: instruction.constraints }));
+          const generatedText = await cortex.complete(instruction.prompt, {
+            maxTokens: instruction.constraints.maxTokens,
+            temperature: instruction.constraints.temperature,
+            stop: instruction.constraints.stop
+          });
+          return runProtocolRecursively(nextTape, {
+            type: "ExecuteInferenceResult",
+            generatedOutput: generatedText
+          }, turn + 1);
+        }
+        if (instruction.type === "Finalize") {
+          const finalize = instruction;
+          dispatch2(verdictValidated({
+            id: directiveId,
+            verdict: {
+              valid: finalize.valid,
+              signature: finalize.signature,
+              memoryStore: finalize.memoryStore,
+              stateDelta: finalize.stateTransform,
+              action: finalize.action,
+              dialogue: finalize.dialogue
+            }
+          }));
+          if (!finalize.valid) {
+            dispatch2(blockAction({ id: npcId, reason: finalize.dialogue || "Validation Failed" }));
+            return {
+              dialogue: finalize.dialogue,
+              action: finalize.action,
+              thought: finalize.dialogue
+            };
+          }
+          if (finalize.memoryStore?.length && !memory) {
+            return rejectWithValue("API returned memoryStore instructions, but no memory engine is configured");
+          }
+          await persistMemoryInstructionsRecursively(finalize.memoryStore || []);
+          if (finalize.stateTransform) {
+            dispatch2(updateNPCState({ id: npcId, delta: finalize.stateTransform }));
+          }
+          dispatch2(setLastAction({ id: npcId, action: finalize.action }));
+          dispatch2(addToHistory({ id: npcId, role: "user", content: text }));
+          dispatch2(addToHistory({ id: npcId, role: "assistant", content: finalize.dialogue }));
+          return {
+            dialogue: finalize.dialogue,
+            action: finalize.action,
+            thought: finalize.dialogue
+          };
+        }
+        return rejectWithValue("API returned unknown instruction type");
       };
+      return runProtocolRecursively(initialTape, void 0, 0);
     } catch (e) {
-      const message = e?.message || e?.data?.message || "Protocol processing failed";
+      const message = extractThunkErrorMessage(e);
       dispatch2(directiveRunFailed({ id: directiveId, error: String(message) }));
       return rejectWithValue(String(message));
     }

package/dist/index.mjs CHANGED Viewed

@@ -49,6 +49,21 @@ var sdkApi = createApi({
       transformResponse: (response) => response
     }),
     // NPC Endpoints
+    /**
+     * User Story: As the SDK protocol loop, I need a single process endpoint
+     * that returns one atomic instruction per turn while echoing full tape state.
+     * ᚹ one hop in, one hop out, like passing a lit shard through vacuum.
+     */
+    postNpcProcess: builder.mutation({
+      query: ({ npcId, request, apiUrl, apiKey }) => ({
+        url: `${apiUrl}/npcs/${npcId}/process`,
+        method: "POST",
+        headers: apiKey ? { "Authorization": `Bearer ${apiKey}` } : {},
+        body: request
+      }),
+      invalidatesTags: (result, error, { npcId }) => [{ type: "NPC", id: npcId }],
+      transformResponse: (response) => response
+    }),
     postDirective: builder.mutation({
       query: ({ npcId, request, apiUrl, apiKey }) => ({
         url: `${apiUrl}/npcs/${npcId}/directive`,
@@ -743,7 +758,7 @@ var { clearGhostSession } = ghostSlice.actions;
 var ghostSlice_default = ghostSlice.reducer;
 // src/utils/sdkVersion.ts
-var SDK_VERSION = "0.6.0";
+var SDK_VERSION = "0.6.1";
 // src/utils/generateNPCId.ts
 var generateNPCId = () => `ag_${Date.now().toString(36)}`;
@@ -1184,6 +1199,13 @@ var dispatch = store.dispatch;
 // src/thunks.ts
 import { createAsyncThunk as createAsyncThunk5 } from "@reduxjs/toolkit";
+var extractThunkErrorMessage = (e) => {
+  if (typeof e === "string") return e;
+  if (e?.data?.message) return String(e.data.message);
+  if (e?.error) return String(e.error);
+  if (e?.message) return String(e.message);
+  return "Protocol processing failed";
+};
 var processNPC = createAsyncThunk5(
   "npc/process",
   async ({ npcId: argNpcId, text, context = {}, apiUrl, apiKey, memory, cortex, persona: argPersona }, { getState, dispatch: dispatch2, rejectWithValue }) => {
@@ -1207,61 +1229,111 @@ var processNPC = createAsyncThunk5(
     const directiveId = `${npcId}:${Date.now()}`;
     dispatch2(directiveRunStarted({ id: directiveId, npcId, observation: text }));
     try {
-      const directiveResult = await dispatch2(
-        sdkApi.endpoints.postDirective.initiate({ npcId, request: { observation: text, npcState: currentState, context }, apiUrl, apiKey })
-      ).unwrap();
-      dispatch2(directiveReceived({ id: directiveId, response: directiveResult }));
-      if (directiveResult.memoryRecall && !memory) {
-        return rejectWithValue("API requested memory recall, but no memory engine is configured");
-      }
-      const recalledMemories = memory && directiveResult.memoryRecall ? (await memory.recall(
-        directiveResult.memoryRecall.query,
-        directiveResult.memoryRecall.limit,
-        directiveResult.memoryRecall.threshold
-      )).map((m) => ({ text: m.text, type: m.type, importance: m.importance })) : [];
-      const contextResult = await dispatch2(
-        sdkApi.endpoints.postContext.initiate({ npcId, request: { memories: recalledMemories, observation: text, npcState: currentState, persona }, apiUrl, apiKey })
-      ).unwrap();
-      dispatch2(contextComposed({ id: directiveId, prompt: contextResult.prompt, constraints: contextResult.constraints }));
-      const generatedText = await cortex.complete(contextResult.prompt, {
-        maxTokens: contextResult.constraints.maxTokens,
-        temperature: contextResult.constraints.temperature,
-        stop: contextResult.constraints.stop
-      });
-      const verdictResult = await dispatch2(
-        sdkApi.endpoints.postVerdict.initiate({ npcId, request: { generatedOutput: generatedText, observation: text, npcState: currentState }, apiUrl, apiKey })
-      ).unwrap();
-      dispatch2(verdictValidated({ id: directiveId, verdict: verdictResult }));
-      if (!verdictResult.valid) {
-        dispatch2(blockAction({ id: npcId, reason: verdictResult.dialogue || "Validation Failed" }));
-        return {
-          dialogue: verdictResult.dialogue,
-          action: verdictResult.action,
-          thought: verdictResult.dialogue
-        };
-      }
-      if (verdictResult.memoryStore?.length && !memory) {
-        return rejectWithValue("API returned memoryStore instructions, but no memory engine is configured");
-      }
-      if (memory && verdictResult.memoryStore) {
-        for (const inst of verdictResult.memoryStore) {
-          await memory.store(inst.text, inst.type, inst.importance);
+      const initialTape = {
+        observation: text,
+        context,
+        npcState: currentState,
+        persona,
+        memories: [],
+        vectorQueried: false
+      };
+      const maxTurns = 12;
+      const persistMemoryInstructionsRecursively = async (instructions, index = 0) => {
+        if (!memory || index >= instructions.length) {
+          return;
         }
-      }
-      if (verdictResult.stateDelta) {
-        dispatch2(updateNPCState({ id: npcId, delta: verdictResult.stateDelta }));
-      }
-      const action = verdictResult.action;
-      dispatch2(setLastAction({ id: npcId, action }));
-      dispatch2(addToHistory({ id: npcId, role: "user", content: text }));
-      dispatch2(addToHistory({ id: npcId, role: "assistant", content: verdictResult.dialogue }));
-      return {
-        dialogue: verdictResult.dialogue,
-        action,
-        thought: verdictResult.dialogue
+        const inst = instructions[index];
+        await memory.store(inst.text, inst.type, inst.importance);
+        await persistMemoryInstructionsRecursively(instructions, index + 1);
+      };
+      const runProtocolRecursively = async (tape, lastResult, turn) => {
+        if (turn >= maxTurns) {
+          return rejectWithValue(`Protocol loop exceeded max turns (${maxTurns})`);
+        }
+        const request = { tape, lastResult };
+        const processResult = await dispatch2(
+          sdkApi.endpoints.postNpcProcess.initiate({ npcId, request, apiUrl, apiKey })
+        ).unwrap();
+        const nextTape = processResult.tape;
+        const instruction = processResult.instruction;
+        if (instruction.type === "IdentifyActor") {
+          return runProtocolRecursively(nextTape, {
+            type: "IdentifyActorResult",
+            actor: {
+              npcId,
+              persona,
+              data: nextTape.npcState
+            }
+          }, turn + 1);
+        }
+        if (instruction.type === "QueryVector") {
+          dispatch2(directiveReceived({
+            id: directiveId,
+            response: { memoryRecall: { query: instruction.query, limit: instruction.limit, threshold: instruction.threshold } }
+          }));
+          if (!memory) {
+            return rejectWithValue("API requested memory recall, but no memory engine is configured");
+          }
+          const recalled = await memory.recall(instruction.query, instruction.limit, instruction.threshold);
+          return runProtocolRecursively(nextTape, {
+            type: "QueryVectorResult",
+            memories: recalled.map((m) => ({ text: m.text, type: m.type, importance: m.importance, similarity: m.similarity }))
+          }, turn + 1);
+        }
+        if (instruction.type === "ExecuteInference") {
+          dispatch2(contextComposed({ id: directiveId, prompt: instruction.prompt, constraints: instruction.constraints }));
+          const generatedText = await cortex.complete(instruction.prompt, {
+            maxTokens: instruction.constraints.maxTokens,
+            temperature: instruction.constraints.temperature,
+            stop: instruction.constraints.stop
+          });
+          return runProtocolRecursively(nextTape, {
+            type: "ExecuteInferenceResult",
+            generatedOutput: generatedText
+          }, turn + 1);
+        }
+        if (instruction.type === "Finalize") {
+          const finalize = instruction;
+          dispatch2(verdictValidated({
+            id: directiveId,
+            verdict: {
+              valid: finalize.valid,
+              signature: finalize.signature,
+              memoryStore: finalize.memoryStore,
+              stateDelta: finalize.stateTransform,
+              action: finalize.action,
+              dialogue: finalize.dialogue
+            }
+          }));
+          if (!finalize.valid) {
+            dispatch2(blockAction({ id: npcId, reason: finalize.dialogue || "Validation Failed" }));
+            return {
+              dialogue: finalize.dialogue,
+              action: finalize.action,
+              thought: finalize.dialogue
+            };
+          }
+          if (finalize.memoryStore?.length && !memory) {
+            return rejectWithValue("API returned memoryStore instructions, but no memory engine is configured");
+          }
+          await persistMemoryInstructionsRecursively(finalize.memoryStore || []);
+          if (finalize.stateTransform) {
+            dispatch2(updateNPCState({ id: npcId, delta: finalize.stateTransform }));
+          }
+          dispatch2(setLastAction({ id: npcId, action: finalize.action }));
+          dispatch2(addToHistory({ id: npcId, role: "user", content: text }));
+          dispatch2(addToHistory({ id: npcId, role: "assistant", content: finalize.dialogue }));
+          return {
+            dialogue: finalize.dialogue,
+            action: finalize.action,
+            thought: finalize.dialogue
+          };
+        }
+        return rejectWithValue("API returned unknown instruction type");
       };
+      return runProtocolRecursively(initialTape, void 0, 0);
     } catch (e) {
-      const message = e?.message || e?.data?.message || "Protocol processing failed";
+      const message = extractThunkErrorMessage(e);
       dispatch2(directiveRunFailed({ id: directiveId, error: String(message) }));
       return rejectWithValue(String(message));
     }

package/package.json CHANGED Viewed

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