@cnstra/core 2.3.0 → 2.4.0

package/dist/types/TCNSDendrite.d.ts

@@ -1,14 +1,9 @@
 import { CNSCollateral } from '../CNSCollateral';
 import { TCNSAxon } from './TCNSAxon';
-import { TCNSLocalContextValueStore } from './TCNSLocalContextValueStore';
 import { TNCNeuronResponseReturn } from './TCNSNeuronResponseReturn';
-import { ICNS } from '../interfaces/ICNS';
-export type TCNSDendrite<TContextValue, TSenderCollateral extends CNSCollateral<unknown>, TAxonType extends TCNSAxon> = {
+import { TCNSHandlerContext } from './TCNSHandlerContext';
+export type TCNSDendrite<TContextValue, TSenderCollateral extends CNSCollateral<unknown>, TAxonType extends TCNSAxon, TExt = unknown> = {
     collateral: TSenderCollateral;
-    response: (payload: TSenderCollateral extends CNSCollateral<infer P> ? P : never, axon: TAxonType, ctx: TCNSLocalContextValueStore<TContextValue> & {
-        abortSignal?: AbortSignal;
-        cns?: ICNS<any, any>;
-        stimulation?: any;
-    }) => TNCNeuronResponseReturn<TAxonType>;
+    response: (payload: TSenderCollateral extends CNSCollateral<infer P> ? P : never, axon: TAxonType, ctx: TCNSHandlerContext<TContextValue, TExt>) => TNCNeuronResponseReturn<TAxonType>;
 };
 //# sourceMappingURL=TCNSDendrite.d.ts.map

package/dist/types/TCNSDendrite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TCNSDendrite.d.ts","sourceRoot":"","sources":["../../src/types/TCNSDendrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,MAAM,YAAY,CACpB,aAAa,EACb,iBAAiB,SAAS,aAAa,CAAC,OAAO,CAAC,EAEhD,SAAS,SAAS,QAAQ,IAC1B;IACA,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,CACN,OAAO,EAAE,iBAAiB,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EACrE,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,0BAA0B,CAAC,aAAa,CAAC,GAAG;QAC7C,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrB,WAAW,CAAC,EAAE,GAAG,CAAC;KACrB,KACA,uBAAuB,CAAC,SAAS,CAAC,CAAC;CAC3C,CAAC"}
+{"version":3,"file":"TCNSDendrite.d.ts","sourceRoot":"","sources":["../../src/types/TCNSDendrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,MAAM,YAAY,CACpB,aAAa,EACb,iBAAiB,SAAS,aAAa,CAAC,OAAO,CAAC,EAEhD,SAAS,SAAS,QAAQ,EAG1B,IAAI,GAAG,OAAO,IACd;IACA,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,CACN,OAAO,EAAE,iBAAiB,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EACrE,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,kBAAkB,CAAC,aAAa,EAAE,IAAI,CAAC,KAC3C,uBAAuB,CAAC,SAAS,CAAC,CAAC;CAC3C,CAAC"}

package/dist/types/TCNSHandlerContext.d.ts

@@ -0,0 +1,24 @@
+import { TCNSLocalContextValueStore } from './TCNSLocalContextValueStore';
+import { ICNS } from '../interfaces/ICNS';
+/**
+ * The base `ctx` bag handed to every dendrite handler — nothing app-specific
+ * lives here. Factory layers add their own fields via the `TExt` extension
+ * (see {@link TCNSHandlerContext}), so the base stays clean for neurons that
+ * don't opt into anything.
+ */
+export type TCNSHandlerContextBase<TContextValue> = TCNSLocalContextValueStore<TContextValue> & {
+    abortSignal?: AbortSignal;
+    cns?: ICNS<any, any>;
+    stimulation?: any;
+};
+/**
+ * The `ctx` a dendrite handler receives. `TExt` is whatever the factory layers
+ * poured in (e.g. `withGlobal<T>()` adds `{ global: T }`) — it's a plain
+ * intersection, so layers add exactly what they want and nothing else, and a
+ * base neuron (no layers) gets `TExt = unknown`, i.e. just the base bag.
+ *
+ * The handler signature stays `(payload, axon, ctx)` no matter how many layers
+ * you stack; each layer widens the type of `ctx`, never the argument list.
+ */
+export type TCNSHandlerContext<TContextValue, TExt = unknown> = TCNSHandlerContextBase<TContextValue> & TExt;
+//# sourceMappingURL=TCNSHandlerContext.d.ts.map

package/dist/types/TCNSHandlerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TCNSHandlerContext.d.ts","sourceRoot":"","sources":["../../src/types/TCNSHandlerContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,CAAC,aAAa,IAC5C,0BAA0B,CAAC,aAAa,CAAC,GAAG;IACxC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrB,WAAW,CAAC,EAAE,GAAG,CAAC;CACrB,CAAC;AAEN;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,CAAC,aAAa,EAAE,IAAI,GAAG,OAAO,IACxD,sBAAsB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC"}

package/dist/types/TCNSNeuron.d.ts

@@ -7,6 +7,6 @@ export type TCNSNeuron<TContextValue, TAxonType extends TCNSAxon = TCNSAxon> = {
     concurrency?: number;
     /** Optional per-neuron max processing duration in milliseconds. */
     maxDuration?: number;
-    dendrites: TCNSDendrite<TContextValue, CNSCollateral<unknown>, TAxonType>[];
+    dendrites: TCNSDendrite<TContextValue, CNSCollateral<unknown>, TAxonType, any>[];
 };
 //# sourceMappingURL=TCNSNeuron.d.ts.map

package/dist/types/TCNSNeuron.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TCNSNeuron.d.ts","sourceRoot":"","sources":["../../src/types/TCNSNeuron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,UAAU,CAClB,aAAa,EACb,SAAS,SAAS,QAAQ,GAAG,QAAQ,IACrC;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,CACnB,aAAa,EACb,aAAa,CAAC,OAAO,CAAC,EACtB,SAAS,CACZ,EAAE,CAAC;CACP,CAAC"}
+{"version":3,"file":"TCNSNeuron.d.ts","sourceRoot":"","sources":["../../src/types/TCNSNeuron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,UAAU,CAClB,aAAa,EACb,SAAS,SAAS,QAAQ,GAAG,QAAQ,IACrC;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,SAAS,EAAE,YAAY,CACnB,aAAa,EACb,aAAa,CAAC,OAAO,CAAC,EACtB,SAAS,EACT,GAAG,CACN,EAAE,CAAC;CACP,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnstra/core",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Embeddable workflow/orchestration engine for TypeScript: deterministic runs over a typed neuron graph (in-memory, zero dependencies).",
   "keywords": [
     "neural-network",