@relkit/langchain 0.0.0-stage → 0.7.10

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

@@ -0,0 +1,5 @@
+/** Publishes native invocation loop observations to RELKIT telemetry using the current execution context and stable agent identifiers. */
+import type { ProtocolEvent } from "@langchain/langgraph";
+import type { AgentRuntimeOptions } from "./runtime.js";
+export declare function createLoopTelemetry(runtime: AgentRuntimeOptions, modelId: string): (event: ProtocolEvent) => void;
+//# sourceMappingURL=runtime-loop-telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop-telemetry.d.ts","sourceRoot":"","sources":["../src/runtime-loop-telemetry.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAE1I,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,IAEvE,OAAO,aAAa,KAAG,IAAI,CA8CpC"}

package/dist/runtime-loop-telemetry.js

@@ -0,0 +1,62 @@
+/** Publishes native invocation loop observations to RELKIT telemetry using the current execution context and stable agent identifiers. */
+import { frameworkTrace } from "@relkit/invocation";
+import { relkitToolRefs } from "./define-agent-native.js";
+import { emitAgentEdge } from "@relkit/agents/internal/observability";
+import { findModelTool } from "./runtime-tools.js";
+export function createLoopTelemetry(runtime, modelId) {
+    let step = 0;
+    return (event) => {
+        if (event.method === "tasks" && isRecord(event.params.data)) {
+            const data = event.params.data;
+            if (data.name === "model_request" && !("result" in data)) {
+                step += 1;
+                frameworkTrace.event("agent.model.step.started", { "relkit.agent.step": step });
+                emitAgentEdge(runtime.hooks, {
+                    relationship: "uses-provider-profile",
+                    from: runtime.agent.id,
+                    to: modelId,
+                });
+            }
+            else if (data.name === "model_request" && "result" in data) {
+                frameworkTrace.event("agent.model.step.completed", { "relkit.agent.step": step });
+            }
+            return;
+        }
+        if (event.method !== "tools" || !isRecord(event.params.data))
+            return;
+        const data = event.params.data;
+        const name = typeof data.tool_name === "string" ? data.tool_name : "unknown";
+        const callId = typeof data.tool_call_id === "string" ? data.tool_call_id : "unknown";
+        const refs = relkitToolRefs(runtime.agent.tools);
+        const descriptor = findModelTool(runtime.tools, refs, name);
+        if (data.event === "tool-started") {
+            frameworkTrace.event("agent.tool.started", {
+                "relkit.tool.id": descriptor?.id ?? name,
+                "relkit.tool.call.id": callId,
+            });
+            if (descriptor === undefined)
+                return;
+            emitAgentEdge(runtime.hooks, {
+                relationship: "uses-tool",
+                from: runtime.agent.id,
+                to: descriptor.id,
+            });
+            emitAgentEdge(runtime.hooks, {
+                relationship: "targets-function",
+                from: descriptor.id,
+                to: descriptor.target.ref.id,
+            });
+        }
+        else if (data.event === "tool-finished" || data.event === "tool-error") {
+            frameworkTrace.event("agent.tool.completed", {
+                "relkit.tool.id": descriptor?.id ?? name,
+                "relkit.tool.call.id": callId,
+                "relkit.tool.failed": data.event === "tool-error",
+            });
+        }
+    };
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-loop-telemetry.js.map

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

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

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

@@ -0,0 +1,52 @@
+/** Extracts validated loop input and output values for native execution, keeping schema failure handling at the invocation boundary. */
+import { Effect } from "effect";
+import type { AgentLoopOptions } from "./runtime-loop.types.js";
+/** Builds the native message list from prior turns and validated input.
+ * @param options - Invocation messages.
+ * @param input - Current validated input.
+ * @param maxInputBytes - Input byte cap.
+ * @returns An Effect with native messages or AgentInvocationFailure.
+ * @example Effect.runSync(nativeMessagesEffect(options, input, 1024));
+ */
+export declare const nativeMessagesEffect: (options: AgentLoopOptions, input: unknown, maxInputBytes: number) => Effect.Effect<{
+    role: "user" | "assistant";
+    content: string;
+}[], import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Builds native messages for existing synchronous callers.
+ * @param options - Invocation messages.
+ * @param input - Current validated input.
+ * @param maxInputBytes - Input byte cap.
+ * @returns Native message list.
+ * @throws The original input JSON or byte limit error.
+ * @example nativeMessages(options, input, 1024);
+ */
+export declare function nativeMessages(options: AgentLoopOptions, input: unknown, maxInputBytes: number): {
+    role: "user" | "assistant";
+    content: string;
+}[];
+/** Extracts the structured model output value.
+ * @param state - Native agent result state.
+ * @returns An Effect with output or AgentInvocationFailure.
+ * @example Effect.runSync(responseValueEffect(state));
+ */
+export declare const responseValueEffect: (state: unknown) => Effect.Effect<unknown, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Extracts structured output for existing synchronous callers.
+ * @param state - Native agent result state.
+ * @returns Output value.
+ * @throws AgentRuntimeError when structured output is absent.
+ * @example responseValue(state);
+ */
+export declare function responseValue(state: unknown): unknown;
+/** Unwraps nested native provider causes without looping on cyclic causes.
+ * @param value - Native provider failure.
+ * @returns An Effect with the deepest distinct cause.
+ * @example Effect.runSync(unwrapNativeCauseEffect(error));
+ */
+export declare const unwrapNativeCauseEffect: (value: unknown) => Effect.Effect<unknown, never, never>;
+/** Unwraps native causes for existing synchronous callers.
+ * @param value - Native provider failure.
+ * @returns Deepest distinct cause.
+ * @example unwrapNativeCause(error);
+ */
+export declare function unwrapNativeCause(value: unknown): unknown;
+//# sourceMappingURL=runtime-loop-values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop-values.d.ts","sourceRoot":"","sources":["../src/runtime-loop-values.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAExI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;uEAYhC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM;;;IAM9F;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,+GAmB/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMrD;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,0DAYnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD"}

package/dist/runtime-loop-values.js

@@ -0,0 +1,85 @@
+/** Extracts validated loop input and output values for native execution, keeping schema failure handling at the invocation boundary. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { jsonValueEffect } from "./runtime-utils.js";
+/** Builds the native message list from prior turns and validated input.
+ * @param options - Invocation messages.
+ * @param input - Current validated input.
+ * @param maxInputBytes - Input byte cap.
+ * @returns An Effect with native messages or AgentInvocationFailure.
+ * @example Effect.runSync(nativeMessagesEffect(options, input, 1024));
+ */
+export const nativeMessagesEffect = Effect.fn("Agents.runtime.nativeMessages")(function* (options, input, maxInputBytes) {
+    const safeInput = yield* jsonValueEffect(input, maxInputBytes, "agent input");
+    return [
+        ...(options.messages ?? []).map((message) => ({
+            role: message.role,
+            content: message.content,
+        })),
+        { role: "user", content: JSON.stringify(safeInput) },
+    ];
+}, (effect) => observeAgent("runtime.native-messages", effect));
+/** Builds native messages for existing synchronous callers.
+ * @param options - Invocation messages.
+ * @param input - Current validated input.
+ * @param maxInputBytes - Input byte cap.
+ * @returns Native message list.
+ * @throws The original input JSON or byte limit error.
+ * @example nativeMessages(options, input, 1024);
+ */
+export function nativeMessages(options, input, maxInputBytes) {
+    return Effect.runSync(nativeMessagesEffect(options, input, maxInputBytes).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Extracts the structured model output value.
+ * @param state - Native agent result state.
+ * @returns An Effect with output or AgentInvocationFailure.
+ * @example Effect.runSync(responseValueEffect(state));
+ */
+export const responseValueEffect = Effect.fn("Agents.runtime.responseValue")((state) => Effect.try({
+    try: () => {
+        if (!isRecord(state) ||
+            !isRecord(state.structuredResponse) ||
+            !("value" in state.structuredResponse)) {
+            throw new AgentRuntimeError("RELKIT_AGENT_OUTPUT_VALIDATION", "Structured output is unavailable");
+        }
+        return state.structuredResponse.value;
+    },
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.response-value", effect));
+/** Extracts structured output for existing synchronous callers.
+ * @param state - Native agent result state.
+ * @returns Output value.
+ * @throws AgentRuntimeError when structured output is absent.
+ * @example responseValue(state);
+ */
+export function responseValue(state) {
+    return Effect.runSync(responseValueEffect(state).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Unwraps nested native provider causes without looping on cyclic causes.
+ * @param value - Native provider failure.
+ * @returns An Effect with the deepest distinct cause.
+ * @example Effect.runSync(unwrapNativeCauseEffect(error));
+ */
+export const unwrapNativeCauseEffect = Effect.fn("Agents.runtime.unwrapNativeCause")((value) => Effect.sync(() => {
+    const seen = new Set();
+    let current = value;
+    while (isRecord(current) && current.cause !== undefined && !seen.has(current.cause)) {
+        seen.add(current);
+        current = current.cause;
+    }
+    return current;
+}), (effect) => observeAgent("runtime.unwrap-native-cause", effect));
+/** Unwraps native causes for existing synchronous callers.
+ * @param value - Native provider failure.
+ * @returns Deepest distinct cause.
+ * @example unwrapNativeCause(error);
+ */
+export function unwrapNativeCause(value) {
+    return Effect.runSync(unwrapNativeCauseEffect(value));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-loop-values.js.map

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

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

package/dist/runtime-loop.d.ts

@@ -0,0 +1,36 @@
+import { Effect } from "effect";
+import type { AgentCapturePolicy } from "@relkit/agents/internal/observability";
+import type { AgentLoopOptions, NativeModel } from "./runtime-loop.types.js";
+export type { AgentLoopOptions, NativeModel } from "./runtime-loop.types.js";
+/** Runs one native model loop with linked Effect cancellation.
+ * @param options - Runtime and invocation integrations.
+ * @param model - Resolved native model.
+ * @param modelId - Stable model identity.
+ * @param signal - Invocation cancellation signal.
+ * @param input - Validated invocation input.
+ * @param maxInputBytes - Input byte cap.
+ * @param maxOutputBytes - Output byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param capture - Capture policy.
+ * @returns An Effect with validated output or AgentInvocationFailure.
+ * @example await Effect.runPromise(runAgentLoopEffect(options, model, id, signal, input, 1024, 1024, invocation, trace, capture));
+ */
+export declare const runAgentLoopEffect: (options: AgentLoopOptions, model: NativeModel, modelId: string, signal: AbortSignal, input: unknown, maxInputBytes: number, maxOutputBytes: number, invocationId: string, traceId: string, capture: AgentCapturePolicy) => Effect.Effect<unknown, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Runs the native model loop for existing Promise callers.
+ * @param options - Runtime and invocation integrations.
+ * @param model - Resolved native model.
+ * @param modelId - Stable model identity.
+ * @param signal - Invocation cancellation signal.
+ * @param input - Validated invocation input.
+ * @param maxInputBytes - Input byte cap.
+ * @param maxOutputBytes - Output byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param capture - Capture policy.
+ * @returns Validated output.
+ * @throws The original model, tool, validation, or cancellation error.
+ * @example await runAgentLoop(options, model, id, signal, input, 1024, 1024, invocation, trace, capture);
+ */
+export declare function runAgentLoop(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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop.d.ts","sourceRoot":"","sources":["../src/runtime-loop.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,uTA8B9B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,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,CAelB"}

package/dist/runtime-loop.js

@@ -0,0 +1,45 @@
+/**
+ * Exposes native loop execution as an observed Effect and Promise facade.
+ * Cancellation remains linked to the caller and the native stream owner.
+ */
+import { runAgentLoopCore } from "./runtime-loop-execution.js";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+/** Runs one native model loop with linked Effect cancellation.
+ * @param options - Runtime and invocation integrations.
+ * @param model - Resolved native model.
+ * @param modelId - Stable model identity.
+ * @param signal - Invocation cancellation signal.
+ * @param input - Validated invocation input.
+ * @param maxInputBytes - Input byte cap.
+ * @param maxOutputBytes - Output byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param capture - Capture policy.
+ * @returns An Effect with validated output or AgentInvocationFailure.
+ * @example await Effect.runPromise(runAgentLoopEffect(options, model, id, signal, input, 1024, 1024, invocation, trace, capture));
+ */
+export const runAgentLoopEffect = Effect.fn("Agents.runtime.runLoop")((options, model, modelId, signal, input, maxInputBytes, maxOutputBytes, invocationId, traceId, capture) => Effect.tryPromise({
+    try: (effectSignal) => runAgentLoopCore(options, model, modelId, AbortSignal.any([signal, effectSignal]), input, maxInputBytes, maxOutputBytes, invocationId, traceId, capture),
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.run-loop", effect));
+/** Runs the native model loop for existing Promise callers.
+ * @param options - Runtime and invocation integrations.
+ * @param model - Resolved native model.
+ * @param modelId - Stable model identity.
+ * @param signal - Invocation cancellation signal.
+ * @param input - Validated invocation input.
+ * @param maxInputBytes - Input byte cap.
+ * @param maxOutputBytes - Output byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @param capture - Capture policy.
+ * @returns Validated output.
+ * @throws The original model, tool, validation, or cancellation error.
+ * @example await runAgentLoop(options, model, id, signal, input, 1024, 1024, invocation, trace, capture);
+ */
+export function runAgentLoop(options, model, modelId, signal, input, maxInputBytes, maxOutputBytes, invocationId, traceId, capture) {
+    return Effect.runPromise(runAgentLoopEffect(options, model, modelId, signal, input, maxInputBytes, maxOutputBytes, invocationId, traceId, capture).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+//# sourceMappingURL=runtime-loop.js.map

package/dist/runtime-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop.js","sourceRoot":"","sources":["../src/runtime-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAKnE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CACnE,CACE,OAAyB,EACzB,KAAkB,EAClB,OAAe,EACf,MAAmB,EACnB,KAAc,EACd,aAAqB,EACrB,cAAsB,EACtB,YAAoB,EACpB,OAAe,EACf,OAA2B,EAC3B,EAAE,CACF,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE,CACpB,gBAAgB,CACd,OAAO,EACP,KAAK,EACL,OAAO,EACP,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EACvC,KAAK,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,OAAO,EACP,OAAO,CACR;IACH,KAAK,EAAE,sBAAsB;CAC9B,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CACrD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAyB,EACzB,KAAkB,EAClB,OAAe,EACf,MAAmB,EACnB,KAAc,EACd,aAAqB,EACrB,cAAsB,EACtB,YAAoB,EACpB,OAAe,EACf,OAA2B;IAE3B,OAAO,MAAM,CAAC,UAAU,CACtB,kBAAkB,CAChB,OAAO,EACP,KAAK,EACL,OAAO,EACP,MAAM,EACN,KAAK,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,OAAO,EACP,OAAO,CACR,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAC3F,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+/** Coordinates native invocation steps, output validation and settlement while retaining tool, interruption and stream finalization order. This companion preserves the native input and output types without starting runtime work. */
+import type { LanguageModelLike } from "@langchain/core/language_models/base";
+import type { AgentInvocationOptions, AgentRuntimeOptions } from "./runtime.js";
+/** Runtime and invocation options consumed by the native model loop. */
+export type AgentLoopOptions = AgentRuntimeOptions & AgentInvocationOptions;
+/** Resolved native model or provider selector. */
+export type NativeModel = string | LanguageModelLike;
+//# sourceMappingURL=runtime-loop.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loop.types.d.ts","sourceRoot":"","sources":["../src/runtime-loop.types.ts"],"names":[],"mappings":"AAAA,wOAAwO;AAExO,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEhF,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAE5E,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,iBAAiB,CAAC"}

package/dist/runtime-loop.types.js

@@ -0,0 +1,3 @@
+/** Coordinates native invocation steps, output validation and settlement while retaining tool, interruption and stream finalization order. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=runtime-loop.types.js.map

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

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

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

@@ -0,0 +1,17 @@
+/** Defines model selection and initialization failures with the selected model identifier and underlying SDK cause. */
+import { Schema } from "effect";
+declare const AgentModelResolutionFailure_base: Schema.Class<AgentModelResolutionFailure, Schema.TaggedStruct<"AgentModelResolutionFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** Tagged model resolution or content limit failure. */
+export declare class AgentModelResolutionFailure extends AgentModelResolutionFailure_base {
+}
+/** Preserves a model provider or limit error for Effect callers.
+ * @param cause - Provider or validation failure.
+ * @returns A tagged model resolution failure.
+ * @example agentModelResolutionFailure(new Error("unavailable"));
+ */
+export declare function agentModelResolutionFailure(cause: unknown): AgentModelResolutionFailure;
+export {};
+//# sourceMappingURL=runtime-model-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model-error.d.ts","sourceRoot":"","sources":["../src/runtime-model-error.ts"],"names":[],"mappings":"AAAA,uHAAuH;AAEvH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,wDAAwD;AACxD,qBAAa,2BAA4B,SAAQ,gCAGhD;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,CAKvF"}

package/dist/runtime-model-error.js

@@ -0,0 +1,17 @@
+/** Defines model selection and initialization failures with the selected model identifier and underlying SDK cause. */
+import { Schema } from "effect";
+/** Tagged model resolution or content limit failure. */
+export class AgentModelResolutionFailure extends Schema.TaggedError()("AgentModelResolutionFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Preserves a model provider or limit error for Effect callers.
+ * @param cause - Provider or validation failure.
+ * @returns A tagged model resolution failure.
+ * @example agentModelResolutionFailure(new Error("unavailable"));
+ */
+export function agentModelResolutionFailure(cause) {
+    return new AgentModelResolutionFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=runtime-model-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model-error.js","sourceRoot":"","sources":["../src/runtime-model-error.ts"],"names":[],"mappings":"AAAA,uHAAuH;AAEvH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,wDAAwD;AACxD,MAAM,OAAO,2BAA4B,SAAQ,MAAM,CAAC,WAAW,EAA+B,CAChG,6BAA6B,EAC7B,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,OAAO,IAAI,2BAA2B,CAAC;QACrC,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-model.d.ts

@@ -0,0 +1,31 @@
+/** Resolves authored model selectors or native model instances for an invocation without replacing the caller's model resource identity. */
+import { Effect } from "effect";
+import type { AgentContentLimits, ResolvedRuntimeModel, RuntimeModelOptions } from "./runtime-model.types.js";
+export type { AgentContentLimits, ResolvedRuntimeModel, RuntimeModelOptions, } from "./runtime-model.types.js";
+/** Resolves a model factory, native model, registry selection, or string selector.
+ * @param options - Model declaration, registry, environment, and content limits.
+ * @returns An Effect with a model and limits or AgentModelResolutionFailure.
+ * @example Effect.runPromise(resolveRuntimeModelEffect({ model: "test", registry: null, environment: {} }));
+ */
+export declare const resolveRuntimeModelEffect: (options: RuntimeModelOptions) => Effect.Effect<ResolvedRuntimeModel, import("./runtime-model-error.js").AgentModelResolutionFailure, never>;
+/** Resolves a model for existing Promise runtime callers.
+ * @param options - Model declaration, registry, environment, and content limits.
+ * @returns A selected model and validated limits.
+ * @throws The original provider or AgentRuntimeError cause.
+ * @example await resolveRuntimeModel({ model: "test", registry: null, environment: {} });
+ */
+export declare function resolveRuntimeModel(options: RuntimeModelOptions): Promise<ResolvedRuntimeModel>;
+/** Validates content byte limits against fixed package maximums.
+ * @param options - Optional input and output byte limits.
+ * @returns An Effect with limits or AgentModelResolutionFailure.
+ * @example Effect.runSync(resolveAgentContentLimitsEffect({ maxInputBytes: 1024 }));
+ */
+export declare const resolveAgentContentLimitsEffect: (options: Pick<RuntimeModelOptions, "maxInputBytes" | "maxOutputBytes">) => Effect.Effect<AgentContentLimits, import("./runtime-model-error.js").AgentModelResolutionFailure, never>;
+/** Validates content byte limits for existing synchronous runtime callers.
+ * @param options - Optional input and output byte limits.
+ * @returns Fixed and validated limits.
+ * @throws The original AgentRuntimeError for invalid limits.
+ * @example resolveAgentContentLimits({ maxInputBytes: 1024 });
+ */
+export declare function resolveAgentContentLimits(options: Pick<RuntimeModelOptions, "maxInputBytes" | "maxOutputBytes">): AgentContentLimits;
+//# sourceMappingURL=runtime-model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model.d.ts","sourceRoot":"","sources":["../src/runtime-model.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAG5I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAKlC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,8IA4CrC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAM/F;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,sLAU3C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,GAAG,gBAAgB,CAAC,GACrE,kBAAkB,CAMpB"}

package/dist/runtime-model.js

@@ -0,0 +1,126 @@
+/** Resolves authored model selectors or native model instances for an invocation without replacing the caller's model resource identity. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { agentModelResolutionFailure } from "./runtime-model-error.js";
+const DEFAULT_MAX_INPUT_BYTES = 64 * 1024;
+const DEFAULT_MAX_OUTPUT_BYTES = 16 * 1024;
+/** Resolves a model factory, native model, registry selection, or string selector.
+ * @param options - Model declaration, registry, environment, and content limits.
+ * @returns An Effect with a model and limits or AgentModelResolutionFailure.
+ * @example Effect.runPromise(resolveRuntimeModelEffect({ model: "test", registry: null, environment: {} }));
+ */
+export const resolveRuntimeModelEffect = Effect.fn("Agents.runtime.resolveModel")(function* (options) {
+    const { maxInputBytes, maxOutputBytes } = yield* resolveAgentContentLimitsEffect(options);
+    if (typeof options.model === "function") {
+        return yield* resolveFactoryModelEffect(options.model, options.environment, {
+            maxInputBytes,
+            maxOutputBytes,
+        });
+    }
+    if (options.model !== undefined && typeof options.model !== "string") {
+        return yield* Effect.try({
+            try: () => ({
+                id: nativeId(options.model),
+                model: asLanguageModel(options.model),
+                maxInputBytes,
+                maxOutputBytes,
+            }),
+            catch: agentModelResolutionFailure,
+        });
+    }
+    const registry = isRecord(options.registry)
+        ? options.registry
+        : undefined;
+    if (registry === undefined || typeof registry.resolveModel !== "function") {
+        if (typeof options.model === "string") {
+            return { id: options.model, model: options.model, maxInputBytes, maxOutputBytes };
+        }
+        return yield* Effect.fail(unavailable());
+    }
+    const selected = yield* Effect.tryPromise({
+        try: () => Promise.resolve(registry.resolveModel(options.model)),
+        catch: agentModelResolutionFailure,
+    });
+    if (!isRecord(selected) || typeof selected.id !== "string" || selected.model === undefined) {
+        return yield* Effect.fail(unavailable());
+    }
+    return {
+        id: selected.id,
+        model: selected.model,
+        maxInputBytes,
+        maxOutputBytes,
+    };
+}, (effect) => observeAgent("runtime.resolve-model", effect));
+/** Resolves a model for existing Promise runtime callers.
+ * @param options - Model declaration, registry, environment, and content limits.
+ * @returns A selected model and validated limits.
+ * @throws The original provider or AgentRuntimeError cause.
+ * @example await resolveRuntimeModel({ model: "test", registry: null, environment: {} });
+ */
+export function resolveRuntimeModel(options) {
+    return Effect.runPromise(resolveRuntimeModelEffect(options).pipe(Effect.catchTag("AgentModelResolutionFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Validates content byte limits against fixed package maximums.
+ * @param options - Optional input and output byte limits.
+ * @returns An Effect with limits or AgentModelResolutionFailure.
+ * @example Effect.runSync(resolveAgentContentLimitsEffect({ maxInputBytes: 1024 }));
+ */
+export const resolveAgentContentLimitsEffect = Effect.fn("Agents.runtime.contentLimits")((options) => Effect.try({
+    try: () => ({
+        maxInputBytes: boundedLimit(options.maxInputBytes, DEFAULT_MAX_INPUT_BYTES),
+        maxOutputBytes: boundedLimit(options.maxOutputBytes, DEFAULT_MAX_OUTPUT_BYTES),
+    }),
+    catch: agentModelResolutionFailure,
+}), (effect) => observeAgent("runtime.content-limits", effect));
+/** Validates content byte limits for existing synchronous runtime callers.
+ * @param options - Optional input and output byte limits.
+ * @returns Fixed and validated limits.
+ * @throws The original AgentRuntimeError for invalid limits.
+ * @example resolveAgentContentLimits({ maxInputBytes: 1024 });
+ */
+export function resolveAgentContentLimits(options) {
+    return Effect.runSync(resolveAgentContentLimitsEffect(options).pipe(Effect.catchTag("AgentModelResolutionFailure", (failure) => Effect.fail(failure.cause))));
+}
+function nativeId(model) {
+    const value = model;
+    const name = typeof value.name === "string" ? value.name : value.constructor?.name;
+    return `native:${typeof name === "string" && name !== "" ? name : "model"}`;
+}
+function asLanguageModel(model) {
+    return model;
+}
+function boundedLimit(value, providerLimit) {
+    const limit = value ?? providerLimit;
+    if (!Number.isSafeInteger(limit) || limit <= 0 || limit > providerLimit) {
+        throw new AgentRuntimeError("RELKIT_AGENT_LIMIT_INVALID", "Agent content limit is invalid");
+    }
+    return limit;
+}
+function unavailable() {
+    return agentModelResolutionFailure(new AgentRuntimeError("RELKIT_AGENT_MODEL_UNAVAILABLE", "Agent model is unavailable"));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object";
+}
+/** Resolves a lazy native model factory while retaining its original failure.
+ * @param factory - Environment-bound native model constructor.
+ * @param environment - Validated application environment.
+ * @param limits - Resolved content byte limits.
+ * @returns A native model identity and its content limits.
+ */
+const resolveFactoryModelEffect = Effect.fn("Agents.runtime.resolveFactoryModel")(function* (factory, environment, limits) {
+    const model = yield* Effect.tryPromise({
+        try: () => Promise.resolve(factory(environment)),
+        catch: agentModelResolutionFailure,
+    });
+    return yield* Effect.try({
+        try: () => ({
+            id: nativeId(model),
+            model: asLanguageModel(model),
+            ...limits,
+        }),
+        catch: agentModelResolutionFailure,
+    });
+});
+//# sourceMappingURL=runtime-model.js.map

package/dist/runtime-model.js.map

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

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

@@ -0,0 +1,22 @@
+/** Resolves authored model selectors or native model instances for an invocation without replacing the caller's model resource identity. This companion preserves the native input and output types without starting runtime work. */
+import type { LanguageModelLike } from "@langchain/core/language_models/base";
+import type { AgentModel } from "./define-agent-native.types.js";
+/** Inputs used to select a native model and content limits. */
+export interface RuntimeModelOptions {
+    readonly model?: AgentModel;
+    readonly registry: unknown;
+    readonly environment: Readonly<Record<string, unknown>>;
+    readonly maxInputBytes?: number;
+    readonly maxOutputBytes?: number;
+}
+/** Validated maximum byte counts for agent input and output. */
+export interface AgentContentLimits {
+    readonly maxInputBytes: number;
+    readonly maxOutputBytes: number;
+}
+/** Selected native model and validated content limits. */
+export interface ResolvedRuntimeModel extends AgentContentLimits {
+    readonly id: string;
+    readonly model: string | LanguageModelLike;
+}
+//# sourceMappingURL=runtime-model.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model.types.d.ts","sourceRoot":"","sources":["../src/runtime-model.types.ts"],"names":[],"mappings":"AAAA,sOAAsO;AAEtO,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAC5C"}

package/dist/runtime-model.types.js

@@ -0,0 +1,3 @@
+/** Resolves authored model selectors or native model instances for an invocation without replacing the caller's model resource identity. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=runtime-model.types.js.map

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

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