@decaf-ts/integrations 0.3.1 → 0.3.2

package/lib/types/graph/planning/GraphRelationResolver.d.mts

@@ -0,0 +1,62 @@
+/**
+ * @module integrations/graph/planning/GraphRelationResolver
+ * @summary Normalizes workflow relations into execution edges.
+ * @description Resolves workflow boundary aliases, validates endpoints and ports, and produces stable edge IDs.
+ */
+import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphExecutionPlanEdge } from "./GraphExecutionPlanEdge.d.mts";
+/**
+ * Resolves raw workflow relation metadata into normalized execution edges.
+ */
+export declare class GraphRelationResolver {
+    /**
+     * Resolves all relations of a workflow into execution edges.
+     *
+     * @param workflow - The workflow definition.
+     * @returns Array of normalized edges.
+     * @throws {GraphTopologyError} when an endpoint is unknown or ambiguous.
+     * @throws {GraphPortError} when a referenced port is missing or unknown.
+     */
+    resolve(workflow: GraphWorkflowDefinition): GraphExecutionPlanEdge[];
+    /**
+     * Resolves a single relation into an edge.
+     */
+    private resolveRelation;
+    /**
+     * Resolves an endpoint (source or target) to a node id or the workflow boundary.
+     */
+    private resolveEndpoint;
+    /**
+     * Validates that a port exists on the given node or boundary.
+     */
+    private validatePort;
+    /**
+     * Builds the set of boundary aliases for a workflow.
+     */
+    private boundaryAliases;
+    /**
+     * Extracts port names from a list of port definitions.
+     */
+    private portNames;
+    /**
+     * Builds a map of node id -> { input ports, output ports }.
+     */
+    private buildNodePortMap;
+    /**
+     * Attempts to resolve a node's full definition from its metadata.
+     *
+     * Accepts either a decorated Model class/instance (resolved via
+     * `graphDefinitionOf`) or a plain `GraphNodeDefinition`-shaped object
+     * (useful for serialized workflows that inline node definitions).
+     */
+    private resolveNodeDefinition;
+    /**
+     * Returns `true` when a value looks like a raw {@link GraphNodeDefinition}
+     * (a plain object with a `ports` array and a `name` string).
+     */
+    private isRawDefinition;
+    /**
+     * Creates a stable edge id from its endpoints and ports.
+     */
+    private createEdgeId;
+}

package/lib/types/graph/planning/GraphTopology.d.cts

@@ -0,0 +1,23 @@
+/**
+ * @module integrations/graph/planning/GraphTopology
+ * @summary Utility helpers for graph topology analysis.
+ * @description Provides helper functions used by the planner and pinning dependency resolver.
+ */
+import type { GraphExecutionPlanEdge } from "./GraphExecutionPlanEdge.d.cts";
+/**
+ * Topology utility for traversing the execution plan's edges.
+ */
+export declare class GraphTopology {
+    /**
+     * Returns the set of upstream node ids reachable from `nodeId` by following
+     * incoming edges. The workflow boundary node is excluded.
+     */
+    static upstreamNodes(nodeId: string, incomingByNode: Map<string, GraphExecutionPlanEdge[]>, includeBoundary?: boolean): Set<string>;
+    /**
+     * Returns the set of downstream node ids reachable from `nodeId` by following
+     * outgoing edges. The workflow boundary node is excluded.
+     */
+    static downstreamNodes(nodeId: string, outgoingByNode: Map<string, GraphExecutionPlanEdge[]>, includeBoundary?: boolean): Set<string>;
+    /** Returns whether a node id is the workflow boundary. */
+    static isBoundary(nodeId: string): boolean;
+}

package/lib/types/graph/planning/GraphTopology.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @module integrations/graph/planning/GraphTopology
+ * @summary Utility helpers for graph topology analysis.
+ * @description Provides helper functions used by the planner and pinning dependency resolver.
+ */
+import type { GraphExecutionPlanEdge } from "./GraphExecutionPlanEdge.d.mts";
+/**
+ * Topology utility for traversing the execution plan's edges.
+ */
+export declare class GraphTopology {
+    /**
+     * Returns the set of upstream node ids reachable from `nodeId` by following
+     * incoming edges. The workflow boundary node is excluded.
+     */
+    static upstreamNodes(nodeId: string, incomingByNode: Map<string, GraphExecutionPlanEdge[]>, includeBoundary?: boolean): Set<string>;
+    /**
+     * Returns the set of downstream node ids reachable from `nodeId` by following
+     * outgoing edges. The workflow boundary node is excluded.
+     */
+    static downstreamNodes(nodeId: string, outgoingByNode: Map<string, GraphExecutionPlanEdge[]>, includeBoundary?: boolean): Set<string>;
+    /** Returns whether a node id is the workflow boundary. */
+    static isBoundary(nodeId: string): boolean;
+}

package/lib/types/graph/planning/index.d.cts

@@ -0,0 +1,12 @@
+/**
+ * @module integrations/graph/planning
+ * @summary Graph execution planning.
+ * @description Re-exports the execution plan types, relation resolver, and topological planner.
+ */
+export * from "./GraphExecutionPlanNode.d.cts";
+export * from "./GraphExecutionPlanEdge.d.cts";
+export * from "./GraphExecutionPlanLayer.d.cts";
+export * from "./GraphExecutionPlan.d.cts";
+export * from "./GraphRelationResolver.d.cts";
+export * from "./GraphExecutionPlanner.d.cts";
+export * from "./GraphTopology.d.cts";

package/lib/types/graph/planning/index.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @module integrations/graph/planning
+ * @summary Graph execution planning.
+ * @description Re-exports the execution plan types, relation resolver, and topological planner.
+ */
+export * from "./GraphExecutionPlanNode.d.mts";
+export * from "./GraphExecutionPlanEdge.d.mts";
+export * from "./GraphExecutionPlanLayer.d.mts";
+export * from "./GraphExecutionPlan.d.mts";
+export * from "./GraphRelationResolver.d.mts";
+export * from "./GraphExecutionPlanner.d.mts";
+export * from "./GraphTopology.d.mts";

package/lib/types/graph/registry/GraphNodeExecutorRegistry.d.cts

@@ -0,0 +1,25 @@
+/**
+ * @module integrations/graph/registry/GraphNodeExecutorRegistry
+ * @summary Registry for graph node executors.
+ * @description Maps node kinds to their executor implementations. The engine resolves executors by node kind at execution time.
+ */
+import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
+/**
+ * Registry that maps node `kind` strings to {@link GraphNodeExecutor}
+ * instances.
+ */
+export declare class GraphNodeExecutorRegistry {
+    private readonly executors;
+    /** Registers an executor for the given node kind. */
+    register(kind: string, executor: GraphNodeExecutor): this;
+    /** Removes the executor for the given node kind. */
+    unregister(kind: string): this;
+    /** Returns whether an executor is registered for the given kind. */
+    has(kind: string): boolean;
+    /**
+     * Resolves the executor for the given node kind.
+     *
+     * @throws {GraphExecutionError} when no executor is registered for `kind`.
+     */
+    resolve(kind: string): GraphNodeExecutor;
+}

package/lib/types/graph/registry/GraphNodeExecutorRegistry.d.mts

@@ -0,0 +1,25 @@
+/**
+ * @module integrations/graph/registry/GraphNodeExecutorRegistry
+ * @summary Registry for graph node executors.
+ * @description Maps node kinds to their executor implementations. The engine resolves executors by node kind at execution time.
+ */
+import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
+/**
+ * Registry that maps node `kind` strings to {@link GraphNodeExecutor}
+ * instances.
+ */
+export declare class GraphNodeExecutorRegistry {
+    private readonly executors;
+    /** Registers an executor for the given node kind. */
+    register(kind: string, executor: GraphNodeExecutor): this;
+    /** Removes the executor for the given node kind. */
+    unregister(kind: string): this;
+    /** Returns whether an executor is registered for the given kind. */
+    has(kind: string): boolean;
+    /**
+     * Resolves the executor for the given node kind.
+     *
+     * @throws {GraphExecutionError} when no executor is registered for `kind`.
+     */
+    resolve(kind: string): GraphNodeExecutor;
+}

package/lib/types/graph/registry/GraphNodeExecutorResolver.d.cts

@@ -0,0 +1,21 @@
+/**
+ * @module integrations/graph/registry/GraphNodeExecutorResolver
+ * @summary Utility for resolving executors from a registry with fallback.
+ * @description Provides a helper that attempts to resolve an executor by kind, falling back to a default executor when the kind is not registered.
+ */
+import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
+import type { GraphNodeExecutorRegistry } from "./GraphNodeExecutorRegistry.d.cts";
+/**
+ * Resolver that wraps a {@link GraphNodeExecutorRegistry} and optionally
+ * falls back to a default executor when a kind is not found.
+ */
+export declare class GraphNodeExecutorResolver {
+    private readonly registry;
+    private readonly defaultExecutor?;
+    constructor(registry: GraphNodeExecutorRegistry, defaultExecutor?: GraphNodeExecutor);
+    /**
+     * Resolves the executor for `kind`, falling back to the default executor
+     * when provided.
+     */
+    resolve(kind: string): GraphNodeExecutor;
+}

package/lib/types/graph/registry/GraphNodeExecutorResolver.d.mts

@@ -0,0 +1,21 @@
+/**
+ * @module integrations/graph/registry/GraphNodeExecutorResolver
+ * @summary Utility for resolving executors from a registry with fallback.
+ * @description Provides a helper that attempts to resolve an executor by kind, falling back to a default executor when the kind is not registered.
+ */
+import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
+import type { GraphNodeExecutorRegistry } from "./GraphNodeExecutorRegistry.d.mts";
+/**
+ * Resolver that wraps a {@link GraphNodeExecutorRegistry} and optionally
+ * falls back to a default executor when a kind is not found.
+ */
+export declare class GraphNodeExecutorResolver {
+    private readonly registry;
+    private readonly defaultExecutor?;
+    constructor(registry: GraphNodeExecutorRegistry, defaultExecutor?: GraphNodeExecutor);
+    /**
+     * Resolves the executor for `kind`, falling back to the default executor
+     * when provided.
+     */
+    resolve(kind: string): GraphNodeExecutor;
+}

package/lib/types/graph/registry/index.d.cts

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/graph/registry
+ * @summary Graph node executor registry and resolver.
+ * @description Re-exports the executor registry and resolver.
+ */
+export * from "./GraphNodeExecutorRegistry.d.cts";
+export * from "./GraphNodeExecutorResolver.d.cts";

package/lib/types/graph/registry/index.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/graph/registry
+ * @summary Graph node executor registry and resolver.
+ * @description Re-exports the executor registry and resolver.
+ */
+export * from "./GraphNodeExecutorRegistry.d.mts";
+export * from "./GraphNodeExecutorResolver.d.mts";

package/lib/types/graph/snapshots/GraphExecutionSnapshotMapper.d.cts

@@ -0,0 +1,10 @@
+import type { GraphExecutionResult, GraphExecutionSnapshotPatch } from "../types.d.cts";
+/**
+ * Maps a {@link GraphExecutionResult} to a {@link GraphExecutionSnapshotPatch}.
+ */
+export declare class GraphExecutionSnapshotMapper {
+    /**
+     * Creates a snapshot patch from an execution result.
+     */
+    map(result: GraphExecutionResult): GraphExecutionSnapshotPatch;
+}

package/lib/types/graph/snapshots/GraphExecutionSnapshotMapper.d.mts

@@ -0,0 +1,10 @@
+import type { GraphExecutionResult, GraphExecutionSnapshotPatch } from "../types.d.mts";
+/**
+ * Maps a {@link GraphExecutionResult} to a {@link GraphExecutionSnapshotPatch}.
+ */
+export declare class GraphExecutionSnapshotMapper {
+    /**
+     * Creates a snapshot patch from an execution result.
+     */
+    map(result: GraphExecutionResult): GraphExecutionSnapshotPatch;
+}

package/lib/types/graph/snapshots/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/graph/snapshots
+ * @summary Graph execution snapshot mapping.
+ * @description Re-exports the snapshot patch mapper.
+ */
+export * from "./GraphExecutionSnapshotMapper.d.cts";

package/lib/types/graph/snapshots/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/graph/snapshots
+ * @summary Graph execution snapshot mapping.
+ * @description Re-exports the snapshot patch mapper.
+ */
+export * from "./GraphExecutionSnapshotMapper.d.mts";

package/lib/types/graph/store/GraphCachedValue.d.cts

@@ -0,0 +1,20 @@
+/**
+ * @module integrations/graph/store/GraphCachedValue
+ * @summary A cached graph value with pinning metadata.
+ * @description Represents a node's output that has been cached (and optionally pinned) in the value store.
+ */
+import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphValueKey } from "./GraphValueKey.d.cts";
+/**
+ * A value stored in the cache, including the outputs, pinning state, and
+ * timestamps for TTL-based expiry.
+ */
+export interface GraphCachedValue {
+    key: GraphValueKey;
+    outputs: GraphExecutionValues;
+    pinned: boolean;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string;
+    metadata?: Record<string, unknown>;
+}

package/lib/types/graph/store/GraphCachedValue.d.mts

@@ -0,0 +1,20 @@
+/**
+ * @module integrations/graph/store/GraphCachedValue
+ * @summary A cached graph value with pinning metadata.
+ * @description Represents a node's output that has been cached (and optionally pinned) in the value store.
+ */
+import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphValueKey } from "./GraphValueKey.d.mts";
+/**
+ * A value stored in the cache, including the outputs, pinning state, and
+ * timestamps for TTL-based expiry.
+ */
+export interface GraphCachedValue {
+    key: GraphValueKey;
+    outputs: GraphExecutionValues;
+    pinned: boolean;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string;
+    metadata?: Record<string, unknown>;
+}

package/lib/types/graph/store/GraphValueKey.d.cts

@@ -0,0 +1,18 @@
+/**
+ * @module integrations/graph/store/GraphValueKey
+ * @summary Stable key for cached graph values.
+ * @description Identifies a cached value in the store by workflow, node, fingerprint, and optional namespace/version.
+ */
+/**
+ * Key used to read/write cached values in a {@link GraphValueStoreAdapter}.
+ *
+ * The `fingerprint` must change when meaningful inputs or dependencies change
+ * so stale values are never accidentally reused.
+ */
+export interface GraphValueKey {
+    workflowId: string;
+    nodeId: string;
+    fingerprint: string;
+    namespace?: string;
+    version?: string;
+}

package/lib/types/graph/store/GraphValueKey.d.mts

@@ -0,0 +1,18 @@
+/**
+ * @module integrations/graph/store/GraphValueKey
+ * @summary Stable key for cached graph values.
+ * @description Identifies a cached value in the store by workflow, node, fingerprint, and optional namespace/version.
+ */
+/**
+ * Key used to read/write cached values in a {@link GraphValueStoreAdapter}.
+ *
+ * The `fingerprint` must change when meaningful inputs or dependencies change
+ * so stale values are never accidentally reused.
+ */
+export interface GraphValueKey {
+    workflowId: string;
+    nodeId: string;
+    fingerprint: string;
+    namespace?: string;
+    version?: string;
+}

package/lib/types/graph/store/GraphValueStore.d.cts

@@ -0,0 +1,41 @@
+import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphValueStoreAdapter } from "./GraphValueStoreAdapter.d.cts";
+import type { GraphValueKey } from "./GraphValueKey.d.cts";
+import type { GraphCachedValue } from "./GraphCachedValue.d.cts";
+/**
+ * Manages values during a single graph execution.
+ *
+ * Runtime values (workflow inputs, node outputs, workflow outputs) are kept in
+ * an in-memory map. Persistent cache and pinning operations are delegated to
+ * the configured {@link GraphValueStoreAdapter}.
+ */
+export declare class GraphValueStore {
+    private readonly adapter;
+    private readonly runtimeValues;
+    /**
+     * @param adapter - The persistent adapter for cached/pinned values.
+     */
+    constructor(adapter: GraphValueStoreAdapter);
+    /** Seeds the workflow input values. */
+    seedWorkflowInputs(inputs: GraphExecutionValues): void;
+    /** Stores the outputs produced by a node. */
+    setNodeOutputs(nodeId: string, outputs: GraphExecutionValues): void;
+    /** Reads a single port value from a node's stored outputs. */
+    getPort(nodeId: string, port: string): unknown;
+    /** Returns whether a node has a value for the given port. */
+    hasPort(nodeId: string, port: string): boolean;
+    /** Sets a single workflow output port value. */
+    setWorkflowOutput(port: string, value: unknown): void;
+    /** Returns all workflow-level values (inputs merged with outputs). */
+    getWorkflowValues(): GraphExecutionValues;
+    /** Reads a cached value from the adapter. */
+    readCached(key: GraphValueKey): Promise<GraphCachedValue | undefined>;
+    /** Writes a cached value through the adapter. */
+    writeCached(key: GraphValueKey, value: GraphCachedValue): Promise<void>;
+    /** Deletes a cached value through the adapter. */
+    deleteCached(key: GraphValueKey): Promise<void>;
+    /** Returns a snapshot of all runtime values. */
+    snapshot(): Record<string, GraphExecutionValues>;
+    /** Returns the underlying adapter (used by the pinning service). */
+    getAdapter(): GraphValueStoreAdapter;
+}

package/lib/types/graph/store/GraphValueStore.d.mts

@@ -0,0 +1,41 @@
+import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphValueStoreAdapter } from "./GraphValueStoreAdapter.d.mts";
+import type { GraphValueKey } from "./GraphValueKey.d.mts";
+import type { GraphCachedValue } from "./GraphCachedValue.d.mts";
+/**
+ * Manages values during a single graph execution.
+ *
+ * Runtime values (workflow inputs, node outputs, workflow outputs) are kept in
+ * an in-memory map. Persistent cache and pinning operations are delegated to
+ * the configured {@link GraphValueStoreAdapter}.
+ */
+export declare class GraphValueStore {
+    private readonly adapter;
+    private readonly runtimeValues;
+    /**
+     * @param adapter - The persistent adapter for cached/pinned values.
+     */
+    constructor(adapter: GraphValueStoreAdapter);
+    /** Seeds the workflow input values. */
+    seedWorkflowInputs(inputs: GraphExecutionValues): void;
+    /** Stores the outputs produced by a node. */
+    setNodeOutputs(nodeId: string, outputs: GraphExecutionValues): void;
+    /** Reads a single port value from a node's stored outputs. */
+    getPort(nodeId: string, port: string): unknown;
+    /** Returns whether a node has a value for the given port. */
+    hasPort(nodeId: string, port: string): boolean;
+    /** Sets a single workflow output port value. */
+    setWorkflowOutput(port: string, value: unknown): void;
+    /** Returns all workflow-level values (inputs merged with outputs). */
+    getWorkflowValues(): GraphExecutionValues;
+    /** Reads a cached value from the adapter. */
+    readCached(key: GraphValueKey): Promise<GraphCachedValue | undefined>;
+    /** Writes a cached value through the adapter. */
+    writeCached(key: GraphValueKey, value: GraphCachedValue): Promise<void>;
+    /** Deletes a cached value through the adapter. */
+    deleteCached(key: GraphValueKey): Promise<void>;
+    /** Returns a snapshot of all runtime values. */
+    snapshot(): Record<string, GraphExecutionValues>;
+    /** Returns the underlying adapter (used by the pinning service). */
+    getAdapter(): GraphValueStoreAdapter;
+}

package/lib/types/graph/store/GraphValueStoreAdapter.d.cts

@@ -0,0 +1,32 @@
+/**
+ * @module integrations/graph/store/GraphValueStoreAdapter
+ * @summary Adapter interface for persistent graph value storage.
+ * @description Users provide implementations of this interface to control where cached/pinned values live (in-memory, database, Redis, file, etc.).
+ */
+import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphValueKey } from "./GraphValueKey.d.cts";
+import type { GraphCachedValue } from "./GraphCachedValue.d.cts";
+/**
+ * Adapter that persists cached and pinned graph values.
+ *
+ * The engine never assumes a specific storage backend; it always delegates to
+ * an adapter. The {@link InMemoryGraphValueStoreAdapter} is the default.
+ */
+export interface GraphValueStoreAdapter {
+    /** Reads a cached value for the given key. */
+    read(key: GraphValueKey): Promise<GraphCachedValue | undefined>;
+    /** Writes a cached value for the given key. */
+    write(key: GraphValueKey, value: GraphCachedValue): Promise<void>;
+    /** Deletes a cached value for the given key. */
+    delete(key: GraphValueKey): Promise<void>;
+    /** Returns whether a cached value exists for the given key. */
+    has(key: GraphValueKey): Promise<boolean>;
+    /** Lists cached values matching a prefix of the key. */
+    list?(prefix: Partial<GraphValueKey>): Promise<GraphCachedValue[]>;
+    /** Clears all cached values for a run. */
+    clearRun?(runId: string): Promise<void>;
+    /** Reads the runtime values for a node in a run. */
+    readRuntimeValues?(runId: string, nodeId: string): Promise<GraphExecutionValues | undefined>;
+    /** Writes the runtime values for a node in a run. */
+    writeRuntimeValues?(runId: string, nodeId: string, values: GraphExecutionValues): Promise<void>;
+}

package/lib/types/graph/store/GraphValueStoreAdapter.d.mts

@@ -0,0 +1,32 @@
+/**
+ * @module integrations/graph/store/GraphValueStoreAdapter
+ * @summary Adapter interface for persistent graph value storage.
+ * @description Users provide implementations of this interface to control where cached/pinned values live (in-memory, database, Redis, file, etc.).
+ */
+import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphValueKey } from "./GraphValueKey.d.mts";
+import type { GraphCachedValue } from "./GraphCachedValue.d.mts";
+/**
+ * Adapter that persists cached and pinned graph values.
+ *
+ * The engine never assumes a specific storage backend; it always delegates to
+ * an adapter. The {@link InMemoryGraphValueStoreAdapter} is the default.
+ */
+export interface GraphValueStoreAdapter {
+    /** Reads a cached value for the given key. */
+    read(key: GraphValueKey): Promise<GraphCachedValue | undefined>;
+    /** Writes a cached value for the given key. */
+    write(key: GraphValueKey, value: GraphCachedValue): Promise<void>;
+    /** Deletes a cached value for the given key. */
+    delete(key: GraphValueKey): Promise<void>;
+    /** Returns whether a cached value exists for the given key. */
+    has(key: GraphValueKey): Promise<boolean>;
+    /** Lists cached values matching a prefix of the key. */
+    list?(prefix: Partial<GraphValueKey>): Promise<GraphCachedValue[]>;
+    /** Clears all cached values for a run. */
+    clearRun?(runId: string): Promise<void>;
+    /** Reads the runtime values for a node in a run. */
+    readRuntimeValues?(runId: string, nodeId: string): Promise<GraphExecutionValues | undefined>;
+    /** Writes the runtime values for a node in a run. */
+    writeRuntimeValues?(runId: string, nodeId: string, values: GraphExecutionValues): Promise<void>;
+}

package/lib/types/graph/store/InMemoryGraphValueStoreAdapter.d.cts

@@ -0,0 +1,33 @@
+/**
+ * @module integrations/graph/store/InMemoryGraphValueStoreAdapter
+ * @summary Default in-memory value store adapter.
+ * @description Stores all cached values in a Map. Suitable for testing and single-process execution.
+ */
+import type { GraphValueStoreAdapter } from "./GraphValueStoreAdapter.d.cts";
+import type { GraphValueKey } from "./GraphValueKey.d.cts";
+import type { GraphCachedValue } from "./GraphCachedValue.d.cts";
+/**
+ * In-memory implementation of {@link GraphValueStoreAdapter}.
+ *
+ * Values are keyed by a serialized string combining namespace, workflowId,
+ * nodeId, version, and fingerprint.
+ */
+export declare class InMemoryGraphValueStoreAdapter implements GraphValueStoreAdapter {
+    private readonly values;
+    /** @inheritDoc */
+    read(key: GraphValueKey): Promise<GraphCachedValue | undefined>;
+    /** @inheritDoc */
+    write(key: GraphValueKey, value: GraphCachedValue): Promise<void>;
+    /** @inheritDoc */
+    delete(key: GraphValueKey): Promise<void>;
+    /** @inheritDoc */
+    has(key: GraphValueKey): Promise<boolean>;
+    /** @inheritDoc */
+    list(prefix: Partial<GraphValueKey>): Promise<GraphCachedValue[]>;
+    /** @inheritDoc */
+    clearRun(runId: string): Promise<void>;
+    /**
+     * Serializes a key into a stable string used as the Map key.
+     */
+    private serializeKey;
+}

package/lib/types/graph/store/InMemoryGraphValueStoreAdapter.d.mts

@@ -0,0 +1,33 @@
+/**
+ * @module integrations/graph/store/InMemoryGraphValueStoreAdapter
+ * @summary Default in-memory value store adapter.
+ * @description Stores all cached values in a Map. Suitable for testing and single-process execution.
+ */
+import type { GraphValueStoreAdapter } from "./GraphValueStoreAdapter.d.mts";
+import type { GraphValueKey } from "./GraphValueKey.d.mts";
+import type { GraphCachedValue } from "./GraphCachedValue.d.mts";
+/**
+ * In-memory implementation of {@link GraphValueStoreAdapter}.
+ *
+ * Values are keyed by a serialized string combining namespace, workflowId,
+ * nodeId, version, and fingerprint.
+ */
+export declare class InMemoryGraphValueStoreAdapter implements GraphValueStoreAdapter {
+    private readonly values;
+    /** @inheritDoc */
+    read(key: GraphValueKey): Promise<GraphCachedValue | undefined>;
+    /** @inheritDoc */
+    write(key: GraphValueKey, value: GraphCachedValue): Promise<void>;
+    /** @inheritDoc */
+    delete(key: GraphValueKey): Promise<void>;
+    /** @inheritDoc */
+    has(key: GraphValueKey): Promise<boolean>;
+    /** @inheritDoc */
+    list(prefix: Partial<GraphValueKey>): Promise<GraphCachedValue[]>;
+    /** @inheritDoc */
+    clearRun(runId: string): Promise<void>;
+    /**
+     * Serializes a key into a stable string used as the Map key.
+     */
+    private serializeKey;
+}

package/lib/types/graph/store/index.d.cts

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/graph/store
+ * @summary Graph value store, adapter, and key types.
+ * @description Re-exports the value store adapter interface, in-memory default, key/cached-value types, and the runtime store wrapper.
+ */
+export * from "./GraphValueKey.d.cts";
+export * from "./GraphCachedValue.d.cts";
+export * from "./GraphValueStoreAdapter.d.cts";
+export * from "./InMemoryGraphValueStoreAdapter.d.cts";
+export * from "./GraphValueStore.d.cts";

package/lib/types/graph/store/index.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/graph/store
+ * @summary Graph value store, adapter, and key types.
+ * @description Re-exports the value store adapter interface, in-memory default, key/cached-value types, and the runtime store wrapper.
+ */
+export * from "./GraphValueKey.d.mts";
+export * from "./GraphCachedValue.d.mts";
+export * from "./GraphValueStoreAdapter.d.mts";
+export * from "./InMemoryGraphValueStoreAdapter.d.mts";
+export * from "./GraphValueStore.d.mts";