@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/graph-edges.js

@@ -0,0 +1,37 @@
+/** Defines typed native graph edge and routing descriptors whose endpoints are checked during graph assembly and compilation. */
+import { conditionalEdgeMutation, edgeMutation } from "./graph-edge-mutations.js";
+import { assertEndpoint, copyDestinations, addUnique } from "./graph-edge-destinations.js";
+import { END, START } from "@langchain/langgraph";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { graphDefinitionFailure } from "./define-graph-error.js";
+/** Creates an edge builder whose mutations run through Effect.
+ * @param nodeIds - Registered node identities.
+ * @returns An Effect with a builder and its ordered operation log.
+ * @example Effect.runSync(createGraphEdgeBuilderEffect(ids));
+ */
+export const createGraphEdgeBuilderEffect = Effect.fn("Agents.graph.edgeBuilder")((nodeIds) => Effect.sync(() => {
+    const operations = [];
+    const signatures = new Set();
+    let builder;
+    const context = { nodeIds, operations, signatures, builder: () => builder };
+    const addConditionalEdgesEffect = conditionalEdgeMutation(context);
+    const addEdgeEffect = edgeMutation(context);
+    builder = {
+        addEdge(start, end) {
+            return Effect.runSync(addEdgeEffect(start, end).pipe(Effect.catchTag("GraphDefinitionFailure", (failure) => Effect.fail(failure.cause))));
+        },
+        addConditionalEdges: ((source, route, destinations) => Effect.runSync(addConditionalEdgesEffect(source, route, destinations).pipe(Effect.catchTag("GraphDefinitionFailure", (failure) => Effect.fail(failure.cause))))),
+    };
+    return { builder: Object.freeze(builder), operations };
+}), (effect) => observeAgent("graph.edge-builder", effect));
+/** Creates an edge builder for existing synchronous graph authoring.
+ * @param nodeIds - Registered node identities.
+ * @returns A builder and its ordered operation log.
+ * @example const { builder, operations } = createGraphEdgeBuilder(ids);
+ */
+export function createGraphEdgeBuilder(nodeIds) {
+    return Effect.runSync(createGraphEdgeBuilderEffect(nodeIds));
+}
+export { assertGraphDestination, assertGraphDestinationEffect, validateGraphRoute, validateGraphRouteEffect, } from "./graph-edge-destinations.js";
+//# sourceMappingURL=graph-edges.js.map

package/dist/graph-edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-edges.js","sourceRoot":"","sources":["../src/graph-edges.ts"],"names":[],"mappings":"AAAA,iIAAiI;AAEjI,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,GAAG,EAAE,KAAK,EAAgC,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAIjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAC/E,CAA2B,OAAwB,EAAE,EAAE,CACrD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACf,MAAM,UAAU,GAAoC,EAAE,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,IAAI,OAAqC,CAAC;IAC1C,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC5E,MAAM,yBAAyB,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,GAAG;QACR,OAAO,CAAC,KAAK,EAAE,GAAG;YAChB,OAAO,MAAM,CAAC,OAAO,CACnB,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAC5B,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACnF,CACF,CAAC;QACJ,CAAC;QACD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CACpD,MAAM,CAAC,OAAO,CACZ,yBAAyB,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,IAAI,CACzD,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACnF,CACF,CAAuD;KAC3D,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CACvD,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAwB;IAKxB,OAAO,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAY,OAAO,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC"}

package/dist/graph-edges.types.d.ts

@@ -0,0 +1,47 @@
+/** Defines typed native graph edge and routing descriptors whose endpoints are checked during graph assembly and compilation. This companion preserves the native input and output types without starting runtime work. */
+import type { END, START, LangGraphRunnableConfig, Send } from "@langchain/langgraph";
+import type { MaybePromise } from "@relkit/contracts";
+/** Native graph conditional route callback. */
+export type GraphRoute<Id extends string, State> = (state: State, config: LangGraphRunnableConfig) => MaybePromise<Id | typeof END | Send<Id> | readonly (Id | Send<Id>)[]>;
+/** Label based graph conditional route callback. */
+export type GraphConditionalRoute<Id extends string, State, Key extends string> = (state: State, config: LangGraphRunnableConfig) => MaybePromise<Key | Send<Id, Partial<State>> | readonly (Key | Send<Id, Partial<State>>)[]>;
+/** Mutable graph edge authoring interface backed by Effect operations. */
+export interface GraphEdgeBuilder<Id extends string, State> {
+    /** Adds a static or join edge.
+     * @param start - One or more source nodes.
+     * @param end - Destination node.
+     * @returns This builder.
+     * @throws TypeError for invalid or duplicate edges.
+     * @example edge.addEdge("start", "finish");
+     */
+    addEdge(start: typeof START | NoInfer<Id> | readonly NoInfer<Id>[], end: NoInfer<Id> | typeof END): GraphEdgeBuilder<Id, State>;
+    /** Adds a dynamic edge.
+     * @param source - Source node.
+     * @param route - Route callback.
+     * @returns This builder.
+     * @throws TypeError for invalid or duplicate routes.
+     * @example edge.addConditionalEdges("start", () => "finish");
+     */
+    addConditionalEdges(source: typeof START | NoInfer<Id>, route: GraphRoute<NoInfer<Id>, State>): GraphEdgeBuilder<Id, State>;
+    /** Adds a labeled dynamic edge.
+     * @param source - Source node.
+     * @param route - Route callback.
+     * @param destinations - Label to destination mapping.
+     * @returns This builder.
+     * @throws TypeError for invalid or duplicate routes.
+     * @example edge.addConditionalEdges("start", () => "yes", { yes: "finish" });
+     */
+    addConditionalEdges<const Key extends string>(source: typeof START | NoInfer<Id>, route: GraphConditionalRoute<NoInfer<Id>, State, Key>, destinations: Readonly<Record<Key, NoInfer<Id> | typeof END>>): GraphEdgeBuilder<Id, State>;
+}
+/** Recorded edge operation consumed by the LangGraph compiler. */
+export type GraphEdgeOperation<Id extends string, State> = {
+    readonly kind: "edge";
+    readonly start: typeof START | Id | readonly Id[];
+    readonly end: Id | typeof END;
+} | {
+    readonly kind: "conditional";
+    readonly source: typeof START | Id;
+    readonly route: (state: State, config: LangGraphRunnableConfig) => MaybePromise<unknown>;
+    readonly destinations?: Readonly<Record<string, Id | typeof END>>;
+};
+//# sourceMappingURL=graph-edges.types.d.ts.map

package/dist/graph-edges.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-edges.types.d.ts","sourceRoot":"","sources":["../src/graph-edges.types.ts"],"names":[],"mappings":"AAAA,2NAA2N;AAE3N,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,MAAM,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CACjD,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,uBAAuB,KAC5B,YAAY,CAAC,EAAE,GAAG,OAAO,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAE3E,oDAAoD;AACpD,MAAM,MAAM,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,MAAM,IAAI,CAChF,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,uBAAuB,KAC5B,YAAY,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEhG,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK;IACxD;;;;;;OAMG;IACH,OAAO,CACL,KAAK,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,SAAS,OAAO,CAAC,EAAE,CAAC,EAAE,EAC1D,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,GAC5B,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/B;;;;;;OAMG;IACH,mBAAmB,CACjB,MAAM,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,EAClC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GACpC,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/B;;;;;;;OAOG;IACH,mBAAmB,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAC1C,MAAM,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,EAClC,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EACrD,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,GAC5D,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;CAChC;AAED,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,IACnD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,GAAG,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,GAAG,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC;CACnE,CAAC"}

package/dist/graph-edges.types.js

@@ -0,0 +1,3 @@
+/** Defines typed native graph edge and routing descriptors whose endpoints are checked during graph assembly and compilation. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=graph-edges.types.js.map

package/dist/graph-edges.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-edges.types.js","sourceRoot":"","sources":["../src/graph-edges.types.ts"],"names":[],"mappings":"AAAA,2NAA2N"}

package/dist/graph-execution-symbol.d.ts

@@ -0,0 +1,3 @@
+/** Private nonenumerable slot holding compiled graph authoring data. */
+export declare const GRAPH_EXECUTION: unique symbol;
+//# sourceMappingURL=graph-execution-symbol.d.ts.map

package/dist/graph-execution-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-execution-symbol.d.ts","sourceRoot":"","sources":["../src/graph-execution-symbol.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,eAAe,eAAuC,CAAC"}

package/dist/graph-execution-symbol.js

@@ -0,0 +1,3 @@
+/** Private nonenumerable slot holding compiled graph authoring data. */
+export const GRAPH_EXECUTION = Symbol.for("relkit.graph-execution");
+//# sourceMappingURL=graph-execution-symbol.js.map

package/dist/graph-execution-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-execution-symbol.js","sourceRoot":"","sources":["../src/graph-execution-symbol.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/graph-interruption.d.ts

@@ -0,0 +1,84 @@
+/** Converts native graph interrupt observations into RELKIT continuation data while preserving the interrupt identifiers needed for resume. */
+import type { JsonValue } from "@relkit/contracts";
+import { Effect, Schema } from "effect";
+import type { GraphWaitingInterrupt } from "./graph-interruption.types.js";
+import type { AgentWaitingRequest } from "@relkit/agents/internal/state.types";
+export type { GraphWaitingInterrupt } from "./graph-interruption.types.js";
+declare const GraphWaitingResponseError_base: Schema.Class<GraphWaitingResponseError, Schema.TaggedStruct<"GraphWaitingResponseError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** No pending request is available to form a graph interruption response. */
+export declare class GraphWaitingResponseError extends GraphWaitingResponseError_base {
+}
+/**
+ * Combines pending graph responses into one JSON schema.
+ *
+ * @param interrupts - Pending interrupts in graph order.
+ * @returns An Effect with the response schema or GraphWaitingResponseError.
+ * @example
+ * const response = Effect.runSync(graphWaitingResponseEffect([{ node: "review", response: true }]));
+ */
+export declare const graphWaitingResponseEffect: (interrupts: readonly GraphWaitingInterrupt[]) => Effect.Effect<JsonValue, GraphWaitingResponseError, never>;
+/**
+ * Combines pending graph responses for synchronous runtime callers.
+ *
+ * @param interrupts - Pending interrupts in graph order.
+ * @returns The single response or ordered tuple schema.
+ * @throws TypeError when no request is pending.
+ * @example
+ * const response = graphWaitingResponse([{ node: "review", response: true }]);
+ */
+export declare function graphWaitingResponse(interrupts: readonly GraphWaitingInterrupt[]): JsonValue;
+/**
+ * Removes internal identifiers while retaining public waiting request order.
+ *
+ * @param interrupts - Pending graph interrupts.
+ * @returns An Effect with public waiting requests; it has no typed failure.
+ * @example
+ * const requests = Effect.runSync(publicWaitingRequestsEffect(interrupts));
+ */
+export declare const publicWaitingRequestsEffect: (interrupts: readonly GraphWaitingInterrupt[]) => Effect.Effect<{
+    response: JsonValue;
+    value?: {} | null;
+    node: string;
+}[], never, never>;
+/**
+ * Returns public waiting requests for synchronous runtime callers.
+ *
+ * @param interrupts - Pending graph interrupts.
+ * @returns Requests without internal interrupt IDs.
+ * @example
+ * const requests = publicWaitingRequests(interrupts);
+ */
+export declare function publicWaitingRequests(interrupts: readonly GraphWaitingInterrupt[]): readonly AgentWaitingRequest[];
+/**
+ * Internal control result used by the server to publish a durable waiting snapshot.
+ *
+ * @example
+ * throw new GraphInterruptedError("thread-1", interrupts);
+ */
+export declare class GraphInterruptedError extends Error {
+    readonly threadId: string;
+    readonly interrupts: readonly GraphWaitingInterrupt[];
+    readonly code: "RELKIT_GRAPH_INTERRUPTED";
+    constructor(threadId: string, interrupts: readonly GraphWaitingInterrupt[]);
+}
+/**
+ * Recognizes the internal graph interruption control result.
+ *
+ * @param value - Candidate error.
+ * @returns An Effect with the recognition result; it has no typed failure.
+ * @example
+ * const interrupted = Effect.runSync(isGraphInterruptedErrorEffect(error));
+ */
+export declare const isGraphInterruptedErrorEffect: (value: unknown) => Effect.Effect<boolean, never, never>;
+/**
+ * Recognizes graph interruption errors for synchronous callers.
+ *
+ * @param value - Candidate error.
+ * @returns True only for a GraphInterruptedError instance.
+ * @example
+ * if (isGraphInterruptedError(error)) console.log(error.threadId);
+ */
+export declare function isGraphInterruptedError(value: unknown): value is GraphInterruptedError;
+//# sourceMappingURL=graph-interruption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-interruption.d.ts","sourceRoot":"","sources":["../src/graph-interruption.ts"],"names":[],"mappings":"AAAA,+IAA+I;AAE/I,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;;;;AAO3E,6EAA6E;AAC7E,qBAAa,yBAA0B,SAAQ,8BAG9C;CAAG;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,8GAsBtC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAU5F;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;kBAUvC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAC3C,SAAS,mBAAmB,EAAE,CAEhC;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAI5C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE;IAJvD,QAAQ,CAAC,IAAI,EAAG,0BAA0B,CAAU;gBAGzC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,qBAAqB,EAAE;CAKxD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,0DAMzC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF"}

package/dist/graph-interruption.js

@@ -0,0 +1,119 @@
+/** Converts native graph interrupt observations into RELKIT continuation data while preserving the interrupt identifiers needed for resume. */
+import { Effect, Metric, Schema } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+const responseCount = Metric.counter("relkit.agents.graph_interruption.response.total");
+const responseFailures = Metric.counter("relkit.agents.graph_interruption.response.failure.total");
+const requestsCount = Metric.counter("relkit.agents.graph_interruption.requests.total");
+const predicateCount = Metric.counter("relkit.agents.graph_interruption.predicate.total");
+/** No pending request is available to form a graph interruption response. */
+export class GraphWaitingResponseError extends Schema.TaggedError()("GraphWaitingResponseError", { message: Schema.String }) {
+}
+/**
+ * Combines pending graph responses into one JSON schema.
+ *
+ * @param interrupts - Pending interrupts in graph order.
+ * @returns An Effect with the response schema or GraphWaitingResponseError.
+ * @example
+ * const response = Effect.runSync(graphWaitingResponseEffect([{ node: "review", response: true }]));
+ */
+export const graphWaitingResponseEffect = Effect.fn("Agents.graphInterruption.response")(function* (interrupts) {
+    yield* Metric.update(responseCount, 1);
+    const first = interrupts[0];
+    if (first === undefined) {
+        yield* Metric.update(responseFailures, 1);
+        return yield* Effect.fail(new GraphWaitingResponseError({
+            message: "Graph interruption has no pending requests",
+        }));
+    }
+    if (interrupts.length === 1)
+        return first.response;
+    return {
+        type: "array",
+        prefixItems: interrupts.map((entry) => entry.response),
+        items: false,
+        minItems: interrupts.length,
+        maxItems: interrupts.length,
+    };
+}, (effect) => observeAgent("graph-interruption.response", effect));
+/**
+ * Combines pending graph responses for synchronous runtime callers.
+ *
+ * @param interrupts - Pending interrupts in graph order.
+ * @returns The single response or ordered tuple schema.
+ * @throws TypeError when no request is pending.
+ * @example
+ * const response = graphWaitingResponse([{ node: "review", response: true }]);
+ */
+export function graphWaitingResponse(interrupts) {
+    return Effect.runSync(graphWaitingResponseEffect(interrupts).pipe(Effect.catchTag("GraphWaitingResponseError", (error) => Effect.sync(() => {
+        throw new TypeError(error.message);
+    }))));
+}
+/**
+ * Removes internal identifiers while retaining public waiting request order.
+ *
+ * @param interrupts - Pending graph interrupts.
+ * @returns An Effect with public waiting requests; it has no typed failure.
+ * @example
+ * const requests = Effect.runSync(publicWaitingRequestsEffect(interrupts));
+ */
+export const publicWaitingRequestsEffect = Effect.fn("Agents.graphInterruption.requests")(function* (interrupts) {
+    yield* Metric.update(requestsCount, 1);
+    return interrupts.map(({ node, value, response }) => ({
+        node,
+        ...(value === undefined ? {} : { value }),
+        response,
+    }));
+}, (effect) => observeAgent("graph-interruption.requests", effect));
+/**
+ * Returns public waiting requests for synchronous runtime callers.
+ *
+ * @param interrupts - Pending graph interrupts.
+ * @returns Requests without internal interrupt IDs.
+ * @example
+ * const requests = publicWaitingRequests(interrupts);
+ */
+export function publicWaitingRequests(interrupts) {
+    return Effect.runSync(publicWaitingRequestsEffect(interrupts));
+}
+/**
+ * Internal control result used by the server to publish a durable waiting snapshot.
+ *
+ * @example
+ * throw new GraphInterruptedError("thread-1", interrupts);
+ */
+export class GraphInterruptedError extends Error {
+    threadId;
+    interrupts;
+    code = "RELKIT_GRAPH_INTERRUPTED";
+    constructor(threadId, interrupts) {
+        super("Graph execution is waiting for human input");
+        this.threadId = threadId;
+        this.interrupts = interrupts;
+        this.name = "GraphInterruptedError";
+    }
+}
+/**
+ * Recognizes the internal graph interruption control result.
+ *
+ * @param value - Candidate error.
+ * @returns An Effect with the recognition result; it has no typed failure.
+ * @example
+ * const interrupted = Effect.runSync(isGraphInterruptedErrorEffect(error));
+ */
+export const isGraphInterruptedErrorEffect = Effect.fn("Agents.graphInterruption.isError")(function* (value) {
+    yield* Metric.update(predicateCount, 1);
+    return value instanceof GraphInterruptedError;
+}, (effect) => observeAgent("graph-interruption.is-error", effect));
+/**
+ * Recognizes graph interruption errors for synchronous callers.
+ *
+ * @param value - Candidate error.
+ * @returns True only for a GraphInterruptedError instance.
+ * @example
+ * if (isGraphInterruptedError(error)) console.log(error.threadId);
+ */
+export function isGraphInterruptedError(value) {
+    return Effect.runSync(isGraphInterruptedErrorEffect(value));
+}
+//# sourceMappingURL=graph-interruption.js.map

package/dist/graph-interruption.js.map

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

package/dist/graph-interruption.types.d.ts

@@ -0,0 +1,16 @@
+/** Converts native graph interrupt observations into RELKIT continuation data while preserving the interrupt identifiers needed for resume. This companion preserves the native input and output types without starting runtime work. */
+import type { JsonValue } from "@relkit/contracts";
+/**
+ * Pending graph interruption and its public response schema.
+ * The optional ID is internal and omitted from published waiting requests.
+ *
+ * @example
+ * const interrupt: GraphWaitingInterrupt = { node: "review", response: true };
+ */
+export interface GraphWaitingInterrupt {
+    readonly id?: string;
+    readonly node: string;
+    readonly value?: unknown;
+    readonly response: JsonValue;
+}
+//# sourceMappingURL=graph-interruption.types.d.ts.map

package/dist/graph-interruption.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-interruption.types.d.ts","sourceRoot":"","sources":["../src/graph-interruption.types.ts"],"names":[],"mappings":"AAAA,yOAAyO;AAEzO,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B"}

package/dist/graph-interruption.types.js

@@ -0,0 +1,3 @@
+/** Converts native graph interrupt observations into RELKIT continuation data while preserving the interrupt identifiers needed for resume. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=graph-interruption.types.js.map

package/dist/graph-interruption.types.js.map

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

package/dist/graph-node-schema-validation.d.ts

@@ -0,0 +1,9 @@
+/** Validates native node input, output and optional resume schemas in authoring order before handler or identity construction; schema failures retain their existing graph-node boundary. */
+import { Effect } from "effect";
+import type { GraphNodeAny } from "./define-graph-node.types.js";
+/** Validates each authored schema without invoking the user's node handler.
+ * @param options - Input, output and optional resume schema from the original node options.
+ * @returns A lazy Effect succeeding after validation or failing with the original graph-node diagnostic.
+ */
+export declare const validateGraphNodeSchemasEffect: (options: Pick<GraphNodeAny, "input" | "output" | "resume">) => Effect.Effect<void, import("./graph-node-validation-error.js").GraphNodeValidationFailure, never>;
+//# sourceMappingURL=graph-node-schema-validation.d.ts.map

package/dist/graph-node-schema-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-node-schema-validation.d.ts","sourceRoot":"","sources":["../src/graph-node-schema-validation.ts"],"names":[],"mappings":"AAAA,6LAA6L;AAE7L,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,8BAA8B,mKAW1C,CAAC"}

package/dist/graph-node-schema-validation.js

@@ -0,0 +1,16 @@
+/** Validates native node input, output and optional resume schemas in authoring order before handler or identity construction; schema failures retain their existing graph-node boundary. */
+import { Effect } from "effect";
+import { assertAgentSchemaEffect } from "@relkit/agents/internal/agent-validation-schema";
+import { graphNodeValidationFailure } from "./graph-node-validation-error.js";
+/** Validates each authored schema without invoking the user's node handler.
+ * @param options - Input, output and optional resume schema from the original node options.
+ * @returns A lazy Effect succeeding after validation or failing with the original graph-node diagnostic.
+ */
+export const validateGraphNodeSchemasEffect = Effect.fn("Agents.graphNode.validateSchemas")(function* (options) {
+    const asGraphFailure = (failure) => graphNodeValidationFailure(new TypeError(failure.message));
+    yield* assertAgentSchemaEffect(options.input, "input").pipe(Effect.mapError(asGraphFailure));
+    yield* assertAgentSchemaEffect(options.output, "output").pipe(Effect.mapError(asGraphFailure));
+    if (options.resume !== undefined)
+        yield* assertAgentSchemaEffect(options.resume, "resume").pipe(Effect.mapError(asGraphFailure));
+});
+//# sourceMappingURL=graph-node-schema-validation.js.map

package/dist/graph-node-schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-node-schema-validation.js","sourceRoot":"","sources":["../src/graph-node-schema-validation.ts"],"names":[],"mappings":"AAAA,6LAA6L;AAE7L,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,EAAE,CAAC,kCAAkC,CAAC,CACzF,QAAQ,CAAC,EAAE,OAA0D;IACnE,MAAM,cAAc,GAAG,CAAC,OAAqC,EAAE,EAAE,CAC/D,0BAA0B,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;IAC7F,KAAK,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;IAC/F,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAC9B,KAAK,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAChC,CAAC;AACN,CAAC,CACF,CAAC"}

package/dist/graph-node-symbol.d.ts

@@ -0,0 +1,3 @@
+/** Private brand identifying a validated RELKIT graph node. */
+export declare const RELKIT_GRAPH_NODE: unique symbol;
+//# sourceMappingURL=graph-node-symbol.d.ts.map

package/dist/graph-node-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-node-symbol.d.ts","sourceRoot":"","sources":["../src/graph-node-symbol.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,eAAkC,CAAC"}

package/dist/graph-node-symbol.js

@@ -0,0 +1,3 @@
+/** Private brand identifying a validated RELKIT graph node. */
+export const RELKIT_GRAPH_NODE = Symbol.for("relkit.graph-node");
+//# sourceMappingURL=graph-node-symbol.js.map

package/dist/graph-node-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-node-symbol.js","sourceRoot":"","sources":["../src/graph-node-symbol.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/graph-node-validation-error.d.ts

@@ -0,0 +1,17 @@
+/** Defines authoring failures for native graph nodes and retains the invalid field for focused descriptor diagnostics. */
+import { Schema } from "effect";
+declare const GraphNodeValidationFailure_base: Schema.Class<GraphNodeValidationFailure, Schema.TaggedStruct<"GraphNodeValidationFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** Tagged graph node validation failure. */
+export declare class GraphNodeValidationFailure extends GraphNodeValidationFailure_base {
+}
+/** Preserves a graph node validation error for Effect callers.
+ * @param cause - Schema, destination, or update failure.
+ * @returns A tagged graph node failure.
+ * @example graphNodeValidationFailure(new TypeError("invalid"));
+ */
+export declare function graphNodeValidationFailure(cause: unknown): GraphNodeValidationFailure;
+export {};
+//# sourceMappingURL=graph-node-validation-error.d.ts.map

package/dist/graph-node-validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-node-validation-error.d.ts","sourceRoot":"","sources":["../src/graph-node-validation-error.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAE1H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,4CAA4C;AAC5C,qBAAa,0BAA2B,SAAQ,+BAG/C;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAKrF"}

package/dist/graph-node-validation-error.js

@@ -0,0 +1,17 @@
+/** Defines authoring failures for native graph nodes and retains the invalid field for focused descriptor diagnostics. */
+import { Schema } from "effect";
+/** Tagged graph node validation failure. */
+export class GraphNodeValidationFailure extends Schema.TaggedError()("GraphNodeValidationFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Preserves a graph node validation error for Effect callers.
+ * @param cause - Schema, destination, or update failure.
+ * @returns A tagged graph node failure.
+ * @example graphNodeValidationFailure(new TypeError("invalid"));
+ */
+export function graphNodeValidationFailure(cause) {
+    return new GraphNodeValidationFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=graph-node-validation-error.js.map

package/dist/graph-node-validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-node-validation-error.js","sourceRoot":"","sources":["../src/graph-node-validation-error.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAE1H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,4CAA4C;AAC5C,MAAM,OAAO,0BAA2B,SAAQ,MAAM,CAAC,WAAW,EAA8B,CAC9F,4BAA4B,EAC5B,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,IAAI,0BAA0B,CAAC;QACpC,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-node-validation-value.d.ts

@@ -0,0 +1,64 @@
+/** Checks graph node authoring values and callable shapes before construction, keeping runtime callbacks untouched after validation. */
+import { type InferOutput, type StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+/** Checks that native command destinations were declared by the node.
+ * @param ends - Declared destinations.
+ * @param value - Native command destination or list.
+ * @returns An Effect with void or GraphNodeValidationFailure.
+ * @example Effect.runSync(validateDestinationsEffect(["next"], "next"));
+ */
+export declare const validateDestinationsEffect: (ends: readonly string[], value: unknown) => Effect.Effect<void, import("./graph-node-validation-error.js").GraphNodeValidationFailure, never>;
+/** Checks native command destinations for existing synchronous callers.
+ * @param ends - Declared destinations.
+ * @param value - Native command destination or list.
+ * @returns Nothing for valid destinations.
+ * @throws TypeError for invalid or undeclared destinations.
+ * @example validateDestinations(["next"], "next");
+ */
+export declare function validateDestinations(ends: readonly string[], value: unknown): void;
+/** Converts a native command update entry list into an object.
+ * @param value - Native update object or entry list.
+ * @returns An Effect with an update or GraphNodeValidationFailure.
+ * @example Effect.runSync(commandUpdateEffect([["count", 1]]));
+ */
+export declare const commandUpdateEffect: (value: unknown) => Effect.Effect<unknown, import("./graph-node-validation-error.js").GraphNodeValidationFailure, never>;
+/** Converts a native command update for existing synchronous callers.
+ * @param value - Native update object or entry list.
+ * @returns An update object or the original value.
+ * @throws TypeError for malformed entry lists.
+ * @example commandUpdate([["count", 1]]);
+ */
+export declare function commandUpdate(value: unknown): unknown;
+/** Validates a graph node output as a record.
+ * @param schema - Output schema.
+ * @param value - Candidate output.
+ * @returns An Effect with a record or GraphNodeValidationFailure.
+ * @example await Effect.runPromise(validatedUpdateEffect(schema, output));
+ */
+export declare const validatedUpdateEffect: <Schema extends StandardSchemaV1>(schema: Schema, value: unknown) => Effect.Effect<Extract<InferOutput<Schema>, Record<string, unknown>>, import("./graph-node-validation-error.js").GraphNodeValidationFailure, never>;
+/** Validates a node output for existing Promise callers.
+ * @param schema - Output schema.
+ * @param value - Candidate output.
+ * @returns Validated output record.
+ * @throws The original schema or record error.
+ * @example await validatedUpdate(schema, output);
+ */
+export declare function validatedUpdate<Schema extends StandardSchemaV1>(schema: Schema, value: unknown): Promise<Extract<InferOutput<Schema>, Record<string, unknown>>>;
+/** Validates a graph node input or output through its Standard Schema.
+ * @param schema - Node schema.
+ * @param value - Candidate value.
+ * @param phase - Input or output diagnostic phase.
+ * @returns An Effect with projected value or GraphNodeValidationFailure.
+ * @example await Effect.runPromise(validatedValueEffect(schema, input, "input"));
+ */
+export declare const validatedValueEffect: <Schema extends StandardSchemaV1>(schema: Schema, value: unknown, phase: "input" | "output") => Effect.Effect<InferOutput<Schema>, import("./graph-node-validation-error.js").GraphNodeValidationFailure, never>;
+/** Validates a node value for existing Promise callers.
+ * @param schema - Node schema.
+ * @param value - Candidate value.
+ * @param phase - Input or output diagnostic phase.
+ * @returns Projected value.
+ * @throws The original schema validation error.
+ * @example await validatedValue(schema, input, "input");
+ */
+export declare function validatedValue<Schema extends StandardSchemaV1>(schema: Schema, value: unknown, phase: "input" | "output"): Promise<InferOutput<Schema>>;
+//# sourceMappingURL=graph-node-validation-value.d.ts.map

package/dist/graph-node-validation-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-node-validation-value.d.ts","sourceRoot":"","sources":["../src/graph-node-validation-value.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAExI,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,gJAOtC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAMlF;AAqBD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,0HAI/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMrD;AAcD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GACrB,MAAM,SAAS,gBAAgB,uLAU3C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS,gBAAgB,EAC7D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAMhE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC9B,MAAM,SAAS,gBAAgB,gLAejC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAS,gBAAgB,EAC5D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,GAAG,QAAQ,GACxB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAM9B"}