@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/native-agent-interruption-error.js

@@ -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";
+/** Tagged native agent continuation or state failure. */
+export class NativeAgentInterruptionFailure extends Schema.TaggedError()("NativeAgentInterruptionFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** 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 function nativeAgentInterruptionFailure(cause) {
+    return new NativeAgentInterruptionFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=native-agent-interruption-error.js.map

package/dist/native-agent-interruption-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-agent-interruption-error.js","sourceRoot":"","sources":["../src/native-agent-interruption-error.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAE1I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,yDAAyD;AACzD,MAAM,OAAO,8BAA+B,SAAQ,MAAM,CAAC,WAAW,EAAkC,CACtG,gCAAgC,EAChC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAAc;IAC3D,OAAO,IAAI,8BAA8B,CAAC;QACxC,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/native-agent-interruption-schema.d.ts

@@ -0,0 +1,66 @@
+/** Declares executable schemas for native interruption payloads before they cross the durable RELKIT continuation boundary. */
+import type { JsonValue } from "@relkit/contracts";
+import { Effect } from "effect";
+import type { DecisionType, HitlRequest, ReviewConfig } from "./native-agent-interruption-schema.types.js";
+export type * from "./native-agent-interruption-schema.types.js";
+/** Constructs the exact response schema for pending reviews.
+ * @param configs - Review policies in action order.
+ * @returns An Effect with a JSON schema and no typed failure.
+ * @example Effect.runSync(hitlResponseSchemaEffect(configs));
+ */
+export declare const hitlResponseSchemaEffect: (configs: readonly ReviewConfig[]) => Effect.Effect<JsonValue, never, never>;
+/** Constructs the response schema for existing synchronous callers.
+ * @param configs - Review policies in action order.
+ * @returns A JSON schema.
+ * @example const schema = hitlResponseSchema(configs);
+ */
+export declare function hitlResponseSchema(configs: readonly ReviewConfig[]): JsonValue;
+/** Validates the native human review request shape.
+ * @param value - Candidate request.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isHitlRequestEffect(value));
+ */
+export declare const isHitlRequestEffect: (value: unknown) => Effect.Effect<boolean, never, never>;
+/** Checks a native human review request for existing synchronous callers.
+ * @param value - Candidate request.
+ * @returns Whether the value is a review request.
+ * @example if (isHitlRequest(value)) handle(value);
+ */
+export declare function isHitlRequest(value: unknown): value is HitlRequest;
+/** Projects a review request to public action fields.
+ * @param value - Validated review request.
+ * @returns An Effect with the public request and no typed failure.
+ * @example Effect.runSync(publicHitlRequestEffect(request));
+ */
+export declare const publicHitlRequestEffect: (value: HitlRequest) => Effect.Effect<HitlRequest, never, never>;
+/** Projects a review request for existing synchronous callers.
+ * @param value - Validated review request.
+ * @returns Public action and review fields.
+ * @example const request = publicHitlRequest(nativeRequest);
+ */
+export declare function publicHitlRequest(value: HitlRequest): HitlRequest;
+/** Checks one native human decision label.
+ * @param value - Candidate label.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isDecisionEffect("approve"));
+ */
+export declare const isDecisionEffect: (value: unknown) => Effect.Effect<boolean, never, never>;
+/** Checks a decision label for existing synchronous callers.
+ * @param value - Candidate label.
+ * @returns Whether the value is an allowed decision kind.
+ * @example if (isDecision(value)) useDecision(value);
+ */
+export declare function isDecision(value: unknown): value is DecisionType;
+/** Checks a non-null, non-array record.
+ * @param value - Candidate record.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isRecordEffect({ name: "tool" }));
+ */
+export declare const isRecordEffect: (value: unknown) => Effect.Effect<boolean, never, never>;
+/** Checks a record for existing synchronous callers.
+ * @param value - Candidate record.
+ * @returns Whether the value is a non-null object.
+ * @example if (isRecord(value)) read(value.name);
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=native-agent-interruption-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-agent-interruption-schema.d.ts","sourceRoot":"","sources":["../src/native-agent-interruption-schema.ts"],"names":[],"mappings":"AAAA,+HAA+H;AAE/H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,6CAA6C,CAAC;AAErD,mBAAmB,6CAA6C,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8EAqBpC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAE9E;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,0DAmB/B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,kEAenC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEjE;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,0DAG5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEhE;AAMD;;;;GAIG;AACH,eAAO,MAAM,cAAc,0DAG1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/native-agent-interruption-schema.js

@@ -0,0 +1,141 @@
+/** Declares executable schemas for native interruption payloads before they cross the durable RELKIT continuation boundary. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+/** Constructs the exact response schema for pending reviews.
+ * @param configs - Review policies in action order.
+ * @returns An Effect with a JSON schema and no typed failure.
+ * @example Effect.runSync(hitlResponseSchemaEffect(configs));
+ */
+export const hitlResponseSchemaEffect = Effect.fn("Agents.nativeHitl.responseSchema")((configs) => Effect.sync(() => ({
+    type: "object",
+    properties: {
+        decisions: {
+            type: "array",
+            prefixItems: configs.map(({ actionName, allowedDecisions, argsSchema }) => ({
+                oneOf: allowedDecisions.map((decision) => decisionSchema(decision, actionName, argsSchema)),
+            })),
+            items: false,
+            minItems: configs.length,
+            maxItems: configs.length,
+        },
+    },
+    required: ["decisions"],
+    additionalProperties: false,
+})), (effect) => observeAgent("native-hitl.response-schema", effect));
+/** Constructs the response schema for existing synchronous callers.
+ * @param configs - Review policies in action order.
+ * @returns A JSON schema.
+ * @example const schema = hitlResponseSchema(configs);
+ */
+export function hitlResponseSchema(configs) {
+    return Effect.runSync(hitlResponseSchemaEffect(configs));
+}
+/** Validates the native human review request shape.
+ * @param value - Candidate request.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isHitlRequestEffect(value));
+ */
+export const isHitlRequestEffect = Effect.fn("Agents.nativeHitl.isRequest")((value) => Effect.sync(() => recordShape(value) &&
+    Array.isArray(value.actionRequests) &&
+    value.actionRequests.every(recordShape) &&
+    Array.isArray(value.reviewConfigs) &&
+    value.actionRequests.length === value.reviewConfigs.length &&
+    value.reviewConfigs.every((config) => recordShape(config) &&
+        typeof config.actionName === "string" &&
+        Array.isArray(config.allowedDecisions) &&
+        config.allowedDecisions.length > 0 &&
+        config.allowedDecisions.every(decisionShape))), (effect) => observeAgent("native-hitl.is-request", effect));
+/** Checks a native human review request for existing synchronous callers.
+ * @param value - Candidate request.
+ * @returns Whether the value is a review request.
+ * @example if (isHitlRequest(value)) handle(value);
+ */
+export function isHitlRequest(value) {
+    return Effect.runSync(isHitlRequestEffect(value));
+}
+/** Projects a review request to public action fields.
+ * @param value - Validated review request.
+ * @returns An Effect with the public request and no typed failure.
+ * @example Effect.runSync(publicHitlRequestEffect(request));
+ */
+export const publicHitlRequestEffect = Effect.fn("Agents.nativeHitl.publicRequest")((value) => Effect.sync(() => ({
+    actionRequests: value.actionRequests.map((action) => ({
+        name: action.name,
+        args: action.args,
+        ...(typeof action.description === "string" ? { description: action.description } : {}),
+    })),
+    reviewConfigs: value.reviewConfigs.map((config) => ({
+        actionName: config.actionName,
+        allowedDecisions: [...config.allowedDecisions],
+        ...(config.argsSchema === undefined ? {} : { argsSchema: config.argsSchema }),
+    })),
+})), (effect) => observeAgent("native-hitl.public-request", effect));
+/** Projects a review request for existing synchronous callers.
+ * @param value - Validated review request.
+ * @returns Public action and review fields.
+ * @example const request = publicHitlRequest(nativeRequest);
+ */
+export function publicHitlRequest(value) {
+    return Effect.runSync(publicHitlRequestEffect(value));
+}
+/** Checks one native human decision label.
+ * @param value - Candidate label.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isDecisionEffect("approve"));
+ */
+export const isDecisionEffect = Effect.fn("Agents.nativeHitl.isDecision")((value) => Effect.sync(() => decisionShape(value)), (effect) => observeAgent("native-hitl.is-decision", effect));
+/** Checks a decision label for existing synchronous callers.
+ * @param value - Candidate label.
+ * @returns Whether the value is an allowed decision kind.
+ * @example if (isDecision(value)) useDecision(value);
+ */
+export function isDecision(value) {
+    return Effect.runSync(isDecisionEffect(value));
+}
+function decisionShape(value) {
+    return value === "approve" || value === "edit" || value === "reject";
+}
+/** Checks a non-null, non-array record.
+ * @param value - Candidate record.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isRecordEffect({ name: "tool" }));
+ */
+export const isRecordEffect = Effect.fn("Agents.nativeHitl.isRecord")((value) => Effect.sync(() => recordShape(value)), (effect) => observeAgent("native-hitl.is-record", effect));
+/** Checks a record for existing synchronous callers.
+ * @param value - Candidate record.
+ * @returns Whether the value is a non-null object.
+ * @example if (isRecord(value)) read(value.name);
+ */
+export function isRecord(value) {
+    return Effect.runSync(isRecordEffect(value));
+}
+function recordShape(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function decisionSchema(type, actionName, argsSchema) {
+    const base = { type: "object", additionalProperties: false };
+    if (type === "approve") {
+        return { ...base, properties: { type: { const: type } }, required: ["type"] };
+    }
+    if (type === "reject") {
+        return {
+            ...base,
+            properties: { type: { const: type }, message: { type: "string" } },
+            required: ["type"],
+        };
+    }
+    return {
+        ...base,
+        properties: {
+            type: { const: type },
+            editedAction: {
+                type: "object",
+                properties: { name: { const: actionName }, args: argsSchema ?? { type: "object" } },
+                required: ["name", "args"],
+                additionalProperties: false,
+            },
+        },
+        required: ["type", "editedAction"],
+    };
+}
+//# sourceMappingURL=native-agent-interruption-schema.js.map

package/dist/native-agent-interruption-schema.js.map

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

package/dist/native-agent-interruption-schema.types.d.ts

@@ -0,0 +1,16 @@
+/** Declares executable schemas for native interruption payloads before they cross the durable RELKIT continuation boundary. This companion preserves the native input and output types without starting runtime work. */
+import type { JsonValue } from "@relkit/contracts";
+/** Human review decision accepted by a native agent. */
+export type DecisionType = "approve" | "edit" | "reject";
+/** Review policy for one pending action. */
+export interface ReviewConfig {
+    readonly actionName: string;
+    readonly allowedDecisions: readonly DecisionType[];
+    readonly argsSchema?: JsonValue;
+}
+/** Public set of actions awaiting human review. */
+export interface HitlRequest {
+    readonly actionRequests: readonly Record<string, unknown>[];
+    readonly reviewConfigs: readonly ReviewConfig[];
+}
+//# sourceMappingURL=native-agent-interruption-schema.types.d.ts.map

package/dist/native-agent-interruption-schema.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-agent-interruption-schema.types.d.ts","sourceRoot":"","sources":["../src/native-agent-interruption-schema.types.ts"],"names":[],"mappings":"AAAA,yNAAyN;AAEzN,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;CACjC;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC5D,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;CACjD"}

package/dist/native-agent-interruption-schema.types.js

@@ -0,0 +1,3 @@
+/** Declares executable schemas for native interruption payloads before they cross the durable RELKIT continuation boundary. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=native-agent-interruption-schema.types.js.map

package/dist/native-agent-interruption-schema.types.js.map

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

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

@@ -0,0 +1,19 @@
+/** Decodes native agent interruption data and rejects invalid continuation payloads before approval or resume processing. */
+import type { GraphWaitingInterrupt } from "./graph-interruption.js";
+import type { AgentWaitingRequest } from "@relkit/agents/internal/state.types";
+/** Extracts public native interruptions from nested graph state.
+ * @param snapshot - Native graph state.
+ * @param path - Current nested graph path.
+ * @returns Public interruptions in task order.
+ * @example const requests = snapshotInterrupts(snapshot, []);
+ */
+export declare function snapshotInterrupts(snapshot: unknown, path: readonly string[]): GraphWaitingInterrupt[];
+/** Validates one or more replies against pending native reviews.
+ * @param requests - Pending review requests.
+ * @param value - Candidate reply or ordered reply list.
+ * @returns Validated reply values.
+ * @throws TypeError for absent, mismatched, or invalid replies.
+ * @example const replies = validateNativeAgentResumeInputCore(requests, input);
+ */
+export declare function validateNativeAgentResumeInputCore(requests: readonly AgentWaitingRequest[], value: unknown): unknown;
+//# sourceMappingURL=native-agent-interruption-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-agent-interruption-validation.d.ts","sourceRoot":"","sources":["../src/native-agent-interruption-validation.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAG7H,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AASrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,qBAAqB,EAAE,CAsBzB;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,mBAAmB,EAAE,EACxC,KAAK,EAAE,OAAO,GACb,OAAO,CAOT"}

package/dist/native-agent-interruption-validation.js

@@ -0,0 +1,107 @@
+/** Decodes native agent interruption data and rejects invalid continuation payloads before approval or resume processing. */
+import { validate } from "@cfworker/json-schema";
+import { hitlResponseSchema, isDecision, isHitlRequest, isRecord, publicHitlRequest, } from "./native-agent-interruption-schema.js";
+/** Extracts public native interruptions from nested graph state.
+ * @param snapshot - Native graph state.
+ * @param path - Current nested graph path.
+ * @returns Public interruptions in task order.
+ * @example const requests = snapshotInterrupts(snapshot, []);
+ */
+export function snapshotInterrupts(snapshot, path) {
+    if (!isRecord(snapshot) || !Array.isArray(snapshot.tasks))
+        return [];
+    return snapshot.tasks.flatMap((task) => {
+        if (!isRecord(task))
+            return [];
+        const name = typeof task.name === "string" ? task.name : "human-input";
+        if (isRecord(task.state) && Array.isArray(task.state.tasks)) {
+            return snapshotInterrupts(task.state, [...path, name]);
+        }
+        if (!Array.isArray(task.interrupts))
+            return [];
+        return task.interrupts.flatMap((entry) => {
+            if (!isRecord(entry) || !isHitlRequest(entry.value))
+                return [];
+            const value = publicHitlRequest(entry.value);
+            return [
+                {
+                    ...(typeof entry.id === "string" ? { id: entry.id } : {}),
+                    node: [...path, name].join("/"),
+                    value,
+                    response: hitlResponseSchema(value.reviewConfigs),
+                },
+            ];
+        });
+    });
+}
+/** Validates one or more replies against pending native reviews.
+ * @param requests - Pending review requests.
+ * @param value - Candidate reply or ordered reply list.
+ * @returns Validated reply values.
+ * @throws TypeError for absent, mismatched, or invalid replies.
+ * @example const replies = validateNativeAgentResumeInputCore(requests, input);
+ */
+export function validateNativeAgentResumeInputCore(requests, value) {
+    if (requests.length === 0)
+        throw new TypeError("Agent has no waiting continuation");
+    if (requests.length === 1)
+        return validateReply(requests[0], value);
+    if (!Array.isArray(value) || value.length !== requests.length) {
+        throw new TypeError(`Agent continuation requires ${requests.length} replies`);
+    }
+    return requests.map((request, index) => validateReply(request, value[index]));
+}
+function validateReply(request, value) {
+    const requestValue = request.value;
+    if (!isHitlRequest(requestValue) || !isRecord(value) || !Array.isArray(value.decisions)) {
+        throw new TypeError("Agent continuation requires human decisions");
+    }
+    if (Object.keys(value).some((key) => key !== "decisions")) {
+        throw new TypeError("Agent continuation has unknown fields");
+    }
+    if (value.decisions.length !== requestValue.reviewConfigs.length) {
+        throw new TypeError("Agent continuation decision count is invalid");
+    }
+    return {
+        decisions: value.decisions.map((decision, index) => validateDecision(decision, requestValue.reviewConfigs[index])),
+    };
+}
+function validateDecision(value, config) {
+    if (!isRecord(value) ||
+        !isDecision(value.type) ||
+        !config.allowedDecisions.includes(value.type)) {
+        throw new TypeError("Agent continuation decision is not allowed");
+    }
+    if (value.type === "approve") {
+        exactKeys(value, ["type"]);
+        return { type: "approve" };
+    }
+    if (value.type === "reject") {
+        exactKeys(value, ["type", "message"]);
+        if (value.message !== undefined && typeof value.message !== "string") {
+            throw new TypeError("Agent rejection message must be text");
+        }
+        return {
+            type: "reject",
+            ...(value.message === undefined ? {} : { message: value.message }),
+        };
+    }
+    exactKeys(value, ["type", "editedAction"]);
+    if (!isRecord(value.editedAction) ||
+        value.editedAction.name !== config.actionName ||
+        !isRecord(value.editedAction.args)) {
+        throw new TypeError("Agent edited action is invalid");
+    }
+    exactKeys(value.editedAction, ["name", "args"]);
+    if (config.argsSchema !== undefined &&
+        !validate(value.editedAction.args, config.argsSchema).valid) {
+        throw new TypeError("Agent edited action arguments are invalid");
+    }
+    return { type: "edit", editedAction: value.editedAction };
+}
+function exactKeys(value, allowed) {
+    if (Object.keys(value).some((key) => !allowed.includes(key))) {
+        throw new TypeError("Agent continuation has unknown fields");
+    }
+}
+//# sourceMappingURL=native-agent-interruption-validation.js.map

package/dist/native-agent-interruption-validation.js.map

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

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

@@ -0,0 +1,55 @@
+/** Projects native agent interruption state into RELKIT approval and continuation records without losing native interrupt identity. */
+import { Command } from "@langchain/langgraph";
+import { Effect } from "effect";
+import type { NativeAgent, NativeAgentConfig } from "./native-agent-interruption.types.js";
+import type { AgentWaitingRequest } from "@relkit/agents/internal/state.types";
+/** Reads native pending requests and constructs a resume command.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @param value - One reply or an ordered reply list.
+ * @returns An Effect with a native Command or NativeAgentInterruptionFailure.
+ * @example await Effect.runPromise(nativeAgentResumeCommandEffect(agent, config, reply));
+ */
+export declare const nativeAgentResumeCommandEffect: (agent: NativeAgent, config: import("@langchain/core/runnables").RunnableConfig<Record<string, any>>, value: unknown) => Effect.Effect<Command<{
+    [k: string]: unknown;
+}, Record<string, unknown>, string>, import("./native-agent-interruption-error.js").NativeAgentInterruptionFailure, never>;
+/** Builds a native resume command for existing Promise callers.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @param value - Candidate continuation reply.
+ * @returns A native resume command.
+ * @throws The original state or validation error.
+ * @example await nativeAgentResumeCommand(agent, config, reply);
+ */
+export declare function nativeAgentResumeCommand(agent: NativeAgent, config: NativeAgentConfig, value: unknown): Promise<Command>;
+/** Reads and projects waiting native interruptions.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @returns An Effect with ordered waiting requests or NativeAgentInterruptionFailure.
+ * @example await Effect.runPromise(nativeAgentWaitingInterruptsEffect(agent, config));
+ */
+export declare const nativeAgentWaitingInterruptsEffect: (agent: NativeAgent, config: import("@langchain/core/runnables").RunnableConfig<Record<string, any>>) => Effect.Effect<import("./graph-interruption.types.js").GraphWaitingInterrupt[], import("./native-agent-interruption-error.js").NativeAgentInterruptionFailure, never>;
+/** Reads waiting native interruptions for existing Promise callers.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @returns Ordered waiting requests.
+ * @throws The original native state provider error.
+ * @example await nativeAgentWaitingInterrupts(agent, config);
+ */
+export declare function nativeAgentWaitingInterrupts(agent: NativeAgent, config: NativeAgentConfig): Promise<readonly import("./graph-interruption.js").GraphWaitingInterrupt[]>;
+/** Validates native continuation replies against pending requests.
+ * @param requests - Pending waiting requests.
+ * @param value - One reply or an ordered reply list.
+ * @returns An Effect with validated replies or NativeAgentInterruptionFailure.
+ * @example Effect.runSync(validateNativeAgentResumeInputEffect(requests, reply));
+ */
+export declare const validateNativeAgentResumeInputEffect: (requests: readonly AgentWaitingRequest[], value: unknown) => Effect.Effect<unknown, import("./native-agent-interruption-error.js").NativeAgentInterruptionFailure, never>;
+/** Validates native continuation replies for existing synchronous callers.
+ * @param requests - Pending waiting requests.
+ * @param value - Candidate reply or ordered reply list.
+ * @returns Validated reply values.
+ * @throws The original invalid continuation error.
+ * @example const reply = validateNativeAgentResumeInput(requests, value);
+ */
+export declare function validateNativeAgentResumeInput(requests: readonly AgentWaitingRequest[], value: unknown): unknown;
+//# sourceMappingURL=native-agent-interruption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-agent-interruption.d.ts","sourceRoot":"","sources":["../src/native-agent-interruption.ts"],"names":[],"mappings":"AAAA,uIAAuI;AAEvI,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAK3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;;0HAoB1C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,+QAoB9C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,SAAS,OAAO,yBAAyB,EAAE,qBAAqB,EAAE,CAAC,CAM7E;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,4KAOhD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,SAAS,mBAAmB,EAAE,EACxC,KAAK,EAAE,OAAO,GACb,OAAO,CAMT"}

package/dist/native-agent-interruption.js

@@ -0,0 +1,85 @@
+/** Projects native agent interruption state into RELKIT approval and continuation records without losing native interrupt identity. */
+import { Command } from "@langchain/langgraph";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { nativeAgentInterruptionFailure } from "./native-agent-interruption-error.js";
+import { snapshotInterrupts, validateNativeAgentResumeInputCore, } from "./native-agent-interruption-validation.js";
+/** Reads native pending requests and constructs a resume command.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @param value - One reply or an ordered reply list.
+ * @returns An Effect with a native Command or NativeAgentInterruptionFailure.
+ * @example await Effect.runPromise(nativeAgentResumeCommandEffect(agent, config, reply));
+ */
+export const nativeAgentResumeCommandEffect = Effect.fn("Agents.nativeHitl.resumeCommand")(function* (agent, config, value) {
+    const requests = yield* nativeAgentWaitingInterruptsEffect(agent, config);
+    const reply = yield* validateNativeAgentResumeInputEffect(requests, value);
+    const replies = requests.length === 1 ? [reply] : reply;
+    return yield* Effect.try({
+        try: () => new Command({
+            resume: Object.fromEntries(requests.map((request, index) => {
+                if (request.id === undefined)
+                    throw new TypeError("Agent interruption has no native ID");
+                return [request.id, replies[index]];
+            })),
+        }),
+        catch: nativeAgentInterruptionFailure,
+    });
+}, (effect) => observeAgent("native-hitl.resume-command", effect));
+/** Builds a native resume command for existing Promise callers.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @param value - Candidate continuation reply.
+ * @returns A native resume command.
+ * @throws The original state or validation error.
+ * @example await nativeAgentResumeCommand(agent, config, reply);
+ */
+export function nativeAgentResumeCommand(agent, config, value) {
+    return Effect.runPromise(nativeAgentResumeCommandEffect(agent, config, value).pipe(Effect.catchTag("NativeAgentInterruptionFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Reads and projects waiting native interruptions.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @returns An Effect with ordered waiting requests or NativeAgentInterruptionFailure.
+ * @example await Effect.runPromise(nativeAgentWaitingInterruptsEffect(agent, config));
+ */
+export const nativeAgentWaitingInterruptsEffect = Effect.fn("Agents.nativeHitl.waiting")((agent, config) => Effect.tryPromise({
+    try: async (effectSignal) => snapshotInterrupts(await agent.getState({
+        ...config,
+        signal: config.signal === undefined
+            ? effectSignal
+            : AbortSignal.any([config.signal, effectSignal]),
+    }, { subgraphs: true }), []),
+    catch: nativeAgentInterruptionFailure,
+}), (effect) => observeAgent("native-hitl.waiting", effect));
+/** Reads waiting native interruptions for existing Promise callers.
+ * @param agent - Native agent state provider.
+ * @param config - State lookup configuration.
+ * @returns Ordered waiting requests.
+ * @throws The original native state provider error.
+ * @example await nativeAgentWaitingInterrupts(agent, config);
+ */
+export function nativeAgentWaitingInterrupts(agent, config) {
+    return Effect.runPromise(nativeAgentWaitingInterruptsEffect(agent, config).pipe(Effect.catchTag("NativeAgentInterruptionFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Validates native continuation replies against pending requests.
+ * @param requests - Pending waiting requests.
+ * @param value - One reply or an ordered reply list.
+ * @returns An Effect with validated replies or NativeAgentInterruptionFailure.
+ * @example Effect.runSync(validateNativeAgentResumeInputEffect(requests, reply));
+ */
+export const validateNativeAgentResumeInputEffect = Effect.fn("Agents.nativeHitl.validateReply")((requests, value) => Effect.try({
+    try: () => validateNativeAgentResumeInputCore(requests, value),
+    catch: nativeAgentInterruptionFailure,
+}), (effect) => observeAgent("native-hitl.validate-reply", effect));
+/** Validates native continuation replies for existing synchronous callers.
+ * @param requests - Pending waiting requests.
+ * @param value - Candidate reply or ordered reply list.
+ * @returns Validated reply values.
+ * @throws The original invalid continuation error.
+ * @example const reply = validateNativeAgentResumeInput(requests, value);
+ */
+export function validateNativeAgentResumeInput(requests, value) {
+    return Effect.runSync(validateNativeAgentResumeInputEffect(requests, value).pipe(Effect.catchTag("NativeAgentInterruptionFailure", (failure) => Effect.fail(failure.cause))));
+}
+//# sourceMappingURL=native-agent-interruption.js.map

package/dist/native-agent-interruption.js.map

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

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

@@ -0,0 +1,5 @@
+/** Native LangGraph agent state access used by continuation operations. */
+export type NativeAgent = Pick<ReturnType<typeof import("langchain").createAgent>, "getState">;
+/** State lookup configuration accepted by a native agent. */
+export type NativeAgentConfig = Parameters<NativeAgent["getState"]>[0];
+//# sourceMappingURL=native-agent-interruption.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-agent-interruption.types.d.ts","sourceRoot":"","sources":["../src/native-agent-interruption.types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,WAAW,EAAE,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;AAE/F,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/native-agent-interruption.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=native-agent-interruption.types.js.map

package/dist/native-agent-interruption.types.js.map

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

package/dist/persistence-error.d.ts

@@ -0,0 +1,17 @@
+/** Defines typed failures for native persistence acquisition and release, retaining the selected resource and underlying cause. */
+import { Schema } from "effect";
+declare const AgentPersistenceFailure_base: Schema.Class<AgentPersistenceFailure, Schema.TaggedStruct<"AgentPersistenceFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** A typed persistence acquire, validation, or release failure. */
+export declare class AgentPersistenceFailure extends AgentPersistenceFailure_base {
+}
+/** Retains the original failure for compatibility callers.
+ * @param cause - Persistence provider or protocol error.
+ * @returns A tagged persistence failure.
+ * @example agentPersistenceFailure(new Error("store unavailable"));
+ */
+export declare function agentPersistenceFailure(cause: unknown): AgentPersistenceFailure;
+export {};
+//# sourceMappingURL=persistence-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-error.d.ts","sourceRoot":"","sources":["../src/persistence-error.ts"],"names":[],"mappings":"AAAA,mIAAmI;AAEnI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,mEAAmE;AACnE,qBAAa,uBAAwB,SAAQ,4BAG5C;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAK/E"}

package/dist/persistence-error.js

@@ -0,0 +1,17 @@
+/** Defines typed failures for native persistence acquisition and release, retaining the selected resource and underlying cause. */
+import { Schema } from "effect";
+/** A typed persistence acquire, validation, or release failure. */
+export class AgentPersistenceFailure extends Schema.TaggedError()("AgentPersistenceFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Retains the original failure for compatibility callers.
+ * @param cause - Persistence provider or protocol error.
+ * @returns A tagged persistence failure.
+ * @example agentPersistenceFailure(new Error("store unavailable"));
+ */
+export function agentPersistenceFailure(cause) {
+    return new AgentPersistenceFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=persistence-error.js.map