@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/runtime-native-public.js

@@ -0,0 +1,165 @@
+/** Coordinates native state and tool projection for public execution sinks without exposing undeclared private state. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+import { publicToolValue } from "./runtime-native-public-tools.js";
+import { selectedStateEffect } from "./runtime-native-public-state.js";
+import { validateValueEffect } from "./runtime-utils.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 const nativePublicEventEffect = Effect.fn("Agents.runtime.nativePublicEvent")(function* (event, stateSchemas, context = {}, eventSchemas = {}) {
+    const value = yield* publicValueEffect(event.method, event.params.data, stateSchemas, eventSchemas);
+    return yield* Effect.try({
+        try: () => ({
+            nativeSequence: event.seq,
+            kind: event.method,
+            scope: [...event.params.namespace],
+            occurredAt: new Date(event.params.timestamp).toISOString(),
+            ...context,
+            ...(event.params.node === undefined ? {} : { node: event.params.node }),
+            ...(value === undefined ? {} : { value }),
+        }),
+        catch: agentInvocationFailure,
+    });
+}, (effect) => observeAgent("runtime.native-public-event", effect));
+/** 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 function nativePublicEvent(event, stateSchemas, context = {}, eventSchemas = {}) {
+    return Effect.runPromise(nativePublicEventEffect(event, stateSchemas, context, eventSchemas).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+const publicValueEffect = Effect.fn("Agents.runtime.publicEventValue")(function* (method, value, stateSchemas, eventSchemas) {
+    if (method === "input")
+        return undefined;
+    if (method === "values" || method === "updates")
+        return yield* selectedStateEffect(value, stateSchemas);
+    if (method === "tasks")
+        return publicTask(value);
+    if (method === "checkpoints") {
+        return eventFields(value, ["id", "parent_id", "step", "source"]);
+    }
+    if (method === "lifecycle")
+        return publicLifecycle(value);
+    if (method === "messages")
+        return publicMessage(value);
+    if (method === "tools" && isRecord(value)) {
+        return {
+            ...eventFields(value, ["event", "tool_call_id", "tool_name", "code"]),
+            ...(value.input === undefined ? {} : { input: publicToolValue(value.input) }),
+            ...(value.output === undefined ? {} : { output: publicToolValue(value.output) }),
+        };
+    }
+    if (method === "custom" && isRecord(value) && typeof value.name === "string") {
+        const schema = eventSchemas[value.name];
+        if (schema === undefined)
+            return undefined;
+        return {
+            name: value.name,
+            data: yield* validateValueEffect(schema, value.data, "output"),
+        };
+    }
+    return undefined;
+}, (effect) => observeAgent("runtime.public-event-value", effect));
+function publicTask(value) {
+    if (!isRecord(value))
+        return {};
+    const interrupted = Array.isArray(value.interrupts) && value.interrupts.length > 0;
+    const status = value.error !== undefined
+        ? "failed"
+        : interrupted
+            ? "interrupted"
+            : "result" in value
+                ? "completed"
+                : "started";
+    return { ...eventFields(value, ["id", "name"]), status };
+}
+function publicLifecycle(value) {
+    if (!isRecord(value))
+        return {};
+    const cause = safeCause(value.cause);
+    return {
+        ...eventFields(value, ["event", "graph_name"]),
+        ...(cause === undefined ? {} : { cause }),
+    };
+}
+function safeCause(value) {
+    if (!isRecord(value) || typeof value.type !== "string")
+        return undefined;
+    if (value.type === "toolCall" && typeof value.tool_call_id === "string") {
+        return { type: value.type, tool_call_id: value.tool_call_id };
+    }
+    if ((value.type === "send" || value.type === "edge") && typeof value.from_node === "string") {
+        return { type: value.type, from_node: value.from_node };
+    }
+    return { type: "unknown" };
+}
+function publicMessage(value) {
+    if (!isRecord(value))
+        return {};
+    const base = eventFields(value, ["event", "id", "run_id", "role", "index", "code"]);
+    if (isRecord(value.delta) && value.delta.type === "reasoning-delta")
+        return base;
+    if (isRecord(value.content) && String(value.content.type).includes("reasoning"))
+        return base;
+    return {
+        ...base,
+        ...(publicContent(value.content) === undefined
+            ? {}
+            : { content: publicContent(value.content) }),
+        ...(publicDelta(value.delta) === undefined ? {} : { delta: publicDelta(value.delta) }),
+        ...(publicUsage(value.usage) === undefined ? {} : { usage: publicUsage(value.usage) }),
+    };
+}
+function publicContent(value) {
+    if (!isRecord(value) || typeof value.type !== "string")
+        return undefined;
+    if (value.type === "reasoning" || value.type === "non_standard")
+        return undefined;
+    return eventFields(value, [
+        "type",
+        "id",
+        "file_id",
+        "url",
+        "base64",
+        "mime_type",
+        "index",
+        "text",
+        "name",
+        "args",
+        "call_id",
+    ]);
+}
+function publicDelta(value) {
+    if (!isRecord(value) || typeof value.type !== "string")
+        return undefined;
+    if (value.type === "reasoning-delta")
+        return undefined;
+    return eventFields(value, ["type", "text", "data", "encoding"]);
+}
+function publicUsage(value) {
+    if (!isRecord(value))
+        return undefined;
+    return eventFields(value, ["input_tokens", "output_tokens", "total_tokens"]);
+}
+function eventFields(value, names) {
+    if (!isRecord(value))
+        return {};
+    return Object.fromEntries(names.flatMap((name) => (value[name] === undefined ? [] : [[name, value[name]]])));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-native-public.js.map

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

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

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

@@ -0,0 +1,5 @@
+/** Coordinates native state and tool projection for public execution sinks without exposing undeclared private state. This companion preserves the native input and output types without starting runtime work. */
+import type { AgentExecutionEvent } from "@relkit/agents/internal/runtime-events";
+/** Agent and parent context attached to a public native event. */
+export type NativeExecutionContext = Pick<AgentExecutionEvent, "agent" | "parent">;
+//# sourceMappingURL=runtime-native-public.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-public.types.d.ts","sourceRoot":"","sources":["../src/runtime-native-public.types.ts"],"names":[],"mappings":"AAAA,mNAAmN;AAEnN,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC"}

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

@@ -0,0 +1,3 @@
+/** Coordinates native state and tool projection for public execution sinks without exposing undeclared private state. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=runtime-native-public.types.js.map

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

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

package/dist/runtime-native-response-format.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a validated RELKIT output schema to the native structured response
+ * strategy, preserving schema failures and disabling native silent recovery.
+ */
+import { type StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+import type { NativeModel } from "./runtime-loop.types.js";
+/** Creates the native structured output strategy.
+ * @param schema - Authored output validator.
+ * @param model - Resolved model; explicit OpenAI Responses clients use native JSON schema.
+ * @returns An Effect with a strategy or AgentInvocationFailure.
+ * @example Effect.runSync(responseFormatEffect(output));
+ */
+export declare const responseFormatEffect: (schema: StandardSchemaV1<unknown, unknown>, model?: NativeModel | undefined) => Effect.Effect<import("langchain").ProviderStrategy<Record<string, unknown>> | import("langchain").TypedToolStrategy<Record<string, unknown>>, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+//# sourceMappingURL=runtime-native-response-format.d.ts.map

package/dist/runtime-native-response-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-response-format.d.ts","sourceRoot":"","sources":["../src/runtime-native-response-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,mSAoChC,CAAC"}

package/dist/runtime-native-response-format.js

@@ -0,0 +1,46 @@
+/**
+ * Converts a validated RELKIT output schema to the native structured response
+ * strategy, preserving schema failures and disabling native silent recovery.
+ */
+import { getJsonSchema } from "@relkit/schema";
+import { providerStrategy, toolStrategy } 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";
+import { strictResponseSchema } from "./runtime-strict-response-schema.js";
+/** Creates the native structured output strategy.
+ * @param schema - Authored output validator.
+ * @param model - Resolved model; explicit OpenAI Responses clients use native JSON schema.
+ * @returns An Effect with a strategy or AgentInvocationFailure.
+ * @example Effect.runSync(responseFormatEffect(output));
+ */
+export const responseFormatEffect = Effect.fn("Agents.runtime.responseFormat")((schema, model) => Effect.try({
+    try: () => {
+        const projection = getJsonSchema(schema);
+        if (!projection.ok) {
+            throw new AgentRuntimeError("RELKIT_SCHEMA_UNAVAILABLE", "Agent output schema is unavailable");
+        }
+        const wrapped = {
+            title: "relkit_output",
+            type: "object",
+            properties: { value: projection.schema },
+            required: ["value"],
+            additionalProperties: false,
+        };
+        // Responses clients can drop string tool_choice; use their native schema channel.
+        if (typeof model === "object" &&
+            model !== null &&
+            "useResponsesApi" in model &&
+            model.useResponsesApi === true) {
+            const strictSchema = strictResponseSchema(wrapped);
+            return providerStrategy({
+                schema: { ...(strictSchema ?? wrapped), type: "object" },
+                strict: strictSchema !== undefined,
+            });
+        }
+        return toolStrategy(wrapped, { handleError: false });
+    },
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.response-format", effect));
+//# sourceMappingURL=runtime-native-response-format.js.map

package/dist/runtime-native-response-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-response-format.js","sourceRoot":"","sources":["../src/runtime-native-response-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAyB,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,EAAE,CAAC,+BAA+B,CAAC,CAC5E,CAAC,MAAwB,EAAE,KAAmB,EAAE,EAAE,CAChD,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE;QACR,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,iBAAiB,CACzB,2BAA2B,EAC3B,oCAAoC,CACrC,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE;YACxC,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,oBAAoB,EAAE,KAAK;SAC5B,CAAC;QACF,kFAAkF;QAClF,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,iBAAiB,IAAI,KAAK;YAC1B,KAAK,CAAC,eAAe,KAAK,IAAI,EAC9B,CAAC;YACD,MAAM,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACnD,OAAO,gBAAgB,CAAC;gBACtB,MAAM,EAAE,EAAE,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxD,MAAM,EAAE,YAAY,KAAK,SAAS;aACnC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,YAAY,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,EAAE,sBAAsB;CAC9B,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAC5D,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Builds native child configurations and nested runnables after model, tools and
+ * persistence have been resolved by the existing ordered subagent traversal.
+ */
+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 type { NativeTools } from "./runtime-native-tools.js";
+import type { responseFormatEffect } from "./runtime-native-response-format.js";
+import type { AgentInvocationFailure } from "./runtime-effect-error.js";
+import type { NativeNestedSubagent } from "./runtime-native-subagents.types.js";
+/** Projects an already resolved child's native runnable configuration.
+ * @param child - Validated native descriptor.
+ * @param model - Resolved or inherited native model.
+ * @param instructions - Validated native instructions.
+ * @param format - Selected native structured output strategy.
+ * @param childTools - Validated native tool mappings.
+ * @param limitMiddleware - Shared per-invocation limits.
+ * @returns The same native child configuration.
+ */
+export declare function childAgentCommon(child: AgentDescriptor<string, unknown, unknown>, model: string | LanguageModelLike, instructions: string, format: Effect.Success<ReturnType<typeof responseFormatEffect>>, childTools: NativeTools, limitMiddleware: AnyAgentMiddleware): {
+    name: string;
+    model: string | LanguageModelLike;
+    systemPrompt: string;
+    tools: (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>)[];
+    middleware: AnyAgentMiddleware[];
+    responseFormat: import("langchain").ProviderStrategy<Record<string, unknown>> | import("langchain").TypedToolStrategy<Record<string, unknown>>;
+};
+/** Constructs one nested runnable with the existing native exception boundary.
+ * @param child - Validated nested descriptor.
+ * @param common - Already resolved native configuration.
+ * @param persistence - Child-owned checkpoint/store handles.
+ * @param nested - Ordered native nested children.
+ * @param backend - Resolved child or inherited backend.
+ * @param deepagents - Selected native DeepAgents module.
+ * @returns The nested runnable declaration or the original tagged failure.
+ */
+export declare const nestedChildAgentEffect: (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[]>, common: {
+    name: string;
+    model: string | LanguageModelLike;
+    systemPrompt: string;
+    tools: (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>)[];
+    middleware: AnyAgentMiddleware[];
+    responseFormat: import("langchain").ProviderStrategy<Record<string, unknown>> | import("langchain").TypedToolStrategy<Record<string, unknown>>;
+}, persistence: import("./graph-persistence.types.js").ResolvedGraphPersistence, nested: unknown[], backend: unknown, deepagents: typeof import("deepagents")) => Effect.Effect<NativeNestedSubagent, AgentInvocationFailure, never>;
+//# sourceMappingURL=runtime-native-subagents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-subagents.d.ts","sourceRoot":"","sources":["../src/runtime-native-subagents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,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;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAGhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAChD,KAAK,EAAE,MAAM,GAAG,iBAAiB,EACjC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,EAC/D,UAAU,EAAE,WAAW,EACvB,eAAe,EAAE,kBAAkB;;;;;;;EAapC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;;oOAyBlC,CAAC"}

package/dist/runtime-native-subagents.js

@@ -0,0 +1,50 @@
+import { Effect } from "effect";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+/** Projects an already resolved child's native runnable configuration.
+ * @param child - Validated native descriptor.
+ * @param model - Resolved or inherited native model.
+ * @param instructions - Validated native instructions.
+ * @param format - Selected native structured output strategy.
+ * @param childTools - Validated native tool mappings.
+ * @param limitMiddleware - Shared per-invocation limits.
+ * @returns The same native child configuration.
+ */
+export function childAgentCommon(child, model, instructions, format, childTools, limitMiddleware) {
+    return {
+        name: child.id,
+        model,
+        systemPrompt: instructions,
+        tools: [...childTools.values],
+        middleware: [
+            ...child.middleware,
+            limitMiddleware,
+        ],
+        responseFormat: format,
+    };
+}
+/** Constructs one nested runnable with the existing native exception boundary.
+ * @param child - Validated nested descriptor.
+ * @param common - Already resolved native configuration.
+ * @param persistence - Child-owned checkpoint/store handles.
+ * @param nested - Ordered native nested children.
+ * @param backend - Resolved child or inherited backend.
+ * @param deepagents - Selected native DeepAgents module.
+ * @returns The nested runnable declaration or the original tagged failure.
+ */
+export const nestedChildAgentEffect = Effect.fn("Agents.runtime.nestedChild")((child, common, persistence, nested, backend, deepagents) => Effect.try({
+    try: () => ({
+        name: child.id,
+        description: child.description ?? child.title ?? child.id,
+        runnable: deepagents.createDeepAgent({
+            ...common,
+            ...persistence,
+            subagents: nested,
+            ...(child.skills === undefined ? {} : { skills: [...child.skills] }),
+            ...(child.memory === undefined ? {} : { memory: [...child.memory] }),
+            ...(backend === undefined ? {} : { backend }),
+            ...(child.interruptOn === undefined ? {} : { interruptOn: child.interruptOn }),
+        }),
+    }),
+    catch: agentInvocationFailure,
+}));
+//# sourceMappingURL=runtime-native-subagents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-subagents.js","sourceRoot":"","sources":["../src/runtime-native-subagents.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAInE;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgD,EAChD,KAAiC,EACjC,YAAoB,EACpB,MAA+D,EAC/D,UAAuB,EACvB,eAAmC;IAEnC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,EAAE;QACd,KAAK;QACL,YAAY,EAAE,YAAY;QAC1B,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;QAC7B,UAAU,EAAE;YACV,GAAI,KAAK,CAAC,UAAuD;YACjE,eAAe;SAChB;QACD,cAAc,EAAE,MAAM;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAC3E,CACE,KAAgD,EAChD,MAA2C,EAC3C,WAA6E,EAC7E,MAAiB,EACjB,OAAgB,EAChB,UAAuC,EACsB,EAAE,CAC/D,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACV,IAAI,EAAE,KAAK,CAAC,EAAE;QACd,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE;QACzD,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC;YACnC,GAAG,MAAM;YACT,GAAG,WAAW;YACd,SAAS,EAAE,MAAM;YACjB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7C,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;SACtE,CAAC;KACZ,CAAC;IACF,KAAK,EAAE,sBAAsB;CAC9B,CAAC,CACL,CAAC"}

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

@@ -0,0 +1,7 @@
+/** Native nested subagent declaration consumed by DeepAgents construction. */
+export interface NativeNestedSubagent {
+    readonly name: string;
+    readonly description: string;
+    readonly runnable: ReturnType<typeof import("deepagents").createDeepAgent>;
+}
+//# sourceMappingURL=runtime-native-subagents.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-subagents.types.d.ts","sourceRoot":"","sources":["../src/runtime-native-subagents.types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,cAAc,YAAY,EAAE,eAAe,CAAC,CAAC;CAC5E"}

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

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

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

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

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

@@ -0,0 +1,67 @@
+/** Resolves native execution support, including optional DeepAgents loading, preserving initialization and nested dependency errors as invocation causes. */
+import { Context, Effect, Layer } from "effect";
+import type { AgentDescriptor } from "./define-agent.js";
+import type { NativeTools } from "./runtime-native-tools.js";
+import type { DeepAgentsLoaderService } from "./runtime-native-support.types.js";
+export type { DeepAgentsLoaderService } from "./runtime-native-support.types.js";
+declare const DeepAgentsLoader_base: Context.ServiceClass<DeepAgentsLoader, "relkit/agents/DeepAgentsLoader", DeepAgentsLoaderService>;
+/** Substitutable loader for the optional DeepAgents dependency.
+ * @example Effect.provide(loadDeepAgentsEffect(), DeepAgentsLoaderLive);
+ */
+export declare class DeepAgentsLoader extends DeepAgentsLoader_base {
+}
+/** Live dynamic import of the optional DeepAgents dependency.
+ * @example Effect.runPromise(Effect.provide(loadDeepAgentsEffect(), DeepAgentsLoaderLive));
+ */
+export declare const DeepAgentsLoaderLive: Layer.Layer<DeepAgentsLoader, never, never>;
+/** Combines public IDs and failures from native tool groups.
+ * @param groups - Root and subagent tool groups.
+ * @returns An Effect with combined tools or AgentInvocationFailure.
+ * @example Effect.runSync(combineNativeToolsEffect(groups));
+ */
+export declare const combineNativeToolsEffect: (groups: readonly NativeTools[]) => Effect.Effect<NativeTools, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Combines tool groups for existing synchronous callers.
+ * @param groups - Root and subagent tool groups.
+ * @returns Combined tool names and failure reader.
+ * @throws The original invalid group error.
+ * @example combineNativeTools(groups);
+ */
+export declare function combineNativeTools(groups: readonly NativeTools[]): NativeTools;
+/** Projects authored instructions to native system prompt text.
+ * @param agent - Authored agent descriptor.
+ * @returns An Effect with prompt text or AgentInvocationFailure.
+ * @example Effect.runSync(nativeInstructionsEffect(agent));
+ */
+export declare const nativeInstructionsEffect: (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<string, import("./runtime-effect-error.js").AgentInvocationFailure, never>;
+/** Projects native instructions for existing synchronous callers.
+ * @param agent - Authored agent descriptor.
+ * @returns Native system prompt text.
+ * @throws The original invalid instructions error.
+ * @example nativeInstructions(agent);
+ */
+export declare function nativeInstructions(agent: AgentDescriptor<string, unknown, unknown>): string;
+/** Loads the optional DeepAgents module through a replaceable service.
+ * @returns An Effect with DeepAgents or AgentInvocationFailure.
+ * @example await Effect.runPromise(Effect.provide(loadDeepAgentsEffect(), DeepAgentsLoaderLive));
+ */
+export declare const loadDeepAgentsEffect: () => Effect.Effect<typeof import("deepagents"), import("./runtime-effect-error.js").AgentInvocationFailure, DeepAgentsLoader>;
+/** Loads DeepAgents for existing Promise callers.
+ * @returns The optional DeepAgents module.
+ * @throws AgentRuntimeError when the module is unavailable.
+ * @example await loadDeepAgents();
+ */
+export declare function loadDeepAgents(): Promise<typeof import("deepagents")>;
+/** Verifies optional runtime dependencies for authored agents.
+ * @param agents - Root and subagent descriptors.
+ * @returns An Effect with void or AgentInvocationFailure.
+ * @example await Effect.runPromise(Effect.provide(assertAgentRuntimeDependenciesEffect(agents), DeepAgentsLoaderLive));
+ */
+export declare const assertAgentRuntimeDependenciesEffect: (agents: 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[]>[]) => Effect.Effect<void, import("./runtime-effect-error.js").AgentInvocationFailure, DeepAgentsLoader>;
+/** Verifies optional runtime dependencies for existing Promise callers.
+ * @param agents - Root and subagent descriptors.
+ * @returns A Promise that resolves when dependencies are available.
+ * @throws AgentRuntimeError for an unavailable dependency.
+ * @example await assertAgentRuntimeDependencies(agents);
+ */
+export declare function assertAgentRuntimeDependencies(agents: readonly AgentDescriptor<string, unknown, unknown>[]): Promise<void>;
+//# sourceMappingURL=runtime-native-support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-support.d.ts","sourceRoot":"","sources":["../src/runtime-native-support.ts"],"names":[],"mappings":"AAAA,6JAA6J;AAE7J,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,YAAY,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;;AAEjF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,qBAErC;CAAG;AAEJ;;GAEG;AACH,eAAO,MAAM,oBAAoB,6CAKhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,mIAqBpC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAM9E;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8YAYpC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,CAM3F;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,gIAShC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,cAAc,YAAY,CAAC,CAAC,CAOrE;AAED;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,maAKhD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/runtime-native-support.js

@@ -0,0 +1,112 @@
+/** Resolves native execution support, including optional DeepAgents loading, preserving initialization and nested dependency errors as invocation causes. */
+import { Context, Effect, Layer } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { hasDeepAgentCapabilities } from "./define-agent-deep.js";
+import { agentInvocationFailure } from "./runtime-effect-error.js";
+/** Substitutable loader for the optional DeepAgents dependency.
+ * @example Effect.provide(loadDeepAgentsEffect(), DeepAgentsLoaderLive);
+ */
+export class DeepAgentsLoader extends Context.Service()("relkit/agents/DeepAgentsLoader") {
+}
+/** Live dynamic import of the optional DeepAgents dependency.
+ * @example Effect.runPromise(Effect.provide(loadDeepAgentsEffect(), DeepAgentsLoaderLive));
+ */
+export const DeepAgentsLoaderLive = Layer.succeed(DeepAgentsLoader, DeepAgentsLoader.of({
+    load: () => import("deepagents"),
+}));
+/** Combines public IDs and failures from native tool groups.
+ * @param groups - Root and subagent tool groups.
+ * @returns An Effect with combined tools or AgentInvocationFailure.
+ * @example Effect.runSync(combineNativeToolsEffect(groups));
+ */
+export const combineNativeToolsEffect = Effect.fn("Agents.runtime.combineNativeTools")((groups) => Effect.try({
+    try: () => {
+        const publicIds = new Map();
+        const relkitNames = new Set();
+        for (const group of groups) {
+            for (const [name, id] of group.publicIds)
+                publicIds.set(name, id);
+            for (const name of group.relkitNames)
+                relkitNames.add(name);
+        }
+        return {
+            values: groups[0].values,
+            publicIds,
+            relkitNames,
+            failure: () => groups.map((group) => group.failure()).find((failure) => failure !== undefined),
+        };
+    },
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.combine-native-tools", effect));
+/** Combines tool groups for existing synchronous callers.
+ * @param groups - Root and subagent tool groups.
+ * @returns Combined tool names and failure reader.
+ * @throws The original invalid group error.
+ * @example combineNativeTools(groups);
+ */
+export function combineNativeTools(groups) {
+    return Effect.runSync(combineNativeToolsEffect(groups).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Projects authored instructions to native system prompt text.
+ * @param agent - Authored agent descriptor.
+ * @returns An Effect with prompt text or AgentInvocationFailure.
+ * @example Effect.runSync(nativeInstructionsEffect(agent));
+ */
+export const nativeInstructionsEffect = Effect.fn("Agents.runtime.nativeInstructions")((agent) => Effect.try({
+    try: () => {
+        const value = agent.instructions;
+        if (typeof value === "string")
+            return value;
+        if ("template" in value)
+            return value.template;
+        return typeof value.value === "string" ? value.value : value.value.join("\n\n");
+    },
+    catch: agentInvocationFailure,
+}), (effect) => observeAgent("runtime.native-instructions", effect));
+/** Projects native instructions for existing synchronous callers.
+ * @param agent - Authored agent descriptor.
+ * @returns Native system prompt text.
+ * @throws The original invalid instructions error.
+ * @example nativeInstructions(agent);
+ */
+export function nativeInstructions(agent) {
+    return Effect.runSync(nativeInstructionsEffect(agent).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Loads the optional DeepAgents module through a replaceable service.
+ * @returns An Effect with DeepAgents or AgentInvocationFailure.
+ * @example await Effect.runPromise(Effect.provide(loadDeepAgentsEffect(), DeepAgentsLoaderLive));
+ */
+export const loadDeepAgentsEffect = Effect.fn("Agents.runtime.loadDeepAgents")(function* () {
+    const loader = yield* DeepAgentsLoader;
+    return yield* Effect.tryPromise({
+        try: () => loader.load(),
+        catch: agentInvocationFailure,
+    });
+}, (effect) => observeAgent("runtime.load-deepagents", effect));
+/** Loads DeepAgents for existing Promise callers.
+ * @returns The optional DeepAgents module.
+ * @throws AgentRuntimeError when the module is unavailable.
+ * @example await loadDeepAgents();
+ */
+export function loadDeepAgents() {
+    return Effect.runPromise(loadDeepAgentsEffect().pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(DeepAgentsLoaderLive)));
+}
+/** Verifies optional runtime dependencies for authored agents.
+ * @param agents - Root and subagent descriptors.
+ * @returns An Effect with void or AgentInvocationFailure.
+ * @example await Effect.runPromise(Effect.provide(assertAgentRuntimeDependenciesEffect(agents), DeepAgentsLoaderLive));
+ */
+export const assertAgentRuntimeDependenciesEffect = Effect.fn("Agents.runtime.assertDependencies")(function* (agents) {
+    if (agents.some(hasDeepAgentCapabilities))
+        yield* loadDeepAgentsEffect();
+}, (effect) => observeAgent("runtime.assert-dependencies", effect));
+/** Verifies optional runtime dependencies for existing Promise callers.
+ * @param agents - Root and subagent descriptors.
+ * @returns A Promise that resolves when dependencies are available.
+ * @throws AgentRuntimeError for an unavailable dependency.
+ * @example await assertAgentRuntimeDependencies(agents);
+ */
+export function assertAgentRuntimeDependencies(agents) {
+    return Effect.runPromise(assertAgentRuntimeDependenciesEffect(agents).pipe(Effect.catchTag("AgentInvocationFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(DeepAgentsLoaderLive)));
+}
+//# sourceMappingURL=runtime-native-support.js.map

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

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

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

@@ -0,0 +1,9 @@
+/** Replaceable loader for the optional DeepAgents runtime dependency. */
+export interface DeepAgentsLoaderService {
+    /** Loads the optional runtime module.
+     * @returns The DeepAgents module.
+     * @example await loader.load();
+     */
+    readonly load: () => Promise<typeof import("deepagents")>;
+}
+//# sourceMappingURL=runtime-native-support.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-native-support.types.d.ts","sourceRoot":"","sources":["../src/runtime-native-support.types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,YAAY,CAAC,CAAC,CAAC;CAC3D"}

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

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

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

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