@cnstra/core 2.5.0 → 2.6.0

package/dist/index.d.ts

@@ -1,23 +1,8 @@
 export { CNS } from './CNS';
-export { CNSPersistOptionsRegistry } from './CNSPersistOptionsRegistry';
 export { CNSCollateral } from './CNSCollateral';
 export { CNSStimulationContextStore } from './CNSStimulationContextStore';
 export { CNSStimulationGate } from './utils/CNSStimulationGate';
-export type { ICNS } from './interfaces/ICNS';
-export type { TCNSNeuron } from './types/TCNSNeuron';
-export type { TCNSAxon } from './types/TCNSAxon';
-export type { TCNSDendrite } from './types/TCNSDendrite';
-export type { TCNSHandlerContext } from './types/TCNSHandlerContext';
-export type { TCNSSignal } from './types/TCNSSignal';
-export type { TCNSNeuronActivationTask } from './types/TCNSNeuronActivationTask';
-export type { TCNSStimulationOptions } from './types/TCNSStimulationOptions';
-export type { TCNSStimulationResponse } from './types/TCNSStimulationResponse';
-export type { TCNSStimulationDrain } from './types/TCNSStimulationDrain';
-export type { TCNSModality } from './types/TCNSModality';
-export type { TCNSAfferentPath } from './types/TCNSAfferentPath';
-export type { TCNSNeuronActivationTaskFailure } from './types/TCNSNeuronActivationTaskFailure';
-export type { TCNSNeuronPersistOptions, TCNSCollateralPersistOptions, TCNSStimulationPersistOptions } from './types/TCNSPersist';
 export type { TCNSStimulationGateOptions, TCNSStimulationGateSignal } from './utils/CNSStimulationGate';
-export { collateral, neuron, neuronFactory, withCtx, withGlobal, afferentPath, modality, createPersistRegistry, createCNS, } from './factory/index';
+export { collateral, neuron, neuronFactory, withCtx, withGlobal, afferentPath, modality, } from './factory/index';
 export type { TNeuronFactory } from './factory/index';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC/F,YAAY,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACjI,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAGxG,OAAO,EACH,UAAU,EACV,MAAM,EACN,aAAa,EACb,OAAO,EACP,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,qBAAqB,EACrB,SAAS,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAKhE,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAGxG,OAAO,EACH,UAAU,EACV,MAAM,EACN,aAAa,EACb,OAAO,EACP,UAAU,EACV,YAAY,EACZ,QAAQ,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -37,6 +37,13 @@ var CNSDendriteContext = class {
   get global() {
     return this.cns.global;
   }
+  // The caller-supplied per-stimulation context (`stimulate(sig, {stimulationContext})`),
+  // the same value on every hop — the environment-agnostic way to correlate logs to a
+  // run (pass `{ stimulationId, attemptNumber }`). Prototype getter like `global`:
+  // zero extra allocation, read only where a handler reaches for it.
+  get stimulationContext() {
+    return this.stimulation.options?.stimulationContext;
+  }
   get() {
     return this.stimulation.getContext().get(this.neuron);
   }
@@ -48,7 +55,7 @@ var CNSDendriteContext = class {
   }
 };
 var CNSStimulationResponseImpl = class {
-  constructor(stimulation, store, inputSignal, outputSignal, queueLength, pendingActivations, activeActivations, hops, error) {
+  constructor(stimulation, store, inputSignal, outputSignal, queueLength, pendingActivations, activeActivations, hops, error, neuron2) {
     this.stimulation = stimulation;
     this.store = store;
     this.inputSignal = inputSignal;
@@ -58,6 +65,7 @@ var CNSStimulationResponseImpl = class {
     this.activeActivations = activeActivations;
     this.hops = hops;
     this.error = error;
+    this.neuron = neuron2;
   }
   get contextValue() {
     return this.store ? this.store.getAll() : /* @__PURE__ */ new Map();
@@ -331,6 +339,19 @@ var CNSStimulation = class {
   getFailedTasks() {
     return this.failedTasks ? [...this.failedTasks] : [];
   }
+  /**
+   * The current outstanding frontier — every task that has not completed:
+   * queued, active, and pending (awaiting an async onResponse), plus any
+   * failed/aborted tasks. This is the set to persist for resume: re-activating
+   * it re-runs exactly the not-yet-done work. Safe to call at any point during
+   * a run (for progress) or after it fails.
+   */
+  getOutstandingTasks() {
+    return [
+      ...this.getAllActivationTasks(),
+      ...this.getFailedTasks().map((f) => f.task)
+    ];
+  }
   /**
    * Get the context store for this stimulation
    */
@@ -662,7 +683,8 @@ var CNSStimulation = class {
           this.pendingActivations,
           this.activeOperations,
           this.options?.maxNeuronHops && emitter ? this.neuronVisitMap?.get(emitter) ?? 0 : void 0,
-          error
+          error,
+          emitter
         )
       );
     } catch (e) {
@@ -1211,72 +1233,6 @@ var CNS = class {
   }
 };
 
-// src/CNSPersistOptionsRegistry.ts
-var CNSPersistOptionsRegistry = class {
-  constructor() {
-    this.neurons = /* @__PURE__ */ new Map();
-    this.neuronNames = /* @__PURE__ */ new WeakMap();
-    this.collaterals = /* @__PURE__ */ new Map();
-    this.stimulations = /* @__PURE__ */ new Map();
-  }
-  addNeuron(neuron2, options) {
-    this.neurons.set(options.name, neuron2);
-    this.neuronNames.set(neuron2, options.name);
-  }
-  getNeuron(name) {
-    return this.neurons.get(name);
-  }
-  getNeuronName(neuron2) {
-    return this.neuronNames.get(neuron2);
-  }
-  getNamedNeurons() {
-    return this.neurons;
-  }
-  getCollateralName(collateral2) {
-    for (const [name, col] of this.collaterals) {
-      if (col === collateral2) return name;
-    }
-    return void 0;
-  }
-  removeNeuron(name) {
-    const neuron2 = this.neurons.get(name);
-    if (neuron2) this.neuronNames.delete(neuron2);
-    this.neurons.delete(name);
-  }
-  addCollateral(collateral2, options) {
-    this.collaterals.set(options.name, collateral2);
-  }
-  getCollateral(name) {
-    return this.collaterals.get(name);
-  }
-  removeCollateral(name) {
-    this.collaterals.delete(name);
-  }
-  addStimulation(stimulation, options) {
-    this.stimulations.set(options.stimulationId, stimulation);
-  }
-  getStimulation(stimulationId) {
-    return this.stimulations.get(stimulationId);
-  }
-  removeStimulation(stimulationId) {
-    this.stimulations.delete(stimulationId);
-  }
-  register(name, neuron2, collateralNames) {
-    this.addNeuron(neuron2, { name, neuron: neuron2 });
-    for (const [key, col] of Object.entries(neuron2.axon)) {
-      this.addCollateral(col, {
-        name: collateralNames?.[key] ?? key,
-        collateral: col
-      });
-    }
-    return this;
-  }
-  registerCollateral(name, collateral2) {
-    this.addCollateral(collateral2, { name, collateral: collateral2 });
-    return this;
-  }
-};
-
 // src/CNSCollateral.ts
 var CNSCollateral = class {
   createSignal(payload) {
@@ -1479,31 +1435,7 @@ var modality = (afferentPaths) => {
     afferentPaths
   };
 };
-var createPersistRegistry = (namedNeurons) => {
-  const registry = new CNSPersistOptionsRegistry();
-  for (const [name, entry] of Object.entries(namedNeurons)) {
-    const isEntry = "neuron" in entry && !("axon" in entry);
-    const neuron2 = isEntry ? entry.neuron : entry;
-    const colNames = isEntry ? entry.collaterals ?? {} : {};
-    registry.addNeuron(neuron2, { name, neuron: neuron2 });
-    for (const [key, col] of Object.entries(neuron2.axon)) {
-      registry.addCollateral(col, {
-        name: colNames[key] ?? key,
-        collateral: col
-      });
-    }
-  }
-  return registry;
-};
-var createCNS = (namedNeurons, options) => {
-  const neurons = Object.values(namedNeurons).map(
-    (entry) => entry && typeof entry === "object" && "neuron" in entry ? entry.neuron : entry
-  );
-  const cns = new CNS(neurons, options, options?.global);
-  const registry = createPersistRegistry(namedNeurons);
-  return { cns, registry };
-};
 
-export { CNS, CNSCollateral, CNSPersistOptionsRegistry, CNSStimulationContextStore, CNSStimulationGate, afferentPath, collateral, createCNS, createPersistRegistry, modality, neuron, neuronFactory, withCtx, withGlobal };
+export { CNS, CNSCollateral, CNSStimulationContextStore, CNSStimulationGate, afferentPath, collateral, modality, neuron, neuronFactory, withCtx, withGlobal };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map