@graphrefly/graphrefly 0.37.0 → 0.39.0

package/dist/index-DXz9uwcs.d.ts

@@ -1,186 +0,0 @@
-import { a as Node, N as NodeOptions } from './node-fSc-hCv8.js';
-import { a as GraphOptions, G as Graph } from './graph-YQXDndFy.js';
-
-/**
- * Reduction primitives (roadmap §8.1).
- *
- * Composable building blocks for taking heterogeneous massive inputs and producing
- * prioritized, auditable, human-actionable output. Each primitive is either a Graph
- * factory or a Node factory, built on top of core + extra primitives.
- *
- * @module
- */
-
-type StepRef = string | Node<unknown>;
-/** A named stage for {@link funnel}. */
-type FunnelStage = {
-    /** Stage name (mounted as subgraph). */
-    name: string;
-    /** Builder: receives a sub-graph, should add an `"input"` and `"output"` node. */
-    build: (sub: Graph) => void;
-};
-/** Options for {@link funnel}. */
-type FunnelOptions = GraphOptions & {
-    meta?: Record<string, unknown>;
-};
-/**
- * Multi-source merge with sequential reduction stages.
- *
- * Sources are merged into a single stream. Each stage is a named subgraph
- * (mounted via `graph.mount()`). Stages connect linearly:
- * `merged → stage[0].input → stage[0].output → stage[1].input → ...`
- *
- * @param name - Graph name.
- * @param sources - Input nodes to merge.
- * @param stages - Sequential reduction stages.
- * @param opts - Optional graph/meta options.
- * @returns Graph with `"merged"` and mounted stage subgraphs.
- *
- * @category patterns
- */
-declare function funnel<T>(name: string, sources: ReadonlyArray<Node<T>>, stages: ReadonlyArray<FunnelStage>, opts?: FunnelOptions): Graph;
-/** Options for {@link feedback}. */
-type FeedbackOptions = {
-    /** Maximum feedback iterations before stopping (default: 10). */
-    maxIterations?: number;
-    /** Optional budget gate node path for cost-bounded iteration. */
-    budgetNode?: StepRef;
-    meta?: Record<string, unknown>;
-};
-/**
- * Introduce a bounded reactive cycle into an existing graph.
- *
- * When `condition` emits a non-null DATA value, the feedback effect routes it
- * back to the `reentry` state node — creating a cycle. Bounded by
- * `maxIterations` (default 10). The counter node (`__feedback_<condition>`)
- * is the source of truth — reset it to 0 to allow more iterations.
- *
- * To remove the feedback cycle, call `graph.remove("__feedback_<condition>")`.
- *
- * @param graph - Existing graph to augment with a feedback cycle.
- * @param condition - Path to a node whose DATA triggers feedback.
- * @param reentry - Path to a state node that receives the feedback value.
- * @param opts - Iteration bounds and metadata.
- * @returns The same graph (mutated with feedback nodes added).
- *
- * @category patterns
- */
-declare function feedback(graph: Graph, condition: string, reentry: string, opts?: FeedbackOptions): Graph;
-/** A reactive constraint for {@link budgetGate}. */
-type BudgetConstraint<T = unknown> = {
-    /** Constraint node whose value is checked. */
-    node: Node<T>;
-    /** Returns `true` when the constraint is satisfied (budget available). */
-    check: (value: T) => boolean;
-};
-/** Options for {@link budgetGate}. */
-type BudgetGateOptions = Omit<NodeOptions<unknown>, "describeKind" | "name" | "meta"> & {
-    meta?: Record<string, unknown>;
-};
-/**
- * Pass-through that respects reactive constraint nodes.
- *
- * DATA flows through when all constraints are satisfied. When any constraint
- * is exceeded, PAUSE is sent upstream and DATA is buffered. When constraints
- * relax, RESUME is sent and buffered DATA flushes.
- *
- * @param source - Input node.
- * @param constraints - Reactive constraint checks.
- * @param opts - Optional node options.
- * @returns Gated node.
- *
- * @category patterns
- */
-declare function budgetGate<T>(source: Node<T>, constraints: ReadonlyArray<BudgetConstraint>, opts?: BudgetGateOptions): Node<T>;
-/** A scored item with full breakdown. */
-type ScoredItem<T = unknown> = {
-    /** Original value. */
-    value: T;
-    /** Final weighted score. */
-    score: number;
-    /** Per-signal breakdown: signal index → weighted contribution. */
-    breakdown: number[];
-};
-/** Options for {@link scorer}. */
-type ScorerOptions = Omit<NodeOptions<unknown>, "describeKind" | "name" | "meta"> & {
-    meta?: Record<string, unknown>;
-    /** Custom scoring function per signal. Default: identity (signal value IS the score). */
-    scoreFns?: ReadonlyArray<(value: unknown) => number>;
-};
-/**
- * Reactive multi-signal scoring with live weights.
- *
- * Each source emits items to score. Weights are reactive state nodes that
- * LLM or human can adjust live. Output is sorted scored items with full
- * breakdown.
- *
- * @param sources - Signal nodes (each emits a numeric score dimension).
- * @param weights - Reactive weight nodes (one per source).
- * @param opts - Optional node/meta options.
- * @returns Node emitting scored output.
- *
- * @category patterns
- */
-declare function scorer(sources: ReadonlyArray<Node<number>>, weights: ReadonlyArray<Node<number>>, opts?: ScorerOptions): Node<ScoredItem<number[]>>;
-/** A single effectiveness record for an action×context pair. */
-type EffectivenessEntry = {
-    readonly key: string;
-    readonly attempts: number;
-    readonly successes: number;
-    readonly successRate: number;
-};
-/** Snapshot shape for the effectiveness tracker node. */
-type EffectivenessSnapshot = ReadonlyMap<string, EffectivenessEntry>;
-/** Bundle returned by {@link effectivenessTracker}. */
-interface EffectivenessTrackerBundle {
-    /** Reactive node — current effectiveness map snapshot. */
-    readonly node: Node<EffectivenessSnapshot>;
-    /** Record a completed action (success or failure). */
-    record(key: string, success: boolean): void;
-    /** Look up effectiveness for a specific key. */
-    lookup(key: string): EffectivenessEntry | undefined;
-    /** Tear down internal keepalive subscriptions. */
-    dispose(): void;
-}
-/** Options for {@link effectivenessTracker}. */
-type EffectivenessTrackerOptions = {
-    /** Name for the reactive map (default "effectiveness-entries"). */
-    name?: string;
-};
-/**
- * Generic action×context → success rate tracker.
- *
- * Generalized from the harness `strategyModel` pattern. Tracks attempts and
- * successes per string key, exposes a reactive snapshot node, and provides
- * `record()` / `lookup()` methods.
- *
- * Use cases: A/B testing, routing optimization, cache policy tuning, retry
- * strategy selection — any domain that tracks effectiveness per action.
- *
- * @param opts - Optional configuration.
- * @returns Bundle with reactive node, record(), lookup(), dispose().
- */
-declare function effectivenessTracker(opts?: EffectivenessTrackerOptions): EffectivenessTrackerBundle;
-
-type index_BudgetConstraint<T = unknown> = BudgetConstraint<T>;
-type index_BudgetGateOptions = BudgetGateOptions;
-type index_EffectivenessEntry = EffectivenessEntry;
-type index_EffectivenessSnapshot = EffectivenessSnapshot;
-type index_EffectivenessTrackerBundle = EffectivenessTrackerBundle;
-type index_EffectivenessTrackerOptions = EffectivenessTrackerOptions;
-type index_FeedbackOptions = FeedbackOptions;
-type index_FunnelOptions = FunnelOptions;
-type index_FunnelStage = FunnelStage;
-type index_ScoredItem<T = unknown> = ScoredItem<T>;
-type index_ScorerOptions = ScorerOptions;
-type index_StepRef = StepRef;
-declare const index_budgetGate: typeof budgetGate;
-declare const index_effectivenessTracker: typeof effectivenessTracker;
-declare const index_feedback: typeof feedback;
-declare const index_funnel: typeof funnel;
-declare const index_scorer: typeof scorer;
-declare namespace index {
-  export { type index_BudgetConstraint as BudgetConstraint, type index_BudgetGateOptions as BudgetGateOptions, type index_EffectivenessEntry as EffectivenessEntry, type index_EffectivenessSnapshot as EffectivenessSnapshot, type index_EffectivenessTrackerBundle as EffectivenessTrackerBundle, type index_EffectivenessTrackerOptions as EffectivenessTrackerOptions, type index_FeedbackOptions as FeedbackOptions, type index_FunnelOptions as FunnelOptions, type index_FunnelStage as FunnelStage, type index_ScoredItem as ScoredItem, type index_ScorerOptions as ScorerOptions, type index_StepRef as StepRef, index_budgetGate as budgetGate, index_effectivenessTracker as effectivenessTracker, index_feedback as feedback, index_funnel as funnel, index_scorer as scorer };
-}
-
-export { type BudgetConstraint as B, type EffectivenessEntry as E, type FeedbackOptions as F, type ScoredItem as S, type BudgetGateOptions as a, type EffectivenessSnapshot as b, type EffectivenessTrackerBundle as c, type EffectivenessTrackerOptions as d, type FunnelOptions as e, type FunnelStage as f, type ScorerOptions as g, type StepRef as h, index as i, budgetGate as j, effectivenessTracker as k, feedback as l, funnel as m, scorer as s };

package/dist/index-DbWwMWiB.d.cts

@@ -1,139 +0,0 @@
-import { a as Node } from './node-fSc-hCv8.cjs';
-import { G as Graph } from './graph-CaNXUc3c.cjs';
-
-/**
- * Memory patterns (roadmap §4.3).
- *
- * Domain-layer helpers composed from GraphRefly primitives. `vectorIndex` uses
- * an exact-search backend by default; an HNSW adapter can be injected as an
- * optional dependency.
- */
-
-type CollectionPolicy = "fifo" | "lru";
-type VectorBackend = "flat" | "hnsw";
-type LightCollectionEntry<T> = {
-    readonly id: string;
-    readonly value: T;
-    readonly createdAtNs: number;
-    readonly lastAccessNs: number;
-};
-type LightCollectionOptions = {
-    name?: string;
-    maxSize?: number;
-    policy?: CollectionPolicy;
-};
-type LightCollectionBundle<T> = {
-    readonly entries: Node<ReadonlyMap<string, LightCollectionEntry<T>>>;
-    upsert: (id: string, value: T) => void;
-    remove: (id: string) => void;
-    clear: () => void;
-    get: (id: string) => T | undefined;
-    has: (id: string) => boolean;
-};
-type CollectionEntry<T> = LightCollectionEntry<T> & {
-    readonly baseScore: number;
-};
-type RankedCollectionEntry<T> = CollectionEntry<T> & {
-    readonly score: number;
-};
-type CollectionOptions<T> = {
-    maxSize?: number;
-    policy?: CollectionPolicy;
-    /**
-     * Produces a base score at insert/update time.
-     */
-    score?: (value: T) => number;
-    /**
-     * Exponential decay rate per second. 0 disables decay.
-     */
-    decayRate?: number;
-    /**
-     * Minimum score floor after decay.
-     */
-    minScore?: number;
-};
-type CollectionGraph<T> = Graph & {
-    upsert: (id: string, value: T, opts?: {
-        score?: number;
-    }) => void;
-    remove: (id: string) => void;
-    clear: () => void;
-    getItem: (id: string) => CollectionEntry<T> | undefined;
-};
-type VectorRecord<TMeta> = {
-    readonly id: string;
-    readonly vector: readonly number[];
-    readonly meta?: TMeta;
-};
-type VectorSearchResult<TMeta> = {
-    readonly id: string;
-    readonly score: number;
-    readonly meta?: TMeta;
-};
-type HnswAdapter<TMeta> = {
-    upsert: (id: string, vector: readonly number[], meta?: TMeta) => void;
-    remove: (id: string) => void;
-    clear: () => void;
-    search: (query: readonly number[], k: number) => ReadonlyArray<VectorSearchResult<TMeta>>;
-};
-type VectorIndexOptions<TMeta> = {
-    backend?: VectorBackend;
-    dimension?: number;
-    /**
-     * Optional dependency seam for HNSW.
-     */
-    hnswFactory?: () => HnswAdapter<TMeta>;
-};
-type VectorIndexBundle<TMeta> = {
-    readonly backend: VectorBackend;
-    readonly entries: Node<ReadonlyMap<string, VectorRecord<TMeta>>>;
-    upsert: (id: string, vector: readonly number[], meta?: TMeta) => void;
-    remove: (id: string) => void;
-    clear: () => void;
-    search: (query: readonly number[], k?: number) => ReadonlyArray<VectorSearchResult<TMeta>>;
-};
-type KnowledgeEdge<TRelation extends string = string> = {
-    readonly from: string;
-    readonly to: string;
-    readonly relation: TRelation;
-    readonly weight: number;
-};
-type KnowledgeGraphGraph<TEntity, TRelation extends string = string> = Graph & {
-    upsertEntity: (id: string, value: TEntity) => void;
-    removeEntity: (id: string) => void;
-    link: (from: string, to: string, relation: TRelation, weight?: number) => void;
-    unlink: (from: string, to: string, relation?: TRelation) => void;
-    related: (id: string, relation?: TRelation) => ReadonlyArray<KnowledgeEdge<TRelation>>;
-};
-declare function decay(baseScore: number, ageSeconds: number, ratePerSecond: number, minScore?: number): number;
-declare function lightCollection<T>(opts?: LightCollectionOptions): LightCollectionBundle<T>;
-declare function collection<T>(name: string, opts?: CollectionOptions<T>): CollectionGraph<T>;
-declare function vectorIndex<TMeta>(opts?: VectorIndexOptions<TMeta>): VectorIndexBundle<TMeta>;
-declare function knowledgeGraph<TEntity, TRelation extends string = string>(name: string): KnowledgeGraphGraph<TEntity, TRelation>;
-
-type index_CollectionEntry<T> = CollectionEntry<T>;
-type index_CollectionGraph<T> = CollectionGraph<T>;
-type index_CollectionOptions<T> = CollectionOptions<T>;
-type index_CollectionPolicy = CollectionPolicy;
-type index_HnswAdapter<TMeta> = HnswAdapter<TMeta>;
-type index_KnowledgeEdge<TRelation extends string = string> = KnowledgeEdge<TRelation>;
-type index_KnowledgeGraphGraph<TEntity, TRelation extends string = string> = KnowledgeGraphGraph<TEntity, TRelation>;
-type index_LightCollectionBundle<T> = LightCollectionBundle<T>;
-type index_LightCollectionEntry<T> = LightCollectionEntry<T>;
-type index_LightCollectionOptions = LightCollectionOptions;
-type index_RankedCollectionEntry<T> = RankedCollectionEntry<T>;
-type index_VectorBackend = VectorBackend;
-type index_VectorIndexBundle<TMeta> = VectorIndexBundle<TMeta>;
-type index_VectorIndexOptions<TMeta> = VectorIndexOptions<TMeta>;
-type index_VectorRecord<TMeta> = VectorRecord<TMeta>;
-type index_VectorSearchResult<TMeta> = VectorSearchResult<TMeta>;
-declare const index_collection: typeof collection;
-declare const index_decay: typeof decay;
-declare const index_knowledgeGraph: typeof knowledgeGraph;
-declare const index_lightCollection: typeof lightCollection;
-declare const index_vectorIndex: typeof vectorIndex;
-declare namespace index {
-  export { type index_CollectionEntry as CollectionEntry, type index_CollectionGraph as CollectionGraph, type index_CollectionOptions as CollectionOptions, type index_CollectionPolicy as CollectionPolicy, type index_HnswAdapter as HnswAdapter, type index_KnowledgeEdge as KnowledgeEdge, type index_KnowledgeGraphGraph as KnowledgeGraphGraph, type index_LightCollectionBundle as LightCollectionBundle, type index_LightCollectionEntry as LightCollectionEntry, type index_LightCollectionOptions as LightCollectionOptions, type index_RankedCollectionEntry as RankedCollectionEntry, type index_VectorBackend as VectorBackend, type index_VectorIndexBundle as VectorIndexBundle, type index_VectorIndexOptions as VectorIndexOptions, type index_VectorRecord as VectorRecord, type index_VectorSearchResult as VectorSearchResult, index_collection as collection, index_decay as decay, index_knowledgeGraph as knowledgeGraph, index_lightCollection as lightCollection, index_vectorIndex as vectorIndex };
-}
-
-export { type CollectionEntry as C, type HnswAdapter as H, type KnowledgeGraphGraph as K, type LightCollectionBundle as L, type RankedCollectionEntry as R, type VectorSearchResult as V, type VectorIndexBundle as a, type CollectionGraph as b, type CollectionOptions as c, type CollectionPolicy as d, type KnowledgeEdge as e, type LightCollectionEntry as f, type LightCollectionOptions as g, type VectorBackend as h, index as i, type VectorIndexOptions as j, type VectorRecord as k, collection as l, decay as m, knowledgeGraph as n, lightCollection as o, vectorIndex as v };

package/dist/meta-BGO6C7K9.d.cts

@@ -1,41 +0,0 @@
-import { e as NodeDescribeKind, a as Node, A as Actor } from './node-fSc-hCv8.cjs';
-
-/**
- * JSON-shaped slice of a node for `Graph.describe()`
- * (GRAPHREFLY-SPEC §3.6, Appendix B).
- */
-type DescribeNodeOutput = {
-    type: NodeDescribeKind;
-    status?: Node["status"];
-    deps: string[];
-    meta?: Record<string, unknown>;
-    name?: string;
-    value?: unknown;
-    /** True when the node is in `"sentinel"` state (no value ever). */
-    sentinel?: boolean;
-    v?: {
-        id: string;
-        version: number;
-        cid?: string;
-        prev?: string | null;
-    };
-    guard?: string;
-    lastMutation?: Readonly<{
-        actor: Actor;
-        timestamp_ns: number;
-    }>;
-    /**
-     * Latest annotation attached via `graph.trace(path, annotation)` or via
-     * `graph.add(node, { name: path, annotation })`, when present. Populated by
-     * `Graph.describe` only — `describeNode` has no graph context.
-     */
-    annotation?: string;
-};
-/** Detail level for progressive disclosure (Phase 3.3b). */
-type DescribeDetail = "minimal" | "standard" | "full";
-/** Valid field names for `describe({ fields: [...] })`. */
-type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
-/** Resolve which fields to include based on detail level or explicit field list. */
-declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
-
-export { type DescribeDetail as D, type DescribeField as a, type DescribeNodeOutput as b, resolveDescribeFields as r };

package/dist/meta-CC6EPdpK.d.ts

@@ -1,41 +0,0 @@
-import { e as NodeDescribeKind, a as Node, A as Actor } from './node-fSc-hCv8.js';
-
-/**
- * JSON-shaped slice of a node for `Graph.describe()`
- * (GRAPHREFLY-SPEC §3.6, Appendix B).
- */
-type DescribeNodeOutput = {
-    type: NodeDescribeKind;
-    status?: Node["status"];
-    deps: string[];
-    meta?: Record<string, unknown>;
-    name?: string;
-    value?: unknown;
-    /** True when the node is in `"sentinel"` state (no value ever). */
-    sentinel?: boolean;
-    v?: {
-        id: string;
-        version: number;
-        cid?: string;
-        prev?: string | null;
-    };
-    guard?: string;
-    lastMutation?: Readonly<{
-        actor: Actor;
-        timestamp_ns: number;
-    }>;
-    /**
-     * Latest annotation attached via `graph.trace(path, annotation)` or via
-     * `graph.add(node, { name: path, annotation })`, when present. Populated by
-     * `Graph.describe` only — `describeNode` has no graph context.
-     */
-    annotation?: string;
-};
-/** Detail level for progressive disclosure (Phase 3.3b). */
-type DescribeDetail = "minimal" | "standard" | "full";
-/** Valid field names for `describe({ fields: [...] })`. */
-type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
-/** Resolve which fields to include based on detail level or explicit field list. */
-declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
-
-export { type DescribeDetail as D, type DescribeField as a, type DescribeNodeOutput as b, resolveDescribeFields as r };

package/dist/resilience-OBU472D2.js

@@ -1 +0,0 @@
-import{a,b,c,d,e,f,g,h,i,j,k}from"./chunk-A5HZZYRK.js";import"./chunk-ESMPEKEV.js";import"./chunk-4VVTGLXJ.js";import"./chunk-MQZWA3DF.js";import"./chunk-LYCLF26R.js";import"./chunk-CK2E7BTU.js";import"./chunk-QYADASLV.js";export{b as CircuitOpenError,f as RateLimiterOverflowError,i as TimeoutError,c as circuitBreaker,j as fallback,g as rateLimiter,a as retry,k as timeout,e as tokenBucket,d as withBreaker,h as withStatus};