@relkit/langchain 0.0.0-stage → 0.7.10

package/dist/persistence-error.js.map

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

package/dist/persistence-symbol.d.ts

@@ -0,0 +1,3 @@
+/** Shared marker used to recognize RELKIT persistence descriptors. */
+export declare const RELKIT_PERSISTENCE: unique symbol;
+//# sourceMappingURL=persistence-symbol.d.ts.map

package/dist/persistence-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-symbol.d.ts","sourceRoot":"","sources":["../src/persistence-symbol.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,eAAyC,CAAC"}

package/dist/persistence-symbol.js

@@ -0,0 +1,3 @@
+/** Shared marker used to recognize RELKIT persistence descriptors. */
+export const RELKIT_PERSISTENCE = Symbol.for("relkit.agent-persistence");
+//# sourceMappingURL=persistence-symbol.js.map

package/dist/persistence-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-symbol.js","sourceRoot":"","sources":["../src/persistence-symbol.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC"}

package/dist/runtime-approval-decision.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Converts supported approval reply forms to the canonical record while keeping
+ * approval policy, tracing and tool lifecycle in their existing owners.
+ */
+import { Effect } from "effect";
+import { type PendingApproval } from "@relkit/agents/internal/approval";
+/** Normalizes the supported reply forms without changing approval semantics.
+ * @param approval - Pending decision being resolved.
+ * @param response - Supported handler reply or canonical record.
+ * @returns Canonical decision or a tagged approval failure.
+ */
+export declare const resolveApprovalDecisionEffect: (approval: PendingApproval, response: boolean | "denied" | "approved" | import("@relkit/agents/internal/approval").ApprovalRecord) => Effect.Effect<import("@relkit/agents/internal/approval").ApprovalRecord, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+//# sourceMappingURL=runtime-approval-decision.d.ts.map

package/dist/runtime-approval-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-approval-decision.d.ts","sourceRoot":"","sources":["../src/runtime-approval-decision.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAI1C;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,mRAczC,CAAC"}

package/dist/runtime-approval-decision.js

@@ -0,0 +1,21 @@
+/**
+ * Converts supported approval reply forms to the canonical record while keeping
+ * approval policy, tracing and tool lifecycle in their existing owners.
+ */
+import { Effect } from "effect";
+import { approveApprovalEffect, denyApprovalEffect, } from "@relkit/agents/internal/approval";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+/** Normalizes the supported reply forms without changing approval semantics.
+ * @param approval - Pending decision being resolved.
+ * @param response - Supported handler reply or canonical record.
+ * @returns Canonical decision or a tagged approval failure.
+ */
+export const resolveApprovalDecisionEffect = Effect.fn("Agents.runtime.approvalDecision")(function* (approval, response) {
+    const decision = response === "approved" || response === true
+        ? yield* approveApprovalEffect(approval).pipe(Effect.mapError((failure) => agentInvocationFailure(failure.cause)))
+        : response === "denied" || response === false
+            ? yield* denyApprovalEffect(approval).pipe(Effect.mapError((failure) => agentInvocationFailure(failure.cause)))
+            : response;
+    return decision;
+});
+//# sourceMappingURL=runtime-approval-decision.js.map

package/dist/runtime-approval-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-approval-decision.js","sourceRoot":"","sources":["../src/runtime-approval-decision.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAEnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,EAAE,CAAC,iCAAiC,CAAC,CACvF,QAAQ,CAAC,EAAE,QAAyB,EAAE,QAAmD;IACvF,MAAM,QAAQ,GACZ,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,IAAI;QAC1C,CAAC,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,IAAI,CACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpE;QACH,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,KAAK;YAC3C,CAAC,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,IAAI,CACtC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACpE;YACH,CAAC,CAAC,QAAQ,CAAC;IACjB,OAAO,QAAQ,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/runtime-dependencies.d.ts

@@ -0,0 +1,7 @@
+import type { AgentDescriptor } from "./define-agent.js";
+/** Checks selected native capabilities and preserves the original loader failure and lifecycle.
+ * @param agents - Authored native agent descriptors whose requested capabilities determine peers.
+ * @returns The existing owned dependency check; optional native modules load only when selected.
+ */
+export declare function assertAgentRuntimeDependencies(agents: readonly AgentDescriptor<string, unknown, unknown>[]): Promise<void>;
+//# sourceMappingURL=runtime-dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-dependencies.d.ts","sourceRoot":"","sources":["../src/runtime-dependencies.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/runtime-dependencies.js

@@ -0,0 +1,10 @@
+/** Exposes dependency preflight without making optional DeepAgents declarations part of ordinary native authoring. */
+import { assertAgentRuntimeDependencies as assertNativeDependencies } from "./runtime-native-support.js";
+/** Checks selected native capabilities and preserves the original loader failure and lifecycle.
+ * @param agents - Authored native agent descriptors whose requested capabilities determine peers.
+ * @returns The existing owned dependency check; optional native modules load only when selected.
+ */
+export function assertAgentRuntimeDependencies(agents) {
+    return assertNativeDependencies(agents);
+}
+//# sourceMappingURL=runtime-dependencies.js.map

package/dist/runtime-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-dependencies.js","sourceRoot":"","sources":["../src/runtime-dependencies.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,OAAO,EAAE,8BAA8B,IAAI,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGzG;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAA4D;IAE5D,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/runtime-effect-error.d.ts

@@ -0,0 +1,18 @@
+/** Normalizes Effect failures from native invocation adapters while retaining the original failure cause at the public runtime boundary. */
+import { Schema } from "effect";
+declare const AgentInvocationFailure_base: Schema.Class<AgentInvocationFailure, Schema.TaggedStruct<"AgentInvocationFailure", {
+    readonly code: Schema.String;
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** A typed Effect failure that retains the public invocation error as its cause. */
+export declare class AgentInvocationFailure extends AgentInvocationFailure_base {
+}
+/** Captures an invocation failure without losing compatibility error details.
+ * @param cause - Rejected dependency, validation, or runtime error.
+ * @returns A tagged failure carrying its original cause.
+ * @example agentInvocationFailure(new Error("model unavailable"));
+ */
+export declare function agentInvocationFailure(cause: unknown): AgentInvocationFailure;
+export {};
+//# sourceMappingURL=runtime-effect-error.d.ts.map

package/dist/runtime-effect-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-effect-error.d.ts","sourceRoot":"","sources":["../src/runtime-effect-error.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAE5I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;AAGhC,oFAAoF;AACpF,qBAAa,sBAAuB,SAAQ,2BAG3C;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAM7E"}

package/dist/runtime-effect-error.js

@@ -0,0 +1,19 @@
+/** Normalizes Effect failures from native invocation adapters while retaining the original failure cause at the public runtime boundary. */
+import { Schema } from "effect";
+import { AgentRuntimeError } from "./runtime-errors.js";
+/** A typed Effect failure that retains the public invocation error as its cause. */
+export class AgentInvocationFailure extends Schema.TaggedError()("AgentInvocationFailure", { code: Schema.String, message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Captures an invocation failure without losing compatibility error details.
+ * @param cause - Rejected dependency, validation, or runtime error.
+ * @returns A tagged failure carrying its original cause.
+ * @example agentInvocationFailure(new Error("model unavailable"));
+ */
+export function agentInvocationFailure(cause) {
+    return new AgentInvocationFailure({
+        code: cause instanceof AgentRuntimeError ? cause.code : "RELKIT_AGENT_INVOCATION_FAILED",
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=runtime-effect-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-effect-error.js","sourceRoot":"","sources":["../src/runtime-effect-error.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAE5I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,oFAAoF;AACpF,MAAM,OAAO,sBAAuB,SAAQ,MAAM,CAAC,WAAW,EAA0B,CACtF,wBAAwB,EACxB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CACvE;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,IAAI,sBAAsB,CAAC;QAChC,IAAI,EAAE,KAAK,YAAY,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,gCAAgC;QACxF,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/runtime-errors.d.ts

@@ -0,0 +1,11 @@
+/** Constructs invocation failures with agent identity and native causes, including selected dependency failures and execution errors. */
+import type { StandardIssue } from "@relkit/schema";
+/** Safe public failure fields; a non-enumerable native cause is private diagnostic data. */
+export declare class AgentRuntimeError extends Error {
+    readonly code: string;
+    readonly issues?: readonly StandardIssue[] | undefined;
+    /** @param code - Stable failure code. @param message - Safe public description.
+     * @param issues - Validation issues. @param options - Private cause; never serialize or log raw. */
+    constructor(code: string, message: string, issues?: readonly StandardIssue[] | undefined, options?: ErrorOptions);
+}
+//# sourceMappingURL=runtime-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-errors.d.ts","sourceRoot":"","sources":["../src/runtime-errors.ts"],"names":[],"mappings":"AAAA,yIAAyI;AAEzI,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,4FAA4F;AAC5F,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE;IAL5C;wGACoG;gBAEzF,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,YAAA,EAC1C,OAAO,CAAC,EAAE,YAAY;CAKzB"}

package/dist/runtime-errors.js

@@ -0,0 +1,15 @@
+/** Constructs invocation failures with agent identity and native causes, including selected dependency failures and execution errors. */
+/** Safe public failure fields; a non-enumerable native cause is private diagnostic data. */
+export class AgentRuntimeError extends Error {
+    code;
+    issues;
+    /** @param code - Stable failure code. @param message - Safe public description.
+     * @param issues - Validation issues. @param options - Private cause; never serialize or log raw. */
+    constructor(code, message, issues, options) {
+        super(message, options);
+        this.code = code;
+        this.issues = issues;
+        this.name = "AgentRuntimeError";
+    }
+}
+//# sourceMappingURL=runtime-errors.js.map

package/dist/runtime-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-errors.js","sourceRoot":"","sources":["../src/runtime-errors.ts"],"names":[],"mappings":"AAAA,yIAAyI;AAIzI,4FAA4F;AAC5F,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAI/B;IAEA;IALX;wGACoG;IACpG,YACW,IAAY,EACrB,OAAe,EACN,MAAiC,EAC1C,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QALf,SAAI,GAAJ,IAAI,CAAQ;QAEZ,WAAM,GAAN,MAAM,CAA2B;QAI1C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/runtime-failure-diagnostics.d.ts

@@ -0,0 +1,10 @@
+/** Records bounded failure categories at the invocation boundary; native causes remain private and are never logged raw. */
+import { Effect } from "effect";
+import type { AgentInvocationFailure } from "./runtime-effect-error.js";
+import type { AgentInvocationOptions, AgentRuntimeOptions } from "./runtime.types.js";
+/** Logs one safe diagnostic before public failure mapping, without retrying execution.
+ * @param failure - Typed invocation failure retaining the private cause.
+ * @param options - Authored agent and invocation identities; input/output are excluded.
+ * @returns Logging effect, or no operation for waiting/cancelled control flow. */
+export declare function logAgentFailure(failure: AgentInvocationFailure, options: AgentRuntimeOptions & AgentInvocationOptions): Effect.Effect<void, never, never>;
+//# sourceMappingURL=runtime-failure-diagnostics.d.ts.map

package/dist/runtime-failure-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-failure-diagnostics.d.ts","sourceRoot":"","sources":["../src/runtime-failure-diagnostics.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAmCtF;;;kFAGkF;AAClF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,mBAAmB,GAAG,sBAAsB,qCAoBtD"}

package/dist/runtime-failure-diagnostics.js

@@ -0,0 +1,61 @@
+/** Records bounded failure categories at the invocation boundary; native causes remain private and are never logged raw. */
+import { Effect } from "effect";
+import { GraphInterruptedError } from "./graph-interruption.js";
+import { AgentRuntimeError } from "./runtime-errors.js";
+const codes = new Set([
+    "RELKIT_AGENT_INPUT_VALIDATION",
+    "RELKIT_AGENT_OUTPUT_VALIDATION",
+    "RELKIT_AGENT_MODEL_ERROR",
+    "RELKIT_AGENT_MODEL_UNAVAILABLE",
+    "RELKIT_AGENT_RESPONSE_LIMIT",
+    "RELKIT_AGENT_STEP_LIMIT",
+    "RELKIT_AGENT_TOOL_LIMIT",
+    "RELKIT_AGENT_TIMEOUT",
+    "RELKIT_AGENT_JSON_INVALID",
+    "RELKIT_AGENT_LIMIT_INVALID",
+    "RELKIT_SCHEMA_UNAVAILABLE",
+    "RELKIT_TOOL_UNKNOWN",
+]);
+const nativeNames = new Set([
+    "Error",
+    "TypeError",
+    "SyntaxError",
+    "RangeError",
+    "APIError",
+    "BadRequestError",
+    "AuthenticationError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "ConflictError",
+    "UnprocessableEntityError",
+    "RateLimitError",
+    "InternalServerError",
+    "APIConnectionError",
+    "APIConnectionTimeoutError",
+    "StructuredOutputParsingError",
+]);
+/** Logs one safe diagnostic before public failure mapping, without retrying execution.
+ * @param failure - Typed invocation failure retaining the private cause.
+ * @param options - Authored agent and invocation identities; input/output are excluded.
+ * @returns Logging effect, or no operation for waiting/cancelled control flow. */
+export function logAgentFailure(failure, options) {
+    const cause = failure.cause;
+    if (cause instanceof GraphInterruptedError)
+        return Effect.void;
+    if (cause instanceof AgentRuntimeError && cause.code === "RELKIT_AGENT_CANCELLED")
+        return Effect.void;
+    const native = cause instanceof Error && cause.cause instanceof Error ? cause.cause : cause;
+    const status = native instanceof Error && "status" in native ? native.status : undefined;
+    return Effect.logError("Agent invocation failed", {
+        agentId: options.agent.id,
+        invocationId: options.invocationId,
+        traceId: options.traceId,
+        threadId: options.threadId,
+        code: codes.has(failure.code) ? failure.code : "RELKIT_AGENT_INVOCATION_FAILED",
+        nativeType: native instanceof Error && nativeNames.has(native.name) ? native.name : "unclassified",
+        ...(typeof status === "number" && Number.isInteger(status) && status >= 100 && status <= 599
+            ? { providerStatus: status }
+            : {}),
+    });
+}
+//# sourceMappingURL=runtime-failure-diagnostics.js.map

package/dist/runtime-failure-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-failure-diagnostics.js","sourceRoot":"","sources":["../src/runtime-failure-diagnostics.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;IACpB,+BAA+B;IAC/B,gCAAgC;IAChC,0BAA0B;IAC1B,gCAAgC;IAChC,6BAA6B;IAC7B,yBAAyB;IACzB,yBAAyB;IACzB,sBAAsB;IACtB,2BAA2B;IAC3B,4BAA4B;IAC5B,2BAA2B;IAC3B,qBAAqB;CACtB,CAAC,CAAC;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,OAAO;IACP,WAAW;IACX,aAAa;IACb,YAAY;IACZ,UAAU;IACV,iBAAiB;IACjB,qBAAqB;IACrB,uBAAuB;IACvB,eAAe;IACf,eAAe;IACf,0BAA0B;IAC1B,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;IACpB,2BAA2B;IAC3B,8BAA8B;CAC/B,CAAC,CAAC;AAEH;;;kFAGkF;AAClF,MAAM,UAAU,eAAe,CAC7B,OAA+B,EAC/B,OAAqD;IAErD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,KAAK,YAAY,qBAAqB;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAC/D,IAAI,KAAK,YAAY,iBAAiB,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB;QAC/E,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5F,MAAM,MAAM,GAAG,MAAM,YAAY,KAAK,IAAI,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,OAAO,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE;QAChD,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;QACzB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,gCAAgC;QAC/E,UAAU,EACR,MAAM,YAAY,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;QACxF,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG;YAC1F,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE;YAC5B,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime-integration.d.ts

@@ -0,0 +1,10 @@
+export declare const runtimeIntegration: Readonly<{
+    kind: "runtime-integration";
+    integrationId: "langchain";
+    registrations: readonly {
+        capability: string;
+        adapterId: string;
+        protocolVersion: number;
+    }[];
+}>;
+//# sourceMappingURL=runtime-integration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-integration.d.ts","sourceRoot":"","sources":["../src/runtime-integration.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,kBAAkB;;;;;;;;EAOc,CAAC"}

package/dist/runtime-integration.js

@@ -0,0 +1,9 @@
+export const runtimeIntegration = Object.freeze({
+    kind: "runtime-integration",
+    integrationId: "langchain",
+    registrations: Object.freeze([
+        { capability: "agent-execution", adapterId: "langchain", protocolVersion: 1 },
+        { capability: "agent-deep", adapterId: "deepagents", protocolVersion: 1 },
+    ]),
+});
+//# sourceMappingURL=runtime-integration.js.map

package/dist/runtime-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-integration.js","sourceRoot":"","sources":["../src/runtime-integration.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,qBAAqB;IAC3B,aAAa,EAAE,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC;QAC3B,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,EAAE;QAC7E,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,EAAE;KAC1E,CAAC;CACH,CAA4C,CAAC"}

package/dist/runtime-invoke.d.ts

@@ -0,0 +1,27 @@
+import { Effect } from "effect";
+import type { AgentExecutionService } from "./runtime-service.types.js";
+import type { NativeAgentRuntimeOptions } from "./runtime-native-agent.types.js";
+/** Resolves validated invocation identity, capture policy and native model.
+ * @param options - Agent runtime and invocation inputs.
+ * @param service - Selected native execution service.
+ * @returns Validated native dependencies or the original tagged failure.
+ */
+export declare const resolveNativeInvocationEffect: (options: NativeAgentRuntimeOptions, service: AgentExecutionService) => Effect.Effect<{
+    capture: import("@relkit/agents/internal/capture").AgentCapturePolicy;
+    invocationId: import("@relkit/contracts").StableId;
+    traceId: import("@relkit/contracts").StableId;
+    runtimeModel: import("./runtime-model.types.js").ResolvedRuntimeModel;
+}, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Runs native work inside the original scoped signal and trace boundary.
+ * @param options - Agent runtime and invocation inputs.
+ * @param service - Selected native execution service.
+ * @param invocation - Resolved identity, model and capture policy.
+ * @returns Native output with linked cancellation and scoped cleanup.
+ */
+export declare const invokeNativeWithContextEffect: (options: NativeAgentRuntimeOptions, service: AgentExecutionService, invocation: {
+    capture: import("@relkit/agents/internal/capture").AgentCapturePolicy;
+    invocationId: import("@relkit/contracts").StableId;
+    traceId: import("@relkit/contracts").StableId;
+    runtimeModel: import("./runtime-model.types.js").ResolvedRuntimeModel;
+}) => Effect.Effect<unknown, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+//# sourceMappingURL=runtime-invoke.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-invoke.d.ts","sourceRoot":"","sources":["../src/runtime-invoke.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;qEA6BzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B;;;;;+FAoDxC,CAAC"}

package/dist/runtime-invoke.js

@@ -0,0 +1,77 @@
+/**
+ * Resolves model and invocation identities before acquiring the scoped native
+ * signal; stream work inherits the same tracing and cancellation context.
+ */
+import { normalizeId } from "@relkit/contracts";
+import { frameworkTrace } from "@relkit/invocation";
+import { Effect } from "effect";
+import { createAgentCapturePolicyEffect } from "@relkit/agents/internal/capture-policy";
+import { generatedAgentFunctionId } from "@relkit/agents/internal/generated-function";
+import { signalFailure, validateValue, withSignal } from "./runtime-utils.js";
+import { acquireExecutionSignalEffect, ExecutionSignalClockLive } from "./signal.js";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+/** Resolves validated invocation identity, capture policy and native model.
+ * @param options - Agent runtime and invocation inputs.
+ * @param service - Selected native execution service.
+ * @returns Validated native dependencies or the original tagged failure.
+ */
+export const resolveNativeInvocationEffect = Effect.fn("Agents.runtime.resolveInvocation")(function* (options, service) {
+    const agent = options.agent;
+    const capture = yield* createAgentCapturePolicyEffect(options.capture).pipe(Effect.mapError((error) => agentInvocationFailure(new TypeError(error.message))));
+    const invocationId = yield* Effect.try({
+        try: () => normalizeId(options.invocationId ?? `agent-${service.randomUUID()}`),
+        catch: agentInvocationFailure,
+    });
+    const traceId = yield* Effect.try({
+        try: () => normalizeId(options.traceId ?? invocationId),
+        catch: agentInvocationFailure,
+    });
+    const runtimeModel = yield* Effect.tryPromise({
+        try: () => service.resolveModel({
+            ...(agent.model === undefined ? {} : { model: agent.model }),
+            registry: options.modelRegistry,
+            environment: options.environment ?? {},
+            ...(options.maxInputBytes === undefined ? {} : { maxInputBytes: options.maxInputBytes }),
+            ...(options.maxOutputBytes === undefined
+                ? {}
+                : { maxOutputBytes: options.maxOutputBytes }),
+        }),
+        catch: agentInvocationFailure,
+    });
+    return { capture, invocationId, traceId, runtimeModel };
+});
+/** Runs native work inside the original scoped signal and trace boundary.
+ * @param options - Agent runtime and invocation inputs.
+ * @param service - Selected native execution service.
+ * @param invocation - Resolved identity, model and capture policy.
+ * @returns Native output with linked cancellation and scoped cleanup.
+ */
+export const invokeNativeWithContextEffect = Effect.fn("Agents.runtime.invokeNative")(function* (options, service, invocation) {
+    const { capture, invocationId, traceId, runtimeModel } = invocation;
+    return yield* Effect.scoped(Effect.gen(function* () {
+        const execution = yield* acquireExecutionSignalEffect(options).pipe(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.model.id": runtimeModel.id,
+                    },
+                }, async () => {
+                    if (signal.aborted)
+                        throw signalFailure(signal);
+                    const input = options.resume
+                        ? options.input
+                        : await withSignal(validateValue(options.agent.input, options.input, "input"), signal);
+                    return service.runLoop(options, runtimeModel.model, runtimeModel.id, signal, input, runtimeModel.maxInputBytes, runtimeModel.maxOutputBytes, invocationId, traceId, capture);
+                });
+            },
+            catch: agentInvocationFailure,
+        });
+    }));
+});
+//# sourceMappingURL=runtime-invoke.js.map

package/dist/runtime-invoke.js.map

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

package/dist/runtime-loop-context.types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Carries one native loop's already acquired runnable, identity, state selection
+ * and signal to stream/settlement helpers without allocating another lifetime.
+ */
+import type { AgentLoopOptions } from "./runtime-loop.types.js";
+import type { createNativeAgent } from "./runtime-native-agent.js";
+import type { createLoopTelemetry } from "./runtime-loop-telemetry.js";
+export interface NativeAgentLoopContext {
+    readonly options: AgentLoopOptions;
+    readonly native: Awaited<ReturnType<typeof createNativeAgent>>;
+    readonly config: {
+        readonly configurable?: {
+            readonly thread_id: string;
+        };
+    };
+    readonly input: unknown;
+    readonly signal: AbortSignal;
+    readonly maxInputBytes: number;
+    readonly maxOutputBytes: number;
+    readonly observe: ReturnType<typeof createLoopTelemetry>;
+}
+//# sourceMappingURL=runtime-loop-context.types.d.ts.map

package/dist/runtime-loop-context.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop-context.types.d.ts","sourceRoot":"","sources":["../src/runtime-loop-context.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE;YAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC5E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;CAC1D"}

package/dist/runtime-loop-context.types.js

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

package/dist/runtime-loop-context.types.js.map

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

package/dist/runtime-loop-execution.d.ts

@@ -0,0 +1,4 @@
+import type { AgentCapturePolicy } from "@relkit/agents/internal/observability";
+import type { AgentLoopOptions, NativeModel } from "./runtime-loop.types.js";
+export declare function runAgentLoopCore(options: AgentLoopOptions, model: NativeModel, modelId: string, signal: AbortSignal, input: unknown, maxInputBytes: number, maxOutputBytes: number, invocationId: string, traceId: string, capture: AgentCapturePolicy): Promise<unknown>;
+//# sourceMappingURL=runtime-loop-execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop-execution.d.ts","sourceRoot":"","sources":["../src/runtime-loop-execution.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAQhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG7E,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CA+ClB"}

package/dist/runtime-loop-execution.js

@@ -0,0 +1,61 @@
+/**
+ * Executes one native agent stream while retaining model failure precedence.
+ * Public wrappers own Effect interruption; state helpers use the same signal.
+ */
+import { frameworkTrace } from "@relkit/invocation";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { createLoopTelemetry } from "./runtime-loop-telemetry.js";
+import { createNativeAgent, StructuredOutputParsingError } from "./runtime-native-agent.js";
+import { GraphInterruptedError } from "./graph-interruption.js";
+import { modelFailure, signalFailure } from "./runtime-utils.js";
+import { unwrapNativeCause } from "./runtime-loop-values.js";
+import { streamNativeAgentLoop, settleNativeAgentLoop } from "./runtime-loop-state.js";
+export async function runAgentLoopCore(options, model, modelId, signal, input, maxInputBytes, maxOutputBytes, invocationId, traceId, capture) {
+    const native = await createNativeAgent({
+        runtime: {
+            ...options,
+            agent: options.agent,
+        },
+        model,
+        signal,
+        maxOutputBytes,
+        invocationId,
+        traceId,
+    });
+    const observe = createLoopTelemetry(options, modelId);
+    const config = options.threadId === undefined ? {} : { configurable: { thread_id: options.threadId } };
+    const context = {
+        options,
+        native,
+        config,
+        input,
+        signal,
+        maxInputBytes,
+        maxOutputBytes,
+        observe,
+    };
+    try {
+        const state = await frameworkTrace.span(`relkit.agent.${options.agent.id}.model`, {
+            input,
+            kind: "client",
+            attributes: { "relkit.agent.id": options.agent.id, "relkit.model.id": modelId },
+        }, () => streamNativeAgentLoop(context));
+        return settleNativeAgentLoop(context, state);
+    }
+    catch (cause) {
+        const nativeCause = unwrapNativeCause(cause);
+        if (signal.aborted)
+            throw signalFailure(signal);
+        if (native.tools.failure() !== undefined)
+            throw native.tools.failure();
+        if (nativeCause instanceof AgentRuntimeError)
+            throw nativeCause;
+        if (nativeCause instanceof GraphInterruptedError)
+            throw nativeCause;
+        if (nativeCause instanceof StructuredOutputParsingError) {
+            throw new AgentRuntimeError("RELKIT_AGENT_OUTPUT_VALIDATION", "Output validation failed");
+        }
+        throw modelFailure(nativeCause, signal);
+    }
+}
+//# sourceMappingURL=runtime-loop-execution.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop-execution.js","sourceRoot":"","sources":["../src/runtime-loop-execution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAyB,EACzB,KAAkB,EAClB,OAAe,EACf,MAAmB,EACnB,KAAc,EACd,aAAqB,EACrB,cAAsB,EACtB,YAAoB,EACpB,OAAe,EACf,OAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,OAAO,EAAE;YACP,GAAG,OAAO;YACV,KAAK,EAAE,OAAO,CAAC,KAAkD;SAClE;QACD,KAAK;QACL,MAAM;QACN,cAAc;QACd,YAAY;QACZ,OAAO;KACR,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,MAAM,GACV,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC1F,MAAM,OAAO,GAAG;QACd,OAAO;QACP,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,aAAa;QACb,cAAc;QACd,OAAO;KACR,CAAC;IACF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CACrC,gBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EACxC;YACE,KAAK;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,iBAAiB,EAAE,OAAO,EAAE;SAChF,EACD,GAAG,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC,CACrC,CAAC;QACF,OAAO,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,SAAS;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACvE,IAAI,WAAW,YAAY,iBAAiB;YAAE,MAAM,WAAW,CAAC;QAChE,IAAI,WAAW,YAAY,qBAAqB;YAAE,MAAM,WAAW,CAAC;QACpE,IAAI,WAAW,YAAY,4BAA4B,EAAE,CAAC;YACxD,MAAM,IAAI,iBAAiB,CAAC,gCAAgC,EAAE,0BAA0B,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/runtime-loop-state.d.ts

@@ -0,0 +1,13 @@
+import type { NativeAgentLoopContext } from "./runtime-loop-context.types.js";
+/** Collects the native stream under its caller's existing trace and signal.
+ * @param context - Runnable and per-invocation dependencies.
+ * @returns The native final state after stream collection.
+ */
+export declare function streamNativeAgentLoop(context: NativeAgentLoopContext): Promise<any>;
+/** Publishes waiting state or validated output without changing persistence identity.
+ * @param context - Existing runnable, checkpoint config and content sink.
+ * @param state - Native final state before public output validation.
+ * @returns Validated output, or the existing graph interruption error.
+ */
+export declare function settleNativeAgentLoop(context: NativeAgentLoopContext, state: unknown): Promise<unknown>;
+//# sourceMappingURL=runtime-loop-state.d.ts.map

package/dist/runtime-loop-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop-state.d.ts","sourceRoot":"","sources":["../src/runtime-loop-state.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,gBAiC1E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,OAAO,oBA6B1F"}

package/dist/runtime-loop-state.js

@@ -0,0 +1,57 @@
+/**
+ * Streams one already acquired native runnable and settles its public output or
+ * interruption using the same checkpoint identity, byte limits and content sink.
+ */
+import { isInterrupted } from "@langchain/langgraph";
+import { collectNativeEvents } from "./runtime-native-events.js";
+import { selectedStateSchemas } from "./runtime-state-schemas.js";
+import { nativeAgentResumeCommand, nativeAgentWaitingInterrupts, } from "./native-agent-interruption.js";
+import { GraphInterruptedError, graphWaitingResponse, publicWaitingRequests, } from "./graph-interruption.js";
+import { jsonValue, validateValue, withSignal } from "./runtime-utils.js";
+import { nativeMessages, responseValue } from "./runtime-loop-values.js";
+/** Collects the native stream under its caller's existing trace and signal.
+ * @param context - Runnable and per-invocation dependencies.
+ * @returns The native final state after stream collection.
+ */
+export async function streamNativeAgentLoop(context) {
+    const { options, native, config, input, signal, maxInputBytes, observe } = context;
+    if (options.resume && options.threadId === undefined) {
+        throw new TypeError("Agent resume requires threadId");
+    }
+    const nativeInput = options.resume
+        ? await nativeAgentResumeCommand(native.agent, config, input)
+        : { messages: nativeMessages(options, input, maxInputBytes) };
+    const run = await withSignal(native.agent.streamEvents(nativeInput, {
+        version: "v3",
+        signal,
+        ...config,
+    }), signal);
+    await collectNativeEvents(run, options.contentSink, native.tools.publicIds, native.tools.relkitNames, signal, options.agent.limits, selectedStateSchemas(options.agent.middleware.map((middleware) => middleware.stateSchema), options.agent.client?.state ?? []), native.tools.failure, observe, (reason) => run.abort(reason), options.agent.client?.events);
+    return withSignal(run.output, signal);
+}
+/** Publishes waiting state or validated output without changing persistence identity.
+ * @param context - Existing runnable, checkpoint config and content sink.
+ * @param state - Native final state before public output validation.
+ * @returns Validated output, or the existing graph interruption error.
+ */
+export async function settleNativeAgentLoop(context, state) {
+    const { options, native, config, signal, maxOutputBytes } = context;
+    if (isInterrupted(state)) {
+        if (options.threadId === undefined) {
+            throw new TypeError("Agent interruption requires threadId");
+        }
+        const interrupts = await nativeAgentWaitingInterrupts(native.agent, config);
+        await withSignal(options.contentSink?.emitWaiting?.({
+            response: graphWaitingResponse(interrupts),
+            requests: publicWaitingRequests(interrupts),
+        }, signal), signal);
+        throw new GraphInterruptedError(options.threadId, interrupts);
+    }
+    const output = await validateValue(options.agent.output, jsonValue(responseValue(state), maxOutputBytes, "agent output"), "output");
+    if (options.contentSink !== undefined) {
+        await withSignal(options.contentSink.emitOutput(output, signal), signal);
+        await withSignal(options.contentSink.finishOutput?.(signal), signal);
+    }
+    return output;
+}
+//# sourceMappingURL=runtime-loop-state.js.map

package/dist/runtime-loop-state.js.map

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