@relkit/langchain 0.0.0-stage → 0.7.10

package/dist/runtime-tools.d.ts

@@ -0,0 +1,35 @@
+/** Builds invocation tool bindings from the selected RELKIT registry and native tool descriptors, keeping execution ownership with the caller. */
+import type { JsonValue } from "@relkit/contracts";
+import { Effect } from "effect";
+import type { AgentInvocationOptions, AgentRuntimeOptions } from "./runtime.js";
+import type { AgentToolCall } from "./runtime-tools.types.js";
+export type { AgentToolCall } from "./runtime-tools.types.js";
+export { findModelTool, findModelToolEffect, findTool, findToolEffect, modelToolName, modelToolNameEffect, } from "./runtime-tool-lookup.js";
+/** Executes an allowed RELKIT tool with safe public error projection.
+ * @param options - Runtime and invocation integrations.
+ * @param turn - Model requested tool call.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Maximum serialized result size.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Optional trace identity.
+ * @param parentSpanId - Optional parent trace span.
+ * @returns An Effect with JSON result or AgentInvocationFailure for control errors.
+ * @example await Effect.runPromise(runToolEffect(options, turn, signal, 1024, id));
+ */
+export declare const runToolEffect: (options: import("./runtime.types.js").AgentRuntimeBaseOptions & {
+    readonly modelRegistry?: unknown;
+} & AgentInvocationOptions, turn: AgentToolCall, signal: AbortSignal, maxOutputBytes: number, invocationId: string, traceId?: string | undefined, parentSpanId?: string | undefined) => Effect.Effect<JsonValue, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Executes a tool for existing Promise callers.
+ * @param options - Runtime and invocation integrations.
+ * @param turn - Model requested tool call.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Maximum serialized result size.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Optional trace identity.
+ * @param parentSpanId - Optional parent trace span.
+ * @returns Safe JSON result.
+ * @throws ApprovalRequiredError or AgentRuntimeError for cancellation.
+ * @example await runTool(options, turn, signal, 1024, id);
+ */
+export declare function runTool(options: AgentRuntimeOptions & AgentInvocationOptions, turn: AgentToolCall, signal: AbortSignal, maxOutputBytes: number, invocationId: string, traceId?: string, parentSpanId?: string): Promise<JsonValue>;
+//# sourceMappingURL=runtime-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tools.d.ts","sourceRoot":"","sources":["../src/runtime-tools.ts"],"names":[],"mappings":"AAAA,kJAAkJ;AAElJ,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAQhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;mRA+CzB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,mBAAmB,GAAG,sBAAsB,EACrD,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,SAAS,CAAC,CAOpB"}

package/dist/runtime-tools.js

@@ -0,0 +1,78 @@
+/** Builds invocation tool bindings from the selected RELKIT registry and native tool descriptors, keeping execution ownership with the caller. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { ApprovalRequiredError } from "@relkit/agents/internal/approval";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+import { invokeAgentToolEffect } from "./runtime-tool-adapter.js";
+import { jsonValueEffect, signalFailure } from "./runtime-utils.js";
+import { relkitToolRefs } from "./define-agent-native.js";
+import { findToolEffect } from "./runtime-tool-lookup.js";
+export { findModelTool, findModelToolEffect, findTool, findToolEffect, modelToolName, modelToolNameEffect, } from "./runtime-tool-lookup.js";
+/** Executes an allowed RELKIT tool with safe public error projection.
+ * @param options - Runtime and invocation integrations.
+ * @param turn - Model requested tool call.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Maximum serialized result size.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Optional trace identity.
+ * @param parentSpanId - Optional parent trace span.
+ * @returns An Effect with JSON result or AgentInvocationFailure for control errors.
+ * @example await Effect.runPromise(runToolEffect(options, turn, signal, 1024, id));
+ */
+export const runToolEffect = Effect.fn("Agents.runtime.runTool")(function* (options, turn, signal, maxOutputBytes, invocationId, traceId, parentSpanId) {
+    const tool = yield* findToolEffect(options.tools, turn.toolId);
+    if (tool === undefined ||
+        !relkitToolRefs(options.agent.tools).some((entry) => entry.ref.id === turn.toolId)) {
+        return safeToolError("RELKIT_TOOL_NOT_ALLOWED");
+    }
+    const outcome = yield* invokeAgentToolEffect(options.engine, tool, turn, options, signal, invocationId, traceId, parentSpanId).pipe(Effect.map((value) => ({ kind: "result", value })), Effect.catchTag("AgentInvocationFailure", (failure) => {
+        const cause = failure.cause;
+        if (cause instanceof ApprovalRequiredError)
+            return Effect.fail(failure);
+        if (signal.aborted)
+            return Effect.fail(agentInvocationFailure(signalFailure(signal)));
+        return Effect.succeed({
+            kind: "error",
+            value: safeToolError(safeCode(cause, tool)),
+        });
+    }));
+    if (outcome.kind === "error")
+        return outcome.value;
+    return yield* jsonValueEffect(outcome.value, maxOutputBytes, "tool result").pipe(Effect.catchTag("AgentInvocationFailure", (failure) => {
+        if (signal.aborted)
+            return Effect.fail(agentInvocationFailure(signalFailure(signal)));
+        return Effect.succeed(safeToolError(safeCode(failure.cause, tool)));
+    }));
+}, (effect) => observeAgent("runtime.run-tool", effect));
+/** Executes a tool for existing Promise callers.
+ * @param options - Runtime and invocation integrations.
+ * @param turn - Model requested tool call.
+ * @param signal - Invocation cancellation signal.
+ * @param maxOutputBytes - Maximum serialized result size.
+ * @param invocationId - Stable invocation identity.
+ * @param traceId - Optional trace identity.
+ * @param parentSpanId - Optional parent trace span.
+ * @returns Safe JSON result.
+ * @throws ApprovalRequiredError or AgentRuntimeError for cancellation.
+ * @example await runTool(options, turn, signal, 1024, id);
+ */
+export function runTool(options, turn, signal, maxOutputBytes, invocationId, traceId, parentSpanId) {
+    return Effect.runPromise(runToolEffect(options, turn, signal, maxOutputBytes, invocationId, traceId, parentSpanId).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))), { signal });
+}
+function safeToolError(code) {
+    return { error: { code, message: "Tool call failed" } };
+}
+function safeCode(value, tool) {
+    if (!isRecord(value) || typeof value.code !== "string")
+        return "RELKIT_TOOL_FAILED";
+    if (value.code.startsWith("RELKIT_"))
+        return value.code;
+    return tool.target.errors?.some((error) => error.id === value.code)
+        ? value.code
+        : "RELKIT_TOOL_FAILED";
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object";
+}
+//# sourceMappingURL=runtime-tools.js.map

package/dist/runtime-tools.js.map

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

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

@@ -0,0 +1,7 @@
+/** One model requested RELKIT tool call. */
+export interface AgentToolCall {
+    readonly callId: string;
+    readonly toolId: string;
+    readonly input: unknown;
+}
+//# sourceMappingURL=runtime-tools.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tools.types.d.ts","sourceRoot":"","sources":["../src/runtime-tools.types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB"}

package/dist/runtime-tools.types.js

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

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

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

package/dist/runtime-utils.d.ts

@@ -0,0 +1,56 @@
+/** Normalizes native invocation utility values shared by runtime adapters without changing the owning request's execution context. */
+import { type JsonValue } from "@relkit/contracts";
+import { type StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { createExecutionSignal, signalFailure, withSignal } from "./signal.js";
+export { createExecutionSignal, signalFailure, withSignal };
+/** Validates an invocation value through a Standard Schema.
+ * @param schema - Input or output validator.
+ * @param value - Candidate value.
+ * @param phase - Validation phase for public error codes.
+ * @returns An Effect with validated value or AgentInvocationFailure.
+ * @example await Effect.runPromise(validateValueEffect(schema, input, "input"));
+ */
+export declare const validateValueEffect: (schema: StandardSchemaV1<unknown, unknown>, value: unknown, phase: "input" | "output") => Effect.Effect<unknown, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Validates an invocation value for existing Promise callers.
+ * @param schema - Input or output validator.
+ * @param value - Candidate value.
+ * @param phase - Validation phase for public error codes.
+ * @returns Validated input or output.
+ * @throws AgentRuntimeError for invalid values.
+ * @example await validateValue(schema, input, "input");
+ */
+export declare function validateValue(schema: StandardSchemaV1, value: unknown, phase: "input" | "output"): Promise<unknown>;
+/** Produces bounded, canonical JSON from a runtime value.
+ * @param value - Candidate JSON value.
+ * @param maxBytes - Maximum encoded byte length.
+ * @param label - Stable error subject.
+ * @returns An Effect with JSON or AgentInvocationFailure.
+ * @example Effect.runSync(jsonValueEffect({ ok: true }, 1024, "output"));
+ */
+export declare const jsonValueEffect: (value: unknown, maxBytes: number, label: string) => Effect.Effect<JsonValue, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Produces bounded JSON for existing synchronous callers.
+ * @param value - Candidate JSON value.
+ * @param maxBytes - Maximum encoded byte length.
+ * @param label - Stable error subject.
+ * @returns Canonical JSON.
+ * @throws AgentRuntimeError for invalid JSON or byte limits.
+ * @example jsonValue({ ok: true }, 1024, "output");
+ */
+export declare function jsonValue(value: unknown, maxBytes: number, label: string): JsonValue;
+/** Classifies a model failure without exposing provider details.
+ * @param cause - Provider or response failure.
+ * @param signal - Invocation cancellation signal.
+ * @returns An Effect with a safe AgentRuntimeError.
+ * @example Effect.runSync(modelFailureEffect(error, signal));
+ */
+export declare const modelFailureEffect: (cause: unknown, signal: AbortSignal) => Effect.Effect<AgentRuntimeError, never, never>;
+/** Classifies a model failure for existing synchronous callers.
+ * @param cause - Provider or response failure.
+ * @param signal - Invocation cancellation signal.
+ * @returns A safe AgentRuntimeError.
+ * @example modelFailure(error, signal);
+ */
+export declare function modelFailure(cause: unknown, signal: AbortSignal): AgentRuntimeError;
+//# sourceMappingURL=runtime-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-utils.d.ts","sourceRoot":"","sources":["../src/runtime-utils.ts"],"names":[],"mappings":"AAAA,sIAAsI;AAEtI,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,sLAO/B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,GAAG,QAAQ,GACxB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAyBD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,kJAO3B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAMpF;AAcD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,yFAG9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAEnF"}

package/dist/runtime-utils.js

@@ -0,0 +1,106 @@
+/** Normalizes native invocation utility values shared by runtime adapters without changing the owning request's execution context. */
+import { canonicalJson } from "@relkit/contracts";
+import { validate } from "@relkit/schema";
+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 { createExecutionSignal, signalFailure, withSignal } from "./signal.js";
+export { createExecutionSignal, signalFailure, withSignal };
+/** Validates an invocation value through a Standard Schema.
+ * @param schema - Input or output validator.
+ * @param value - Candidate value.
+ * @param phase - Validation phase for public error codes.
+ * @returns An Effect with validated value or AgentInvocationFailure.
+ * @example await Effect.runPromise(validateValueEffect(schema, input, "input"));
+ */
+export const validateValueEffect = Effect.fn("Agents.runtime.validateValue")((schema, value, phase) => Effect.tryPromise({
+    try: () => validateValueCore(schema, value, phase),
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.validate-value", effect));
+/** Validates an invocation value for existing Promise callers.
+ * @param schema - Input or output validator.
+ * @param value - Candidate value.
+ * @param phase - Validation phase for public error codes.
+ * @returns Validated input or output.
+ * @throws AgentRuntimeError for invalid values.
+ * @example await validateValue(schema, input, "input");
+ */
+export function validateValue(schema, value, phase) {
+    return Effect.runPromise(validateValueEffect(schema, value, phase).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+async function validateValueCore(schema, value, phase) {
+    try {
+        const result = await validate(schema, value);
+        if (!("value" in result))
+            throw new AgentRuntimeError(phase === "input" ? "RELKIT_AGENT_INPUT_VALIDATION" : "RELKIT_AGENT_OUTPUT_VALIDATION", `${phase === "input" ? "Input" : "Output"} validation failed`, result.issues);
+        return result.value;
+    }
+    catch (cause) {
+        if (cause instanceof AgentRuntimeError)
+            throw cause;
+        throw new AgentRuntimeError(phase === "input" ? "RELKIT_AGENT_INPUT_VALIDATION" : "RELKIT_AGENT_OUTPUT_VALIDATION", `${phase === "input" ? "Input" : "Output"} validation failed`);
+    }
+}
+/** Produces bounded, canonical JSON from a runtime value.
+ * @param value - Candidate JSON value.
+ * @param maxBytes - Maximum encoded byte length.
+ * @param label - Stable error subject.
+ * @returns An Effect with JSON or AgentInvocationFailure.
+ * @example Effect.runSync(jsonValueEffect({ ok: true }, 1024, "output"));
+ */
+export const jsonValueEffect = Effect.fn("Agents.runtime.jsonValue")((value, maxBytes, label) => Effect.try({
+    try: () => jsonValueCore(value, maxBytes, label),
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.json-value", effect));
+/** Produces bounded JSON for existing synchronous callers.
+ * @param value - Candidate JSON value.
+ * @param maxBytes - Maximum encoded byte length.
+ * @param label - Stable error subject.
+ * @returns Canonical JSON.
+ * @throws AgentRuntimeError for invalid JSON or byte limits.
+ * @example jsonValue({ ok: true }, 1024, "output");
+ */
+export function jsonValue(value, maxBytes, label) {
+    return Effect.runSync(jsonValueEffect(value, maxBytes, label).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+function jsonValueCore(value, maxBytes, label) {
+    try {
+        const serialized = canonicalJson(value);
+        if (new TextEncoder().encode(serialized).byteLength > maxBytes)
+            throw new AgentRuntimeError("RELKIT_AGENT_RESPONSE_LIMIT", `${label} exceeds its byte limit`);
+        return JSON.parse(serialized);
+    }
+    catch (cause) {
+        if (cause instanceof AgentRuntimeError)
+            throw cause;
+        throw new AgentRuntimeError("RELKIT_AGENT_JSON_INVALID", `${label} is not JSON-safe`);
+    }
+}
+/** Classifies a model failure without exposing provider details.
+ * @param cause - Provider or response failure.
+ * @param signal - Invocation cancellation signal.
+ * @returns An Effect with a safe AgentRuntimeError.
+ * @example Effect.runSync(modelFailureEffect(error, signal));
+ */
+export const modelFailureEffect = Effect.fn("Agents.runtime.modelFailure")((cause, signal) => Effect.sync(() => modelFailureCore(cause, signal)), (effect) => observeAgent("runtime.model-failure", effect));
+/** Classifies a model failure for existing synchronous callers.
+ * @param cause - Provider or response failure.
+ * @param signal - Invocation cancellation signal.
+ * @returns A safe AgentRuntimeError.
+ * @example modelFailure(error, signal);
+ */
+export function modelFailure(cause, signal) {
+    return Effect.runSync(modelFailureEffect(cause, signal));
+}
+/** Maps provider failures to safe fields while retaining their non-enumerable diagnostic cause.
+ * @param cause - Native failure; may contain private provider payloads.
+ * @param signal - Invocation cancellation authority. @returns Safe failure without retrying work. */
+function modelFailureCore(cause, signal) {
+    if (signal.aborted)
+        return signalFailure(signal);
+    return cause instanceof AgentRuntimeError && cause.code === "RELKIT_AGENT_RESPONSE_LIMIT"
+        ? cause
+        : new AgentRuntimeError("RELKIT_AGENT_MODEL_ERROR", "Model response was invalid or unavailable", undefined, { cause });
+}
+//# sourceMappingURL=runtime-utils.js.map

package/dist/runtime-utils.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,47 @@
+/** Exposes generated and direct native invocation entrypoints plus dependency and persistence lifecycle operations for the selected integration. */
+import { Effect } from "effect";
+import { AgentExecution } from "./runtime-service.js";
+import type { AgentInvocationOptions, AgentRuntime, AgentRuntimeOptions } from "./runtime.types.js";
+export type * from "./runtime.types.js";
+export { runtimeIntegration } from "./runtime-integration.js";
+export { createGeneratedAgentFunction } from "@relkit/agents/internal/generated-function";
+export { releaseAgentPersistence } from "./graph-persistence-release.js";
+export { assertAgentRuntimeDependencies } from "./runtime-dependencies.js";
+export { AgentRuntimeError } from "./runtime-errors.js";
+export { AgentInvocationFailure } from "./runtime-effect-error.js";
+/** Invokes an agent with typed failures and interruption linked to its work.
+ * @param options - Runtime dependencies and invocation input.
+ * @returns An Effect with the agent result or AgentInvocationFailure.
+ * @example Effect.runPromise(Effect.provide(invokeAgentEffect(options), AgentExecutionLive));
+ */
+export declare const invokeAgentEffect: (options: import("./runtime.types.js").AgentRuntimeBaseOptions & {
+    readonly modelRegistry?: unknown;
+} & AgentInvocationOptions) => Effect.Effect<unknown, import("./runtime-effect-error.js").AgentInvocationFailure, AgentExecution>;
+/** Runs an agent through the live Effect Layer for existing Promise callers.
+ * @param options - Runtime dependencies and invocation input.
+ * @returns The agent result.
+ * @throws The original validation, provider, cancellation, or runtime error.
+ * @example await invokeAgent({ ...options, input: { message: "hi" } });
+ */
+export declare function invokeAgent(options: AgentRuntimeOptions & AgentInvocationOptions): Promise<unknown>;
+/**
+ * Runs an agent once for generated function actions, retaining output failure identity.
+ * @param options - Agent dependencies, invocation identity and cancellation.
+ * @returns Validated output; a failed final response does not undo completed tool actions.
+ * @example await invokeAgentFunction(options);
+ */
+export declare function invokeAgentFunction(options: AgentRuntimeOptions & AgentInvocationOptions): Promise<unknown>;
+/** Creates a reusable runtime through an observable Effect.
+ * @param options - Agent, model, tool, and engine dependencies.
+ * @returns An Effect with a frozen runtime and no typed failure.
+ * @example Effect.runSync(createAgentRuntimeEffect(options));
+ */
+export declare const createAgentRuntimeEffect: (options: AgentRuntimeOptions) => Effect.Effect<AgentRuntime, never, never>;
+/** Binds one agent catalog for existing synchronous callers.
+ * @param options - Agent, model, tool, and engine dependencies.
+ * @returns A frozen reusable runtime.
+ * @example const runtime = createAgentRuntime(options);
+ */
+export declare function createAgentRuntime(options: AgentRuntimeOptions): AgentRuntime;
+export declare const runAgent: typeof invokeAgent;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,oJAAoJ;AAOpJ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC,OAAO,EAAE,cAAc,EAAsB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,mBAAmB,oBAAoB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;iIAuB7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,mBAAmB,GAAG,sBAAsB,GACpD,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,sBAAsB,oBAUxF;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,6EAUpC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAE7E;AAED,eAAO,MAAM,QAAQ,oBAAc,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,90 @@
+/** Exposes generated and direct native invocation entrypoints plus dependency and persistence lifecycle operations for the selected integration. */
+import { resolveNativeInvocationEffect, invokeNativeWithContextEffect } from "./runtime-invoke.js";
+import { normalizeId } from "@relkit/contracts";
+import { frameworkTrace, unexpectedDefect } from "@relkit/invocation";
+import { AgentRuntimeError } from "./runtime-errors.js";
+import { logAgentFailure } from "./runtime-failure-diagnostics.js";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { createAgentCapturePolicyEffect } from "@relkit/agents/internal/capture-policy";
+import { signalFailure, validateValue, withSignal } from "./runtime-utils.js";
+import { acquireExecutionSignalEffect, ExecutionSignalClockLive } from "./signal.js";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+import { generatedAgentFunctionId } from "@relkit/agents/internal/generated-function";
+import { isGraphDescriptor } from "./define-graph.js";
+import { AgentExecution, AgentExecutionLive } from "./runtime-service.js";
+export { runtimeIntegration } from "./runtime-integration.js";
+export { createGeneratedAgentFunction } from "@relkit/agents/internal/generated-function";
+export { releaseAgentPersistence } from "./graph-persistence-release.js";
+export { assertAgentRuntimeDependencies } from "./runtime-dependencies.js";
+export { AgentRuntimeError } from "./runtime-errors.js";
+export { AgentInvocationFailure } from "./runtime-effect-error.js";
+/** Invokes an agent with typed failures and interruption linked to its work.
+ * @param options - Runtime dependencies and invocation input.
+ * @returns An Effect with the agent result or AgentInvocationFailure.
+ * @example Effect.runPromise(Effect.provide(invokeAgentEffect(options), AgentExecutionLive));
+ */
+export const invokeAgentEffect = Effect.fn("Agents.runtime.invoke")(function* (options) {
+    const service = yield* AgentExecution;
+    const agent = options.agent;
+    if (isGraphDescriptor(agent)) {
+        return yield* Effect.tryPromise({
+            try: (effectSignal) => service.invokeGraph({
+                ...options,
+                agent,
+                signal: options.signal === undefined
+                    ? effectSignal
+                    : AbortSignal.any([options.signal, effectSignal]),
+            }),
+            catch: agentInvocationFailure,
+        });
+    }
+    const nativeOptions = { ...options, agent };
+    const invocation = yield* resolveNativeInvocationEffect(nativeOptions, service);
+    return yield* invokeNativeWithContextEffect(nativeOptions, service, invocation);
+}, (effect) => observeAgent("runtime.invoke", effect));
+/** Runs an agent through the live Effect Layer for existing Promise callers.
+ * @param options - Runtime dependencies and invocation input.
+ * @returns The agent result.
+ * @throws The original validation, provider, cancellation, or runtime error.
+ * @example await invokeAgent({ ...options, input: { message: "hi" } });
+ */
+export function invokeAgent(options) {
+    return Effect.runPromise(invokeAgentEffect(options).pipe(Effect.tapError((failure) => logAgentFailure(failure, options)), Effect.catchTag("AgentInvocationFailure", (error) => Effect.fail(error.cause)), Effect.provide(AgentExecutionLive)));
+}
+/**
+ * Runs an agent once for generated function actions, retaining output failure identity.
+ * @param options - Agent dependencies, invocation identity and cancellation.
+ * @returns Validated output; a failed final response does not undo completed tool actions.
+ * @example await invokeAgentFunction(options);
+ */
+export function invokeAgentFunction(options) {
+    return invokeAgent(options).catch((cause) => {
+        if (cause instanceof AgentRuntimeError && cause.code === "RELKIT_AGENT_OUTPUT_VALIDATION")
+            throw unexpectedDefect(cause, {
+                code: cause.code,
+                message: "Agent output validation failed. Tool actions may have completed; check their results before retrying.",
+            });
+        throw cause;
+    });
+}
+/** Creates a reusable runtime through an observable Effect.
+ * @param options - Agent, model, tool, and engine dependencies.
+ * @returns An Effect with a frozen runtime and no typed failure.
+ * @example Effect.runSync(createAgentRuntimeEffect(options));
+ */
+export const createAgentRuntimeEffect = Effect.fn("Agents.runtime.create")(function* (options) {
+    return yield* Effect.sync(() => Object.freeze({
+        invoke: (input, invocation = {}) => invokeAgent({ ...options, ...invocation, input }),
+    }));
+}, (effect) => observeAgent("runtime.create", effect));
+/** Binds one agent catalog for existing synchronous callers.
+ * @param options - Agent, model, tool, and engine dependencies.
+ * @returns A frozen reusable runtime.
+ * @example const runtime = createAgentRuntime(options);
+ */
+export function createAgentRuntime(options) {
+    return Effect.runSync(createAgentRuntimeEffect(options));
+}
+export const runAgent = invokeAgent;
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/runtime.types.d.ts

@@ -0,0 +1,77 @@
+/** Exposes generated and direct native invocation entrypoints plus dependency and persistence lifecycle operations for the selected integration. This companion preserves the native input and output types without starting runtime work. */
+import type { MaybePromise } from "@relkit/contracts";
+import type { AgentDescriptor } from "./define-agent.js";
+import type { GraphDescriptor } from "./define-graph.js";
+import type { AgentCapturePolicy, AgentRuntimeHooks } from "@relkit/agents/internal/observability";
+type AgentAny = AgentDescriptor<string, unknown, unknown> | GraphDescriptor;
+type ApprovalDecision = "approved" | "denied" | boolean | import("@relkit/agents/internal/approval").ApprovalRecord;
+/** Resolves a pending tool approval for an invocation. */
+export type AgentApprovalHandler = (approval: import("@relkit/agents/internal/approval").PendingApproval) => MaybePromise<ApprovalDecision>;
+/** Supplies queued steering messages to a running agent. */
+export interface AgentSteeringSource {
+    readonly drain: () => MaybePromise<readonly string[]>;
+}
+/** One user or assistant message in a native agent conversation. */
+export interface AgentConversationMessage {
+    readonly role: "user" | "assistant";
+    readonly content: string;
+}
+/** Sends agent output and events to the surrounding runtime. */
+export interface AgentContentSink {
+    readonly emitOutput: (value: unknown, signal: AbortSignal) => MaybePromise<void>;
+    readonly finishOutput?: (signal: AbortSignal) => MaybePromise<void>;
+    readonly progressSinkForTool?: (tool: {
+        readonly toolCallId: string;
+        readonly toolId: string;
+    }) => import("@relkit/invocation").ProgressSink;
+    readonly emitTool?: (value: {
+        readonly toolCallId: string;
+        readonly toolId: string;
+        readonly state: import("@relkit/agents/internal/state.types").ToolPartState;
+        readonly value?: unknown;
+    }, signal: AbortSignal) => MaybePromise<void>;
+    readonly emitEvent?: (value: import("@relkit/agents/internal/runtime-events").AgentExecutionEvent, signal: AbortSignal) => MaybePromise<void>;
+    readonly emitMessage?: (value: import("@relkit/contracts").BrowserMessage, signal: AbortSignal) => MaybePromise<void>;
+    readonly emitWaiting?: (value: Omit<import("@relkit/agents/internal/state.types").AgentWaitingState, "revision" | "runId">, signal: AbortSignal) => MaybePromise<void>;
+}
+/** Common authoring and execution dependencies for an agent runtime. */
+export interface AgentRuntimeBaseOptions {
+    readonly agent: AgentAny;
+    readonly tools: import("@relkit/tools").ToolSource;
+    readonly bucketBackend?: import("./deepagent-bucket-client.types.js").DeepAgentBucketClient;
+    readonly engine: import("@relkit/tools").ToolEngine;
+    readonly maxInputBytes?: number;
+    readonly maxOutputBytes?: number;
+    readonly approval?: AgentApprovalHandler;
+    readonly messages?: readonly AgentConversationMessage[];
+    readonly steering?: AgentSteeringSource;
+    readonly contentSink?: AgentContentSink;
+    readonly hooks?: AgentRuntimeHooks;
+    readonly capture?: AgentCapturePolicy;
+    readonly environment?: Readonly<Record<string, unknown>>;
+}
+/** Long-lived dependencies shared by agent invocations. */
+export type AgentRuntimeOptions = AgentRuntimeBaseOptions & {
+    readonly modelRegistry?: unknown;
+};
+/** Per-call identity, input, cancellation, and control options. */
+export interface AgentInvocationOptions {
+    readonly input: unknown;
+    readonly invocationId?: string;
+    readonly signal?: AbortSignal;
+    readonly deadlineMs?: number;
+    readonly timeoutMs?: number;
+    readonly approval?: AgentApprovalHandler;
+    readonly traceId?: string;
+    readonly parentSpanId?: string;
+    readonly hooks?: AgentRuntimeHooks;
+    readonly capture?: AgentCapturePolicy;
+    readonly threadId?: string;
+    readonly resume?: boolean;
+}
+/** Reusable invocation API bound to one agent catalog. */
+export interface AgentRuntime {
+    readonly invoke: (input: unknown, options?: Omit<AgentInvocationOptions, "input">) => Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=runtime.types.d.ts.map

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

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

package/dist/runtime.types.js

@@ -0,0 +1,3 @@
+/** Exposes generated and direct native invocation entrypoints plus dependency and persistence lifecycle operations for the selected integration. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=runtime.types.js.map

package/dist/runtime.types.js.map

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

package/dist/signal-deadline.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves the earliest authored deadline before the signal owner installs its
+ * timer. Invalid timeout/deadline values preserve the existing public diagnostic.
+ */
+import type { ExecutionSignalOptions } from "./signal.types.js";
+/** Selects the earliest finite invocation deadline.
+ * @param options - Agent limit, optional timeout and absolute deadline.
+ * @param now - Current milliseconds from the replaceable execution clock.
+ * @returns The absolute deadline in milliseconds.
+ */
+export declare function executionDeadline(options: ExecutionSignalOptions, now: number): number;
+//# sourceMappingURL=signal-deadline.d.ts.map

package/dist/signal-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-deadline.d.ts","sourceRoot":"","sources":["../src/signal-deadline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CActF"}

package/dist/signal-deadline.js

@@ -0,0 +1,21 @@
+import { AgentRuntimeError } from "./runtime-errors.js";
+/** Selects the earliest finite invocation deadline.
+ * @param options - Agent limit, optional timeout and absolute deadline.
+ * @param now - Current milliseconds from the replaceable execution clock.
+ * @returns The absolute deadline in milliseconds.
+ */
+export function executionDeadline(options, now) {
+    const deadlines = [now + options.agent.limits.timeoutMs, options.deadlineMs];
+    if (options.timeoutMs !== undefined &&
+        (!Number.isSafeInteger(options.timeoutMs) || options.timeoutMs < 0)) {
+        throw new AgentRuntimeError("RELKIT_AGENT_DEADLINE_INVALID", "Agent timeout is invalid");
+    }
+    if (options.timeoutMs !== undefined)
+        deadlines.push(now + options.timeoutMs);
+    if (deadlines.some((deadline) => deadline !== undefined && !Number.isFinite(deadline))) {
+        throw new AgentRuntimeError("RELKIT_AGENT_DEADLINE_INVALID", "Agent deadline is invalid");
+    }
+    const deadline = Math.min(...deadlines.filter((value) => value !== undefined));
+    return deadline;
+}
+//# sourceMappingURL=signal-deadline.js.map

package/dist/signal-deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-deadline.js","sourceRoot":"","sources":["../src/signal-deadline.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA+B,EAAE,GAAW;IAC5E,MAAM,SAAS,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7E,IACE,OAAO,CAAC,SAAS,KAAK,SAAS;QAC/B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,EACnE,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,+BAA+B,EAAE,0BAA0B,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7E,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,iBAAiB,CAAC,+BAA+B,EAAE,2BAA2B,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;IAChG,OAAO,QAAQ,CAAC;AAClB,CAAC"}