@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/define-persistence.js

@@ -0,0 +1,112 @@
+/** Creates native persistence descriptors around authored checkpointers and stores; runtime acquisition and release remain owned by the invocation scope. */
+import { normalizeId } from "@relkit/contracts";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { RELKIT_PERSISTENCE } from "./persistence-symbol.js";
+import { agentPersistenceFailure } from "./persistence-error.js";
+export { assertPersistenceProtocol, assertPersistenceProtocolEffect, isPersistenceResource, isPersistenceResourceEffect, } from "./define-persistence-guards.js";
+/** Defines a lazily acquired checkpointer resource.
+ * @param options - Identity, client factory, ownership, and disposal policy.
+ * @returns An Effect with a resource descriptor or AgentPersistenceFailure.
+ * @example Effect.runSync(defineCheckpointerDbEffect({ id: "db", client: saver }));
+ */
+export const defineCheckpointerDbEffect = Effect.fn("Agents.persistence.defineCheckpointer")((options) => Effect.try({
+    try: () => buildAgentStorageResource("checkpointer", options),
+    catch: agentPersistenceFailure,
+}), (effect) => observeAgent("persistence.define-checkpointer", effect));
+/** Defines a checkpointer for existing synchronous authoring callers.
+ * @param options - Identity, client factory, ownership, and disposal policy.
+ * @returns A lazily acquired resource descriptor.
+ * @throws The original invalid options error.
+ * @example const resource = defineCheckpointerDb({ id: "db", client: saver });
+ */
+export function defineCheckpointerDb(options) {
+    return Effect.runSync(defineCheckpointerDbEffect(options).pipe(Effect.catchTag("AgentPersistenceFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Defines a lazily acquired memory store resource.
+ * @param options - Identity, client factory, ownership, and disposal policy.
+ * @returns An Effect with a resource descriptor or AgentPersistenceFailure.
+ * @example Effect.runSync(defineMemoryDbEffect({ id: "memory", client: store }));
+ */
+export const defineMemoryDbEffect = Effect.fn("Agents.persistence.defineMemory")((options) => Effect.try({
+    try: () => buildAgentStorageResource("memory", options),
+    catch: agentPersistenceFailure,
+}), (effect) => observeAgent("persistence.define-memory", effect));
+/** Defines a memory store for existing synchronous authoring callers.
+ * @param options - Identity, client factory, ownership, and disposal policy.
+ * @returns A lazily acquired resource descriptor.
+ * @throws The original invalid options error.
+ * @example const resource = defineMemoryDb({ id: "memory", client: store });
+ */
+export function defineMemoryDb(options) {
+    return Effect.runSync(defineMemoryDbEffect(options).pipe(Effect.catchTag("AgentPersistenceFailure", (failure) => Effect.fail(failure.cause))));
+}
+function buildAgentStorageResource(resource, options) {
+    const { id, factory, ownership } = validateAgentStorageOptions(resource, options);
+    let active;
+    let released = false;
+    const descriptor = {
+        [RELKIT_PERSISTENCE]: true,
+        kind: "agent-persistence",
+        resource,
+        id,
+        ownership,
+    };
+    Object.defineProperties(descriptor, {
+        acquire: {
+            enumerable: false,
+            value: (context) => {
+                if (released)
+                    return Promise.reject(new Error(`${resource} resource "${id}" is released`));
+                if (active !== undefined)
+                    return active;
+                let created;
+                try {
+                    created = factory
+                        ? Promise.resolve(options.client(context))
+                        : Promise.resolve(options.client);
+                }
+                catch (error) {
+                    created = Promise.reject(error);
+                }
+                active = created.catch((error) => {
+                    active = undefined;
+                    throw error;
+                });
+                return active;
+            },
+        },
+        release: {
+            enumerable: false,
+            value: async () => {
+                if (released)
+                    return;
+                released = true;
+                if (ownership !== "owned" || active === undefined)
+                    return;
+                await options.dispose(await active);
+            },
+        },
+    });
+    return Object.freeze(descriptor);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Validates storage ownership before allocating lazy acquisition state.
+ * @param resource - Checkpointer or memory resource family.
+ * @param options - Authored client, ownership and disposal policy.
+ * @returns Normalized identity and resource ownership.
+ */
+function validateAgentStorageOptions(resource, options) {
+    if (!isRecord(options))
+        throw new TypeError("Persistence options must be an object");
+    const id = normalizeId(options.id);
+    const factory = typeof options.client === "function";
+    const ownership = options.ownership ?? (factory ? "owned" : "borrowed");
+    if (ownership === "owned" && typeof options.dispose !== "function") {
+        throw new TypeError(`Owned ${resource} resource requires dispose`);
+    }
+    return { id, factory, ownership };
+}
+//# sourceMappingURL=define-persistence.js.map

package/dist/define-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-persistence.js","sourceRoot":"","sources":["../src/define-persistence.ts"],"names":[],"mappings":"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"}

package/dist/define-persistence.types.d.ts

@@ -0,0 +1,30 @@
+/** Creates native persistence descriptors around authored checkpointers and stores; runtime acquisition and release remain owned by the invocation scope. This companion preserves the native input and output types without starting runtime work. */
+import type { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph";
+import type { MaybePromise } from "@relkit/contracts";
+import type { RELKIT_PERSISTENCE } from "./persistence-symbol.js";
+/** Environment made available while acquiring persistence. */
+export interface PersistenceContext {
+    readonly env: Readonly<Record<string, unknown>>;
+}
+/** Lazily acquired, explicitly released persistence descriptor. */
+export interface PersistenceResource<Kind extends "checkpointer" | "memory", Value> {
+    readonly [RELKIT_PERSISTENCE]: true;
+    readonly kind: "agent-persistence";
+    readonly resource: Kind;
+    readonly id: string;
+    readonly ownership: "owned" | "borrowed";
+    readonly acquire: (context: PersistenceContext) => Promise<Value>;
+    readonly release: () => Promise<void>;
+}
+/** Checkpointer resource passed to a LangGraph runtime. */
+export type CheckpointerResource<Value extends BaseCheckpointSaver = BaseCheckpointSaver> = PersistenceResource<"checkpointer", Value>;
+/** Memory store resource passed to a LangGraph runtime. */
+export type MemoryResource<Value extends BaseStore = BaseStore> = PersistenceResource<"memory", Value>;
+/** Acquisition and disposal configuration for an agent persistence resource. */
+export interface PersistenceOptions<Value> {
+    readonly id: string;
+    readonly client: Value | ((context: PersistenceContext) => MaybePromise<Value>);
+    readonly ownership?: "owned" | "borrowed";
+    readonly dispose?: (value: Value) => MaybePromise<void>;
+}
+//# sourceMappingURL=define-persistence.types.d.ts.map

package/dist/define-persistence.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-persistence.types.d.ts","sourceRoot":"","sources":["../src/define-persistence.types.ts"],"names":[],"mappings":"AAAA,uPAAuP;AAEvP,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjD;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,cAAc,GAAG,QAAQ,EAAE,KAAK;IAChF,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,mBAAmB,GAAG,mBAAmB,IACtF,mBAAmB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AAC7C,2DAA2D;AAC3D,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,mBAAmB,CACnF,QAAQ,EACR,KAAK,CACN,CAAC;AAEF,gFAAgF;AAChF,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,OAAO,EAAE,kBAAkB,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;CACzD"}

package/dist/define-persistence.types.js

@@ -0,0 +1,3 @@
+/** Creates native persistence descriptors around authored checkpointers and stores; runtime acquisition and release remain owned by the invocation scope. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=define-persistence.types.js.map

package/dist/define-persistence.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-persistence.types.js","sourceRoot":"","sources":["../src/define-persistence.types.ts"],"names":[],"mappings":"AAAA,uPAAuP"}

package/dist/graph-compile-error.d.ts

@@ -0,0 +1,17 @@
+/** Defines typed failures for native graph compilation, preserving the graph identity and underlying native compile cause. */
+import { Schema } from "effect";
+declare const GraphCompilationFailure_base: Schema.Class<GraphCompilationFailure, Schema.TaggedStruct<"GraphCompilationFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** Tagged graph compilation or route execution failure. */
+export declare class GraphCompilationFailure extends GraphCompilationFailure_base {
+}
+/** Preserves a graph compilation or route error for Effect callers.
+ * @param cause - LangGraph, route, or validation failure.
+ * @returns A tagged graph compilation failure.
+ * @example graphCompilationFailure(new TypeError("invalid route"));
+ */
+export declare function graphCompilationFailure(cause: unknown): GraphCompilationFailure;
+export {};
+//# sourceMappingURL=graph-compile-error.d.ts.map

package/dist/graph-compile-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-compile-error.d.ts","sourceRoot":"","sources":["../src/graph-compile-error.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAE9H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,2DAA2D;AAC3D,qBAAa,uBAAwB,SAAQ,4BAG5C;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAK/E"}

package/dist/graph-compile-error.js

@@ -0,0 +1,17 @@
+/** Defines typed failures for native graph compilation, preserving the graph identity and underlying native compile cause. */
+import { Schema } from "effect";
+/** Tagged graph compilation or route execution failure. */
+export class GraphCompilationFailure extends Schema.TaggedError()("GraphCompilationFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Preserves a graph compilation or route error for Effect callers.
+ * @param cause - LangGraph, route, or validation failure.
+ * @returns A tagged graph compilation failure.
+ * @example graphCompilationFailure(new TypeError("invalid route"));
+ */
+export function graphCompilationFailure(cause) {
+    return new GraphCompilationFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=graph-compile-error.js.map

package/dist/graph-compile-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-compile-error.js","sourceRoot":"","sources":["../src/graph-compile-error.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAE9H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,2DAA2D;AAC3D,MAAM,OAAO,uBAAwB,SAAQ,MAAM,CAAC,WAAW,EAA2B,CACxF,yBAAyB,EACzB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,IAAI,uBAAuB,CAAC;QACjC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/graph-compile.d.ts

@@ -0,0 +1,32 @@
+/** Compiles validated RELKIT graph descriptors into LangGraph execution objects using the authored nodes, edges, state and persistence options. */
+import { type LangGraphRunnableConfig } from "@langchain/langgraph";
+import type { MaybePromise } from "@relkit/contracts";
+import { Effect } from "effect";
+import { type GraphDescriptor, type GraphNodeLike } from "./define-graph.js";
+import type { ResolvedGraphPersistence } from "./graph-persistence.js";
+/** Runs a user route and validates its destination with linked cancellation.
+ * @param route - User conditional route.
+ * @param state - Current graph state.
+ * @param config - LangGraph configuration.
+ * @param nodeIds - Valid node identities.
+ * @param destinations - Optional route label map.
+ * @returns An Effect with a destination or GraphCompilationFailure.
+ * @example await Effect.runPromise(runGraphRouteEffect(route, state, config, ids));
+ */
+export declare const runGraphRouteEffect: <Id extends string>(route: (state: unknown, config: LangGraphRunnableConfig) => MaybePromise<unknown>, state: unknown, config: LangGraphRunnableConfig<Record<string, any>>, nodeIds: ReadonlySet<Id>, destinations?: Readonly<Record<string, "__end__" | Id>> | undefined) => Effect.Effect<unknown, import("./graph-compile-error.js").GraphCompilationFailure, never>;
+/** Compiles a graph descriptor and its resolved persistence resources.
+ * @param descriptor - Authored graph descriptor.
+ * @param persistence - Resolved checkpointer and store.
+ * @returns An Effect with a LangGraph runnable or GraphCompilationFailure.
+ * @example Effect.runSync(compileGraphEffect(graph));
+ */
+export declare const compileGraphEffect: (descriptor: GraphDescriptor<string, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@langchain/langgraph").AnyStateSchema, readonly GraphNodeLike[]>, persistence?: ResolvedGraphPersistence | undefined) => Effect.Effect<any, import("./graph-compile-error.js").GraphCompilationFailure, never>;
+/** Compiles a graph for existing synchronous runtime callers.
+ * @param descriptor - Authored graph descriptor.
+ * @param persistence - Resolved checkpointer and store.
+ * @returns A LangGraph runnable.
+ * @throws The original compilation error.
+ * @example const runnable = compileGraph(graph);
+ */
+export declare function compileGraph(descriptor: GraphDescriptor, persistence?: ResolvedGraphPersistence): any;
+//# sourceMappingURL=graph-compile.d.ts.map

package/dist/graph-compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-compile.d.ts","sourceRoot":"","sources":["../src/graph-compile.ts"],"names":[],"mappings":"AAAA,mJAAmJ;AAEnJ,OAAO,EAAc,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAK7F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GACnB,EAAE,SAAS,MAAM,iBACX,OAAO,UAAU,uBAAuB,KAAK,YAAY,CAAC,OAAO,CAAC,mQA0BpF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,uXA0C9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,eAAe,EAC3B,WAAW,GAAE,wBAA6B,OAO3C"}

package/dist/graph-compile.js

@@ -0,0 +1,94 @@
+/** Compiles validated RELKIT graph descriptors into LangGraph execution objects using the authored nodes, edges, state and persistence options. */
+import { StateGraph } from "@langchain/langgraph";
+import { isFunctionGraphNode } from "@relkit/functions";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { graphCompilationFailure } from "./graph-compile-error.js";
+import { graphExecution } from "./define-graph.js";
+import { isGraphNodeDescriptor } from "./define-graph-node.js";
+import { validateGraphRoute } from "./graph-edges.js";
+import { selectGraphState } from "./graph-state-schema.js";
+import { isSubgraphNode, subgraphForNode } from "./graph-subgraph.js";
+/** Runs a user route and validates its destination with linked cancellation.
+ * @param route - User conditional route.
+ * @param state - Current graph state.
+ * @param config - LangGraph configuration.
+ * @param nodeIds - Valid node identities.
+ * @param destinations - Optional route label map.
+ * @returns An Effect with a destination or GraphCompilationFailure.
+ * @example await Effect.runPromise(runGraphRouteEffect(route, state, config, ids));
+ */
+export const runGraphRouteEffect = Effect.fn("Agents.graph.route")(function* (route, state, config, nodeIds, destinations) {
+    const destination = yield* Effect.tryPromise({
+        try: (effectSignal) => Promise.resolve(route(state, {
+            ...config,
+            signal: config.signal === undefined
+                ? effectSignal
+                : AbortSignal.any([config.signal, effectSignal]),
+        })),
+        catch: graphCompilationFailure,
+    });
+    yield* Effect.try({
+        try: () => validateGraphRoute(destination, nodeIds, destinations),
+        catch: graphCompilationFailure,
+    });
+    return destination;
+}, (effect) => observeAgent("graph.route", effect));
+/** Compiles a graph descriptor and its resolved persistence resources.
+ * @param descriptor - Authored graph descriptor.
+ * @param persistence - Resolved checkpointer and store.
+ * @returns An Effect with a LangGraph runnable or GraphCompilationFailure.
+ * @example Effect.runSync(compileGraphEffect(graph));
+ */
+export const compileGraphEffect = Effect.fn("Agents.graph.compile")((descriptor, persistence = {}) => Effect.try({
+    try: () => {
+        const execution = graphExecution(descriptor);
+        const native = new StateGraph({
+            state: execution.state,
+            input: selectGraphState(execution.state, descriptor.input),
+            output: selectGraphState(execution.state, descriptor.output),
+        });
+        const ids = new Set(descriptor.nodes.map((node) => node.id));
+        for (const node of descriptor.nodes) {
+            native.addNode(node.id, nodeAction(node), {
+                ...((isGraphNodeDescriptor(node) || isSubgraphNode(node)) && node.ends.length > 0
+                    ? { ends: node.ends }
+                    : {}),
+            });
+        }
+        for (const edge of execution.operations) {
+            if (edge.kind === "edge") {
+                native.addEdge(edge.start, edge.end);
+                continue;
+            }
+            const route = (state, config) => Effect.runPromise(runGraphRouteEffect(edge.route, state, config, ids, edge.destinations).pipe(Effect.catchTag("GraphCompilationFailure", (failure) => Effect.fail(failure.cause))));
+            native.addConditionalEdges(edge.source, route, edge.destinations);
+        }
+        return native.compile({
+            name: descriptor.id,
+            ...(persistence.checkpointer === undefined
+                ? {}
+                : { checkpointer: persistence.checkpointer }),
+            ...(persistence.store === undefined ? {} : { store: persistence.store }),
+        });
+    },
+    catch: graphCompilationFailure,
+}), (effect) => observeAgent("graph.compile", effect));
+/** Compiles a graph for existing synchronous runtime callers.
+ * @param descriptor - Authored graph descriptor.
+ * @param persistence - Resolved checkpointer and store.
+ * @returns A LangGraph runnable.
+ * @throws The original compilation error.
+ * @example const runnable = compileGraph(graph);
+ */
+export function compileGraph(descriptor, persistence = {}) {
+    return Effect.runSync(compileGraphEffect(descriptor, persistence).pipe(Effect.catchTag("GraphCompilationFailure", (failure) => Effect.fail(failure.cause))));
+}
+function nodeAction(node) {
+    if (isSubgraphNode(node))
+        return compileGraph(subgraphForNode(node));
+    return isFunctionGraphNode(node)
+        ? (state) => node.invoke(state)
+        : (state, config) => node.handler(state, config);
+}
+//# sourceMappingURL=graph-compile.js.map

package/dist/graph-compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-compile.js","sourceRoot":"","sources":["../src/graph-compile.ts"],"names":[],"mappings":"AAAA,mJAAmJ;AAEnJ,OAAO,EAAE,UAAU,EAAgC,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,cAAc,EAA4C,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAChE,QAAQ,CAAC,EACP,KAAiF,EACjF,KAAc,EACd,MAA+B,EAC/B,OAAwB,EACxB,YAAuD;IAEvD,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QAC3C,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE,CACpB,OAAO,CAAC,OAAO,CACb,KAAK,CAAC,KAAK,EAAE;YACX,GAAG,MAAM;YACT,MAAM,EACJ,MAAM,CAAC,MAAM,KAAK,SAAS;gBACzB,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;SACrD,CAAC,CACH;QACH,KAAK,EAAE,uBAAuB;KAC/B,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,EAAE,YAAY,CAAC;QACjE,KAAK,EAAE,uBAAuB;KAC/B,CAAC,CAAC;IACH,OAAO,WAAW,CAAC;AACrB,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAChD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,sBAAsB,CAAC,CACjE,CAAC,UAA2B,EAAE,cAAwC,EAAE,EAAE,EAAE,CAC1E,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE;QACR,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;YAC5B,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC;YAC1D,MAAM,EAAE,gBAAgB,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC;SAC7D,CAAQ,CAAC;QACV,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;gBACxC,GAAG,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;oBAC/E,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;oBACrB,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrC,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,MAA+B,EAAE,EAAE,CAChE,MAAM,CAAC,UAAU,CACf,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CACzE,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpF,CACF,CAAC;YACJ,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;YACpB,IAAI,EAAE,UAAU,CAAC,EAAE;YACnB,GAAG,CAAC,WAAW,CAAC,YAAY,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,YAAY,EAAE,CAAC;YAC/C,GAAG,CAAC,WAAW,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC;SACzE,CAAC,CAAC;IACL,CAAC;IACD,KAAK,EAAE,uBAAuB;CAC/B,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAClD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA2B,EAC3B,cAAwC,EAAE;IAE1C,OAAO,MAAM,CAAC,OAAO,CACnB,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,IAAI,CAC9C,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpF,CACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAmB;IACrC,IAAI,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,CAAC,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAc,CAAC;QACjD,CAAC,CAAC,CAAC,KAAc,EAAE,MAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAc,EAAE,MAAe,CAAC,CAAC;AACzF,CAAC"}

package/dist/graph-continuation-error.d.ts

@@ -0,0 +1,17 @@
+/** Defines continuation failures for persisted native graphs so invalid or unavailable resume state remains distinct from invocation failures. */
+import { Schema } from "effect";
+declare const GraphContinuationFailure_base: Schema.Class<GraphContinuationFailure, Schema.TaggedStruct<"GraphContinuationFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** Tagged validation or state failure while resuming a graph. */
+export declare class GraphContinuationFailure extends GraphContinuationFailure_base {
+}
+/** Preserves the original graph continuation error.
+ * @param cause - Invalid continuation or graph provider failure.
+ * @returns A tagged continuation failure.
+ * @example graphContinuationFailure(new TypeError("invalid reply"));
+ */
+export declare function graphContinuationFailure(cause: unknown): GraphContinuationFailure;
+export {};
+//# sourceMappingURL=graph-continuation-error.d.ts.map

package/dist/graph-continuation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-continuation-error.d.ts","sourceRoot":"","sources":["../src/graph-continuation-error.ts"],"names":[],"mappings":"AAAA,kJAAkJ;AAElJ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,iEAAiE;AACjE,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAKjF"}

package/dist/graph-continuation-error.js

@@ -0,0 +1,17 @@
+/** Defines continuation failures for persisted native graphs so invalid or unavailable resume state remains distinct from invocation failures. */
+import { Schema } from "effect";
+/** Tagged validation or state failure while resuming a graph. */
+export class GraphContinuationFailure extends Schema.TaggedError()("GraphContinuationFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Preserves the original graph continuation error.
+ * @param cause - Invalid continuation or graph provider failure.
+ * @returns A tagged continuation failure.
+ * @example graphContinuationFailure(new TypeError("invalid reply"));
+ */
+export function graphContinuationFailure(cause) {
+    return new GraphContinuationFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=graph-continuation-error.js.map

package/dist/graph-continuation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-continuation-error.js","sourceRoot":"","sources":["../src/graph-continuation-error.ts"],"names":[],"mappings":"AAAA,kJAAkJ;AAElJ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,iEAAiE;AACjE,MAAM,OAAO,wBAAyB,SAAQ,MAAM,CAAC,WAAW,EAA4B,CAC1F,0BAA0B,EAC1B,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,IAAI,wBAAwB,CAAC;QAClC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/graph-continuation-validation.d.ts

@@ -0,0 +1,22 @@
+/** Checks persisted graph continuation input and identity before native resume admission, preventing execution against a mismatched thread or graph. */
+import type { GraphDescriptor, GraphNodeLike } from "./define-graph.js";
+import type { AgentWaitingRequest } from "@relkit/agents/internal/state.types";
+import { Effect } from "effect";
+/** Validates one or more graph continuation replies with bounded concurrency.
+ * @param descriptor - Graph whose nodes own the continuation schemas.
+ * @param requests - Waiting requests in graph order.
+ * @param value - One reply or a list matching the requests.
+ * @returns An Effect with validated reply values or GraphContinuationFailure.
+ * @example Effect.runPromise(validateGraphResumeInputEffect(graph, requests, reply));
+ */
+export declare const validateGraphResumeInputEffect: (descriptor: GraphDescriptor<string, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@langchain/langgraph").AnyStateSchema, readonly GraphNodeLike[]>, requests: readonly AgentWaitingRequest[], value: unknown) => Effect.Effect<unknown, import("./graph-continuation-error.js").GraphContinuationFailure, never>;
+/** Validates graph continuation replies for existing Promise callers.
+ * @param descriptor - Graph whose nodes own the continuation schemas.
+ * @param requests - Waiting requests in graph order.
+ * @param value - One reply or a list matching the requests.
+ * @returns Validated reply values.
+ * @throws The original continuation validation error.
+ * @example await validateGraphResumeInput(graph, requests, reply);
+ */
+export declare function validateGraphResumeInput(descriptor: GraphDescriptor, requests: readonly AgentWaitingRequest[], value: unknown): Promise<unknown>;
+//# sourceMappingURL=graph-continuation-validation.d.ts.map

package/dist/graph-continuation-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-continuation-validation.d.ts","sourceRoot":"","sources":["../src/graph-continuation-validation.ts"],"names":[],"mappings":"AAAA,wJAAwJ;AAExJ,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAIxC;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,uYAsC1C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,eAAe,EAC3B,QAAQ,EAAE,SAAS,mBAAmB,EAAE,EACxC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAMlB"}

package/dist/graph-continuation-validation.js

@@ -0,0 +1,67 @@
+/** Checks persisted graph continuation input and identity before native resume admission, preventing execution against a mismatched thread or graph. */
+import { isGraphNodeDescriptor } from "./define-graph-node.js";
+import { isSubgraphNode, subgraphForNode } from "./graph-subgraph.js";
+import { validateValue } from "./runtime-utils.js";
+import { Effect, Result } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { graphContinuationFailure } from "./graph-continuation-error.js";
+/** Validates one or more graph continuation replies with bounded concurrency.
+ * @param descriptor - Graph whose nodes own the continuation schemas.
+ * @param requests - Waiting requests in graph order.
+ * @param value - One reply or a list matching the requests.
+ * @returns An Effect with validated reply values or GraphContinuationFailure.
+ * @example Effect.runPromise(validateGraphResumeInputEffect(graph, requests, reply));
+ */
+export const validateGraphResumeInputEffect = Effect.fn("Agents.graph.validateResume")(function* (descriptor, requests, value) {
+    yield* Effect.try({
+        try: () => {
+            if (requests.length === 0)
+                throw new TypeError("Graph has no waiting continuation");
+            if (requests.length > 1 && (!Array.isArray(value) || value.length !== requests.length)) {
+                throw new TypeError(`Graph continuation requires ${requests.length} replies`);
+            }
+        },
+        catch: graphContinuationFailure,
+    });
+    if (requests.length === 1) {
+        return yield* Effect.tryPromise({
+            try: () => validateRequest(descriptor, requests[0], value),
+            catch: graphContinuationFailure,
+        });
+    }
+    const values = value;
+    const outcomes = yield* Effect.forEach(requests, (request, index) => Effect.result(Effect.tryPromise({
+        try: () => validateRequest(descriptor, request, values[index]),
+        catch: graphContinuationFailure,
+    })), { concurrency: 8 });
+    const firstFailure = outcomes.find(Result.isFailure);
+    if (firstFailure !== undefined)
+        return yield* Effect.fail(firstFailure.failure);
+    return outcomes.map((outcome) => (Result.isSuccess(outcome) ? outcome.success : undefined));
+}, (effect) => observeAgent("graph.validate-resume", effect));
+/** Validates graph continuation replies for existing Promise callers.
+ * @param descriptor - Graph whose nodes own the continuation schemas.
+ * @param requests - Waiting requests in graph order.
+ * @param value - One reply or a list matching the requests.
+ * @returns Validated reply values.
+ * @throws The original continuation validation error.
+ * @example await validateGraphResumeInput(graph, requests, reply);
+ */
+export function validateGraphResumeInput(descriptor, requests, value) {
+    return Effect.runPromise(validateGraphResumeInputEffect(descriptor, requests, value).pipe(Effect.catchTag("GraphContinuationFailure", (failure) => Effect.fail(failure.cause))));
+}
+async function validateRequest(descriptor, request, value) {
+    const node = resumeNode(descriptor, request.node.split("/"));
+    if (!isGraphNodeDescriptor(node) || node.resume === undefined) {
+        throw new TypeError(`Graph node "${request.node}" has no continuation schema`);
+    }
+    return validateValue(node.resume, value, "input");
+}
+function resumeNode(descriptor, path) {
+    const [head, ...tail] = path;
+    const node = descriptor.nodes.find((candidate) => candidate.id === head);
+    if (tail.length === 0)
+        return node;
+    return isSubgraphNode(node) ? resumeNode(subgraphForNode(node), tail) : undefined;
+}
+//# sourceMappingURL=graph-continuation-validation.js.map

package/dist/graph-continuation-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-continuation-validation.js","sourceRoot":"","sources":["../src/graph-continuation-validation.ts"],"names":[],"mappings":"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"}

package/dist/graph-continuation-waiting.d.ts

@@ -0,0 +1,23 @@
+/** Projects native graph interrupts into durable waiting state used by the RELKIT continuation protocol before returning control to callers. */
+import { Effect } from "effect";
+import type { GraphDescriptor } from "./define-graph.js";
+import type { GraphWaitingInterrupt } from "./graph-interruption.js";
+import type { CompiledGraph, GraphConfig } from "./graph-continuation.types.js";
+/** Reads waiting interrupts from the graph state snapshot.
+ * @param graph - Compiled LangGraph instance.
+ * @param descriptor - Source graph descriptor for node schemas.
+ * @param config - Optional persistent thread configuration.
+ * @returns An Effect with waiting interrupts or GraphContinuationFailure.
+ * @example Effect.runPromise(waitingInterruptsEffect(graph, descriptor, config));
+ */
+export declare const waitingInterruptsEffect: (graph: any, descriptor: GraphDescriptor<string, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@langchain/langgraph").AnyStateSchema, readonly import("./define-graph.types.js").GraphNodeLike[]>, config: GraphConfig) => Effect.Effect<readonly GraphWaitingInterrupt[], import("./graph-continuation-error.js").GraphContinuationFailure, never>;
+/** Reads waiting interrupts for existing Promise callers.
+ * @param graph - Compiled LangGraph instance.
+ * @param descriptor - Source graph descriptor for node schemas.
+ * @param config - Optional persistent thread configuration.
+ * @returns Waiting interrupts in task order.
+ * @throws The original graph state or schema failure.
+ * @example await waitingInterrupts(graph, descriptor, config);
+ */
+export declare function waitingInterrupts(graph: CompiledGraph, descriptor: GraphDescriptor, config: GraphConfig): Promise<readonly GraphWaitingInterrupt[]>;
+//# sourceMappingURL=graph-continuation-waiting.d.ts.map

package/dist/graph-continuation-waiting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-continuation-waiting.d.ts","sourceRoot":"","sources":["../src/graph-continuation-waiting.ts"],"names":[],"mappings":"AAAA,gJAAgJ;AAGhJ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGhF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,yaAYnC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAM3C"}

package/dist/graph-continuation-waiting.js

@@ -0,0 +1,53 @@
+/** Projects native graph interrupts into durable waiting state used by the RELKIT continuation protocol before returning control to callers. */
+import { getJsonSchema } from "@relkit/schema";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { isGraphNodeDescriptor } from "./define-graph-node.js";
+import { isSubgraphNode, subgraphForNode } from "./graph-subgraph.js";
+import { graphContinuationFailure } from "./graph-continuation-error.js";
+/** Reads waiting interrupts from the graph state snapshot.
+ * @param graph - Compiled LangGraph instance.
+ * @param descriptor - Source graph descriptor for node schemas.
+ * @param config - Optional persistent thread configuration.
+ * @returns An Effect with waiting interrupts or GraphContinuationFailure.
+ * @example Effect.runPromise(waitingInterruptsEffect(graph, descriptor, config));
+ */
+export const waitingInterruptsEffect = Effect.fn("Agents.graph.waiting")(function* (graph, descriptor, config) {
+    const snapshot = yield* Effect.tryPromise({
+        try: () => graph.getState(config, { subgraphs: true }),
+        catch: graphContinuationFailure,
+    });
+    return yield* Effect.try({
+        try: () => snapshotInterrupts(snapshot, descriptor, []),
+        catch: graphContinuationFailure,
+    });
+}, (effect) => observeAgent("graph.waiting", effect));
+/** Reads waiting interrupts for existing Promise callers.
+ * @param graph - Compiled LangGraph instance.
+ * @param descriptor - Source graph descriptor for node schemas.
+ * @param config - Optional persistent thread configuration.
+ * @returns Waiting interrupts in task order.
+ * @throws The original graph state or schema failure.
+ * @example await waitingInterrupts(graph, descriptor, config);
+ */
+export function waitingInterrupts(graph, descriptor, config) {
+    return Effect.runPromise(waitingInterruptsEffect(graph, descriptor, config).pipe(Effect.catchTag("GraphContinuationFailure", (failure) => Effect.fail(failure.cause))));
+}
+function snapshotInterrupts(snapshot, descriptor, path) {
+    return snapshot.tasks.flatMap((task) => {
+        const node = descriptor.nodes.find((candidate) => candidate.id === task.name);
+        if (isSubgraphNode(node) && task.state?.tasks !== undefined) {
+            return snapshotInterrupts(task.state, subgraphForNode(node), [...path, node.id]);
+        }
+        if (!isGraphNodeDescriptor(node) || node.resume === undefined)
+            return [];
+        const projection = getJsonSchema(node.resume);
+        return task.interrupts.map((entry) => ({
+            ...(entry.id === undefined ? {} : { id: entry.id }),
+            node: [...path, task.name].join("/"),
+            ...(entry.value === undefined ? {} : { value: entry.value }),
+            response: projection.ok ? projection.schema : null,
+        }));
+    });
+}
+//# sourceMappingURL=graph-continuation-waiting.js.map

package/dist/graph-continuation-waiting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-continuation-waiting.js","sourceRoot":"","sources":["../src/graph-continuation-waiting.ts"],"names":[],"mappings":"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"}