@cnstra/core 1.7.0 → 1.8.1

package/dist/CNS.d.ts

@@ -1,42 +1,21 @@
 import { TCNSNeuron } from './types/TCNSNeuron';
 import { TCNSDendrite } from './types/TCNSDendrite';
-import { ICNS } from './interfaces/ICNS';
-import { TCNSSubscriber } from './types/TCNSSubscriber';
 import { TCNSOptions } from './types/TCNSOptions';
 import { TCNSStimulationOptions } from './types/TCNSStimulationOptions';
-import { CNSCollateral } from './CNSCollateral';
+import { CNSStimulation } from './CNSStimulation';
 import { TCNSSignal } from './types/TCNSSignal';
 import { CNSInstanceNeuronQueue } from './CNSInstanceNeuronQueue';
 import { TCNSStimulationResponse } from './types/TCNSStimulationResponse';
-export declare class CNS<TCollateralName extends string, TNeuronName extends string, TNeuron extends TCNSNeuron<any, TNeuronName, any, any, any, any, any>, TDendrite extends TCNSDendrite<any, any, any, any, any, any>> implements ICNS<TNeuron, TDendrite> {
+import { TCNSNeuronActivationTask } from './types/TCNSNeuronActivationTask';
+import { CNSNetwork } from './CNSNetwork';
+import { ICNS } from './interfaces/ICNS';
+export declare class CNS<TCollateralName extends string, TNeuronName extends string, TNeuron extends TCNSNeuron<any, TNeuronName, any, any, any, any, any>, TDendrite extends TCNSDendrite<any, any, any, any, any, any>> implements Omit<ICNS<TCollateralName, TNeuronName, TNeuron, TDendrite>, 'stimulate'> {
     protected readonly neurons: TNeuron[];
     readonly options?: TCNSOptions | undefined;
     /**
-     * Fast lookup: collateralName -> list of (neuron, dendrite) subscribers.
-     * Built once at construction time.
-     */
-    private subIndex;
-    private neuronIndex;
-    private dendriteIndex;
-    private collateralIndex;
-    private parentNeuronByCollateralName;
-    /**
-     * Strongly Connected Components of the neuron graph.
-     * Each component is a set of neuron IDs that can reach each other.
+     * Network graph analysis and strongly connected components.
      */
-    stronglyConnectedComponents: Set<string>[];
-    /**
-     * Quick lookup: neuron ID -> SCC index for fast reachability checks.
-     */
-    private neuronToSCC;
-    /**
-     * DAG of SCCs: SCC index -> set of SCC indices that can reach this SCC
-     */
-    private sccDag;
-    /**
-     * Precomputed ancestor sets for each SCC for fast reachability checks
-     */
-    private sccAncestors;
+    readonly network: CNSNetwork<TCollateralName, TNeuronName, TNeuron, TDendrite>;
     /**
      * Global per-neuron concurrency gates shared across all stimulations.
      */
@@ -45,68 +24,18 @@ export declare class CNS<TCollateralName extends string, TNeuronName extends str
      * Global task queue used by stimulation to schedule per-neuron gated work.
      * Does not replace per-stimulation concurrency; only coordinates global per-neuron limits.
      */
-    private readonly globalTaskQueue;
     protected readonly instanceNeuronQueue: CNSInstanceNeuronQueue<TNeuron>;
     /**
      * Global response listeners applied to every stimulation.
      */
     private readonly globalResponseListeners;
     constructor(neurons: TNeuron[], options?: TCNSOptions | undefined);
+    addResponseListener<TInputPayload, TOutputPayload>(listener: (response: TCNSStimulationResponse<TCollateralName, TInputPayload, TOutputPayload, TNeuronName>) => void | Promise<void>): () => void;
+    private wrapOnResponse;
+    stimulate<TInputPayload extends TOutputPayload, TOutputPayload = TInputPayload>(signalOrSignals: TCNSSignal<TCollateralName, TInputPayload> | TCNSSignal<TCollateralName, TInputPayload>[], options?: TCNSStimulationOptions<TCollateralName, TInputPayload, TOutputPayload, TNeuronName, TNeuron, TDendrite>): CNSStimulation<TCollateralName, TNeuronName, TNeuron, TDendrite, TInputPayload, TOutputPayload>;
     /**
-     * Validate uniqueness constraints:
-     * - neuron names are unique and non-empty
-     * - axon collateral types are globally unique (single owner)
-     * - the same collateral instance cannot be owned by multiple neurons
-     * Throws aggregated error if violations are found.
-     */
-    private validateUniqueIdentifiers;
-    addResponseListener(listener: <TInputPayload, TOutputPayload>(response: TCNSStimulationResponse<TCollateralName, TInputPayload, TOutputPayload>) => void | Promise<void>): () => void;
-    wrapOnResponse<T>(local?: (response: T) => void | Promise<void>): (response: T) => void | Promise<void>;
-    protected runWithNeuronConcurrency(neuron: TNeuron, fn: () => (() => void) | Promise<() => void>): Promise<void>;
-    private buildIndexes;
-    /**
-     * Build the neuron graph where neurons are connected if one can stimulate the other.
-     */
-    private buildNeuronGraph;
-    /**
-     * Build strongly connected components using Tarjan's algorithm.
-     */
-    private buildSCC;
-    /**
-     * Build DAG between SCCs based on the original neuron graph
-     */
-    private buildSCCDAG;
-    /**
-     * Precompute ancestor sets for each SCC for fast reachability checks
-     * Uses topological sort for efficient computation
-     */
-    private buildSCCAncestors;
-    /**
-     * Get outgoing edges for a given SCC index
-     */
-    private getOutgoingEdges;
-    /**
-     * Check if a neuron can be reached again (including self-calling).
-     * Returns true if the neuron is in a strongly connected component with more than one member,
-     * or if it's in a single-member SCC that can reach itself.
-     */
-    getSCCSetByNeuronName(neuronName: string): Set<string> | undefined;
-    /**
-     * Get the SCC index for a given neuron ID
-     */
-    getSccIndexByNeuronName(neuronName: string): number | undefined;
-    /**
-     * Check if a neuron can be guaranteed not to be visited again during the current propagation.
-     * This is the core logic for safe context cleanup.
+     * Start a stimulation with activation tasks directly
      */
-    canNeuronBeGuaranteedDone(neuronName: string, activeSccCounts: Map<number, number>): boolean;
-    getParentNeuronByCollateralName(collateralName: TCollateralName): TNeuron | undefined;
-    getDendrites(): TDendrite[];
-    getCollaterals(): CNSCollateral<TCollateralName, unknown>[];
-    getNeurons(): TNeuron[];
-    getCollateralByName<TName extends string = string>(collateralName: TName): CNSCollateral<TName, unknown> | undefined;
-    getNeuronByName<TName extends string = string>(neuronName: TName): TNeuron | undefined;
-    getSubscribers(collateralName: TCollateralName): TCNSSubscriber<TNeuron, TDendrite>[];
-    stimulate<TInputPayload extends TOutputPayload, TOutputPayload>(signalOrSignals: TCNSSignal<TCollateralName, TInputPayload> | TCNSSignal<TCollateralName, TInputPayload>[], options?: TCNSStimulationOptions<TCollateralName, TInputPayload, TOutputPayload>): Promise<void>;
+    activate<TInputPayload, TOutputPayload>(tasks: TCNSNeuronActivationTask<TCollateralName, TNeuronName>[], options?: TCNSStimulationOptions<TCollateralName, TInputPayload, TOutputPayload, TNeuronName, TNeuron, TDendrite>): CNSStimulation<TCollateralName, TNeuronName, TNeuron, TDendrite, TInputPayload, TOutputPayload>;
 }
 //# sourceMappingURL=CNS.d.ts.map

package/dist/CNS.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CNS.d.ts","sourceRoot":"","sources":["../src/CNS.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CNS.d.ts","sourceRoot":"","sources":["../src/CNS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,qBAAa,GAAG,CACZ,eAAe,SAAS,MAAM,EAC9B,WAAW,SAAS,MAAM,EAC1B,OAAO,SAAS,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACrE,SAAS,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAC9D,YACM,IAAI,CACA,IAAI,CAAC,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,EACtD,WAAW,CACd;IAmCD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE;aACrB,OAAO,CAAC,EAAE,WAAW;IAlCzC;;OAEG;IACH,SAAgB,OAAO,EAAE,UAAU,CAC/B,eAAe,EACf,WAAW,EACX,OAAO,EACP,SAAS,CACZ,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IAEJ;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,kCACI;IAE1C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAEjC;gBAGgB,OAAO,EAAE,OAAO,EAAE,EACrB,OAAO,CAAC,EAAE,WAAW,YAAA;IAKlC,mBAAmB,CAAC,aAAa,EAAE,cAAc,EACpD,QAAQ,EAAE,CACN,QAAQ,EAAE,uBAAuB,CAC7B,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,CACd,KACA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC1B,MAAM,IAAI;IAWb,OAAO,CAAC,cAAc;IAkDf,SAAS,CACZ,aAAa,SAAS,cAAc,EACpC,cAAc,GAAG,aAAa,EAE9B,eAAe,EACT,UAAU,CAAC,eAAe,EAAE,aAAa,CAAC,GAC1C,UAAU,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE,EAClD,OAAO,CAAC,EAAE,sBAAsB,CAC5B,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,OAAO,EACP,SAAS,CACZ,GACF,cAAc,CACb,eAAe,EACf,WAAW,EACX,OAAO,EACP,SAAS,EACT,aAAa,EACb,cAAc,CACjB;IAiBD;;OAEG;IACI,QAAQ,CAAC,aAAa,EAAE,cAAc,EACzC,KAAK,EAAE,wBAAwB,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE,EAC/D,OAAO,CAAC,EAAE,sBAAsB,CAC5B,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,OAAO,EACP,SAAS,CACZ,GACF,cAAc,CACb,eAAe,EACf,WAAW,EACX,OAAO,EACP,SAAS,EACT,aAAa,EACb,cAAc,CACjB;CAgBJ"}

package/dist/CNSNetwork.d.ts

@@ -0,0 +1,87 @@
+import { TCNSNeuron } from './types/TCNSNeuron';
+import { TCNSSubscriber } from './types/TCNSSubscriber';
+import { TCNSDendrite } from './types/TCNSDendrite';
+import { CNSCollateral } from './CNSCollateral';
+export declare class CNSNetwork<TCollateralName extends string, TNeuronName extends string, TNeuron extends TCNSNeuron<any, TNeuronName, any, any, any, any, any>, TDendrite extends TCNSDendrite<any, any, any, any, any, any>> {
+    private readonly neurons;
+    /**
+     * Strongly Connected Components of the neuron graph.
+     * Each component is a set of neuron IDs that can reach each other.
+     */
+    stronglyConnectedComponents: Set<string>[];
+    /**
+     * Quick lookup: neuron ID -> SCC index for fast reachability checks.
+     */
+    private neuronToSCC;
+    /**
+     * DAG of SCCs: SCC index -> set of SCC indices that can reach this SCC
+     */
+    private sccDag;
+    /**
+     * Precomputed ancestor sets for each SCC for fast reachability checks
+     */
+    private sccAncestors;
+    /**
+     * Fast lookup: collateralName -> list of (neuron, dendrite) subscribers.
+     * Built once at construction time.
+     */
+    private subIndex;
+    private neuronIndex;
+    private dendriteIndex;
+    private collateralIndex;
+    private parentNeuronByCollateralName;
+    constructor(neurons: TNeuron[]);
+    /**
+     * Validate uniqueness constraints:
+     * - neuron names are unique and non-empty
+     * - axon collateral types are globally unique (single owner)
+     * - the same collateral instance cannot be owned by multiple neurons
+     * Throws aggregated error if violations are found.
+     */
+    private validateUniqueIdentifiers;
+    /**
+     * Build the neuron graph where neurons are connected if one can stimulate the other.
+     */
+    private buildNeuronGraph;
+    /**
+     * Build strongly connected components using Tarjan's algorithm.
+     */
+    private buildSCC;
+    /**
+     * Build DAG between SCCs based on the original neuron graph
+     */
+    private buildSCCDAG;
+    /**
+     * Precompute ancestor sets for each SCC for fast reachability checks
+     * Uses topological sort for efficient computation
+     */
+    private buildSCCAncestors;
+    /**
+     * Get outgoing edges for a given SCC index
+     */
+    private getOutgoingEdges;
+    /**
+     * Check if a neuron can be reached again (including self-calling).
+     * Returns true if the neuron is in a strongly connected component with more than one member,
+     * or if it's in a single-member SCC that can reach itself.
+     */
+    getSCCSetByNeuronName(neuronName: string): Set<string> | undefined;
+    /**
+     * Get the SCC index for a given neuron ID
+     */
+    getSccIndexByNeuronName(neuronName: string): number | undefined;
+    /**
+     * Check if a neuron can be guaranteed not to be visited again during the current propagation.
+     * This is the core logic for safe context cleanup.
+     */
+    canNeuronBeGuaranteedDone(neuronName: string, activeSccCounts: Map<number, number>): boolean;
+    private buildIndexes;
+    getParentNeuronByCollateralName(collateralName: TCollateralName): TNeuron | undefined;
+    getDendrites(): TDendrite[];
+    getCollaterals(): CNSCollateral<TCollateralName, unknown>[];
+    getNeurons(): TNeuron[];
+    getCollateralByName<TName extends string = string>(collateralName: TName): CNSCollateral<TName, unknown> | undefined;
+    getNeuronByName<TName extends string = string>(neuronName: TName): TNeuron | undefined;
+    getSubscribers(collateralName: TCollateralName): TCNSSubscriber<TNeuron, TDendrite>[];
+}
+//# sourceMappingURL=CNSNetwork.d.ts.map

package/dist/CNSNetwork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CNSNetwork.d.ts","sourceRoot":"","sources":["../src/CNSNetwork.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,UAAU,CACnB,eAAe,SAAS,MAAM,EAC9B,WAAW,SAAS,MAAM,EAC1B,OAAO,SAAS,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACrE,SAAS,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAyChD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAvCpC;;;OAGG;IACI,2BAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAM;IAEvD;;OAEG;IACH,OAAO,CAAC,WAAW,CAA6B;IAEhD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAuC;IAErD;;OAEG;IACH,OAAO,CAAC,YAAY,CAAuC;IAE3D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAGZ;IAEJ,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,eAAe,CAGnB;IAEJ,OAAO,CAAC,4BAA4B,CAAuC;gBAE9C,OAAO,EAAE,OAAO,EAAE;IAM/C;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAuBjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAsEhB;;OAEG;IACH,OAAO,CAAC,WAAW;IA6BnB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiDzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;OAIG;IACI,qBAAqB,CAAC,UAAU,EAAE,MAAM;IAQ/C;;OAEG;IACI,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItE;;;OAGG;IACI,yBAAyB,CAC5B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO;IA4BV,OAAO,CAAC,YAAY;IA8Bb,+BAA+B,CAAC,cAAc,EAAE,eAAe;IAI/D,YAAY;IAIZ,cAAc;IAId,UAAU;IAIV,mBAAmB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACpD,cAAc,EAAE,KAAK,GAIL,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,SAAS;IAGtD,eAAe,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,KAAK;IAIhE,cAAc,CACjB,cAAc,EAAE,eAAe,GAChC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE;CAG1C"}

package/dist/CNSNeuronActivationPump.d.ts

@@ -0,0 +1,27 @@
+import { TCNSNeuronActivationTask } from './types/TCNSNeuronActivationTask';
+export declare class CNSNeuronActivationPump<TCollateralName extends string, TNeuronName extends string> {
+    private readonly processor;
+    protected readonly concurrency?: number | undefined;
+    protected readonly abortSignal?: AbortSignal | undefined;
+    private items;
+    private head;
+    private tail;
+    private size;
+    private capacity;
+    protected activeOperations: number;
+    private activeTasks;
+    private pumping;
+    private needsPump;
+    constructor(processor: (neuronActivationTask: TCNSNeuronActivationTask<TCollateralName, TNeuronName>) => (() => void) | Promise<() => void>, concurrency?: number | undefined, abortSignal?: AbortSignal | undefined, initialCapacity?: number);
+    protected get canStartOperation(): boolean;
+    private resize;
+    private dequeue;
+    private enqueueItem;
+    protected pump(): void;
+    enqueue(neuronActivationTask: TCNSNeuronActivationTask<TCollateralName, TNeuronName>): void;
+    get length(): number;
+    getActiveOperationsCount(): number;
+    getQueuedTasks(): TCNSNeuronActivationTask<TCollateralName, TNeuronName>[];
+    getActiveTasks(): TCNSNeuronActivationTask<TCollateralName, TNeuronName>[];
+}
+//# sourceMappingURL=CNSNeuronActivationPump.d.ts.map

package/dist/CNSNeuronActivationPump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CNSNeuronActivationPump.d.ts","sourceRoot":"","sources":["../src/CNSNeuronActivationPump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,qBAAa,uBAAuB,CAChC,eAAe,SAAS,MAAM,EAC9B,WAAW,SAAS,MAAM;IAkBtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAM1B,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;IACvC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW;IAvBhD,OAAO,CAAC,KAAK,CACN;IACP,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAM;IACtB,SAAS,CAAC,gBAAgB,SAAK;IAC/B,OAAO,CAAC,WAAW,CAEf;IAGJ,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;gBAGL,SAAS,EAAE,CACxB,oBAAoB,EAAE,wBAAwB,CAC1C,eAAe,EACf,WAAW,CACd,KACA,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,EACpB,WAAW,CAAC,EAAE,MAAM,YAAA,EACpB,WAAW,CAAC,EAAE,WAAW,YAAA,EAC5C,eAAe,CAAC,EAAE,MAAM;IAQ5B,SAAS,KAAK,iBAAiB,IAAI,OAAO,CAGzC;IAED,OAAO,CAAC,MAAM;IAgBd,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,WAAW;IAenB,SAAS,CAAC,IAAI;IA4Dd,OAAO,CACH,oBAAoB,EAAE,wBAAwB,CAC1C,eAAe,EACf,WAAW,CACd;IAQL,IAAI,MAAM,WAET;IAED,wBAAwB;IAIjB,cAAc,IAAI,wBAAwB,CAC7C,eAAe,EACf,WAAW,CACd,EAAE;IAWI,cAAc,IAAI,wBAAwB,CAC7C,eAAe,EACf,WAAW,CACd,EAAE;CAGN"}

package/dist/CNSStimulation.d.ts

@@ -1,31 +1,52 @@
-import { ICNS } from './interfaces/ICNS';
+import { ICNSStimulationContextStore } from './interfaces/ICNSStimulationContextStore';
 import { TCNSStimulationOptions } from './types/TCNSStimulationOptions';
 import { TCNSNeuron } from './types/TCNSNeuron';
 import { TCNSDendrite } from './types/TCNSDendrite';
 import { TCNSSubscriber } from './types/TCNSSubscriber';
 import { CNSInstanceNeuronQueue } from './CNSInstanceNeuronQueue';
 import { TCNSSignal } from './types/TCNSSignal';
-import { TCNSSerializedQueueItem } from './types/TCNSSerializedSignal';
+import { TCNSNeuronActivationTask } from './types/TCNSNeuronActivationTask';
+import { CNS } from './CNS';
+import { TCNSNeuronActivationTaskFailure } from './types/TCNSNeuronActivationTaskFailure';
 export declare class CNSStimulation<TCollateralName extends string, TNeuronName extends string, TNeuron extends TCNSNeuron<any, TNeuronName, TCollateralName, any, any, any, any>, TDendrite extends TCNSDendrite<any, any, any, any, any, any>, TInputPayload, TOutputPayload> {
     private readonly cns;
-    readonly options?: TCNSStimulationOptions<TCollateralName, TInputPayload, TOutputPayload> | undefined;
+    readonly options?: TCNSStimulationOptions<TCollateralName, TInputPayload, TOutputPayload, TNeuronName> | undefined;
     private readonly ctx;
     private readonly queue;
     private readonly nueronVisitMap?;
     private readonly instanceNeuronQueue;
     private scheduledCount;
+    private readonly pendingTasks;
+    private readonly failedTasks;
     private completed;
     private resolveCompleted;
     private rejectCompleted;
     private isCompleted;
+    private onResponseError;
     /**
      * Track active SCCs: SCC index -> count of active neurons in that SCC
      */
     private readonly activeSccCounts;
     readonly id: string;
-    constructor(cns: ICNS<TNeuron, TDendrite>, instanceNeuronQueue: CNSInstanceNeuronQueue<TNeuron>, options?: TCNSStimulationOptions<TCollateralName, TInputPayload, TOutputPayload> | undefined);
+    constructor(cns: CNS<TCollateralName, TNeuronName, TNeuron, TDendrite>, instanceNeuronQueue: CNSInstanceNeuronQueue<TNeuron>, options?: TCNSStimulationOptions<TCollateralName, TInputPayload, TOutputPayload, TNeuronName> | undefined);
     private tryResolveCompleted;
     waitUntilComplete(): Promise<void>;
+    /**
+     * Returns all current activation tasks: queued, active, and pending (scheduled but not yet enqueued)
+     */
+    getAllActivationTasks(): TCNSNeuronActivationTask<TCollateralName, TNeuronName>[];
+    /**
+     * Returns all tasks that failed or were aborted
+     */
+    getFailedTasks(): Array<TCNSNeuronActivationTaskFailure<TCollateralName, TNeuronName>>;
+    /**
+     * Get the context store for this stimulation
+     */
+    getContext(): ICNSStimulationContextStore;
+    /**
+     * Enqueue activation tasks directly into the stimulation queue
+     */
+    enqueueTasks(tasks: TCNSNeuronActivationTask<TCollateralName, TNeuronName>[]): void;
     protected get concurrencyEnabled(): boolean;
     protected get autoCleanupContextsEnabled(): boolean;
     /**
@@ -49,8 +70,8 @@ export declare class CNSStimulation<TCollateralName extends string, TNeuronName
      */
     protected canNeuronBeGuaranteedDone(neuronId: TNeuronName): boolean;
     protected cleanupCtxIfNeeded(neuron: TNeuron): void;
-    protected createSubscriberQueueItem(subscriber: TCNSSubscriber<TNeuron, TDendrite>, inputSignal?: TCNSSignal<TCollateralName, any>): TCNSSerializedQueueItem<TCollateralName, TNeuronName>;
-    private processQueueItem;
+    protected createSubscriberQueueItem(subscriber: TCNSSubscriber<TNeuron, TDendrite>, inputSignal?: TCNSSignal<TCollateralName, any>): TCNSNeuronActivationTask<TCollateralName, TNeuronName>;
+    private executeActivationTask;
     protected processResponseOrResponses(inputSignal?: TCNSSignal<TCollateralName, TInputPayload>, outputSignalOrSignals?: TCNSSignal<TCollateralName, TOutputPayload> | TCNSSignal<TCollateralName, TOutputPayload>[], error?: any): void;
     protected processResponse(inputSignal?: TCNSSignal<TCollateralName, TInputPayload>, outputSignal?: TCNSSignal<TCollateralName, TOutputPayload>, error?: any): void;
     responseToSignal(signalOrSignals: TCNSSignal<TCollateralName, TOutputPayload> | TCNSSignal<TCollateralName, TOutputPayload>[]): void;

package/dist/CNSStimulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CNSStimulation.d.ts","sourceRoot":"","sources":["../src/CNSStimulation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CNSStimulation.d.ts","sourceRoot":"","sources":["../src/CNSStimulation.ts"],"names":[],"mappings":"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"}