@graphrefly/graphrefly 0.39.0 → 0.41.0

package/dist/{composite-DGatA-JK.d.ts → decay-BnrlbxSv.d.ts}

@@ -1,5 +1,5 @@
 import { N as Node, a as NodeOptions } from './node-BYInONRr.js';
-import { R as ReactiveMapBundle, a as ReactiveMapOptions } from './reactive-map-jFIsE6Kt.js';
+import { R as ReactiveMapBundle, b as ReactiveMapOptions } from './reactive-map-CjXByDV-.js';
 import { NodeInput } from './extra/sources.js';
 
 /**
@@ -73,4 +73,40 @@ type DistillBundle<TMem> = {
  */
 declare function distill<TRaw, TMem>(source: NodeInput<TRaw>, extractFn: (raw: Node<TRaw>, existing: Node<ReadonlyMap<string, TMem>>) => NodeInput<Extraction<TMem>>, opts: DistillOptions<TMem>): DistillBundle<TMem>;
 
-export { type DistillBundle as D, type Extraction as E, type VerifiableBundle as V, type DistillOptions as a, type VerifiableOptions as b, type VerifyValue as c, distill as d, verifiable as v };
+/**
+ * Pure exponential-decay utility (Tier 2.2 promotion from `patterns/memory/`).
+ *
+ * Used by `collection`, `agentMemory`, harness `strategy.ts`, and any
+ * downstream consumer that needs decay-with-floor scoring. Promoted to
+ * `extra/utils/` because the math has zero domain semantics and is reusable
+ * by non-memory primitives (e.g. routing weight decay, retry-attempt aging).
+ *
+ * @module
+ */
+/**
+ * Default exponential-decay rate corresponding to a 7-day half-life.
+ *
+ * `Math.LN2 / (7 × 86_400)` ≈ `1.146e-6`. Imported by memory tiers + any
+ * consumer that wants the same default cadence as `agentMemory`'s active
+ * tier. Tier 4.4 (Wave AM Unit 1) — promoted from
+ * `patterns/ai/memory/tiers.ts` so non-memory consumers can share the
+ * canonical default without reaching across domains.
+ */
+declare const DEFAULT_DECAY_RATE: number;
+/**
+ * Exponential decay with floor: `score = max(minScore, baseScore * exp(-ratePerSecond * ageSeconds))`.
+ *
+ * Tolerant fallbacks (deliberate for use inside reactive derived fns):
+ * - non-finite `baseScore` → `minScore`
+ * - non-positive `ageSeconds` (incl. clock skew) → `max(minScore, baseScore)` (no decay)
+ * - non-positive `ratePerSecond` → `max(minScore, baseScore)` (no decay; rate=0 disables)
+ *
+ * Underflow boundary: `Math.exp(-745) === 0`. For very long ages × rates the
+ * result clamps to `minScore`; if you need slow decay over years, choose a
+ * smaller `ratePerSecond` rather than relying on graceful underflow.
+ *
+ * Half-life conversion: `ratePerSecond = Math.LN2 / halfLifeSeconds`.
+ */
+declare function decay(baseScore: number, ageSeconds: number, ratePerSecond: number, minScore?: number): number;
+
+export { type DistillBundle as D, type Extraction as E, type VerifiableBundle as V, type DistillOptions as a, type VerifiableOptions as b, type VerifyValue as c, decay as d, distill as e, DEFAULT_DECAY_RATE as f, verifiable as v };

package/dist/{composite-CKd0e2vz.d.cts → decay-C25AyNAj.d.cts}

@@ -1,5 +1,5 @@
 import { N as Node, a as NodeOptions } from './node-BYInONRr.cjs';
-import { R as ReactiveMapBundle, a as ReactiveMapOptions } from './reactive-map-B2qfD3hb.cjs';
+import { R as ReactiveMapBundle, b as ReactiveMapOptions } from './reactive-map-6P_k3AQM.cjs';
 import { NodeInput } from './extra/sources.cjs';
 
 /**
@@ -73,4 +73,40 @@ type DistillBundle<TMem> = {
  */
 declare function distill<TRaw, TMem>(source: NodeInput<TRaw>, extractFn: (raw: Node<TRaw>, existing: Node<ReadonlyMap<string, TMem>>) => NodeInput<Extraction<TMem>>, opts: DistillOptions<TMem>): DistillBundle<TMem>;
 
-export { type DistillBundle as D, type Extraction as E, type VerifiableBundle as V, type DistillOptions as a, type VerifiableOptions as b, type VerifyValue as c, distill as d, verifiable as v };
+/**
+ * Pure exponential-decay utility (Tier 2.2 promotion from `patterns/memory/`).
+ *
+ * Used by `collection`, `agentMemory`, harness `strategy.ts`, and any
+ * downstream consumer that needs decay-with-floor scoring. Promoted to
+ * `extra/utils/` because the math has zero domain semantics and is reusable
+ * by non-memory primitives (e.g. routing weight decay, retry-attempt aging).
+ *
+ * @module
+ */
+/**
+ * Default exponential-decay rate corresponding to a 7-day half-life.
+ *
+ * `Math.LN2 / (7 × 86_400)` ≈ `1.146e-6`. Imported by memory tiers + any
+ * consumer that wants the same default cadence as `agentMemory`'s active
+ * tier. Tier 4.4 (Wave AM Unit 1) — promoted from
+ * `patterns/ai/memory/tiers.ts` so non-memory consumers can share the
+ * canonical default without reaching across domains.
+ */
+declare const DEFAULT_DECAY_RATE: number;
+/**
+ * Exponential decay with floor: `score = max(minScore, baseScore * exp(-ratePerSecond * ageSeconds))`.
+ *
+ * Tolerant fallbacks (deliberate for use inside reactive derived fns):
+ * - non-finite `baseScore` → `minScore`
+ * - non-positive `ageSeconds` (incl. clock skew) → `max(minScore, baseScore)` (no decay)
+ * - non-positive `ratePerSecond` → `max(minScore, baseScore)` (no decay; rate=0 disables)
+ *
+ * Underflow boundary: `Math.exp(-745) === 0`. For very long ages × rates the
+ * result clamps to `minScore`; if you need slow decay over years, choose a
+ * smaller `ratePerSecond` rather than relying on graceful underflow.
+ *
+ * Half-life conversion: `ratePerSecond = Math.LN2 / halfLifeSeconds`.
+ */
+declare function decay(baseScore: number, ageSeconds: number, ratePerSecond: number, minScore?: number): number;
+
+export { type DistillBundle as D, type Extraction as E, type VerifiableBundle as V, type DistillOptions as a, type VerifiableOptions as b, type VerifyValue as c, decay as d, distill as e, DEFAULT_DECAY_RATE as f, verifiable as v };