@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/runtime-native-tool-build.d.ts

@@ -0,0 +1,12 @@
+import type { ClientTool, ServerTool } from "@langchain/core/tools";
+import { tool } from "langchain";
+import type { AgentTool } from "./define-agent-native.types.js";
+import type { NativeToolBuildContext } from "./runtime-native-tool-build.types.js";
+/** Resolves one authored tool and records its public native mapping.
+ * @param entry - RELKIT reference or native tool.
+ * @param index - Authored position.
+ * @param context - Invocation-owned mapping and failure authority.
+ * @returns The native tool preserving the original validation boundary.
+ */
+export declare function nativeToolEntry(entry: AgentTool, index: number, context: NativeToolBuildContext): ClientTool | ServerTool | ReturnType<typeof tool>;
+//# sourceMappingURL=runtime-native-tool-build.d.ts.map

package/dist/runtime-native-tool-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-tool-build.d.ts","sourceRoot":"","sources":["../src/runtime-native-tool-build.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,sBAAsB,GAC9B,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAoBnD"}

package/dist/runtime-native-tool-build.js

@@ -0,0 +1,81 @@
+/**
+ * Converts one checked reference into a native tool while preserving common-engine
+ * execution, trace context and the deferred approval failure reader.
+ */
+import { getJsonSchema } from "@relkit/schema";
+import { frameworkTrace } from "@relkit/invocation";
+import { isToolRef } from "@relkit/tools";
+import { tool } from "langchain";
+import { Effect } from "effect";
+import { AgentInvocationFailure, agentInvocationFailure } from "./runtime-effect-error.js";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { findTool, modelToolName, runToolEffect } from "./runtime-tools.js";
+/** Resolves one authored tool and records its public native mapping.
+ * @param entry - RELKIT reference or native tool.
+ * @param index - Authored position.
+ * @param context - Invocation-owned mapping and failure authority.
+ * @returns The native tool preserving the original validation boundary.
+ */
+export function nativeToolEntry(entry, index, context) {
+    const { options, publicIds, relkitNames } = context;
+    if (!isToolRef(entry)) {
+        const name = nativeName(entry);
+        if (name !== undefined)
+            publicIds.set(name, name);
+        return entry;
+    }
+    const registered = findTool(options.tools, entry.ref.id);
+    if (registered === undefined) {
+        throw new AgentRuntimeError("RELKIT_TOOL_UNKNOWN", "Agent tool is not registered");
+    }
+    const projection = getJsonSchema(registered.target.input);
+    if (!projection.ok) {
+        throw new AgentRuntimeError("RELKIT_SCHEMA_UNAVAILABLE", "Tool input schema is unavailable");
+    }
+    const name = modelToolName(registered.id, index);
+    publicIds.set(name, registered.id);
+    relkitNames.add(name);
+    return createRelkitNativeTool(registered, projection.schema, name, context);
+}
+/** Creates a callback after its descriptor/schema have been checked.
+ * @param registered - RELKIT descriptor.
+ * @param schema - Projected native input schema.
+ * @param name - Stable model-facing name.
+ * @param context - Invocation-owned dependencies.
+ * @returns A native callback executing once through the common engine.
+ */
+function createRelkitNativeTool(registered, schema, name, context) {
+    const { options, signal, maxOutputBytes, invocationId, traceId, identity } = context;
+    return tool(async (input, config) => {
+        const callId = config.toolCall?.id ?? identity.randomUUID();
+        const result = Effect.tryPromise({
+            try: (effectSignal) => {
+                const combined = AbortSignal.any([signal, effectSignal]);
+                return frameworkTrace.span(`relkit.tool.${registered.id}`, {
+                    input,
+                    attributes: {
+                        "relkit.tool.id": registered.id,
+                        "relkit.tool.call.id": callId,
+                    },
+                }, () => Effect.runPromise(runToolEffect(options, { callId, toolId: registered.id, input }, combined, maxOutputBytes, invocationId, traceId)));
+            },
+            catch: agentInvocationFailure,
+        }).pipe(Effect.catchTag("AgentInvocationFailure", (error) => recordNativeToolFailure(context, error)));
+        return Effect.runPromise(result, { signal: config.signal ?? signal });
+    }, { name, description: registered.description, schema: schema });
+}
+/** Records the deferred failure and returns the existing paused tool value.
+ * @param context - Invocation failure authority.
+ * @param error - Native callback failure.
+ * @returns The canonical paused response expected by the native loop.
+ */
+function recordNativeToolFailure(context, error) {
+    return Effect.sync(() => {
+        context.setFailure(error.cause instanceof AgentInvocationFailure ? error.cause.cause : error.cause);
+        return { error: { code: "RELKIT_APPROVAL_REQUIRED", message: "Tool call paused" } };
+    });
+}
+function nativeName(value) {
+    return "name" in value && typeof value.name === "string" ? value.name : undefined;
+}
+//# sourceMappingURL=runtime-native-tool-build.js.map

package/dist/runtime-native-tool-build.js.map

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

package/dist/runtime-native-tool-build.types.d.ts

@@ -0,0 +1,14 @@
+/** Invocation-owned tool identity maps and deferred native failure authority. */
+import type { NativeToolIdentityService, NativeToolRuntimeOptions } from "./runtime-native-tools.types.js";
+export interface NativeToolBuildContext {
+    readonly options: NativeToolRuntimeOptions;
+    readonly signal: AbortSignal;
+    readonly maxOutputBytes: number;
+    readonly invocationId: string;
+    readonly traceId: string;
+    readonly identity: NativeToolIdentityService;
+    readonly publicIds: Map<string, string>;
+    readonly relkitNames: Set<string>;
+    readonly setFailure: (cause: unknown) => void;
+}
+//# sourceMappingURL=runtime-native-tool-build.types.d.ts.map

package/dist/runtime-native-tool-build.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-tool-build.types.d.ts","sourceRoot":"","sources":["../src/runtime-native-tool-build.types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AACzC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C"}

package/dist/runtime-native-tool-build.types.js

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

package/dist/runtime-native-tool-build.types.js.map

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

package/dist/runtime-native-tools-identity.d.ts

@@ -0,0 +1,15 @@
+/** Derives stable native tool identities used by descriptor adaptation and runtime dispatch without cloning the SDK tool instances. */
+import { Context, Layer } from "effect";
+import type { NativeToolIdentityService } from "./runtime-native-tools.types.js";
+declare const NativeToolIdentity_base: Context.ServiceClass<NativeToolIdentity, "relkit/agents/NativeToolIdentity", NativeToolIdentityService>;
+/** Substitutable native tool call identity source.
+ * @example Effect.provide(createNativeToolsEffect(options, signal, 1024, id, trace), NativeToolIdentityLive);
+ */
+export declare class NativeToolIdentity extends NativeToolIdentity_base {
+}
+/** Live UUID source for native tool calls.
+ * @example Effect.runSync(Effect.provide(effect, NativeToolIdentityLive));
+ */
+export declare const NativeToolIdentityLive: Layer.Layer<NativeToolIdentity, never, never>;
+export {};
+//# sourceMappingURL=runtime-native-tools-identity.d.ts.map

package/dist/runtime-native-tools-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-tools-identity.d.ts","sourceRoot":"","sources":["../src/runtime-native-tools-identity.ts"],"names":[],"mappings":"AAAA,uIAAuI;AAEvI,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;;AAEjF;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,uBAGD;CAAG;AAE1C;;GAEG;AACH,eAAO,MAAM,sBAAsB,+CAKlC,CAAC"}

package/dist/runtime-native-tools-identity.js

@@ -0,0 +1,14 @@
+/** Derives stable native tool identities used by descriptor adaptation and runtime dispatch without cloning the SDK tool instances. */
+import { Context, Layer } from "effect";
+/** Substitutable native tool call identity source.
+ * @example Effect.provide(createNativeToolsEffect(options, signal, 1024, id, trace), NativeToolIdentityLive);
+ */
+export class NativeToolIdentity extends Context.Service()("relkit/agents/NativeToolIdentity") {
+}
+/** Live UUID source for native tool calls.
+ * @example Effect.runSync(Effect.provide(effect, NativeToolIdentityLive));
+ */
+export const NativeToolIdentityLive = Layer.succeed(NativeToolIdentity, NativeToolIdentity.of({
+    randomUUID: () => crypto.randomUUID(),
+}));
+//# sourceMappingURL=runtime-native-tools-identity.js.map

package/dist/runtime-native-tools-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-tools-identity.js","sourceRoot":"","sources":["../src/runtime-native-tools-identity.ts"],"names":[],"mappings":"AAAA,uIAAuI;AAEvI,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGxC;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,OAAO,CAAC,OAAO,EAGpD,CAAC,kCAAkC,CAAC;CAAG;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC,OAAO,CACjD,kBAAkB,EAClB,kBAAkB,CAAC,EAAE,CAAC;IACpB,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;CACtC,CAAC,CACH,CAAC"}

package/dist/runtime-native-tools.d.ts

@@ -0,0 +1,29 @@
+/** Combines authored native tools and RELKIT callable adapters for invocation, retaining input schemas and native dispatch identity. */
+import { Effect } from "effect";
+import { AgentInvocationFailure } from "./runtime-effect-error.js";
+import { NativeToolIdentity } from "./runtime-native-tools-identity.js";
+import type { NativeTools, NativeToolRuntimeOptions } from "./runtime-native-tools.types.js";
+export type { NativeTools } from "./runtime-native-tools.types.js";
+export { NativeToolIdentity, NativeToolIdentityLive } from "./runtime-native-tools-identity.js";
+/** Materializes LangChain tools with public IDs and an invocation failure reader.
+ * @param options - Runtime integrations and authored tools.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Tool result byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @returns An Effect with native tools or AgentInvocationFailure.
+ * @example Effect.runSync(Effect.provide(createNativeToolsEffect(options, signal, 1024, id, trace), NativeToolIdentityLive));
+ */
+export declare const createNativeToolsEffect: (options: NativeToolRuntimeOptions, signal: AbortSignal, maxOutputBytes: number, invocationId: string, traceId: string) => Effect.Effect<NativeTools, AgentInvocationFailure, NativeToolIdentity>;
+/** Materializes native tools for existing synchronous callers.
+ * @param options - Runtime integrations and authored tools.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Tool result byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @returns Native tools with public ID mappings.
+ * @throws The original unknown tool or schema error.
+ * @example createNativeTools(options, signal, 1024, id, trace);
+ */
+export declare function createNativeTools(options: NativeToolRuntimeOptions, signal: AbortSignal, maxOutputBytes: number, invocationId: string, traceId: string): NativeTools;
+//# sourceMappingURL=runtime-native-tools.d.ts.map

package/dist/runtime-native-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-tools.d.ts","sourceRoot":"","sources":["../src/runtime-native-tools.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAQxI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,2BAA2B,CAAC;AAE3F,OAAO,EAAE,kBAAkB,EAA0B,MAAM,oCAAoC,CAAC;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAG7F,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEhG;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,mMAoCnC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,WAAW,CAOb"}

package/dist/runtime-native-tools.js

@@ -0,0 +1,65 @@
+/** Combines authored native tools and RELKIT callable adapters for invocation, retaining input schemas and native dispatch identity. */
+import { nativeToolEntry } from "./runtime-native-tool-build.js";
+import { getJsonSchema } from "@relkit/schema";
+import { frameworkTrace } from "@relkit/invocation";
+import { isToolRef } from "@relkit/tools";
+import { tool } from "langchain";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { AgentInvocationFailure, agentInvocationFailure } from "./runtime-effect-error.js";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { NativeToolIdentity, NativeToolIdentityLive } from "./runtime-native-tools-identity.js";
+import { findTool, modelToolName, runToolEffect } from "./runtime-tools.js";
+export { NativeToolIdentity, NativeToolIdentityLive } from "./runtime-native-tools-identity.js";
+/** Materializes LangChain tools with public IDs and an invocation failure reader.
+ * @param options - Runtime integrations and authored tools.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Tool result byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @returns An Effect with native tools or AgentInvocationFailure.
+ * @example Effect.runSync(Effect.provide(createNativeToolsEffect(options, signal, 1024, id, trace), NativeToolIdentityLive));
+ */
+export const createNativeToolsEffect = Effect.fn("Agents.runtime.createNativeTools")(function* (options, signal, maxOutputBytes, invocationId, traceId) {
+    const identity = yield* NativeToolIdentity;
+    return yield* Effect.try({
+        try: () => {
+            const publicIds = new Map();
+            const relkitNames = new Set();
+            let failure;
+            const context = {
+                options,
+                signal,
+                maxOutputBytes,
+                invocationId,
+                traceId,
+                identity,
+                publicIds,
+                relkitNames,
+                setFailure: (cause) => {
+                    failure = cause;
+                },
+            };
+            const values = options.agent.tools.map((entry, index) => nativeToolEntry(entry, index, context));
+            return { values, publicIds, relkitNames, failure: () => failure };
+        },
+        catch: agentInvocationFailure,
+    });
+}, (effect) => observeAgent("runtime.create-native-tools", effect));
+/** Materializes native tools for existing synchronous callers.
+ * @param options - Runtime integrations and authored tools.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Tool result byte cap.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Trace identity.
+ * @returns Native tools with public ID mappings.
+ * @throws The original unknown tool or schema error.
+ * @example createNativeTools(options, signal, 1024, id, trace);
+ */
+export function createNativeTools(options, signal, maxOutputBytes, invocationId, traceId) {
+    return Effect.runSync(createNativeToolsEffect(options, signal, maxOutputBytes, invocationId, traceId).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(NativeToolIdentityLive)));
+}
+function nativeName(value) {
+    return "name" in value && typeof value.name === "string" ? value.name : undefined;
+}
+//# sourceMappingURL=runtime-native-tools.js.map

package/dist/runtime-native-tools.js.map

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

package/dist/runtime-native-tools.types.d.ts

@@ -0,0 +1,21 @@
+/** Combines authored native tools and RELKIT callable adapters for invocation, retaining input schemas and native dispatch identity. This companion preserves the native input and output types without starting runtime work. */
+import type { ClientTool, ServerTool } from "@langchain/core/tools";
+import type { AgentInvocationOptions, AgentRuntimeOptions } from "./runtime.js";
+/** Native tools and public identity mapping for one invocation. */
+export interface NativeTools {
+    readonly values: readonly (ClientTool | ServerTool | ReturnType<typeof import("langchain").tool>)[];
+    readonly publicIds: ReadonlyMap<string, string>;
+    readonly relkitNames: ReadonlySet<string>;
+    readonly failure: () => unknown;
+}
+/** Runtime context used to materialize native tools. */
+export type NativeToolRuntimeOptions = AgentRuntimeOptions & AgentInvocationOptions;
+/** Replaceable identity source for native tool calls. */
+export interface NativeToolIdentityService {
+    /** Creates a call identity when LangChain does not supply one.
+     * @returns A UUID.
+     * @example identity.randomUUID();
+     */
+    readonly randomUUID: () => string;
+}
+//# sourceMappingURL=runtime-native-tools.types.d.ts.map

package/dist/runtime-native-tools.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-tools.types.d.ts","sourceRoot":"","sources":["../src/runtime-native-tools.types.ts"],"names":[],"mappings":"AAAA,kOAAkO;AAElO,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEhF,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CACxB,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,cAAc,WAAW,EAAE,IAAI,CAAC,CACtE,EAAE,CAAC;IACJ,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;CACjC;AAED,wDAAwD;AACxD,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAEpF,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;CACnC"}

package/dist/runtime-native-tools.types.js

@@ -0,0 +1,3 @@
+/** Combines authored native tools and RELKIT callable adapters for invocation, retaining input schemas and native dispatch identity. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=runtime-native-tools.types.js.map

package/dist/runtime-native-tools.types.js.map

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

package/dist/runtime-service.d.ts

@@ -0,0 +1,15 @@
+/** Provides the Effect runtime service that composes native model resolution, tools and loop execution under the invocation owner. */
+import { Context, Layer } from "effect";
+import type { AgentExecutionService } from "./runtime-service.types.js";
+export type { AgentExecutionService } from "./runtime-service.types.js";
+declare const AgentExecution_base: Context.ServiceClass<AgentExecution, "relkit/agents/AgentExecution", AgentExecutionService>;
+/** Injectable model, graph, loop, and identity boundary.
+ * @example Effect.provide(invokeAgentEffect(options), AgentExecutionLive);
+ */
+export declare class AgentExecution extends AgentExecution_base {
+}
+/** Live agent integrations used by the Promise compatibility API.
+ * @example Effect.runPromise(Effect.provide(invokeAgentEffect(options), AgentExecutionLive));
+ */
+export declare const AgentExecutionLive: Layer.Layer<AgentExecution, never, never>;
+//# sourceMappingURL=runtime-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-service.d.ts","sourceRoot":"","sources":["../src/runtime-service.ts"],"names":[],"mappings":"AAAA,sIAAsI;AAEtI,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAIhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;;AAExE;;GAEG;AACH,qBAAa,cAAe,SAAQ,mBAEnC;CAAG;AAEJ;;GAEG;AACH,eAAO,MAAM,kBAAkB,2CAU9B,CAAC"}

package/dist/runtime-service.js

@@ -0,0 +1,20 @@
+/** Provides the Effect runtime service that composes native model resolution, tools and loop execution under the invocation owner. */
+import { Context, Effect, Layer } from "effect";
+import { invokeGraph } from "./graph-runtime.js";
+import { runAgentLoop } from "./runtime-loop.js";
+import { resolveRuntimeModel } from "./runtime-model.js";
+/** Injectable model, graph, loop, and identity boundary.
+ * @example Effect.provide(invokeAgentEffect(options), AgentExecutionLive);
+ */
+export class AgentExecution extends Context.Service()("relkit/agents/AgentExecution") {
+}
+/** Live agent integrations used by the Promise compatibility API.
+ * @example Effect.runPromise(Effect.provide(invokeAgentEffect(options), AgentExecutionLive));
+ */
+export const AgentExecutionLive = Layer.effect(AgentExecution, Effect.sync(() => AgentExecution.of({
+    resolveModel: resolveRuntimeModel,
+    runLoop: runAgentLoop,
+    invokeGraph,
+    randomUUID: () => crypto.randomUUID(),
+})));
+//# sourceMappingURL=runtime-service.js.map

package/dist/runtime-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-service.js","sourceRoot":"","sources":["../src/runtime-service.ts"],"names":[],"mappings":"AAAA,sIAAsI;AAEtI,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,OAAO,CAAC,OAAO,EAAyC,CAC1F,8BAA8B,CAC/B;CAAG;AAEJ;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAC5C,cAAc,EACd,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CACf,cAAc,CAAC,EAAE,CAAC;IAChB,YAAY,EAAE,mBAAmB;IACjC,OAAO,EAAE,YAAY;IACrB,WAAW;IACX,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;CACtC,CAAC,CACH,CACF,CAAC"}

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

@@ -0,0 +1,12 @@
+/** Provides the Effect runtime service that composes native model resolution, tools and loop execution under the invocation owner. This companion preserves the native input and output types without starting runtime work. */
+import type { invokeGraph } from "./graph-runtime.js";
+import type { runAgentLoop } from "./runtime-loop.js";
+import type { resolveRuntimeModel } from "./runtime-model.js";
+/** Substitutable integrations used while invoking an agent. */
+export interface AgentExecutionService {
+    readonly resolveModel: typeof resolveRuntimeModel;
+    readonly runLoop: typeof runAgentLoop;
+    readonly invokeGraph: typeof invokeGraph;
+    readonly randomUUID: () => string;
+}
+//# sourceMappingURL=runtime-service.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-service.types.d.ts","sourceRoot":"","sources":["../src/runtime-service.types.ts"],"names":[],"mappings":"AAAA,gOAAgO;AAEhO,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,OAAO,mBAAmB,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,YAAY,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,WAAW,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;CACnC"}

package/dist/runtime-service.types.js

@@ -0,0 +1,3 @@
+/** Provides the Effect runtime service that composes native model resolution, tools and loop execution under the invocation owner. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=runtime-service.types.js.map

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

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

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

@@ -0,0 +1,19 @@
+/** Decodes invocation state and output values at the native runtime boundary before persisted or public projections consume them. */
+import type { StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+/** Resolves validators for selected public state keys.
+ * @param sources - State schema sources in precedence order.
+ * @param selected - Public state keys.
+ * @returns An Effect with validators or AgentInvocationFailure.
+ * @example Effect.runSync(selectedStateSchemasEffect([state], ["answer"]));
+ */
+export declare const selectedStateSchemasEffect: (sources: readonly unknown[], selected: readonly string[]) => Effect.Effect<ReadonlyMap<string, StandardSchemaV1<unknown, unknown>>, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Resolves public state validators for existing synchronous callers.
+ * @param sources - State schema sources in precedence order.
+ * @param selected - Public state keys.
+ * @returns A map of selected validators.
+ * @throws TypeError for a selected key without a validator.
+ * @example selectedStateSchemas([state], ["answer"]);
+ */
+export declare function selectedStateSchemas(sources: readonly unknown[], selected: readonly string[]): ReadonlyMap<string, StandardSchemaV1>;
+//# sourceMappingURL=runtime-state-schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state-schemas.d.ts","sourceRoot":"","sources":["../src/runtime-state-schemas.ts"],"names":[],"mappings":"AAAA,qIAAqI;AAErI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,yMAOtC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAMvC"}

package/dist/runtime-state-schemas.js

@@ -0,0 +1,58 @@
+/** Decodes invocation state and output values at the native runtime boundary before persisted or public projections consume them. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+/** Resolves validators for selected public state keys.
+ * @param sources - State schema sources in precedence order.
+ * @param selected - Public state keys.
+ * @returns An Effect with validators or AgentInvocationFailure.
+ * @example Effect.runSync(selectedStateSchemasEffect([state], ["answer"]));
+ */
+export const selectedStateSchemasEffect = Effect.fn("Agents.runtime.selectedStateSchemas")((sources, selected) => Effect.try({
+    try: () => selectedStateSchemasCore(sources, selected),
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.selected-state-schemas", effect));
+/** Resolves public state validators for existing synchronous callers.
+ * @param sources - State schema sources in precedence order.
+ * @param selected - Public state keys.
+ * @returns A map of selected validators.
+ * @throws TypeError for a selected key without a validator.
+ * @example selectedStateSchemas([state], ["answer"]);
+ */
+export function selectedStateSchemas(sources, selected) {
+    return Effect.runSync(selectedStateSchemasEffect(sources, selected).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+function selectedStateSchemasCore(sources, selected) {
+    const schemas = new Map();
+    for (const source of sources) {
+        const fields = stateFields(source);
+        for (const key of selected) {
+            const schema = fields?.[key];
+            if (isStandardSchema(schema))
+                schemas.set(key, schema);
+        }
+    }
+    for (const key of selected) {
+        if (!schemas.has(key))
+            throw new TypeError(`Agent client state key "${key}" has no validator`);
+    }
+    return schemas;
+}
+function stateFields(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (isRecord(value.fields))
+        return value.fields;
+    const shape = typeof value.shape === "function" ? value.shape() : value.shape;
+    return isRecord(shape) ? shape : undefined;
+}
+function isStandardSchema(value) {
+    return (isRecord(value) &&
+        isRecord(value["~standard"]) &&
+        value["~standard"].version === 1 &&
+        typeof value["~standard"].validate === "function");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-state-schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state-schemas.js","sourceRoot":"","sources":["../src/runtime-state-schemas.ts"],"names":[],"mappings":"AAAA,qIAAqI;AAGrI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,EAAE,CAAC,qCAAqC,CAAC,CACxF,CAAC,OAA2B,EAAE,QAA2B,EAAE,EAAE,CAC3D,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE,CAAC,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC;IACtD,KAAK,EAAE,sBAAsB;CAC9B,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,gCAAgC,EAAE,MAAM,CAAC,CACnE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA2B,EAC3B,QAA2B;IAE3B,OAAO,MAAM,CAAC,OAAO,CACnB,0BAA0B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,CAChD,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACnF,CACF,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,OAA2B,EAC3B,QAA2B;IAE3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IACpD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,gBAAgB,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,2BAA2B,GAAG,oBAAoB,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAC9E,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC5B,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,KAAK,CAAC;QAChC,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,KAAK,UAAU,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/runtime-strict-response-schema.d.ts

@@ -0,0 +1,9 @@
+/** Selects the structural JSON-schema subset that can use provider enforcement without making optional fields required. */
+import type { JsonSchema } from "@relkit/schema";
+/** Closes declared objects for native generation; runtime validation still uses the authored schema.
+ * @param schema - JSON schema projection; never mutated.
+ * @param depth - Current schema nesting, bounded conservatively.
+ * @returns A provider-enforceable schema, or undefined to preserve the existing non-strict strategy.
+ * @remarks shortcut: only structural keywords are certified; extend with provider tests when other constraints need strict generation. */
+export declare function strictResponseSchema(schema: JsonSchema, depth?: number): JsonSchema | undefined;
+//# sourceMappingURL=runtime-strict-response-schema.d.ts.map

package/dist/runtime-strict-response-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-strict-response-schema.d.ts","sourceRoot":"","sources":["../src/runtime-strict-response-schema.ts"],"names":[],"mappings":"AAAA,2HAA2H;AAC3H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAiBjD;;;;0IAI0I;AAC1I,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,SAAI,GAAG,UAAU,GAAG,SAAS,CAiB1F"}

package/dist/runtime-strict-response-schema.js

@@ -0,0 +1,67 @@
+const keywords = new Set([
+    "type",
+    "properties",
+    "required",
+    "additionalProperties",
+    "items",
+    "anyOf",
+    "enum",
+    "const",
+    "title",
+    "description",
+]);
+const types = new Set(["object", "array", "string", "number", "integer", "boolean", "null"]);
+/** Closes declared objects for native generation; runtime validation still uses the authored schema.
+ * @param schema - JSON schema projection; never mutated.
+ * @param depth - Current schema nesting, bounded conservatively.
+ * @returns A provider-enforceable schema, or undefined to preserve the existing non-strict strategy.
+ * @remarks shortcut: only structural keywords are certified; extend with provider tests when other constraints need strict generation. */
+export function strictResponseSchema(schema, depth = 0) {
+    if (depth > 5 || Object.keys(schema).some((key) => !keywords.has(key)))
+        return undefined;
+    if (Array.isArray(schema.anyOf)) {
+        const anyOf = schema.anyOf.map((member) => isSchema(member) ? strictResponseSchema(member, depth + 1) : undefined);
+        if (anyOf.some((member) => member === undefined))
+            return undefined;
+        return { ...schema, anyOf: anyOf.filter((member) => member !== undefined) };
+    }
+    if (typeof schema.type !== "string" || !types.has(schema.type))
+        return undefined;
+    if (schema.type === "object")
+        return strictObject(schema, depth);
+    if (schema.type === "array") {
+        if (!isSchema(schema.items))
+            return undefined;
+        const items = strictResponseSchema(schema.items, depth + 1);
+        return items === undefined ? undefined : { ...schema, items };
+    }
+    return schema;
+}
+/** @param schema - Object projection. @param depth - Schema nesting. @returns A closed object only when every declared field is required. */
+function strictObject(schema, depth) {
+    if (!isSchema(schema.properties) ||
+        (schema.additionalProperties !== undefined && schema.additionalProperties !== false))
+        return undefined;
+    const keys = Object.keys(schema.properties);
+    const required = schema.required;
+    if (!Array.isArray(required) ||
+        required.length !== keys.length ||
+        keys.some((key) => !required.includes(key)))
+        return undefined;
+    const properties = {};
+    for (const key of keys) {
+        const value = schema.properties[key];
+        if (!isSchema(value))
+            return undefined;
+        const child = strictResponseSchema(value, depth + 1);
+        if (child === undefined)
+            return undefined;
+        properties[key] = child;
+    }
+    return { ...schema, properties, additionalProperties: false };
+}
+/** @param value - Projected JSON value. @returns Whether the value is a schema object. */
+function isSchema(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-strict-response-schema.js.map

package/dist/runtime-strict-response-schema.js.map

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

package/dist/runtime-tool-adapter.d.ts

@@ -0,0 +1,34 @@
+/** Adapts RELKIT callable tools to native SDK tools while preserving validated input, execution context and typed invocation failures. */
+import type { ToolDescriptor, ToolEngine } from "@relkit/tools";
+import { Effect } from "effect";
+import type { RuntimeToolOptions } from "./runtime-tool-events.types.js";
+import type { AgentToolCall } from "./runtime-tools.types.js";
+export { createAgentInvocationDispatcher, createAgentInvocationDispatcherEffect, } from "./runtime-tool-dispatcher.js";
+/** Invokes an allowed tool with validated input and public lifecycle events.
+ * @param engine - Function tool engine.
+ * @param tool - Registered tool descriptor.
+ * @param turn - Requested tool call.
+ * @param options - Runtime and invocation integrations.
+ * @param signal - Invocation cancellation signal.
+ * @param invocationId - Current invocation identity.
+ * @param traceId - Optional trace identity.
+ * @param parentSpanId - Optional parent span identity.
+ * @returns An Effect with the tool result or AgentInvocationFailure.
+ * @example await Effect.runPromise(invokeAgentToolEffect(engine, tool, turn, options, signal, id));
+ */
+export declare const invokeAgentToolEffect: (engine: ToolEngine, tool: ToolDescriptor<string>, turn: AgentToolCall, options: RuntimeToolOptions, signal: AbortSignal, invocationId: string, traceId?: string | undefined, parentSpanId?: string | undefined) => Effect.Effect<unknown, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Invokes an allowed tool for existing Promise callers.
+ * @param engine - Function tool engine.
+ * @param tool - Registered tool descriptor.
+ * @param turn - Requested tool call.
+ * @param options - Runtime and invocation integrations.
+ * @param signal - Invocation cancellation signal.
+ * @param invocationId - Current invocation identity.
+ * @param traceId - Optional trace identity.
+ * @param parentSpanId - Optional parent span identity.
+ * @returns A Promise of the tool result.
+ * @throws The original validation, sink, approval, or tool error.
+ * @example await invokeAgentTool(engine, tool, turn, options, signal, id);
+ */
+export declare function invokeAgentTool(engine: ToolEngine, tool: ToolDescriptor<string>, turn: AgentToolCall, options: RuntimeToolOptions, signal: AbortSignal, invocationId: string, traceId?: string, parentSpanId?: string): Promise<unknown>;
+//# sourceMappingURL=runtime-tool-adapter.d.ts.map

package/dist/runtime-tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tool-adapter.d.ts","sourceRoot":"","sources":["../src/runtime-tool-adapter.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAU1I,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAwB,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EACL,+BAA+B,EAC/B,qCAAqC,GACtC,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,+SAiDjC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAclB"}