@relkit/langchain 0.0.0-stage → 0.7.10

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

@@ -0,0 +1,40 @@
+/** Constructs the native agent from resolved model, tools, middleware and optional DeepAgents configuration immediately before invocation. */
+import type { LanguageModelLike } from "@langchain/core/language_models/base";
+import type { AnyAgentMiddleware } from "langchain";
+import { Effect } from "effect";
+import type { AgentDescriptor } from "./define-agent.js";
+import { AgentInvocationFailure } from "./runtime-effect-error.js";
+import type { CreateNativeAgentOptions, NativeAgentRuntimeOptions } from "./runtime-native-agent.types.js";
+import { type NativeTools } from "./runtime-native-tools.js";
+import { NativeToolIdentity } from "./runtime-native-tools-identity.js";
+/** Materializes tools for a root or child agent.
+ * @param runtime - Root runtime integrations.
+ * @param options - Native invocation options.
+ * @param agent - Agent whose tools are materialized.
+ * @returns An Effect with native tools or AgentInvocationFailure.
+ * @example Effect.runSync(createToolsForAgentEffect(runtime, options, child));
+ */
+export declare const createToolsForAgentEffect: (runtime: NativeAgentRuntimeOptions, options: CreateNativeAgentOptions, agent: AgentDescriptor<string, unknown, unknown, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, readonly import("./define-agent-native.types.js").AgentMiddleware[], readonly import("./define-agent-native.types.js").AgentTool[]>) => Effect.Effect<NativeTools, AgentInvocationFailure, NativeToolIdentity>;
+/** Resolves a child model or inherits its parent model.
+ * @param child - Child descriptor.
+ * @param inherited - Parent model.
+ * @param runtime - Model registry and environment.
+ * @returns An Effect with a native model or AgentInvocationFailure.
+ * @example await Effect.runPromise(childModelEffect(child, model, runtime));
+ */
+export declare const childModelEffect: (child: AgentDescriptor<string, unknown, unknown, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, readonly import("./define-agent-native.types.js").AgentMiddleware[], readonly import("./define-agent-native.types.js").AgentTool[]>, inherited: string | LanguageModelLike, runtime: NativeAgentRuntimeOptions) => Effect.Effect<string | LanguageModelLike, AgentInvocationFailure, never>;
+/** Builds child and nested DeepAgents declarations in authored order.
+ * @param children - Child descriptors.
+ * @param inheritedModel - Parent model.
+ * @param inheritedBackend - Parent bucket backend.
+ * @param runtime - Root runtime integrations.
+ * @param options - Native invocation options.
+ * @param groups - Mutable tool groups retained by the root agent.
+ * @param deepagents - Loaded DeepAgents module.
+ * @param limitMiddleware - Shared invocation limit middleware.
+ * @returns An Effect with child declarations or AgentInvocationFailure.
+ * @example await Effect.runPromise(createSubagentsEffect(children, model, backend, runtime, options, groups, deepagents, limits));
+ */
+export declare const createSubagentsEffect: (children: readonly AgentDescriptor<string, unknown, unknown, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, import("@relkit/schema").StandardSchemaV1<unknown, unknown>, readonly import("./define-agent-native.types.js").AgentMiddleware[], readonly import("./define-agent-native.types.js").AgentTool[]>[], inheritedModel: string | LanguageModelLike, inheritedBackend: unknown, runtime: NativeAgentRuntimeOptions, options: CreateNativeAgentOptions, groups: NativeTools[], deepagents: typeof import("deepagents"), limitMiddleware: AnyAgentMiddleware) => Effect.Effect<unknown[], AgentInvocationFailure, NativeToolIdentity>;
+export { responseFormatEffect } from "./runtime-native-response-format.js";
+//# sourceMappingURL=runtime-native-agent-build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-agent-build.d.ts","sourceRoot":"","sources":["../src/runtime-native-agent-build.ts"],"names":[],"mappings":"AAAA,8IAA8I;AAI9I,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,sBAAsB,EAA0B,MAAM,2BAA2B,CAAC;AAC3F,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAIxE;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,mcAcrC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,ycAe5B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,2nBAsBjC,CAAC;AA0DF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC"}

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

@@ -0,0 +1,77 @@
+/** Constructs the native agent from resolved model, tools, middleware and optional DeepAgents configuration immediately before invocation. */
+import { childAgentCommon, nestedChildAgentEffect } from "./runtime-native-subagents.js";
+import { responseFormatEffect } from "./runtime-native-response-format.js";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { hasDeepAgentCapabilities } from "./define-agent-deep.js";
+import { resolveAgentPersistenceEffect } from "./graph-persistence.js";
+import { AgentInvocationFailure, agentInvocationFailure } from "./runtime-effect-error.js";
+import { createNativeToolsEffect } from "./runtime-native-tools.js";
+import { NativeToolIdentity } from "./runtime-native-tools-identity.js";
+import { nativeInstructionsEffect } from "./runtime-native-support.js";
+import { resolveRuntimeModelEffect } from "./runtime-model.js";
+/** Materializes tools for a root or child agent.
+ * @param runtime - Root runtime integrations.
+ * @param options - Native invocation options.
+ * @param agent - Agent whose tools are materialized.
+ * @returns An Effect with native tools or AgentInvocationFailure.
+ * @example Effect.runSync(createToolsForAgentEffect(runtime, options, child));
+ */
+export const createToolsForAgentEffect = Effect.fn("Agents.runtime.createAgentTools")((runtime, options, agent) => createNativeToolsEffect({ ...runtime, agent }, options.signal, options.maxOutputBytes, options.invocationId, options.traceId), (effect) => observeAgent("runtime.create-agent-tools", effect));
+/** Resolves a child model or inherits its parent model.
+ * @param child - Child descriptor.
+ * @param inherited - Parent model.
+ * @param runtime - Model registry and environment.
+ * @returns An Effect with a native model or AgentInvocationFailure.
+ * @example await Effect.runPromise(childModelEffect(child, model, runtime));
+ */
+export const childModelEffect = Effect.fn("Agents.runtime.childModel")(function* (child, inherited, runtime) {
+    if (child.model === undefined)
+        return inherited;
+    const resolved = yield* resolveRuntimeModelEffect({
+        model: child.model,
+        registry: runtime.modelRegistry,
+        environment: runtime.environment ?? {},
+    }).pipe(Effect.mapError((failure) => agentInvocationFailure(failure.cause)));
+    return resolved.model;
+}, (effect) => observeAgent("runtime.child-model", effect));
+/** Builds child and nested DeepAgents declarations in authored order.
+ * @param children - Child descriptors.
+ * @param inheritedModel - Parent model.
+ * @param inheritedBackend - Parent bucket backend.
+ * @param runtime - Root runtime integrations.
+ * @param options - Native invocation options.
+ * @param groups - Mutable tool groups retained by the root agent.
+ * @param deepagents - Loaded DeepAgents module.
+ * @param limitMiddleware - Shared invocation limit middleware.
+ * @returns An Effect with child declarations or AgentInvocationFailure.
+ * @example await Effect.runPromise(createSubagentsEffect(children, model, backend, runtime, options, groups, deepagents, limits));
+ */
+export const createSubagentsEffect = Effect.fn("Agents.runtime.createSubagents")((children, inheritedModel, inheritedBackend, runtime, options, groups, deepagents, limitMiddleware) => createSubagentsCore(children, inheritedModel, inheritedBackend, runtime, options, groups, deepagents, limitMiddleware), (effect) => observeAgent("runtime.create-subagents", effect));
+function createSubagentsCore(children, inheritedModel, inheritedBackend, runtime, options, groups, deepagents, limitMiddleware) {
+    return Effect.gen(function* () {
+        const subagents = [];
+        for (const child of children) {
+            const childTools = yield* createToolsForAgentEffect(runtime, options, child);
+            groups.push(childTools);
+            const model = yield* childModelEffect(child, inheritedModel, runtime);
+            const instructions = yield* nativeInstructionsEffect(child);
+            const format = yield* responseFormatEffect(child.output);
+            const common = childAgentCommon(child, model, instructions, format, childTools, limitMiddleware);
+            if (!hasDeepAgentCapabilities(child)) {
+                subagents.push({
+                    ...common,
+                    description: child.description ?? child.title ?? child.id,
+                });
+                continue;
+            }
+            const backend = child.backend ?? inheritedBackend;
+            const persistence = yield* resolveAgentPersistenceEffect(child, runtime.environment ?? {}).pipe(Effect.mapError((failure) => agentInvocationFailure(failure.cause)));
+            const nested = yield* createSubagentsCore(child.subagents ?? [], model, backend, runtime, options, groups, deepagents, limitMiddleware);
+            subagents.push(yield* nestedChildAgentEffect(child, common, persistence, nested, backend, deepagents));
+        }
+        return subagents;
+    });
+}
+export { responseFormatEffect } from "./runtime-native-response-format.js";
+//# sourceMappingURL=runtime-native-agent-build.js.map

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

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

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

@@ -0,0 +1,30 @@
+/** Owns native agent construction and invocation adaptation, retaining the authored SDK configuration and selected persistence context. */
+import { StructuredOutputParsingError, type AnyAgentMiddleware } from "langchain";
+import { Effect } from "effect";
+import type { CreateNativeAgentOptions, NativeAgent } from "./runtime-native-agent.types.js";
+import type { NativeTools } from "./runtime-native-tools.js";
+export { StructuredOutputParsingError };
+export type { CreateNativeAgentOptions, NativeAgent } from "./runtime-native-agent.types.js";
+/** Builds a native LangChain or DeepAgents runnable for one invocation.
+ * @param options - Runtime, model, signal, and invocation identity.
+ * @returns An Effect with native agent and tools or AgentInvocationFailure.
+ * @example await Effect.runPromise(Effect.provide(createNativeAgentEffect(options), Layer.merge(DeepAgentsLoaderLive, NativeToolIdentityLive)));
+ */
+export declare const createNativeAgentEffect: (options: CreateNativeAgentOptions) => Effect.Effect<{
+    agent: import("langchain").ReactAgent<import("langchain").AgentTypeConfig<import("langchain").ResponseFormatUndefined, undefined, import("langchain").AnyAnnotationRoot, AnyAgentMiddleware[], readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool | import("langchain").DynamicStructuredTool<import("@langchain/core/utils/json_schema").JSONSchema | import("@langchain/core/utils/types").InteropZodObject | import("@langchain/core/utils/types").InteropZodType<string>, unknown, unknown, unknown, unknown, string> | import("langchain").DynamicTool<unknown, unknown>)[], readonly []>>;
+    tools: NativeTools;
+} | {
+    agent: import("langchain").ReactAgent<import("langchain").AgentTypeConfig<Record<string, any>, import("@langchain/langgraph").StateDefinitionInit | undefined, import("@langchain/core/utils/types").InteropZodObject | import("langchain").AnyAnnotationRoot, readonly AnyAgentMiddleware[], readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[], readonly (() => import("@langchain/langgraph").StreamTransformer<any>)[]>>;
+    tools: NativeTools;
+}, import("./runtime-effect-error.js").AgentInvocationFailure, import("./runtime-native-tools-identity.js").NativeToolIdentity | import("./runtime-native-support.js").DeepAgentsLoader>;
+/** Builds a native agent for existing Promise callers.
+ * @param options - Runtime, model, signal, and invocation identity.
+ * @returns Native agent and public tool mappings.
+ * @throws The original model, schema, persistence, or dependency error.
+ * @example await createNativeAgent(options);
+ */
+export declare function createNativeAgent(options: CreateNativeAgentOptions): Promise<{
+    readonly agent: NativeAgent;
+    readonly tools: NativeTools;
+}>;
+//# sourceMappingURL=runtime-native-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-agent.d.ts","sourceRoot":"","sources":["../src/runtime-native-agent.ts"],"names":[],"mappings":"AAAA,2IAA2I;AAE3I,OAAO,EAAe,4BAA4B,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,MAAM,EAAS,MAAM,QAAQ,CAAC;AAWvC,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAG7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAQ7D,OAAO,EAAE,4BAA4B,EAAE,CAAC;AACxC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE7F;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;wLAgDnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC;IAC5E,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,CAAC,CAQD"}

package/dist/runtime-native-agent.js

@@ -0,0 +1,84 @@
+/** Owns native agent construction and invocation adaptation, retaining the authored SDK configuration and selected persistence context. */
+import { createAgent, StructuredOutputParsingError } from "langchain";
+import { Effect, Layer } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { hasDeepAgentCapabilities } from "./define-agent-deep.js";
+import { createThreadBucketBackendEffect } from "./deepagent-bucket-scope.js";
+import { resolveAgentPersistenceEffect } from "./graph-persistence.js";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+import { createSubagentsEffect, createToolsForAgentEffect, responseFormatEffect, } from "./runtime-native-agent-build.js";
+import { createNativeLimitMiddlewareEffect } from "./runtime-native-limits.js";
+import { NativeToolIdentityLive } from "./runtime-native-tools-identity.js";
+import { combineNativeToolsEffect, DeepAgentsLoaderLive, loadDeepAgentsEffect, nativeInstructionsEffect, } from "./runtime-native-support.js";
+export { StructuredOutputParsingError };
+/** Builds a native LangChain or DeepAgents runnable for one invocation.
+ * @param options - Runtime, model, signal, and invocation identity.
+ * @returns An Effect with native agent and tools or AgentInvocationFailure.
+ * @example await Effect.runPromise(Effect.provide(createNativeAgentEffect(options), Layer.merge(DeepAgentsLoaderLive, NativeToolIdentityLive)));
+ */
+export const createNativeAgentEffect = Effect.fn("Agents.runtime.createNativeAgent")(function* (options) {
+    const { runtime } = options;
+    const { tools, persistence, limitMiddleware, common } = yield* nativeAgentCommonEffect(options);
+    if (!hasDeepAgentCapabilities(runtime.agent)) {
+        const agent = yield* Effect.try({
+            try: () => createAgent(common),
+            catch: agentInvocationFailure,
+        });
+        return { agent, tools };
+    }
+    const deepagents = yield* loadDeepAgentsEffect();
+    const backend = runtime.bucketBackend === undefined
+        ? runtime.agent.backend
+        : yield* createThreadBucketBackendEffect(runtime.bucketBackend, runtime.agent.id, runtime.threadId ?? "").pipe(Effect.mapError((failure) => agentInvocationFailure(failure.cause)));
+    const groups = [tools];
+    const subagents = yield* createSubagentsEffect(runtime.agent.subagents ?? [], options.model, backend, runtime, options, groups, deepagents, limitMiddleware);
+    const agent = yield* Effect.try({
+        try: () => deepagents.createDeepAgent({
+            ...common,
+            subagents,
+            ...(runtime.agent.skills === undefined ? {} : { skills: [...runtime.agent.skills] }),
+            ...(runtime.agent.memory === undefined ? {} : { memory: [...runtime.agent.memory] }),
+            ...(backend === undefined ? {} : { backend }),
+            ...(runtime.agent.interruptOn === undefined
+                ? {}
+                : { interruptOn: runtime.agent.interruptOn }),
+        }),
+        catch: agentInvocationFailure,
+    });
+    return { agent, tools: yield* combineNativeToolsEffect(groups) };
+}, (effect) => observeAgent("runtime.create-native-agent", effect));
+/** Builds a native agent for existing Promise callers.
+ * @param options - Runtime, model, signal, and invocation identity.
+ * @returns Native agent and public tool mappings.
+ * @throws The original model, schema, persistence, or dependency error.
+ * @example await createNativeAgent(options);
+ */
+export function createNativeAgent(options) {
+    return Effect.runPromise(createNativeAgentEffect(options).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(Layer.merge(DeepAgentsLoaderLive, NativeToolIdentityLive))), { signal: options.signal });
+}
+/** Resolves native tools, persistence and response configuration in the original order.
+ * @param options - One invocation's native runtime dependencies.
+ * @returns Shared configuration for ordinary and DeepAgents execution.
+ */
+const nativeAgentCommonEffect = Effect.fn("Agents.runtime.nativeCommon")(function* (options) {
+    const { runtime } = options;
+    const tools = yield* createToolsForAgentEffect(runtime, options, runtime.agent);
+    const persistence = yield* resolveAgentPersistenceEffect(runtime.agent, runtime.environment ?? {}).pipe(Effect.mapError((failure) => agentInvocationFailure(failure.cause)));
+    const limitMiddleware = yield* createNativeLimitMiddlewareEffect(runtime.agent.limits);
+    const instructions = yield* nativeInstructionsEffect(runtime.agent);
+    const format = yield* responseFormatEffect(runtime.agent.output, options.model);
+    const common = {
+        name: runtime.agent.id,
+        model: options.model,
+        systemPrompt: instructions,
+        tools: [...tools.values],
+        middleware: [
+            ...runtime.agent.middleware,
+            limitMiddleware,
+        ],
+        responseFormat: format,
+        ...persistence,
+    };
+    return { tools, persistence, limitMiddleware, common };
+});
+//# sourceMappingURL=runtime-native-agent.js.map

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

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

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

@@ -0,0 +1,21 @@
+/** Owns native agent construction and invocation adaptation, retaining the authored SDK configuration and selected persistence context. This companion preserves the native input and output types without starting runtime work. */
+import type { LanguageModelLike } from "@langchain/core/language_models/base";
+import type { createAgent } from "langchain";
+import type { AgentDescriptor } from "./define-agent.js";
+import type { AgentInvocationOptions, AgentRuntimeOptions } from "./runtime.js";
+/** Runtime options narrowed to a native agent descriptor. */
+export type NativeAgentRuntimeOptions = Omit<AgentRuntimeOptions, "agent"> & AgentInvocationOptions & {
+    readonly agent: AgentDescriptor<string, unknown, unknown>;
+};
+/** Native LangChain agent runnable. */
+export type NativeAgent = ReturnType<typeof createAgent>;
+/** Inputs required to build one native agent invocation. */
+export interface CreateNativeAgentOptions {
+    readonly runtime: NativeAgentRuntimeOptions;
+    readonly model: string | LanguageModelLike;
+    readonly signal: AbortSignal;
+    readonly maxOutputBytes: number;
+    readonly invocationId: string;
+    readonly traceId: string;
+}
+//# sourceMappingURL=runtime-native-agent.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-agent.types.d.ts","sourceRoot":"","sources":["../src/runtime-native-agent.types.ts"],"names":[],"mappings":"AAAA,qOAAqO;AAErO,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEhF,6DAA6D;AAC7D,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GACxE,sBAAsB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CAC3D,CAAC;AAEJ,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,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;CAC1B"}

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

@@ -0,0 +1,3 @@
+/** Owns native agent construction and invocation adaptation, retaining the authored SDK configuration and selected persistence context. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=runtime-native-agent.types.js.map

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

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

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

@@ -0,0 +1,28 @@
+/** Projects native tool events into RELKIT tool lifecycle observations while preserving tool call identifiers and status order. */
+import type { ProtocolEvent } from "@langchain/langgraph";
+import { Effect } from "effect";
+import type { AgentContentSink } from "./runtime.types.js";
+/** Emits public lifecycle updates for a native tool event.
+ * @param event - Native event.
+ * @param sink - Optional client sink.
+ * @param toolIds - Public tool name mapping.
+ * @param relkitNames - RELKIT owned tool names.
+ * @param toolNames - Mutable call name map.
+ * @param signal - Invocation cancellation signal.
+ * @returns An Effect with void or AgentInvocationFailure.
+ * @example await Effect.runPromise(emitToolEventEffect(event, sink, ids, names, calls, signal));
+ */
+export declare const emitToolEventEffect: (event: ProtocolEvent, sink: AgentContentSink | undefined, toolIds: ReadonlyMap<string, string>, relkitNames: ReadonlySet<string>, toolNames: Map<string, string>, signal: AbortSignal) => Effect.Effect<void, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Emits a native tool event for existing Promise callers.
+ * @param event - Native event.
+ * @param sink - Optional client sink.
+ * @param toolIds - Public tool name mapping.
+ * @param relkitNames - RELKIT owned tool names.
+ * @param toolNames - Mutable call name map.
+ * @param signal - Invocation cancellation signal.
+ * @returns A Promise that resolves after all lifecycle emissions.
+ * @throws The original sink or cancellation error.
+ * @example await emitToolEvent(event, sink, ids, names, calls, signal);
+ */
+export declare function emitToolEvent(event: ProtocolEvent, sink: AgentContentSink | undefined, toolIds: ReadonlyMap<string, string>, relkitNames: ReadonlySet<string>, toolNames: Map<string, string>, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=runtime-native-event-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-event-tools.d.ts","sourceRoot":"","sources":["../src/runtime-native-event-tools.ts"],"names":[],"mappings":"AAAA,mIAAmI;AAEnI,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,mRAmD/B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAOf"}

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

@@ -0,0 +1,88 @@
+/** Projects native tool events into RELKIT tool lifecycle observations while preserving tool call identifiers and status order. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+import { publicToolValueEffect } from "./runtime-native-public-tools.js";
+import { signalFailure, withSignal } from "./signal.js";
+/** Emits public lifecycle updates for a native tool event.
+ * @param event - Native event.
+ * @param sink - Optional client sink.
+ * @param toolIds - Public tool name mapping.
+ * @param relkitNames - RELKIT owned tool names.
+ * @param toolNames - Mutable call name map.
+ * @param signal - Invocation cancellation signal.
+ * @returns An Effect with void or AgentInvocationFailure.
+ * @example await Effect.runPromise(emitToolEventEffect(event, sink, ids, names, calls, signal));
+ */
+export const emitToolEventEffect = Effect.fn("Agents.runtime.emitNativeToolEvent")(function* (event, sink, toolIds, relkitNames, toolNames, signal) {
+    if (event.method !== "tools" || sink?.emitTool === undefined || !isRecord(event.params.data))
+        return;
+    const data = event.params.data;
+    const callId = data.tool_call_id;
+    if (typeof callId !== "string")
+        return;
+    const suppliedName = typeof data.tool_name === "string" ? data.tool_name : undefined;
+    if (suppliedName !== undefined)
+        toolNames.set(callId, suppliedName);
+    const nativeName = suppliedName ?? toolNames.get(callId);
+    if (relkitNames.has(nativeName ?? ""))
+        return;
+    const toolId = nativeName === undefined ? "unknown" : (toolIds.get(nativeName) ?? nativeName);
+    const emit = (state, value) => {
+        if (signal.aborted)
+            return Effect.fail(agentInvocationFailure(signalFailure(signal)));
+        return Effect.tryPromise({
+            try: (effectSignal) => {
+                const combined = AbortSignal.any([signal, effectSignal]);
+                return withSignal(sink.emitTool({
+                    toolCallId: callId,
+                    toolId,
+                    state,
+                    ...(value === undefined ? {} : { value }),
+                }, combined), combined);
+            },
+            catch: agentInvocationFailure,
+        });
+    };
+    if (data.event === "tool-started") {
+        yield* emit("started");
+        yield* emit("input-ready", yield* publicToolValueEffect(data.input));
+        yield* emit("running");
+        return;
+    }
+    const output = yield* publicToolValueEffect(data.output);
+    const state = toolState(data.event, output);
+    if (state !== undefined)
+        yield* emit(state, output);
+}, (effect) => observeAgent("runtime.emit-native-tool-event", effect));
+/** Emits a native tool event for existing Promise callers.
+ * @param event - Native event.
+ * @param sink - Optional client sink.
+ * @param toolIds - Public tool name mapping.
+ * @param relkitNames - RELKIT owned tool names.
+ * @param toolNames - Mutable call name map.
+ * @param signal - Invocation cancellation signal.
+ * @returns A Promise that resolves after all lifecycle emissions.
+ * @throws The original sink or cancellation error.
+ * @example await emitToolEvent(event, sink, ids, names, calls, signal);
+ */
+export function emitToolEvent(event, sink, toolIds, relkitNames, toolNames, signal) {
+    return Effect.runPromise(emitToolEventEffect(event, sink, toolIds, relkitNames, toolNames, signal).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))), { signal });
+}
+function toolState(event, output) {
+    if (event === "tool-error" || isSafeToolError(output))
+        return "failed";
+    if (event === "tool-finished")
+        return "succeeded";
+    return undefined;
+}
+function isSafeToolError(value) {
+    return (isRecord(value) &&
+        isRecord(value.error) &&
+        typeof value.error.code === "string" &&
+        value.error.message === "Tool call failed");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-native-event-tools.js.map

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

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

package/dist/runtime-native-events-helpers.d.ts

@@ -0,0 +1,30 @@
+/** Extracts native event identifiers and payload fragments shared by stream adapters, retaining the SDK's event identity conventions. */
+import type { ProtocolEvent } from "@langchain/langgraph";
+import { type NativeExecutionContext } from "./runtime-native-public.js";
+/** Tracks agent and subagent identity from native protocol events.
+ * @param event - Native event.
+ * @param contexts - Mutable scope context map.
+ * @returns Nothing; the context map is updated when identity is present.
+ * @example trackExecutionContext(event, contexts);
+ */
+export declare function trackExecutionContext(event: ProtocolEvent, contexts: Map<string, NativeExecutionContext>): void;
+/** Resolves the nearest execution context for a nested event.
+ * @param event - Native event.
+ * @param contexts - Recorded scope contexts.
+ * @returns Nearest context or an empty context.
+ * @example executionContext(event, contexts);
+ */
+export declare function executionContext(event: ProtocolEvent, contexts: ReadonlyMap<string, NativeExecutionContext>): NativeExecutionContext;
+/** Checks whether an event starts a model call.
+ * @param event - Native event.
+ * @returns Whether the event starts a model call.
+ * @example isModelStart(event);
+ */
+export declare function isModelStart(event: ProtocolEvent): boolean;
+/** Checks whether an event starts a tool call.
+ * @param event - Native event.
+ * @returns Whether the event starts a tool call.
+ * @example isToolStart(event);
+ */
+export declare function isToolStart(event: ProtocolEvent): boolean;
+//# sourceMappingURL=runtime-native-events-helpers.d.ts.map

package/dist/runtime-native-events-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-events-helpers.d.ts","sourceRoot":"","sources":["../src/runtime-native-events-helpers.ts"],"names":[],"mappings":"AAAA,yIAAyI;AAEzI,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAE1F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAC5C,IAAI,CAuBN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,GACpD,sBAAsB,CAMxB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAO1D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAMzD"}

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

@@ -0,0 +1,74 @@
+/** Extracts native event identifiers and payload fragments shared by stream adapters, retaining the SDK's event identity conventions. */
+import { publicToolValue } from "./runtime-native-public.js";
+/** Tracks agent and subagent identity from native protocol events.
+ * @param event - Native event.
+ * @param contexts - Mutable scope context map.
+ * @returns Nothing; the context map is updated when identity is present.
+ * @example trackExecutionContext(event, contexts);
+ */
+export function trackExecutionContext(event, contexts) {
+    const data = event.params.data;
+    if (!isRecord(data))
+        return;
+    const key = scopeKey(event.params.namespace);
+    if (event.method === "tasks" && isRecord(data.metadata)) {
+        const agent = data.metadata.lc_agent_name;
+        if (typeof agent === "string" && agent !== "")
+            contexts.set(key, { ...contexts.get(key), agent });
+        return;
+    }
+    if (event.method !== "tools" ||
+        data.event !== "tool-started" ||
+        data.tool_name !== "task" ||
+        typeof data.tool_call_id !== "string")
+        return;
+    const input = publicToolValue(data.input);
+    if (!isRecord(input) || typeof input.subagent_type !== "string")
+        return;
+    contexts.set(key, {
+        agent: input.subagent_type,
+        parent: { kind: "tool", toolCallId: data.tool_call_id, toolId: "task" },
+    });
+}
+/** Resolves the nearest execution context for a nested event.
+ * @param event - Native event.
+ * @param contexts - Recorded scope contexts.
+ * @returns Nearest context or an empty context.
+ * @example executionContext(event, contexts);
+ */
+export function executionContext(event, contexts) {
+    for (let length = event.params.namespace.length; length >= 0; length -= 1) {
+        const found = contexts.get(scopeKey(event.params.namespace.slice(0, length)));
+        if (found !== undefined)
+            return found;
+    }
+    return {};
+}
+function scopeKey(namespace) {
+    return namespace.join("\u0000");
+}
+/** Checks whether an event starts a model call.
+ * @param event - Native event.
+ * @returns Whether the event starts a model call.
+ * @example isModelStart(event);
+ */
+export function isModelStart(event) {
+    return (event.method === "tasks" &&
+        isRecord(event.params.data) &&
+        event.params.data.name === "model_request" &&
+        !("result" in event.params.data));
+}
+/** Checks whether an event starts a tool call.
+ * @param event - Native event.
+ * @returns Whether the event starts a tool call.
+ * @example isToolStart(event);
+ */
+export function isToolStart(event) {
+    return (event.method === "tools" &&
+        isRecord(event.params.data) &&
+        event.params.data.event === "tool-started");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-native-events-helpers.js.map

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

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

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

@@ -0,0 +1,45 @@
+/** Maps the native event stream into RELKIT execution events and public observations in the order delivered by the native iterator. */
+import type { ProtocolEvent } from "@langchain/langgraph";
+import type { StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+import type { AgentContentSink } from "./runtime.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 declare const collectNativeEventsEffect: (events: AsyncIterable<ProtocolEvent>, sink: AgentContentSink | undefined, toolIds: ReadonlyMap<string, string>, relkitNames: ReadonlySet<string>, signal: AbortSignal, limits: {
+    readonly maxSteps: number;
+    readonly maxToolCalls: number;
+}, stateSchemas: ReadonlyMap<string, StandardSchemaV1<unknown, unknown>>, failure: () => unknown, observe: ((event: ProtocolEvent) => void) | undefined, abort: (reason: unknown) => void, eventSchemas?: Readonly<Record<string, StandardSchemaV1<unknown, unknown>>> | undefined) => Effect.Effect<undefined, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** 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 declare function collectNativeEvents(events: AsyncIterable<ProtocolEvent>, sink: AgentContentSink | undefined, toolIds: ReadonlyMap<string, string>, relkitNames: ReadonlySet<string>, signal: AbortSignal, limits: {
+    readonly maxSteps: number;
+    readonly maxToolCalls: number;
+}, stateSchemas: ReadonlyMap<string, StandardSchemaV1>, failure: () => unknown, observe: ((event: ProtocolEvent) => void) | undefined, abort: (reason: unknown) => void, eventSchemas?: Readonly<Record<string, StandardSchemaV1>>): Promise<void>;
+//# sourceMappingURL=runtime-native-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-events.d.ts","sourceRoot":"","sources":["../src/runtime-native-events.ts"],"names":[],"mappings":"AAAA,uIAAuI;AAEvI,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,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAarD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,yBAAyB;uBAOL,MAAM;2BAAyB,MAAM;yFAEnD,OAAO,oBACJ,aAAa,KAAK,IAAI,+BACxB,OAAO,KAAK,IAAI,yLA8BnC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,EACpC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACpE,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACnD,OAAO,EAAE,MAAM,OAAO,EACtB,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,EACrD,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAChC,YAAY,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAM,GAC5D,OAAO,CAAC,IAAI,CAAC,CAiBf"}