@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/graph-runtime-error.js

@@ -0,0 +1,17 @@
+/** Translates native graph execution failures into the RELKIT graph error boundary while preserving their original causes. */
+import { Schema } from "effect";
+/** Tagged graph invocation failure with the original runtime cause. */
+export class GraphInvocationFailure extends Schema.TaggedError()("GraphInvocationFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Preserves a graph invocation failure for Effect callers.
+ * @param cause - Graph, schema, provider, or cancellation error.
+ * @returns A tagged graph invocation failure.
+ * @example graphInvocationFailure(new Error("graph failed"));
+ */
+export function graphInvocationFailure(cause) {
+    return new GraphInvocationFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=graph-runtime-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-error.js","sourceRoot":"","sources":["../src/graph-runtime-error.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAE9H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,uEAAuE;AACvE,MAAM,OAAO,sBAAuB,SAAQ,MAAM,CAAC,WAAW,EAA0B,CACtF,wBAAwB,EACxB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,IAAI,sBAAsB,CAAC;QAChC,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-runtime-execution.d.ts

@@ -0,0 +1,28 @@
+/** Runs a compiled graph within the invocation context, coordinating input, continuation and persistence before projecting final output. */
+import { Effect } from "effect";
+import { GraphInvocationFailure } from "./graph-runtime-error.js";
+import type { GraphRuntimeOptions } from "./graph-runtime.types.js";
+/** Runs one compiled graph with persistence and a linked invocation scope.
+ * @param options - Graph and runtime integrations.
+ * @param input - Validated invocation input.
+ * @param signal - Invocation cancellation signal.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param maxOutputBytes - Output byte cap.
+ * @returns An Effect with graph output or GraphInvocationFailure.
+ * @example await Effect.runPromise(runCompiledGraphEffect(options, input, signal, id, trace, 1024));
+ */
+export declare const runCompiledGraphEffect: (options: GraphRuntimeOptions, input: unknown, signal: AbortSignal, invocationId: string, traceId: string, maxOutputBytes: number) => Effect.Effect<import("@relkit/contracts").JsonValue, GraphInvocationFailure, never>;
+/** Runs a compiled graph for existing Promise callers.
+ * @param options - Graph and runtime integrations.
+ * @param input - Validated invocation input.
+ * @param signal - Invocation cancellation signal.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param maxOutputBytes - Output byte cap.
+ * @returns Validated graph output or a waiting interruption.
+ * @throws The original graph, persistence, output, or cancellation error.
+ * @example await runCompiledGraph(options, input, signal, id, trace, 1024);
+ */
+export declare function runCompiledGraph(options: GraphRuntimeOptions, input: unknown, signal: AbortSignal, invocationId: string, traceId: string, maxOutputBytes: number): Promise<unknown>;
+//# sourceMappingURL=graph-runtime-execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-execution.d.ts","sourceRoot":"","sources":["../src/graph-runtime-execution.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAG5I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,0BAA0B,CAAC;AAE1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAKpE;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,2NAiDlC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/graph-runtime-execution.js

@@ -0,0 +1,69 @@
+/** Runs a compiled graph within the invocation context, coordinating input, continuation and persistence before projecting final output. */
+import { currentInvocationScope, runInInvocationScope } from "@relkit/invocation";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { compileGraphEffect } from "./graph-compile.js";
+import { graphConfigEffect } from "./graph-continuation.js";
+import { resolveGraphPersistenceEffect } from "./graph-persistence.js";
+import { GraphInvocationFailure, graphInvocationFailure } from "./graph-runtime-error.js";
+import { streamCompiledGraphEffect } from "./graph-runtime-stream.js";
+import { graphWorkflowRequiresPersistenceEffect } from "./graph-workflow.js";
+import { createAgentInvocationDispatcherEffect } from "./runtime-tool-dispatcher.js";
+import { signalFailure } from "./signal.js";
+/** Runs one compiled graph with persistence and a linked invocation scope.
+ * @param options - Graph and runtime integrations.
+ * @param input - Validated invocation input.
+ * @param signal - Invocation cancellation signal.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param maxOutputBytes - Output byte cap.
+ * @returns An Effect with graph output or GraphInvocationFailure.
+ * @example await Effect.runPromise(runCompiledGraphEffect(options, input, signal, id, trace, 1024));
+ */
+export const runCompiledGraphEffect = Effect.fn("Agents.graph.runCompiled")(function* (options, input, signal, invocationId, traceId, maxOutputBytes) {
+    if (signal.aborted)
+        return yield* Effect.fail(graphInvocationFailure(signalFailure(signal)));
+    const persistence = yield* runnableGraphPersistenceEffect(options);
+    const graph = yield* compileGraphEffect(options.agent, persistence).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    const config = yield* graphConfigEffect(options.agent, options.threadId).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    const current = yield* Effect.sync(() => currentInvocationScope());
+    const dispatcher = current?.dispatcher ??
+        (yield* createAgentInvocationDispatcherEffect(options.engine, options, invocationId, traceId, options.parentSpanId, signal));
+    return yield* Effect.tryPromise({
+        try: (effectSignal) => {
+            const combined = AbortSignal.any([signal, effectSignal]);
+            const scope = current === undefined
+                ? { dispatcher, parent: { id: invocationId, traceId, signal: combined } }
+                : current;
+            return Promise.resolve(runInInvocationScope(scope, () => Effect.runPromise(streamCompiledGraphEffect(options, graph, config, input, combined, maxOutputBytes), { signal: combined })));
+        },
+        catch: (cause) => graphInvocationFailure(cause instanceof GraphInvocationFailure ? cause.cause : cause),
+    });
+}, (effect) => observeAgent("graph.run-compiled", effect));
+/** Runs a compiled graph for existing Promise callers.
+ * @param options - Graph and runtime integrations.
+ * @param input - Validated invocation input.
+ * @param signal - Invocation cancellation signal.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param maxOutputBytes - Output byte cap.
+ * @returns Validated graph output or a waiting interruption.
+ * @throws The original graph, persistence, output, or cancellation error.
+ * @example await runCompiledGraph(options, input, signal, id, trace, 1024);
+ */
+export function runCompiledGraph(options, input, signal, invocationId, traceId, maxOutputBytes) {
+    return Effect.runPromise(runCompiledGraphEffect(options, input, signal, invocationId, traceId, maxOutputBytes).pipe(Effect.catchTag("GraphInvocationFailure", (failure) => Effect.fail(signal.aborted ? signalFailure(signal) : failure.cause))), { signal });
+}
+/** Requires a checkpointer when graph nodes declare resumable waiting.
+ * @param options - Native graph and environment bindings.
+ * @returns Resolved persistence or the original graph failure.
+ */
+const runnableGraphPersistenceEffect = Effect.fn("Agents.graph.runnablePersistence")(function* (options) {
+    const persistence = yield* resolveGraphPersistenceEffect(options.agent, options.environment ?? {}).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    if (persistence.checkpointer === undefined &&
+        (yield* graphWorkflowRequiresPersistenceEffect(options.agent.workflow))) {
+        return yield* Effect.fail(graphInvocationFailure(new TypeError("Graphs with resumable nodes require a checkpointer")));
+    }
+    return persistence;
+});
+//# sourceMappingURL=graph-runtime-execution.js.map

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

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

package/dist/graph-runtime-identity.d.ts

@@ -0,0 +1,15 @@
+/** Derives graph invocation, thread and checkpoint identity used consistently by native execution and persisted continuation lookup. */
+import { Context, Layer } from "effect";
+import type { GraphInvocationIdentityService } from "./graph-runtime-identity.types.js";
+declare const GraphInvocationIdentity_base: Context.ServiceClass<GraphInvocationIdentity, "relkit/agents/GraphInvocationIdentity", GraphInvocationIdentityService>;
+/** Substitutable random source for graph invocation IDs.
+ * @example Effect.provide(invokeGraphEffect(options), GraphInvocationIdentityLive);
+ */
+export declare class GraphInvocationIdentity extends GraphInvocationIdentity_base {
+}
+/** Live graph invocation identity source.
+ * @example Effect.runPromise(Effect.provide(invokeGraphEffect(options), GraphInvocationIdentityLive));
+ */
+export declare const GraphInvocationIdentityLive: Layer.Layer<GraphInvocationIdentity, never, never>;
+export {};
+//# sourceMappingURL=graph-runtime-identity.d.ts.map

package/dist/graph-runtime-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-identity.d.ts","sourceRoot":"","sources":["../src/graph-runtime-identity.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAExI,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;;AAExF;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,4BAGD;CAAG;AAE/C;;GAEG;AACH,eAAO,MAAM,2BAA2B,oDAEtC,CAAC"}

package/dist/graph-runtime-identity.js

@@ -0,0 +1,14 @@
+/** Derives graph invocation, thread and checkpoint identity used consistently by native execution and persisted continuation lookup. */
+import { Context, Layer } from "effect";
+/** Substitutable random source for graph invocation IDs.
+ * @example Effect.provide(invokeGraphEffect(options), GraphInvocationIdentityLive);
+ */
+export class GraphInvocationIdentity extends Context.Service()("relkit/agents/GraphInvocationIdentity") {
+}
+/** Live graph invocation identity source.
+ * @example Effect.runPromise(Effect.provide(invokeGraphEffect(options), GraphInvocationIdentityLive));
+ */
+export const GraphInvocationIdentityLive = Layer.succeed(GraphInvocationIdentity, {
+    randomUUID: () => crypto.randomUUID(),
+});
+//# sourceMappingURL=graph-runtime-identity.js.map

package/dist/graph-runtime-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-identity.js","sourceRoot":"","sources":["../src/graph-runtime-identity.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAExI,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGxC;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,OAAO,CAAC,OAAO,EAGzD,CAAC,uCAAuC,CAAC;CAAG;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC,OAAO,CAAC,uBAAuB,EAAE;IAChF,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;CACtC,CAAC,CAAC"}

package/dist/graph-runtime-identity.types.d.ts

@@ -0,0 +1,5 @@
+/** Random identity source used by graph invocation Effects. */
+export interface GraphInvocationIdentityService {
+    readonly randomUUID: () => string;
+}
+//# sourceMappingURL=graph-runtime-identity.types.d.ts.map

package/dist/graph-runtime-identity.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-identity.types.d.ts","sourceRoot":"","sources":["../src/graph-runtime-identity.types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;CACnC"}

package/dist/graph-runtime-identity.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph-runtime-identity.types.js.map

package/dist/graph-runtime-identity.types.js.map

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

package/dist/graph-runtime-stream-state.d.ts

@@ -0,0 +1,8 @@
+import { Effect } from "effect";
+import type { CompiledGraphStreamContext } from "./graph-runtime-stream.types.js";
+/** Collects the original native events before settling public graph state.
+ * @param context - Already acquired stream, graph and cancellation owner.
+ * @returns Validated output or the same interruption/failure.
+ */
+export declare const collectCompiledGraphStateEffect: (context: CompiledGraphStreamContext) => Effect.Effect<import("@relkit/contracts").JsonValue, import("./graph-runtime-error.js").GraphInvocationFailure, never>;
+//# sourceMappingURL=graph-runtime-stream-state.d.ts.map

package/dist/graph-runtime-stream-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-stream-state.d.ts","sourceRoot":"","sources":["../src/graph-runtime-stream-state.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAahC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,iKA2B1C,CAAC"}

package/dist/graph-runtime-stream-state.js

@@ -0,0 +1,67 @@
+/**
+ * Collects graph state, waiting requests and validated output from an already
+ * acquired native stream. Its caller retains stream abort/finalization ownership.
+ */
+import { isInterrupted } from "@langchain/langgraph";
+import { Effect } from "effect";
+import { graphExecutionEffect } from "./define-graph.js";
+import { waitingInterruptsEffect } from "./graph-continuation.js";
+import { GraphInterruptedError, graphWaitingResponse, publicWaitingRequests, } from "./graph-interruption.js";
+import { graphInvocationFailure } from "./graph-runtime-error.js";
+import { collectNativeEventsEffect } from "./runtime-native-events.js";
+import { selectedStateSchemasEffect } from "./runtime-state-schemas.js";
+import { jsonValueEffect, validateValueEffect } from "./runtime-utils.js";
+import { withSignal } from "./signal.js";
+/** Collects the original native events before settling public graph state.
+ * @param context - Already acquired stream, graph and cancellation owner.
+ * @returns Validated output or the same interruption/failure.
+ */
+export const collectCompiledGraphStateEffect = Effect.fn("Agents.graph.collectStream")(function* (context) {
+    const { options, graph, config, signal, run } = context;
+    const execution = yield* graphExecutionEffect(options.agent);
+    const stateSchemas = yield* selectedStateSchemasEffect([execution.state], options.agent.client?.state ?? []).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    yield* collectNativeEventsEffect(run, options.contentSink, new Map(), new Set(), signal, options.agent.limits, stateSchemas, () => undefined, undefined, (reason) => run.abort(reason), options.agent.client?.events).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    const state = yield* Effect.tryPromise({
+        try: () => withSignal(run.output, signal),
+        catch: graphInvocationFailure,
+    });
+    return yield* settleCompiledGraphStateEffect(context, state);
+});
+/** Emits waiting data or final validated state using the original byte limits.
+ * @param context - Existing graph execution owner.
+ * @param state - Native final graph state awaiting validation.
+ * @returns Validated output or graph interruption.
+ */
+const settleCompiledGraphStateEffect = Effect.fn("Agents.graph.settleStream")(function* (context, state) {
+    const { options, signal, maxOutputBytes } = context;
+    if (isInterrupted(state))
+        return yield* emitCompiledGraphWaitingEffect(context);
+    const validated = yield* validateValueEffect(options.agent.output, state, "output").pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    const output = yield* jsonValueEffect(validated, maxOutputBytes, "graph output").pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    yield* Effect.tryPromise({
+        try: () => withSignal(options.contentSink?.emitOutput(output, signal), signal),
+        catch: graphInvocationFailure,
+    });
+    yield* Effect.tryPromise({
+        try: () => withSignal(options.contentSink?.finishOutput?.(signal), signal),
+        catch: graphInvocationFailure,
+    });
+    return output;
+});
+/** Publishes interruption requests before returning the original waiting failure.
+ * @param context - Existing graph checkpoint identity and sink.
+ * @returns The original tagged graph interruption.
+ */
+const emitCompiledGraphWaitingEffect = Effect.fn("Agents.graph.emitWaiting")(function* (context) {
+    const { options, graph, config, signal } = context;
+    const interrupts = yield* waitingInterruptsEffect(graph, options.agent, config).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    yield* Effect.tryPromise({
+        try: () => withSignal(options.contentSink?.emitWaiting?.({
+            response: graphWaitingResponse(interrupts),
+            requests: publicWaitingRequests(interrupts),
+        }, signal), signal),
+        catch: graphInvocationFailure,
+    });
+    return yield* Effect.fail(graphInvocationFailure(new GraphInterruptedError(options.threadId, interrupts)));
+});
+//# sourceMappingURL=graph-runtime-stream-state.js.map

package/dist/graph-runtime-stream-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-stream-state.js","sourceRoot":"","sources":["../src/graph-runtime-stream-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,EAC9F,OAAmC;IAEnC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,0BAA0B,CACpD,CAAC,SAAS,CAAC,KAAK,CAAC,EACjB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAClC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5E,KAAK,CAAC,CAAC,yBAAyB,CAC9B,GAAG,EACH,OAAO,CAAC,WAAW,EACnB,IAAI,GAAG,EAAE,EACT,IAAI,GAAG,EAAE,EACT,MAAM,EACN,OAAO,CAAC,KAAK,CAAC,MAAM,EACpB,YAAY,EACZ,GAAG,EAAE,CAAC,SAAS,EACf,SAAS,EACT,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAC7B,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACrC,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;QACzC,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,CAAC,8BAA8B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,8BAA8B,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC,EACrF,OAAmC,EACnC,KAAc;IAEd,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACpD,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CACtF,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,IAAI,CACnF,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;IACF,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAC9E,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAC1E,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,8BAA8B,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EACpF,OAAmC;IAEnC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,CAClF,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;IACF,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE,CACR,UAAU,CACR,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,CAChC;YACE,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC;YAC1C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC;SAC5C,EACD,MAAM,CACP,EACD,MAAM,CACP;QACH,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,sBAAsB,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,QAAS,EAAE,UAAU,CAAC,CAAC,CACjF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/graph-runtime-stream.d.ts

@@ -0,0 +1,16 @@
+/** Consumes native graph streams and publishes RELKIT execution events, finalizing the native iterator before settling the invocation. */
+import { Effect } from "effect";
+import type { GraphConfig } from "./graph-continuation.types.js";
+import type { GraphRuntimeOptions } from "./graph-runtime.types.js";
+/** Streams one compiled graph and validates its final public output.
+ * @param options - Graph runtime and content sinks.
+ * @param graph - Compiled native graph.
+ * @param config - Persistent graph configuration.
+ * @param input - Validated invocation input.
+ * @param signal - Linked invocation cancellation signal.
+ * @param maxOutputBytes - Maximum serialized output size.
+ * @returns An Effect with graph output or GraphInvocationFailure.
+ * @example await Effect.runPromise(streamCompiledGraphEffect(options, graph, config, input, signal, 1024));
+ */
+export declare const streamCompiledGraphEffect: (options: GraphRuntimeOptions, graph: any, config: GraphConfig, input: unknown, signal: AbortSignal, maxOutputBytes: number) => Effect.Effect<import("@relkit/contracts").JsonValue, import("./graph-runtime-error.js").GraphInvocationFailure, never>;
+//# sourceMappingURL=graph-runtime-stream.d.ts.map

package/dist/graph-runtime-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-stream.d.ts","sourceRoot":"","sources":["../src/graph-runtime-stream.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAI1I,OAAO,EAAE,MAAM,EAAQ,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAOjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAOpE;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,wPA0CrC,CAAC"}

package/dist/graph-runtime-stream.js

@@ -0,0 +1,49 @@
+/** Consumes native graph streams and publishes RELKIT execution events, finalizing the native iterator before settling the invocation. */
+import { collectCompiledGraphStateEffect } from "./graph-runtime-stream-state.js";
+import { isInterrupted } from "@langchain/langgraph";
+import { Effect, Exit } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { graphExecutionEffect } from "./define-graph.js";
+import { resumeCommandEffect, waitingInterruptsEffect } from "./graph-continuation.js";
+import { GraphInterruptedError, graphWaitingResponse, publicWaitingRequests, } from "./graph-interruption.js";
+import { graphInvocationFailure } from "./graph-runtime-error.js";
+import { collectNativeEventsEffect } from "./runtime-native-events.js";
+import { selectedStateSchemasEffect } from "./runtime-state-schemas.js";
+import { jsonValueEffect, validateValueEffect } from "./runtime-utils.js";
+import { signalFailure, withSignal } from "./signal.js";
+/** Streams one compiled graph and validates its final public output.
+ * @param options - Graph runtime and content sinks.
+ * @param graph - Compiled native graph.
+ * @param config - Persistent graph configuration.
+ * @param input - Validated invocation input.
+ * @param signal - Linked invocation cancellation signal.
+ * @param maxOutputBytes - Maximum serialized output size.
+ * @returns An Effect with graph output or GraphInvocationFailure.
+ * @example await Effect.runPromise(streamCompiledGraphEffect(options, graph, config, input, signal, 1024));
+ */
+export const streamCompiledGraphEffect = Effect.fn("Agents.graph.streamCompiled")(function* (options, graph, config, input, signal, maxOutputBytes) {
+    if (signal.aborted)
+        return yield* Effect.fail(graphInvocationFailure(signalFailure(signal)));
+    const nativeInput = options.resume
+        ? yield* resumeCommandEffect(graph, options.agent, config, input).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)))
+        : input;
+    const run = yield* Effect.tryPromise({
+        try: () => withSignal(graph.streamEvents(nativeInput, {
+            version: "v3",
+            signal,
+            recursionLimit: options.agent.limits.maxSteps,
+            ...config,
+        }), signal),
+        catch: graphInvocationFailure,
+    });
+    const context = { options, graph, config, input, signal, maxOutputBytes, run };
+    return yield* collectCompiledGraphStateEffect(context).pipe(Effect.onExit((exit) => Exit.isFailure(exit)
+        ? Effect.sync(() => {
+            try {
+                run.abort(signalFailure(signal));
+            }
+            catch { }
+        })
+        : Effect.void));
+}, (effect) => observeAgent("graph.stream-compiled", effect));
+//# sourceMappingURL=graph-runtime-stream.js.map

package/dist/graph-runtime-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-stream.js","sourceRoot":"","sources":["../src/graph-runtime-stream.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAE1I,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGxD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAC/E,QAAQ,CAAC,EACP,OAA4B,EAC5B,KAAsC,EACtC,MAAmB,EACnB,KAAc,EACd,MAAmB,EACnB,cAAsB;IAEtB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM;QAChC,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAClE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpE;QACH,CAAC,CAAC,KAAK,CAAC;IACV,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACnC,GAAG,EAAE,GAAG,EAAE,CACR,UAAU,CACR,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE;YAC9B,OAAO,EAAE,IAAI;YACb,MAAM;YACN,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ;YAC7C,GAAG,MAAM;SACV,CAAC,EACF,MAAM,CACP;QACH,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;IAC/E,OAAO,KAAK,CAAC,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC,IAAI,CACzD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACrB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACf,IAAI,CAAC;gBACH,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC,CAAC;QACJ,CAAC,CAAC,MAAM,CAAC,IAAI,CAChB,CACF,CAAC;AACJ,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAC1D,CAAC"}

package/dist/graph-runtime-stream.types.d.ts

@@ -0,0 +1,13 @@
+/** Acquired native stream and public sinks retained by one graph invocation. */
+import type { compileGraph } from "./graph-compile.js";
+import type { GraphConfig } from "./graph-continuation.types.js";
+import type { GraphRuntimeOptions } from "./graph-runtime.types.js";
+export interface CompiledGraphStreamContext {
+    readonly options: GraphRuntimeOptions;
+    readonly graph: ReturnType<typeof compileGraph>;
+    readonly config: GraphConfig;
+    readonly signal: AbortSignal;
+    readonly maxOutputBytes: number;
+    readonly run: Awaited<ReturnType<ReturnType<typeof compileGraph>["streamEvents"]>>;
+}
+//# sourceMappingURL=graph-runtime-stream.types.d.ts.map

package/dist/graph-runtime-stream.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime-stream.types.d.ts","sourceRoot":"","sources":["../src/graph-runtime-stream.types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CACpF"}

package/dist/graph-runtime-stream.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph-runtime-stream.types.js.map

package/dist/graph-runtime-stream.types.js.map

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

package/dist/graph-runtime.d.ts

@@ -0,0 +1,21 @@
+/** Composes graph compilation, scoped persistence and execution into the native invocation entrypoint, retaining stream and continuation behavior. */
+import { Effect } from "effect";
+import { GraphInvocationIdentity } from "./graph-runtime-identity.js";
+import type { GraphRuntimeOptions } from "./graph-runtime.types.js";
+export type { GraphRuntimeOptions } from "./graph-runtime.types.js";
+export { GraphInvocationFailure } from "./graph-runtime-error.js";
+export { GraphInvocationIdentity, GraphInvocationIdentityLive } from "./graph-runtime-identity.js";
+/** Invokes a graph with scoped signal cleanup and linked Effect cancellation.
+ * @param options - Graph, engine, input, and invocation integrations.
+ * @returns An Effect with graph output or GraphInvocationFailure.
+ * @example Effect.runPromise(Effect.provide(invokeGraphEffect(options), GraphInvocationIdentityLive));
+ */
+export declare const invokeGraphEffect: (options: GraphRuntimeOptions) => Effect.Effect<unknown, import("./graph-runtime-error.js").GraphInvocationFailure, GraphInvocationIdentity>;
+/** Invokes a graph for existing Promise runtime callers.
+ * @param options - Graph, engine, input, and invocation integrations.
+ * @returns Validated graph output.
+ * @throws The original graph, provider, validation, or cancellation error.
+ * @example await invokeGraph(options);
+ */
+export declare function invokeGraph(options: GraphRuntimeOptions): Promise<unknown>;
+//# sourceMappingURL=graph-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime.d.ts","sourceRoot":"","sources":["../src/graph-runtime.ts"],"names":[],"mappings":"AAAA,sJAAsJ;AAItJ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,OAAO,EAAE,uBAAuB,EAA+B,MAAM,6BAA6B,CAAC;AACnG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAKpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAEnG;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,8IAmD7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1E"}

package/dist/graph-runtime.js

@@ -0,0 +1,74 @@
+/** Composes graph compilation, scoped persistence and execution into the native invocation entrypoint, retaining stream and continuation behavior. */
+import { normalizeId } from "@relkit/contracts";
+import { frameworkTrace } from "@relkit/invocation";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { generatedAgentFunctionId } from "@relkit/agents/internal/generated-function";
+import { graphInvocationFailure } from "./graph-runtime-error.js";
+import { runCompiledGraph } from "./graph-runtime-execution.js";
+import { GraphInvocationIdentity, GraphInvocationIdentityLive } from "./graph-runtime-identity.js";
+import { resolveAgentContentLimitsEffect } from "./runtime-model.js";
+import { signalFailure, validateValue, withSignal } from "./runtime-utils.js";
+import { acquireExecutionSignalEffect, ExecutionSignalClockLive } from "./signal.js";
+export { GraphInvocationFailure } from "./graph-runtime-error.js";
+export { GraphInvocationIdentity, GraphInvocationIdentityLive } from "./graph-runtime-identity.js";
+/** Invokes a graph with scoped signal cleanup and linked Effect cancellation.
+ * @param options - Graph, engine, input, and invocation integrations.
+ * @returns An Effect with graph output or GraphInvocationFailure.
+ * @example Effect.runPromise(Effect.provide(invokeGraphEffect(options), GraphInvocationIdentityLive));
+ */
+export const invokeGraphEffect = Effect.fn("Agents.graph.invoke")(function* (options) {
+    const { invocationId, traceId } = yield* graphInvocationIdentityEffect(options);
+    const limits = yield* resolveAgentContentLimitsEffect(options).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)));
+    return yield* Effect.scoped(Effect.gen(function* () {
+        const execution = yield* acquireExecutionSignalEffect(options).pipe(Effect.mapError((failure) => graphInvocationFailure(failure.cause)), Effect.provide(ExecutionSignalClockLive));
+        return yield* Effect.tryPromise({
+            try: (effectSignal) => {
+                const signal = AbortSignal.any([execution.signal, effectSignal]);
+                return frameworkTrace.span(`relkit.agent.${options.agent.id}.invoke`, {
+                    input: options.input,
+                    attributes: {
+                        "relkit.agent.id": options.agent.id,
+                        "relkit.function.id": generatedAgentFunctionId(options.agent.id),
+                        "relkit.invocation.id": invocationId,
+                        "relkit.agent.execution": "graph",
+                    },
+                }, async () => {
+                    if (signal.aborted)
+                        throw signalFailure(signal);
+                    const input = options.resume
+                        ? options.input
+                        : await withSignal(validateValue(options.agent.input, options.input, "input"), signal);
+                    return runCompiledGraph(options, input, signal, invocationId, traceId, limits.maxOutputBytes);
+                });
+            },
+            catch: graphInvocationFailure,
+        });
+    }));
+}, (effect) => observeAgent("graph.invoke", effect));
+/** Invokes a graph for existing Promise runtime callers.
+ * @param options - Graph, engine, input, and invocation integrations.
+ * @returns Validated graph output.
+ * @throws The original graph, provider, validation, or cancellation error.
+ * @example await invokeGraph(options);
+ */
+export function invokeGraph(options) {
+    return Effect.runPromise(invokeGraphEffect(options).pipe(Effect.catchTag("GraphInvocationFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(GraphInvocationIdentityLive)));
+}
+/** Normalizes graph identities through the replaceable ID service.
+ * @param options - Caller identity overrides.
+ * @returns Stable invocation and trace IDs.
+ */
+const graphInvocationIdentityEffect = Effect.fn("Agents.graph.invocationIdentity")(function* (options) {
+    const identity = yield* GraphInvocationIdentity;
+    const invocationId = yield* Effect.try({
+        try: () => normalizeId(options.invocationId ?? `agent-${identity.randomUUID()}`),
+        catch: graphInvocationFailure,
+    });
+    const traceId = yield* Effect.try({
+        try: () => normalizeId(options.traceId ?? invocationId),
+        catch: graphInvocationFailure,
+    });
+    return { invocationId, traceId };
+});
+//# sourceMappingURL=graph-runtime.js.map

package/dist/graph-runtime.js.map

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

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

@@ -0,0 +1,8 @@
+/** Composes graph compilation, scoped persistence and execution into the native invocation entrypoint, retaining stream and continuation behavior. This companion preserves the native input and output types without starting runtime work. */
+import type { GraphDescriptor } from "./define-graph.js";
+import type { AgentInvocationOptions, AgentRuntimeOptions } from "./runtime.types.js";
+/** Runtime options for invoking a compiled graph descriptor. */
+export type GraphRuntimeOptions = AgentRuntimeOptions & AgentInvocationOptions & {
+    readonly agent: GraphDescriptor;
+};
+//# sourceMappingURL=graph-runtime.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-runtime.types.d.ts","sourceRoot":"","sources":["../src/graph-runtime.types.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAEhP,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GACnD,sBAAsB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC"}

package/dist/graph-runtime.types.js

@@ -0,0 +1,3 @@
+/** Composes graph compilation, scoped persistence and execution into the native invocation entrypoint, retaining stream and continuation behavior. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=graph-runtime.types.js.map

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

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

package/dist/graph-state-schema.d.ts

@@ -0,0 +1,35 @@
+/** Adapts authored state schemas to the native graph state contract and preserves the reducers and validated channel shapes required by compilation. */
+import { StateSchema, type AnyStateSchema } from "@langchain/langgraph";
+import { type StandardSchemaV1 } from "@relkit/schema";
+import { Effect, Schema } from "effect";
+declare const GraphStateSelectionError_base: Schema.Class<GraphStateSelectionError, Schema.TaggedStruct<"GraphStateSelectionError", {
+    readonly code: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Expected graph state projection failure in the Effect error channel. */
+export declare class GraphStateSelectionError extends GraphStateSelectionError_base {
+}
+/**
+ * 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 declare const selectGraphStateEffect: (state: AnyStateSchema, selection: StandardSchemaV1<unknown, unknown>) => Effect.Effect<StateSchema<Record<string, any>>, GraphStateSelectionError, never>;
+/**
+ * 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 declare function selectGraphState(state: AnyStateSchema, selection: StandardSchemaV1): AnyStateSchema;
+export {};
+//# sourceMappingURL=graph-state-schema.d.ts.map

package/dist/graph-state-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-state-schema.d.ts","sourceRoot":"","sources":["../src/graph-state-schema.ts"],"names":[],"mappings":"AAAA,wJAAwJ;AAExJ,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAOhD,2EAA2E;AAC3E,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,4JA+BlC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,gBAAgB,GAC1B,cAAc,CAUhB"}