@relkit/langchain 0.0.0-stage → 0.7.10

package/dist/graph-state-schema.js

@@ -0,0 +1,65 @@
+/** Adapts authored state schemas to the native graph state contract and preserves the reducers and validated channel shapes required by compilation. */
+import { StateSchema } from "@langchain/langgraph";
+import { getJsonSchema } from "@relkit/schema";
+import { Effect, Metric, Schema } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { AgentRuntimeError } from "./runtime-errors.js";
+const selectionCount = Metric.counter("relkit.agents.graph_state.selection.total");
+const selectionFailures = Metric.counter("relkit.agents.graph_state.selection.failure.total");
+/** Expected graph state projection failure in the Effect error channel. */
+export class GraphStateSelectionError extends Schema.TaggedError()("GraphStateSelectionError", { code: Schema.String, message: Schema.String }) {
+}
+/**
+ * Projects a graph state to the fields declared by a client selection schema.
+ *
+ * @param state - LangGraph state definition to project.
+ * @param selection - Standard Schema describing the selected fields.
+ * @returns An Effect with the selected StateSchema or GraphStateSelectionError.
+ * @throws A defect if LangGraph rejects an otherwise valid StateSchema construction.
+ * @example
+ * const projected = Effect.runSync(selectGraphStateEffect(state, z.object({ answer: z.string() })));
+ */
+export const selectGraphStateEffect = Effect.fn("Agents.graphState.select")(function* (state, selection) {
+    yield* Metric.update(selectionCount, 1);
+    const projection = yield* Effect.sync(() => getJsonSchema(selection));
+    const properties = projection.ok ? projection.schema.properties : undefined;
+    if (!isRecord(properties)) {
+        yield* Metric.update(selectionFailures, 1);
+        return yield* Effect.fail(new GraphStateSelectionError({
+            code: "RELKIT_SCHEMA_UNAVAILABLE",
+            message: "Graph state selection is unavailable",
+        }));
+    }
+    const selected = {};
+    for (const key of Object.keys(properties)) {
+        const field = state.fields[key];
+        if (field === undefined) {
+            yield* Metric.update(selectionFailures, 1);
+            return yield* Effect.fail(new GraphStateSelectionError({
+                code: "RELKIT_SCHEMA_UNAVAILABLE",
+                message: `Graph state field "${key}" is unavailable`,
+            }));
+        }
+        selected[key] = field;
+    }
+    return yield* Effect.sync(() => new StateSchema(selected));
+}, (effect) => observeAgent("graph-state.select", effect));
+/**
+ * Projects graph state for existing synchronous graph definition callers.
+ *
+ * @param state - LangGraph state definition to project.
+ * @param selection - Schema describing selected fields.
+ * @returns A new StateSchema with only those fields.
+ * @throws AgentRuntimeError when the selection or one of its fields is unavailable.
+ * @example
+ * const projected = selectGraphState(state, z.object({ answer: z.string() }));
+ */
+export function selectGraphState(state, selection) {
+    return Effect.runSync(selectGraphStateEffect(state, selection).pipe(Effect.catchTag("GraphStateSelectionError", (error) => Effect.sync(() => {
+        throw new AgentRuntimeError(error.code, error.message);
+    }))));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=graph-state-schema.js.map

package/dist/graph-state-schema.js.map

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

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

@@ -0,0 +1,5 @@
+/** Marker for a graph embedded as a native node. */
+export declare const RELKIT_SUBGRAPH_NODE: unique symbol;
+/** Hidden reference to the embedded graph descriptor. */
+export declare const RELKIT_SUBGRAPH: unique symbol;
+//# sourceMappingURL=graph-subgraph-symbol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-subgraph-symbol.d.ts","sourceRoot":"","sources":["../src/graph-subgraph-symbol.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,eAAqC,CAAC;AAEvE,yDAAyD;AACzD,eAAO,MAAM,eAAe,eAAgC,CAAC"}

package/dist/graph-subgraph-symbol.js

@@ -0,0 +1,5 @@
+/** Marker for a graph embedded as a native node. */
+export const RELKIT_SUBGRAPH_NODE = Symbol.for("relkit.subgraph-node");
+/** Hidden reference to the embedded graph descriptor. */
+export const RELKIT_SUBGRAPH = Symbol.for("relkit.subgraph");
+//# sourceMappingURL=graph-subgraph-symbol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-subgraph-symbol.js","sourceRoot":"","sources":["../src/graph-subgraph-symbol.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAEvE,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/graph-subgraph.d.ts

@@ -0,0 +1,46 @@
+/** Creates nested graph descriptors with their native execution metadata so parent compilation can retain subgraph state and interruption semantics. */
+import type { StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+import type { GraphDescriptor } from "./define-graph.js";
+import type { GraphAsNodeOptions, SubgraphNodeDescriptor } from "./graph-subgraph.types.js";
+export type * from "./graph-subgraph.types.js";
+/** Creates a native node backed by another graph.
+ * @param graph - Graph to embed.
+ * @param options - Optional node identity and destinations.
+ * @returns An Effect with a frozen node or GraphNodeValidationFailure.
+ * @example Effect.runSync(createSubgraphNodeEffect(graph, { id: "nested" }));
+ */
+export declare const createSubgraphNodeEffect: <const Id extends string, InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1>(graph: GraphDescriptor<string, InputSchema, OutputSchema, import("@langchain/langgraph").AnyStateSchema, readonly import("./define-graph.types.js").GraphNodeLike[]>, options?: GraphAsNodeOptions<Id> | undefined) => Effect.Effect<SubgraphNodeDescriptor<Id, InputSchema, OutputSchema>, import("./graph-node-validation-error.js").GraphNodeValidationFailure, never>;
+/** Creates an embedded graph node for existing synchronous callers.
+ * @param graph - Graph to embed.
+ * @param options - Optional node identity and destinations.
+ * @returns A frozen subgraph node.
+ * @throws The original invalid options or destination error.
+ * @example const node = createSubgraphNode(graph, { id: "nested" });
+ */
+export declare function createSubgraphNode<const Id extends string, InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1>(graph: GraphDescriptor<string, InputSchema, OutputSchema>, options?: GraphAsNodeOptions<Id>): SubgraphNodeDescriptor<Id, InputSchema, OutputSchema>;
+/** Checks whether a value is an embedded graph node.
+ * @param value - Candidate node.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isSubgraphNodeEffect(value));
+ */
+export declare const isSubgraphNodeEffect: (value: unknown) => Effect.Effect<boolean, never, never>;
+/** Checks embedded graph nodes for existing synchronous callers.
+ * @param value - Candidate node.
+ * @returns Whether the value is an embedded graph node.
+ * @example if (isSubgraphNode(value)) subgraphForNode(value);
+ */
+export declare function isSubgraphNode(value: unknown): value is SubgraphNodeDescriptor;
+/** Reads the source graph from a subgraph node.
+ * @param value - Embedded graph node.
+ * @returns An Effect with the source descriptor.
+ * @example Effect.runSync(subgraphForNodeEffect(node));
+ */
+export declare const subgraphForNodeEffect: (value: SubgraphNodeDescriptor<string, StandardSchemaV1<unknown, unknown>, StandardSchemaV1<unknown, unknown>>) => Effect.Effect<GraphDescriptor<string, StandardSchemaV1<unknown, unknown>, StandardSchemaV1<unknown, unknown>, import("@langchain/langgraph").AnyStateSchema, readonly import("./define-graph.types.js").GraphNodeLike[]>, never, never>;
+/** Reads the source graph for existing synchronous callers.
+ * @param value - Embedded graph node.
+ * @returns The source graph descriptor.
+ * @example const nested = subgraphForNode(node);
+ */
+export declare function subgraphForNode(value: SubgraphNodeDescriptor): GraphDescriptor;
+//# sourceMappingURL=graph-subgraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-subgraph.d.ts","sourceRoot":"","sources":["../src/graph-subgraph.ts"],"names":[],"mappings":"AAAA,wJAAwJ;AAGxJ,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAE5F,mBAAmB,2BAA2B,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,SAE3B,EAAE,SAAS,MAAM,EACvB,WAAW,SAAS,gBAAgB,EACpC,YAAY,SAAS,gBAAgB,2WA2BxC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,SAAS,MAAM,EACvB,WAAW,SAAS,gBAAgB,EACpC,YAAY,SAAS,gBAAgB,EAErC,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EACzD,OAAO,GAAE,kBAAkB,CAAC,EAAE,CAAM,GACnC,sBAAsB,CAAC,EAAE,EAAE,WAAW,EAAE,YAAY,CAAC,CAMvD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,0DAahC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAE9E;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,4VAGjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,eAAe,CAE9E"}

package/dist/graph-subgraph.js

@@ -0,0 +1,82 @@
+/** Creates nested graph descriptors with their native execution metadata so parent compilation can retain subgraph state and interruption semantics. */
+import { normalizeId } from "@relkit/contracts";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { isRecordEffect } from "@relkit/agents/internal/agent-validation-value";
+import { graphNodeValidationFailure } from "./graph-node-validation-error.js";
+import { copyGraphNodeEndsEffect } from "./graph-node-validation.js";
+import { RELKIT_SUBGRAPH, RELKIT_SUBGRAPH_NODE } from "./graph-subgraph-symbol.js";
+/** Creates a native node backed by another graph.
+ * @param graph - Graph to embed.
+ * @param options - Optional node identity and destinations.
+ * @returns An Effect with a frozen node or GraphNodeValidationFailure.
+ * @example Effect.runSync(createSubgraphNodeEffect(graph, { id: "nested" }));
+ */
+export const createSubgraphNodeEffect = Effect.fn("Agents.graph.subgraphCreate")(function* (graph, options = {}) {
+    if (!(yield* isRecordEffect(options))) {
+        return yield* Effect.fail(graphNodeValidationFailure(new TypeError("Subgraph node options must be an object")));
+    }
+    const id = yield* Effect.try({
+        try: () => normalizeId(options.id ?? graph.id),
+        catch: graphNodeValidationFailure,
+    });
+    const ends = yield* copyGraphNodeEndsEffect(options.ends);
+    const descriptor = {
+        [RELKIT_SUBGRAPH_NODE]: true,
+        kind: "subgraph-node",
+        id,
+        input: graph.input,
+        output: graph.output,
+        ends,
+    };
+    Object.defineProperty(descriptor, RELKIT_SUBGRAPH, { value: graph, enumerable: false });
+    return Object.freeze(descriptor);
+}, (effect) => observeAgent("graph.subgraph-create", effect));
+/** Creates an embedded graph node for existing synchronous callers.
+ * @param graph - Graph to embed.
+ * @param options - Optional node identity and destinations.
+ * @returns A frozen subgraph node.
+ * @throws The original invalid options or destination error.
+ * @example const node = createSubgraphNode(graph, { id: "nested" });
+ */
+export function createSubgraphNode(graph, options = {}) {
+    return Effect.runSync(createSubgraphNodeEffect(graph, options).pipe(Effect.catchTag("GraphNodeValidationFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Checks whether a value is an embedded graph node.
+ * @param value - Candidate node.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isSubgraphNodeEffect(value));
+ */
+export const isSubgraphNodeEffect = Effect.fn("Agents.graph.subgraphIsNode")(function* (value) {
+    if (!(yield* isRecordEffect(value)))
+        return false;
+    const record = value;
+    return (record[RELKIT_SUBGRAPH_NODE] === true &&
+        record.kind === "subgraph-node" &&
+        typeof record.id === "string" &&
+        Array.isArray(record.ends) &&
+        record[RELKIT_SUBGRAPH] !== undefined);
+}, (effect) => observeAgent("graph.subgraph-is-node", effect));
+/** Checks embedded graph nodes for existing synchronous callers.
+ * @param value - Candidate node.
+ * @returns Whether the value is an embedded graph node.
+ * @example if (isSubgraphNode(value)) subgraphForNode(value);
+ */
+export function isSubgraphNode(value) {
+    return Effect.runSync(isSubgraphNodeEffect(value));
+}
+/** Reads the source graph from a subgraph node.
+ * @param value - Embedded graph node.
+ * @returns An Effect with the source descriptor.
+ * @example Effect.runSync(subgraphForNodeEffect(node));
+ */
+export const subgraphForNodeEffect = Effect.fn("Agents.graph.subgraphSource")((value) => Effect.sync(() => value[RELKIT_SUBGRAPH]), (effect) => observeAgent("graph.subgraph-source", effect));
+/** Reads the source graph for existing synchronous callers.
+ * @param value - Embedded graph node.
+ * @returns The source graph descriptor.
+ * @example const nested = subgraphForNode(node);
+ */
+export function subgraphForNode(value) {
+    return Effect.runSync(subgraphForNodeEffect(value));
+}
+//# sourceMappingURL=graph-subgraph.js.map

package/dist/graph-subgraph.js.map

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

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

@@ -0,0 +1,20 @@
+/** Creates nested graph descriptors with their native execution metadata so parent compilation can retain subgraph state and interruption semantics. This companion preserves the native input and output types without starting runtime work. */
+import type { StandardSchemaV1 } from "@relkit/schema";
+import type { GraphDescriptor } from "./define-graph.js";
+import type { RELKIT_SUBGRAPH, RELKIT_SUBGRAPH_NODE } from "./graph-subgraph-symbol.js";
+/** Authoring options for a graph embedded as a node. */
+export interface GraphAsNodeOptions<Id extends string = string> {
+    readonly id?: Id;
+    readonly ends?: readonly string[];
+}
+/** Native graph node whose action is another graph. */
+export interface SubgraphNodeDescriptor<Id extends string = string, InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly [RELKIT_SUBGRAPH_NODE]: true;
+    readonly kind: "subgraph-node";
+    readonly id: Id;
+    readonly input: InputSchema;
+    readonly output: OutputSchema;
+    readonly ends: readonly string[];
+    readonly [RELKIT_SUBGRAPH]: GraphDescriptor;
+}
+//# sourceMappingURL=graph-subgraph.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-subgraph.types.d.ts","sourceRoot":"","sources":["../src/graph-subgraph.types.ts"],"names":[],"mappings":"AAAA,kPAAkP;AAElP,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAExF,wDAAwD;AACxD,MAAM,WAAW,kBAAkB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM;IAC5D,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,uDAAuD;AACvD,MAAM,WAAW,sBAAsB,CACrC,EAAE,SAAS,MAAM,GAAG,MAAM,EAC1B,WAAW,SAAS,gBAAgB,GAAG,gBAAgB,EACvD,YAAY,SAAS,gBAAgB,GAAG,gBAAgB;IAExD,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC7C"}

package/dist/graph-subgraph.types.js

@@ -0,0 +1,3 @@
+/** Creates nested graph descriptors with their native execution metadata so parent compilation can retain subgraph state and interruption semantics. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=graph-subgraph.types.js.map

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

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

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

@@ -0,0 +1,17 @@
+/** Defines graph workflow failures at the RELKIT execution boundary, preserving graph identity and the native failure cause. */
+import { Schema } from "effect";
+declare const GraphWorkflowFailure_base: Schema.Class<GraphWorkflowFailure, Schema.TaggedStruct<"GraphWorkflowFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** Tagged graph workflow projection failure. */
+export declare class GraphWorkflowFailure extends GraphWorkflowFailure_base {
+}
+/** Preserves a graph workflow projection error.
+ * @param cause - Node, edge, or schema projection failure.
+ * @returns A tagged workflow failure.
+ * @example graphWorkflowFailure(new TypeError("invalid node"));
+ */
+export declare function graphWorkflowFailure(cause: unknown): GraphWorkflowFailure;
+export {};
+//# sourceMappingURL=graph-workflow-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-workflow-error.d.ts","sourceRoot":"","sources":["../src/graph-workflow-error.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAEhI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,gDAAgD;AAChD,qBAAa,oBAAqB,SAAQ,yBAGzC;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAKzE"}

package/dist/graph-workflow-error.js

@@ -0,0 +1,17 @@
+/** Defines graph workflow failures at the RELKIT execution boundary, preserving graph identity and the native failure cause. */
+import { Schema } from "effect";
+/** Tagged graph workflow projection failure. */
+export class GraphWorkflowFailure extends Schema.TaggedError()("GraphWorkflowFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Preserves a graph workflow projection error.
+ * @param cause - Node, edge, or schema projection failure.
+ * @returns A tagged workflow failure.
+ * @example graphWorkflowFailure(new TypeError("invalid node"));
+ */
+export function graphWorkflowFailure(cause) {
+    return new GraphWorkflowFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=graph-workflow-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-workflow-error.js","sourceRoot":"","sources":["../src/graph-workflow-error.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAEhI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,gDAAgD;AAChD,MAAM,OAAO,oBAAqB,SAAQ,MAAM,CAAC,WAAW,EAAwB,CAClF,sBAAsB,EACtB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,IAAI,oBAAoB,CAAC;QAC9B,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-workflow.d.ts

@@ -0,0 +1,37 @@
+/** Adapts native graph execution to the RELKIT workflow contract, carrying invocation context and scoped persistence through completion. */
+import { Effect } from "effect";
+import { type FunctionGraphNodeDescriptor } from "@relkit/functions";
+import { type StandardSchemaV1 } from "@relkit/schema";
+import type { GraphNodeAny } from "./define-graph-node.js";
+import { type SubgraphNodeDescriptor } from "./graph-subgraph.js";
+import type { GraphEdgeOperation } from "./graph-edges.js";
+import type { GraphWorkflow } from "./graph-workflow.types.js";
+export type * from "./graph-workflow.types.js";
+/** Projects a frozen serializable graph workflow from authoring nodes and edges.
+ * @param nodes - Validated graph nodes.
+ * @param edges - Validated graph edge operations.
+ * @returns An Effect with a workflow or GraphWorkflowFailure.
+ * @example Effect.runSync(graphWorkflowEffect(nodes, edges));
+ */
+export declare const graphWorkflowEffect: <Id extends string, State>(nodes: readonly (GraphNodeAny | FunctionGraphNodeDescriptor<string, string, unknown, unknown, readonly import("@relkit/functions").ErrorDescriptorAny[], StandardSchemaV1<unknown, unknown>, StandardSchemaV1<unknown, unknown>, import("@relkit/functions").FunctionDependencies> | SubgraphNodeDescriptor<string, StandardSchemaV1<unknown, unknown>, StandardSchemaV1<unknown, unknown>>)[], edges: readonly GraphEdgeOperation<Id, State>[]) => Effect.Effect<GraphWorkflow, import("./graph-workflow-error.js").GraphWorkflowFailure, never>;
+/** Projects a workflow for existing synchronous graph callers.
+ * @param nodes - Validated graph nodes.
+ * @param edges - Validated graph edge operations.
+ * @returns A frozen serializable workflow.
+ * @throws The original node or schema projection error.
+ * @example graphWorkflow(nodes, edges);
+ */
+export declare function graphWorkflow<Id extends string, State>(nodes: readonly (GraphNodeAny | FunctionGraphNodeDescriptor | SubgraphNodeDescriptor)[], edges: readonly GraphEdgeOperation<Id, State>[]): GraphWorkflow;
+/** Checks whether any graph node has a resumable continuation.
+ * @param workflow - Frozen graph workflow.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(graphWorkflowRequiresPersistenceEffect(workflow));
+ */
+export declare const graphWorkflowRequiresPersistenceEffect: (workflow: GraphWorkflow) => Effect.Effect<boolean, never, never>;
+/** Checks persistence needs for existing synchronous graph callers.
+ * @param workflow - Frozen graph workflow.
+ * @returns Whether any node has a resumable continuation.
+ * @example graphWorkflowRequiresPersistence(workflow);
+ */
+export declare function graphWorkflowRequiresPersistence(workflow: GraphWorkflow): boolean;
+//# sourceMappingURL=graph-workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-workflow.d.ts","sourceRoot":"","sources":["../src/graph-workflow.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAI5I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAuB,KAAK,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAmC,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,2BAA2B,CAAC;AAEnC,mBAAmB,2BAA2B,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC7B,EAAE,SAAS,MAAM,EAAE,KAAK,mhBAgB1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,EACpD,KAAK,EAAE,SAAS,CAAC,YAAY,GAAG,2BAA2B,GAAG,sBAAsB,CAAC,EAAE,EACvF,KAAK,EAAE,SAAS,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,GAC9C,aAAa,CAMf;AAED;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,mEAGlD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEjF"}

package/dist/graph-workflow.js

@@ -0,0 +1,86 @@
+/** Adapts native graph execution to the RELKIT workflow contract, carrying invocation context and scoped persistence through completion. */
+import { END, START } from "@langchain/langgraph";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { isFunctionGraphNode } from "@relkit/functions";
+import { getJsonSchema } from "@relkit/schema";
+import { isSubgraphNode, subgraphForNode } from "./graph-subgraph.js";
+import { graphWorkflowFailure } from "./graph-workflow-error.js";
+/** Projects a frozen serializable graph workflow from authoring nodes and edges.
+ * @param nodes - Validated graph nodes.
+ * @param edges - Validated graph edge operations.
+ * @returns An Effect with a workflow or GraphWorkflowFailure.
+ * @example Effect.runSync(graphWorkflowEffect(nodes, edges));
+ */
+export const graphWorkflowEffect = Effect.fn("Agents.graph.workflow")((nodes, edges) => Effect.try({
+    try: () => Object.freeze({
+        version: 1,
+        start: START,
+        end: END,
+        nodes: Object.freeze(nodes.map(workflowNode)),
+        edges: Object.freeze(edges.map(workflowEdge)),
+    }),
+    catch: graphWorkflowFailure,
+}), (effect) => observeAgent("graph.workflow", effect));
+/** Projects a workflow for existing synchronous graph callers.
+ * @param nodes - Validated graph nodes.
+ * @param edges - Validated graph edge operations.
+ * @returns A frozen serializable workflow.
+ * @throws The original node or schema projection error.
+ * @example graphWorkflow(nodes, edges);
+ */
+export function graphWorkflow(nodes, edges) {
+    return Effect.runSync(graphWorkflowEffect(nodes, edges).pipe(Effect.catchTag("GraphWorkflowFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Checks whether any graph node has a resumable continuation.
+ * @param workflow - Frozen graph workflow.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(graphWorkflowRequiresPersistenceEffect(workflow));
+ */
+export const graphWorkflowRequiresPersistenceEffect = Effect.fn("Agents.graph.requiresPersistence")((workflow) => Effect.sync(() => requiresPersistence(workflow)), (effect) => observeAgent("graph.requires-persistence", effect));
+/** Checks persistence needs for existing synchronous graph callers.
+ * @param workflow - Frozen graph workflow.
+ * @returns Whether any node has a resumable continuation.
+ * @example graphWorkflowRequiresPersistence(workflow);
+ */
+export function graphWorkflowRequiresPersistence(workflow) {
+    return Effect.runSync(graphWorkflowRequiresPersistenceEffect(workflow));
+}
+function requiresPersistence(workflow) {
+    return workflow.nodes.some((node) => node.resume !== undefined ||
+        (node.workflow !== undefined && requiresPersistence(node.workflow)));
+}
+function workflowNode(node) {
+    const subgraph = isSubgraphNode(node);
+    return Object.freeze({
+        id: node.id,
+        kind: subgraph ? "subgraph" : isFunctionGraphNode(node) ? "function" : "node",
+        input: schemaValue(node.input),
+        output: schemaValue(node.output),
+        ...(!isFunctionGraphNode(node) && !subgraph && node.resume !== undefined
+            ? { resume: schemaValue(node.resume) }
+            : {}),
+        ends: Object.freeze(isFunctionGraphNode(node) ? [] : [...node.ends]),
+        ...(isFunctionGraphNode(node) ? { targetFunctionId: node.target.id } : {}),
+        ...(subgraph ? { workflow: subgraphForNode(node).workflow } : {}),
+    });
+}
+function workflowEdge(edge) {
+    if (edge.kind === "edge") {
+        return Object.freeze(Array.isArray(edge.start)
+            ? { kind: "join", from: Object.freeze([...edge.start]), to: edge.end }
+            : { kind: "edge", from: edge.start, to: edge.end });
+    }
+    const routes = Object.freeze(Object.entries(edge.destinations ?? {}).map(([label, to]) => Object.freeze({ label, to })));
+    return Object.freeze({
+        kind: "conditional",
+        from: edge.source,
+        routes,
+        dynamic: edge.destinations === undefined,
+    });
+}
+function schemaValue(schema) {
+    const result = getJsonSchema(schema);
+    return result.ok ? result.schema : null;
+}
+//# sourceMappingURL=graph-workflow.js.map

package/dist/graph-workflow.js.map

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

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

@@ -0,0 +1,41 @@
+/** Adapts native graph execution to the RELKIT workflow contract, carrying invocation context and scoped persistence through completion. This companion preserves the native input and output types without starting runtime work. */
+import type { END, START } from "@langchain/langgraph";
+import type { JsonValue } from "@relkit/contracts";
+/** Serializable node entry in an agent graph workflow. */
+export interface GraphWorkflowNode {
+    readonly id: string;
+    readonly kind: "node" | "function" | "subgraph";
+    readonly input: JsonValue;
+    readonly output: JsonValue;
+    readonly resume?: JsonValue;
+    readonly ends: readonly string[];
+    readonly targetFunctionId?: string;
+    readonly workflow?: GraphWorkflow;
+}
+/** Serializable static, join, or conditional graph edge. */
+export type GraphWorkflowEdge = {
+    readonly kind: "edge";
+    readonly from: string;
+    readonly to: string;
+} | {
+    readonly kind: "join";
+    readonly from: readonly string[];
+    readonly to: string;
+} | {
+    readonly kind: "conditional";
+    readonly from: string;
+    readonly routes: readonly {
+        readonly label: string;
+        readonly to: string;
+    }[];
+    readonly dynamic: boolean;
+};
+/** Immutable serializable graph topology for runtime and clients. */
+export interface GraphWorkflow {
+    readonly version: 1;
+    readonly start: typeof START;
+    readonly end: typeof END;
+    readonly nodes: readonly GraphWorkflowNode[];
+    readonly edges: readonly GraphWorkflowEdge[];
+}
+//# sourceMappingURL=graph-workflow.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-workflow.types.d.ts","sourceRoot":"","sources":["../src/graph-workflow.types.ts"],"names":[],"mappings":"AAAA,sOAAsO;AAEtO,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;CACnC;AAED,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAChF;IACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEN,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C"}

package/dist/graph-workflow.types.js

@@ -0,0 +1,3 @@
+/** Adapts native graph execution to the RELKIT workflow contract, carrying invocation context and scoped persistence through completion. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=graph-workflow.types.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/** Publishes the explicit LangChain integration authoring and execution surface; generic application imports remain owned by the SDK-free agents package. */
+export * from "./define-agent.js";
+export * from "./define-graph-node.js";
+export * from "./define-graph.js";
+export * from "./define-persistence.js";
+export * from "./graph-edges.js";
+export * from "./graph-workflow.js";
+export * from "./graph-runtime.js";
+export { validateGraphResumeInput } from "./graph-continuation.js";
+export { validateNativeAgentResumeInput } from "./native-agent-interruption.js";
+export * from "./graph-persistence.js";
+export * from "./graph-subgraph.js";
+export * from "./graph-interruption.js";
+export * from "@relkit/agents/internal/agent-client";
+export * from "@relkit/agents/internal/client-events";
+export * from "@relkit/agents/internal/approval";
+export * from "@relkit/agents/internal/generated-function";
+export { createGeneratedAgentFunction } from "@relkit/agents/internal/generated-function";
+export * from "./runtime.js";
+export * from "./runtime-service.js";
+export { assertAgentRuntimeDependencies } from "./runtime-dependencies.js";
+export * from "@relkit/agents/internal/runtime-events";
+export * from "@relkit/agents/internal/observability";
+export * from "@relkit/agents/internal/agent-telemetry";
+export * from "@relkit/agents/internal/model-selection";
+export type * from "@relkit/agents/internal/state-control-requests.types";
+export type * from "@relkit/agents/internal/state-provider.types";
+export type * from "@relkit/agents/internal/state-receipts.types";
+export type * from "@relkit/agents/internal/state-thread-requests.types";
+export * from "@relkit/agents/internal/state.types";
+export * from "@relkit/agents/internal/thread-transition";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6JAA6J;AAE7J,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,mBAAmB,sDAAsD,CAAC;AAC1E,mBAAmB,8CAA8C,CAAC;AAClE,mBAAmB,8CAA8C,CAAC;AAClE,mBAAmB,qDAAqD,CAAC;AACzE,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/** Publishes the explicit LangChain integration authoring and execution surface; generic application imports remain owned by the SDK-free agents package. */
+export * from "./define-agent.js";
+export * from "./define-graph-node.js";
+export * from "./define-graph.js";
+export * from "./define-persistence.js";
+export * from "./graph-edges.js";
+export * from "./graph-workflow.js";
+export * from "./graph-runtime.js";
+export { validateGraphResumeInput } from "./graph-continuation.js";
+export { validateNativeAgentResumeInput } from "./native-agent-interruption.js";
+export * from "./graph-persistence.js";
+export * from "./graph-subgraph.js";
+export * from "./graph-interruption.js";
+export * from "@relkit/agents/internal/agent-client";
+export * from "@relkit/agents/internal/client-events";
+export * from "@relkit/agents/internal/approval";
+export * from "@relkit/agents/internal/generated-function";
+export { createGeneratedAgentFunction } from "@relkit/agents/internal/generated-function";
+export * from "./runtime.js";
+export * from "./runtime-service.js";
+export { assertAgentRuntimeDependencies } from "./runtime-dependencies.js";
+export * from "@relkit/agents/internal/runtime-events";
+export * from "@relkit/agents/internal/observability";
+export * from "@relkit/agents/internal/agent-telemetry";
+export * from "@relkit/agents/internal/model-selection";
+export * from "@relkit/agents/internal/state.types";
+export * from "@relkit/agents/internal/thread-transition";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6JAA6J;AAE7J,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AAKxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC"}

package/dist/native-agent-interruption-error.d.ts

@@ -0,0 +1,17 @@
+/** Defines failures for native agent interrupt handling so malformed interruption data stays distinct from normal approval suspension. */
+import { Schema } from "effect";
+declare const NativeAgentInterruptionFailure_base: Schema.Class<NativeAgentInterruptionFailure, Schema.TaggedStruct<"NativeAgentInterruptionFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** Tagged native agent continuation or state failure. */
+export declare class NativeAgentInterruptionFailure extends NativeAgentInterruptionFailure_base {
+}
+/** Wraps a native continuation failure for Effect callers.
+ * @param cause - Invalid reply or native state provider failure.
+ * @returns A tagged native agent interruption failure.
+ * @example nativeAgentInterruptionFailure(new TypeError("invalid reply"));
+ */
+export declare function nativeAgentInterruptionFailure(cause: unknown): NativeAgentInterruptionFailure;
+export {};
+//# sourceMappingURL=native-agent-interruption-error.d.ts.map

package/dist/native-agent-interruption-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-agent-interruption-error.d.ts","sourceRoot":"","sources":["../src/native-agent-interruption-error.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAE1I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,yDAAyD;AACzD,qBAAa,8BAA+B,SAAQ,mCAGnD;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CAK7F"}