@relkit/langchain 0.0.0-stage → 0.7.10

package/dist/runtime-native-events.js

@@ -0,0 +1,89 @@
+/** Maps the native event stream into RELKIT execution events and public observations in the order delivered by the native iterator. */
+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 { executionContext, isModelStart, isToolStart, trackExecutionContext, } from "./runtime-native-events-helpers.js";
+import { emitToolEvent } from "./runtime-native-event-tools.js";
+import { NativeMessageAccumulator } from "./runtime-native-messages.js";
+import { nativePublicEvent } from "./runtime-native-public.js";
+import { signalFailure, withSignal } from "./runtime-utils.js";
+/** Collects native events with linked Effect interruption.
+ * @param events - Native event stream.
+ * @param sink - Optional client content sink.
+ * @param toolIds - Public tool name mapping.
+ * @param relkitNames - RELKIT owned tool names.
+ * @param signal - Invocation cancellation signal.
+ * @param limits - Model and tool call limits.
+ * @param stateSchemas - Public state validators.
+ * @param failure - Deferred native tool failure reader.
+ * @param observe - Optional model/tool event observer.
+ * @param abort - Native stream cancellation callback.
+ * @param eventSchemas - Custom event validators.
+ * @returns An Effect with void or AgentInvocationFailure.
+ * @example await Effect.runPromise(collectNativeEventsEffect(events, sink, ids, names, signal, limits, schemas, failure, observe, abort));
+ */
+export const collectNativeEventsEffect = Effect.fn("Agents.runtime.collectNativeEvents")((events, sink, toolIds, relkitNames, signal, limits, stateSchemas, failure, observe, abort, eventSchemas = {}) => Effect.gen(function* () {
+    if (signal.aborted)
+        return yield* Effect.fail(agentInvocationFailure(signalFailure(signal)));
+    yield* Effect.tryPromise({
+        try: (effectSignal) => collectNativeEventsCore(events, sink, toolIds, relkitNames, AbortSignal.any([signal, effectSignal]), limits, stateSchemas, failure, observe, abort, eventSchemas),
+        catch: agentInvocationFailure,
+    }).pipe(Effect.onInterrupt(() => Effect.sync(() => abort(new AgentRuntimeError("RELKIT_AGENT_CANCELLED", "Agent invocation cancelled")))));
+}), (effect) => observeAgent("runtime.collect-native-events", effect));
+/** Collects native events for existing Promise runtime callers.
+ * @param events - Native event stream.
+ * @param sink - Optional client content sink.
+ * @param toolIds - Public tool name mapping.
+ * @param relkitNames - RELKIT owned tool names.
+ * @param signal - Invocation cancellation signal.
+ * @param limits - Model and tool call limits.
+ * @param stateSchemas - Public state validators.
+ * @param failure - Deferred native tool failure reader.
+ * @param observe - Optional model/tool event observer.
+ * @param abort - Native stream cancellation callback.
+ * @param eventSchemas - Custom event validators.
+ * @returns A Promise that resolves after all events are delivered.
+ * @throws The original stream, sink, validation, or cancellation error.
+ * @example await collectNativeEvents(events, sink, ids, names, signal, limits, schemas, failure, observe, abort);
+ */
+export function collectNativeEvents(events, sink, toolIds, relkitNames, signal, limits, stateSchemas, failure, observe, abort, eventSchemas = {}) {
+    return Effect.runPromise(collectNativeEventsEffect(events, sink, toolIds, relkitNames, signal, limits, stateSchemas, failure, observe, abort, eventSchemas).pipe(Effect.catchTag("AgentInvocationFailure", (error) => Effect.fail(error.cause))), { signal });
+}
+async function collectNativeEventsCore(events, sink, toolIds, relkitNames, signal, limits, stateSchemas, failure, observe, abort, eventSchemas) {
+    let modelCalls = 0;
+    let toolCalls = 0;
+    const toolNames = new Map();
+    const contexts = new Map();
+    const messages = new NativeMessageAccumulator();
+    for await (const event of events) {
+        if (signal.aborted)
+            throw signal.reason;
+        if (isModelStart(event) && ++modelCalls > limits.maxSteps) {
+            const error = new AgentRuntimeError("RELKIT_AGENT_STEP_LIMIT", "Agent step limit reached");
+            abort(error);
+            throw error;
+        }
+        if (isToolStart(event) && ++toolCalls > limits.maxToolCalls) {
+            const error = new AgentRuntimeError("RELKIT_AGENT_TOOL_LIMIT", "Agent tool-call limit reached");
+            abort(error);
+            throw error;
+        }
+        trackExecutionContext(event, contexts);
+        await emitToolEvent(event, sink, toolIds, relkitNames, toolNames, signal);
+        observe?.(event);
+        const publicEvent = await nativePublicEvent(event, stateSchemas, executionContext(event, contexts), eventSchemas);
+        if (sink?.emitEvent !== undefined)
+            await withSignal(sink.emitEvent(publicEvent, signal), signal);
+        const message = messages.update(publicEvent);
+        if (message !== undefined && sink?.emitMessage !== undefined) {
+            await withSignal(sink.emitMessage(message, signal), signal);
+        }
+        const toolFailure = failure();
+        if (toolFailure !== undefined) {
+            abort(toolFailure);
+            throw toolFailure;
+        }
+    }
+}
+//# sourceMappingURL=runtime-native-events.js.map

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

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

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

@@ -0,0 +1,18 @@
+/** Applies authored step, tool-call and timeout limits at native invocation boundaries and reports the existing limit failures. */
+import { type AnyAgentMiddleware } from "langchain";
+import { Effect } from "effect";
+import type { AgentLimits } from "./define-agent.js";
+/** Creates per-invocation model and tool call guards.
+ * @param limits - Maximum model steps and tool calls.
+ * @returns An Effect with middleware or AgentInvocationFailure.
+ * @example Effect.runSync(createNativeLimitMiddlewareEffect(limits));
+ */
+export declare const createNativeLimitMiddlewareEffect: (limits: AgentLimits) => Effect.Effect<AnyAgentMiddleware, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Creates native invocation guards for existing synchronous callers.
+ * @param limits - Maximum model steps and tool calls.
+ * @returns LangChain middleware enforcing both limits.
+ * @throws The original middleware creation error.
+ * @example createNativeLimitMiddleware(limits);
+ */
+export declare function createNativeLimitMiddleware(limits: AgentLimits): AnyAgentMiddleware;
+//# sourceMappingURL=runtime-native-limits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-limits.d.ts","sourceRoot":"","sources":["../src/runtime-native-limits.ts"],"names":[],"mappings":"AAAA,mIAAmI;AAEnI,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,+HAuC7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,CAMnF"}

package/dist/runtime-native-limits.js

@@ -0,0 +1,59 @@
+/** Applies authored step, tool-call and timeout limits at native invocation boundaries and reports the existing limit failures. */
+import { createMiddleware } from "langchain";
+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";
+/** Creates per-invocation model and tool call guards.
+ * @param limits - Maximum model steps and tool calls.
+ * @returns An Effect with middleware or AgentInvocationFailure.
+ * @example Effect.runSync(createNativeLimitMiddlewareEffect(limits));
+ */
+export const createNativeLimitMiddlewareEffect = Effect.fn("Agents.runtime.nativeLimits")((limits) => Effect.try({
+    try: () => {
+        const modelGuard = createCallGuard(limits.maxSteps, "RELKIT_AGENT_STEP_LIMIT", "Agent step limit exceeded", "Agents.runtime.modelLimit", "runtime.model-limit");
+        const toolGuard = createCallGuard(limits.maxToolCalls, "RELKIT_AGENT_TOOL_LIMIT", "Agent tool-call limit exceeded", "Agents.runtime.toolLimit", "runtime.tool-limit");
+        const runGuard = (effect) => Effect.runSync(effect.pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+        return createMiddleware({
+            name: "RelkitInvocationLimits",
+            wrapModelCall: (request, handler) => {
+                runGuard(modelGuard());
+                return handler(request);
+            },
+            wrapToolCall: (request, handler) => {
+                runGuard(toolGuard());
+                return handler(request);
+            },
+        });
+    },
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.native-limits", effect));
+/** Creates native invocation guards for existing synchronous callers.
+ * @param limits - Maximum model steps and tool calls.
+ * @returns LangChain middleware enforcing both limits.
+ * @throws The original middleware creation error.
+ * @example createNativeLimitMiddleware(limits);
+ */
+export function createNativeLimitMiddleware(limits) {
+    return Effect.runSync(createNativeLimitMiddlewareEffect(limits).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Creates one per-invocation monotonic call guard.
+ * @param limit - Maximum accepted calls.
+ * @param code - Existing public limit diagnostic.
+ * @param message - Existing safe diagnostic text.
+ * @param operation - Fixed model or tool operation span.
+ * @param observation - Fixed operation telemetry label.
+ * @returns A lazily observed Effect rejecting the first call beyond the limit.
+ */
+function createCallGuard(limit, code, message, operation, observation) {
+    let calls = 0;
+    return Effect.fn(operation)(() => Effect.try({
+        try: () => {
+            if (calls >= limit)
+                throw new AgentRuntimeError(code, message);
+            calls += 1;
+        },
+        catch: agentInvocationFailure,
+    }), (effect) => observeAgent(observation, effect));
+}
+//# sourceMappingURL=runtime-native-limits.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-limits.js","sourceRoot":"","sources":["../src/runtime-native-limits.ts"],"names":[],"mappings":"AAAA,mIAAmI;AAEnI,OAAO,EAAE,gBAAgB,EAA2B,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CACvF,CAAC,MAAmB,EAAE,EAAE,CACtB,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAuB,EAAE;QAC5B,MAAM,UAAU,GAAG,eAAe,CAChC,MAAM,CAAC,QAAQ,EACf,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,CACtB,CAAC;QACF,MAAM,SAAS,GAAG,eAAe,CAC/B,MAAM,CAAC,YAAY,EACnB,yBAAyB,EACzB,gCAAgC,EAChC,0BAA0B,EAC1B,oBAAoB,CACrB,CAAC;QACF,MAAM,QAAQ,GAAG,CAAC,MAAqC,EAAE,EAAE,CACzD,MAAM,CAAC,OAAO,CACZ,MAAM,CAAC,IAAI,CACT,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACnF,CACF,CAAC;QACJ,OAAO,gBAAgB,CAAC;YACtB,IAAI,EAAE,wBAAwB;YAC9B,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;gBAClC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;YACD,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;gBACjC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;gBACtB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,KAAK,EAAE,sBAAsB;CAC9B,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAC1D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAmB;IAC7D,OAAO,MAAM,CAAC,OAAO,CACnB,iCAAiC,CAAC,MAAM,CAAC,CAAC,IAAI,CAC5C,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;;;;;;;GAOG;AACH,SAAS,eAAe,CACtB,KAAa,EACb,IAAwD,EACxD,OAAe,EACf,SAAmE,EACnE,WAAyD;IAEzD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CACzB,GAAG,EAAE,CACH,MAAM,CAAC,GAAG,CAAC;QACT,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,KAAK,IAAI,KAAK;gBAAE,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/D,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QACD,KAAK,EAAE,sBAAsB;KAC9B,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAC9C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,24 @@
+/** Converts invocation messages into native LangChain message shapes while preserving content, tool calls and reply correlation. */
+import type { BrowserMessage } from "@relkit/contracts";
+import { Effect } from "effect";
+import type { AgentExecutionEvent } from "@relkit/agents/internal/runtime-events";
+/** Per-invocation accumulator of streamed native assistant message parts.
+ * @example const messages = new NativeMessageAccumulator();
+ */
+export declare class NativeMessageAccumulator {
+    private readonly messages;
+    /** Applies one public event to the message accumulator.
+     * @param event - Public native event.
+     * @returns An Effect with the latest browser message or undefined.
+     * @example Effect.runSync(messages.updateEffect(event));
+     */
+    readonly updateEffect: (event: AgentExecutionEvent) => Effect.Effect<BrowserMessage | undefined, never, never>;
+    /** Applies one event for existing synchronous callers.
+     * @param event - Public native event.
+     * @returns The updated browser message or undefined.
+     * @example messages.update(event);
+     */
+    update(event: AgentExecutionEvent): BrowserMessage | undefined;
+    private updateCore;
+}
+//# sourceMappingURL=runtime-native-messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-messages.d.ts","sourceRoot":"","sources":["../src/runtime-native-messages.ts"],"names":[],"mappings":"AAAA,oIAAoI;AAEpI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAGlF;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAE5D;;;;OAIG;IACH,QAAQ,CAAC,YAAY,0FAGnB;IAEF;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS;IAI9D,OAAO,CAAC,UAAU;CA6CnB"}

package/dist/runtime-native-messages.js

@@ -0,0 +1,83 @@
+/** Converts invocation messages into native LangChain message shapes while preserving content, tool calls and reply correlation. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+/** Per-invocation accumulator of streamed native assistant message parts.
+ * @example const messages = new NativeMessageAccumulator();
+ */
+export class NativeMessageAccumulator {
+    messages = new Map();
+    /** Applies one public event to the message accumulator.
+     * @param event - Public native event.
+     * @returns An Effect with the latest browser message or undefined.
+     * @example Effect.runSync(messages.updateEffect(event));
+     */
+    updateEffect = Effect.fn("Agents.runtime.messageUpdate")((event) => Effect.sync(() => this.updateCore(event)), (effect) => observeAgent("runtime.message-update", effect));
+    /** Applies one event for existing synchronous callers.
+     * @param event - Public native event.
+     * @returns The updated browser message or undefined.
+     * @example messages.update(event);
+     */
+    update(event) {
+        return Effect.runSync(this.updateEffect(event));
+    }
+    updateCore(event) {
+        if (event.kind !== "messages" || !isRecord(event.value))
+            return undefined;
+        const value = event.value;
+        const key = [...event.scope, event.node ?? ""].join("\u0000");
+        if (value.event === "message-start") {
+            if (value.role !== undefined && value.role !== "ai") {
+                this.messages.delete(key);
+                return undefined;
+            }
+            const messageId = text(value.id);
+            if (messageId === undefined)
+                return undefined;
+            this.messages.set(key, {
+                messageId,
+                createdAt: event.occurredAt,
+                parts: new Map(),
+            });
+            return undefined;
+        }
+        const current = this.messages.get(key);
+        if (current === undefined)
+            return undefined;
+        const index = typeof value.index === "number" ? value.index : 0;
+        if (value.event === "content-block-delta") {
+            const delta = text(isRecord(value.delta) ? value.delta.text : undefined);
+            if (delta !== undefined)
+                current.parts.set(index, (current.parts.get(index) ?? "") + delta);
+        }
+        else if (value.event === "content-block-start" || value.event === "content-block-finish") {
+            const content = text(isRecord(value.content) ? value.content.text : undefined);
+            if (content !== undefined)
+                current.parts.set(index, content);
+        }
+        const complete = value.event === "message-finish";
+        if (complete)
+            this.messages.delete(key);
+        if (current.parts.size === 0)
+            return undefined;
+        return {
+            messageId: current.messageId,
+            role: "assistant",
+            parts: [...current.parts]
+                .sort(([left], [right]) => left - right)
+                .map(([partIndex, partText]) => ({
+                partId: `${current.messageId}:text:${partIndex}`,
+                kind: "text",
+                text: partText,
+                state: complete ? "complete" : "streaming",
+            })),
+            createdAt: current.createdAt,
+        };
+    }
+}
+function text(value) {
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-native-messages.js.map

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

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

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

@@ -0,0 +1,7 @@
+/** Mutable text parts for one native assistant message. */
+export interface MessageState {
+    readonly messageId: string;
+    readonly createdAt: string;
+    readonly parts: Map<number, string>;
+}
+//# sourceMappingURL=runtime-native-messages.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-messages.types.d.ts","sourceRoot":"","sources":["../src/runtime-native-messages.types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

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

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

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

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

package/dist/runtime-native-public-state.d.ts

@@ -0,0 +1,22 @@
+/** Projects permitted native state values for public client events using the agent's declared visibility policy. */
+import type { StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+/** Projects selected state keys from direct or nested native updates.
+ * @param value - Native state update.
+ * @param schemas - Public state validators.
+ * @returns An Effect with projected state or AgentInvocationFailure.
+ * @example await Effect.runPromise(selectedStateEffect(update, schemas));
+ */
+export declare const selectedStateEffect: (value: unknown, schemas: ReadonlyMap<string, StandardSchemaV1<unknown, unknown>>) => Effect.Effect<{
+    [k: string]: unknown;
+} | undefined, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Validates selected fields from one state object with bounded concurrency.
+ * @param value - State object.
+ * @param schemas - Public state validators.
+ * @returns An Effect with selected fields or AgentInvocationFailure.
+ * @example await Effect.runPromise(selectEffect(state, schemas));
+ */
+export declare const selectEffect: (value: Record<string, unknown>, schemas: ReadonlyMap<string, StandardSchemaV1<unknown, unknown>>) => Effect.Effect<{
+    [k: string]: unknown;
+}, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+//# sourceMappingURL=runtime-native-public-state.d.ts.map

package/dist/runtime-native-public-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-public-state.d.ts","sourceRoot":"","sources":["../src/runtime-native-public-state.ts"],"names":[],"mappings":"AAAA,oHAAoH;AAEpH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAIxC;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;iFA2B/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;qEAuBxB,CAAC"}

package/dist/runtime-native-public-state.js

@@ -0,0 +1,44 @@
+/** Projects permitted native state values for public client events using the agent's declared visibility policy. */
+import { Effect, Result } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { validateValueEffect } from "./runtime-utils.js";
+/** Projects selected state keys from direct or nested native updates.
+ * @param value - Native state update.
+ * @param schemas - Public state validators.
+ * @returns An Effect with projected state or AgentInvocationFailure.
+ * @example await Effect.runPromise(selectedStateEffect(update, schemas));
+ */
+export const selectedStateEffect = Effect.fn("Agents.runtime.selectedState")(function* (value, schemas) {
+    if (!isRecord(value) || schemas.size === 0)
+        return undefined;
+    const direct = yield* selectEffect(value, schemas);
+    if (Object.keys(direct).length > 0)
+        return direct;
+    const outcomes = yield* Effect.forEach(Object.entries(value), ([name, update]) => Effect.result(isRecord(update)
+        ? selectEffect(update, schemas).pipe(Effect.map((selected) => Object.keys(selected).length === 0 ? undefined : [name, selected]))
+        : Effect.succeed(undefined)), { concurrency: 8 });
+    const firstFailure = outcomes.find(Result.isFailure);
+    if (firstFailure !== undefined)
+        return yield* Effect.fail(firstFailure.failure);
+    const entries = outcomes.flatMap((outcome) => Result.isSuccess(outcome) && outcome.success !== undefined ? [outcome.success] : []);
+    return entries.length === 0 ? undefined : Object.fromEntries(entries);
+}, (effect) => observeAgent("runtime.selected-state", effect));
+/** Validates selected fields from one state object with bounded concurrency.
+ * @param value - State object.
+ * @param schemas - Public state validators.
+ * @returns An Effect with selected fields or AgentInvocationFailure.
+ * @example await Effect.runPromise(selectEffect(state, schemas));
+ */
+export const selectEffect = Effect.fn("Agents.runtime.selectStateFields")(function* (value, schemas) {
+    const outcomes = yield* Effect.forEach([...schemas], ([key, schema]) => Effect.result(value[key] === undefined
+        ? Effect.succeed(undefined)
+        : validateValueEffect(schema, value[key], "output").pipe(Effect.map((projected) => [key, projected]))), { concurrency: 8 });
+    const firstFailure = outcomes.find(Result.isFailure);
+    if (firstFailure !== undefined)
+        return yield* Effect.fail(firstFailure.failure);
+    return Object.fromEntries(outcomes.flatMap((outcome) => Result.isSuccess(outcome) && outcome.success !== undefined ? [outcome.success] : []));
+}, (effect) => observeAgent("runtime.select-state-fields", effect));
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-native-public-state.js.map

package/dist/runtime-native-public-state.js.map

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

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

@@ -0,0 +1,15 @@
+/** Projects native tool activity into client-visible tool events after applying the declared public visibility contract. */
+import { Effect } from "effect";
+/** Projects a native tool result to its public value.
+ * @param value - Native result or serialized result.
+ * @returns An Effect with the public tool value.
+ * @example Effect.runSync(publicToolValueEffect(result));
+ */
+export declare const publicToolValueEffect: (value: unknown) => Effect.Effect<unknown, never, never>;
+/** Projects a native tool result for existing synchronous callers.
+ * @param value - Native result or serialized result.
+ * @returns Public tool value.
+ * @example publicToolValue(result);
+ */
+export declare function publicToolValue(value: unknown): unknown;
+//# sourceMappingURL=runtime-native-public-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-public-tools.d.ts","sourceRoot":"","sources":["../src/runtime-native-public-tools.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAE5H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,0DAGjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvD"}

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

@@ -0,0 +1,39 @@
+/** Projects native tool activity into client-visible tool events after applying the declared public visibility contract. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+/** Projects a native tool result to its public value.
+ * @param value - Native result or serialized result.
+ * @returns An Effect with the public tool value.
+ * @example Effect.runSync(publicToolValueEffect(result));
+ */
+export const publicToolValueEffect = Effect.fn("Agents.runtime.publicToolValue")((value) => Effect.sync(() => publicToolValueCore(value)), (effect) => observeAgent("runtime.public-tool-value", effect));
+/** Projects a native tool result for existing synchronous callers.
+ * @param value - Native result or serialized result.
+ * @returns Public tool value.
+ * @example publicToolValue(result);
+ */
+export function publicToolValue(value) {
+    return Effect.runSync(publicToolValueEffect(value));
+}
+function publicToolValueCore(value) {
+    if (typeof value === "string") {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    if (isRecord(value) && value.lg_name === "Command") {
+        const update = value.update;
+        const messages = isRecord(update) && Array.isArray(update.messages) ? update.messages : [];
+        return messages.length === 0 ? { completed: true } : publicToolValueCore(messages.at(-1));
+    }
+    if (!isRecord(value) || !("content" in value))
+        return value;
+    return publicToolValueCore(value.content);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-native-public-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-public-tools.js","sourceRoot":"","sources":["../src/runtime-native-public-tools.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAE5H,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAC9E,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,EACjE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAC9D,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,OAAO,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5C,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-native-public.d.ts

@@ -0,0 +1,28 @@
+/** Coordinates native state and tool projection for public execution sinks without exposing undeclared private state. */
+import type { ProtocolEvent } from "@langchain/langgraph";
+import type { StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+import type { AgentExecutionEvent } from "@relkit/agents/internal/runtime-events";
+import type { NativeExecutionContext } from "./runtime-native-public.types.js";
+export type { NativeExecutionContext } from "./runtime-native-public.types.js";
+export { publicToolValue, publicToolValueEffect } from "./runtime-native-public-tools.js";
+/** Projects a native protocol event to its public, validated form.
+ * @param event - Native protocol event.
+ * @param stateSchemas - Public state validators.
+ * @param context - Agent and parent context.
+ * @param eventSchemas - Custom event validators.
+ * @returns An Effect with a public event or AgentInvocationFailure.
+ * @example await Effect.runPromise(nativePublicEventEffect(event, schemas));
+ */
+export declare const nativePublicEventEffect: (event: ProtocolEvent, stateSchemas: ReadonlyMap<string, StandardSchemaV1<unknown, unknown>>, context?: NativeExecutionContext | undefined, eventSchemas?: Readonly<Record<string, StandardSchemaV1<unknown, unknown>>> | undefined) => Effect.Effect<AgentExecutionEvent, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Projects a native event for existing Promise callers.
+ * @param event - Native protocol event.
+ * @param stateSchemas - Public state validators.
+ * @param context - Agent and parent context.
+ * @param eventSchemas - Custom event validators.
+ * @returns A public event.
+ * @throws The original schema or timestamp error.
+ * @example await nativePublicEvent(event, schemas);
+ */
+export declare function nativePublicEvent(event: ProtocolEvent, stateSchemas: ReadonlyMap<string, StandardSchemaV1>, context?: NativeExecutionContext, eventSchemas?: Readonly<Record<string, StandardSchemaV1>>): Promise<AgentExecutionEvent>;
+//# sourceMappingURL=runtime-native-public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-public.d.ts","sourceRoot":"","sources":["../src/runtime-native-public.ts"],"names":[],"mappings":"AAAA,yHAAyH;AAEzH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAGlF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAG/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE1F;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,+UA2BnC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACnD,OAAO,GAAE,sBAA2B,EACpC,YAAY,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAM,GAC5D,OAAO,CAAC,mBAAmB,CAAC,CAM9B"}