@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/define-agent-build.d.ts

@@ -0,0 +1,12 @@
+/** Assembles validated native agent configuration into a RELKIT descriptor, preserving native model, tools and execution metadata for runtime selection. */
+import type { InferInput, InferOutput, StandardSchemaV1 } from "@relkit/schema";
+import { type AgentMiddleware, type AgentTool } from "./define-agent-native.js";
+import type { AgentDescriptor, DefineAgentOptions } from "./define-agent.types.js";
+/** Validates agent options and returns an assembler for a resolved identity.
+ * @param options - Validated authoring options.
+ * @returns A function that assembles a frozen descriptor from its identity.
+ * @throws Validation errors from fields and client policy.
+ * @example prepareAgentDescriptor(options)("support");
+ */
+export declare function prepareAgentDescriptor<const Id extends string, const InputSchema extends StandardSchemaV1, const OutputSchema extends StandardSchemaV1, const Middleware extends readonly AgentMiddleware[], const Tools extends readonly AgentTool[]>(options: DefineAgentOptions<Id, InputSchema, OutputSchema, Middleware, Tools>): (id: Id) => AgentDescriptor<Id, InferInput<InputSchema>, InferOutput<OutputSchema>, InputSchema, OutputSchema, Middleware, Tools>;
+//# sourceMappingURL=define-agent-build.d.ts.map

package/dist/define-agent-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-build.d.ts","sourceRoot":"","sources":["../src/define-agent-build.ts"],"names":[],"mappings":"AAAA,4JAA4J;AAG5J,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAShF,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,SAAS,EACf,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,SAAS,MAAM,EACvB,KAAK,CAAC,WAAW,SAAS,gBAAgB,EAC1C,KAAK,CAAC,YAAY,SAAS,gBAAgB,EAC3C,KAAK,CAAC,UAAU,SAAS,SAAS,eAAe,EAAE,EACnD,KAAK,CAAC,KAAK,SAAS,SAAS,SAAS,EAAE,EAExC,OAAO,EAAE,kBAAkB,CAAC,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,CAAC,GAC5E,CACD,EAAE,EAAE,EAAE,KACH,eAAe,CAClB,EAAE,EACF,UAAU,CAAC,WAAW,CAAC,EACvB,WAAW,CAAC,YAAY,CAAC,EACzB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,KAAK,CACN,CA4CA"}

package/dist/define-agent-build.js

@@ -0,0 +1,60 @@
+/** Assembles validated native agent configuration into a RELKIT descriptor, preserving native model, tools and execution metadata for runtime selection. */
+import { createDescriptorBase, normalizeId } from "@relkit/contracts";
+import { copyAgentInstructions } from "@relkit/agents/internal/define-agent-support";
+import { agentClientContractMetadata } from "./client-contract-metadata.js";
+import { assertAgentSchema } from "@relkit/agents/internal/agent-validation";
+import { copyAgentChat, copyAgentClientPolicy, copyAgentControls, } from "@relkit/agents/internal/agent-client";
+import { copyAgentMiddleware, copyAgentTools, middlewareStateKeys, } from "./define-agent-native.js";
+import { normalizeAgentModel } from "./define-agent-validation.js";
+import { copyDeepAgentCapabilities } from "./define-agent-deep.js";
+import { copyAgentLimits } from "@relkit/agents/internal/define-agent-limits";
+/** Validates agent options and returns an assembler for a resolved identity.
+ * @param options - Validated authoring options.
+ * @returns A function that assembles a frozen descriptor from its identity.
+ * @throws Validation errors from fields and client policy.
+ * @example prepareAgentDescriptor(options)("support");
+ */
+export function prepareAgentDescriptor(options) {
+    assertAgentSchema(options.input, "input");
+    assertAgentSchema(options.output, "output");
+    const model = normalizeAgentModel(options.model);
+    const instructions = copyAgentInstructions(options.instructions);
+    const tools = copyAgentTools(options.tools);
+    const middleware = copyAgentMiddleware(options.middleware);
+    const limits = copyAgentLimits(options.limits);
+    const client = copyAgentClientPolicy(options.client, middlewareStateKeys(middleware));
+    const controls = copyAgentControls(options.controls);
+    const chat = copyAgentChat(options.chat);
+    const deep = copyDeepAgentCapabilities(options);
+    if (client !== undefined && options.stateProfile === undefined) {
+        throw new TypeError("Client-exposed agents require stateProfile");
+    }
+    const stateProfile = options.stateProfile === undefined ? undefined : normalizeId(options.stateProfile);
+    return (id) => {
+        const base = createDescriptorBase("agent", id, options);
+        const clientContract = agentClientContractMetadata({
+            id,
+            tools: options.tools,
+            middleware,
+            ...(client === undefined ? {} : { client }),
+            ...deep,
+        });
+        return Object.freeze({
+            ...base,
+            input: options.input,
+            output: options.output,
+            ...(model === undefined ? {} : { model }),
+            instructions,
+            tools,
+            middleware,
+            limits,
+            ...(stateProfile === undefined ? {} : { stateProfile }),
+            ...(client === undefined ? {} : { client }),
+            ...(chat === undefined ? {} : { chat }),
+            ...(controls === undefined ? {} : { controls }),
+            clientContract,
+            ...deep,
+        });
+    };
+}
+//# sourceMappingURL=define-agent-build.js.map

package/dist/define-agent-build.js.map

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

package/dist/define-agent-deep.d.ts

@@ -0,0 +1,30 @@
+/** Normalizes optional DeepAgents authoring fields without loading the DeepAgents runtime; the same defined-field selection controls the graph marker. */
+import { Effect } from "effect";
+import type { DeepAgentCapabilities } from "./define-agent-deep.types.js";
+export type * from "./define-agent-deep.types.js";
+/** Validates and freezes native DeepAgents options.
+ * @param value - Optional subagents, paths, backend, persistence, and HITL controls.
+ * @returns An Effect with copied capabilities or AgentDefinitionFailure.
+ * @example Effect.runSync(copyDeepAgentCapabilitiesEffect({ skills: ["/skills"] }));
+ */
+export declare const copyDeepAgentCapabilitiesEffect: (value: DeepAgentCapabilities) => Effect.Effect<DeepAgentCapabilities, import("@relkit/agents/internal/define-agent-error").AgentDefinitionFailure, never>;
+/** Copies DeepAgents options for existing synchronous authoring callers.
+ * @param value - Optional subagents, paths, backend, persistence, and HITL controls.
+ * @returns Immutable capabilities.
+ * @throws The original invalid capability error.
+ * @example const options = copyDeepAgentCapabilities({ skills: ["/skills"] });
+ */
+export declare function copyDeepAgentCapabilities(value: DeepAgentCapabilities): DeepAgentCapabilities;
+/** Checks whether a descriptor enables native DeepAgents capabilities.
+ * @param value - Capabilities to inspect.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(hasDeepAgentCapabilitiesEffect({ skills: ["/skills"] }));
+ */
+export declare const hasDeepAgentCapabilitiesEffect: (value: DeepAgentCapabilities) => Effect.Effect<boolean, never, never>;
+/** Checks capabilities for existing synchronous authoring callers.
+ * @param value - Capabilities to inspect.
+ * @returns Whether native DeepAgents behavior is requested.
+ * @example if (hasDeepAgentCapabilities(options)) enableDeep();
+ */
+export declare function hasDeepAgentCapabilities(value: DeepAgentCapabilities): boolean;
+//# sourceMappingURL=define-agent-deep.d.ts.map

package/dist/define-agent-deep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-deep.d.ts","sourceRoot":"","sources":["../src/define-agent-deep.ts"],"names":[],"mappings":"AAAA,0JAA0J;AAG1J,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEzF,mBAAmB,8BAA8B,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,4JAO3C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB,CAM7F;AA6BD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,wEAG1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAE9E"}

package/dist/define-agent-deep.js

@@ -0,0 +1,125 @@
+/** Normalizes optional DeepAgents authoring fields without loading the DeepAgents runtime; the same defined-field selection controls the graph marker. */
+import { isAgentDescriptor } from "./define-agent-validation.js";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentDefinitionFailure } from "@relkit/agents/internal/define-agent-error";
+/** Validates and freezes native DeepAgents options.
+ * @param value - Optional subagents, paths, backend, persistence, and HITL controls.
+ * @returns An Effect with copied capabilities or AgentDefinitionFailure.
+ * @example Effect.runSync(copyDeepAgentCapabilitiesEffect({ skills: ["/skills"] }));
+ */
+export const copyDeepAgentCapabilitiesEffect = Effect.fn("Agents.definition.copyDeep")((value) => Effect.try({
+    try: () => copyDeepAgentCapabilitiesValue(value),
+    catch: agentDefinitionFailure,
+}), (effect) => observeAgent("definition.copy-deep", effect));
+/** Copies DeepAgents options for existing synchronous authoring callers.
+ * @param value - Optional subagents, paths, backend, persistence, and HITL controls.
+ * @returns Immutable capabilities.
+ * @throws The original invalid capability error.
+ * @example const options = copyDeepAgentCapabilities({ skills: ["/skills"] });
+ */
+export function copyDeepAgentCapabilities(value) {
+    return Effect.runSync(copyDeepAgentCapabilitiesEffect(value).pipe(Effect.catchTag("AgentDefinitionFailure", (failure) => Effect.fail(failure.cause))));
+}
+function copyDeepAgentCapabilitiesValue(value) {
+    const subagents = copySubagents(value.subagents);
+    const skills = copyPaths(value.skills, "skills");
+    const memory = copyPaths(value.memory, "memory");
+    const backend = value.backend;
+    if (backend !== undefined &&
+        (typeof backend !== "object" || backend === null) &&
+        typeof backend !== "function") {
+        throw new TypeError("Agent backend must be a native DeepAgents backend");
+    }
+    const interruptOn = copyInterruptOn(value.interruptOn);
+    if (interruptOn !== undefined && value.checkpointer === undefined) {
+        throw new TypeError("Agent interruptOn requires a checkpointer");
+    }
+    return Object.freeze({
+        ...(subagents === undefined ? {} : { subagents }),
+        ...(skills === undefined ? {} : { skills }),
+        ...(memory === undefined ? {} : { memory }),
+        ...(backend === undefined ? {} : { backend }),
+        ...(value.checkpointer === undefined ? {} : { checkpointer: value.checkpointer }),
+        ...(value.store === undefined ? {} : { store: value.store }),
+        ...(interruptOn === undefined ? {} : { interruptOn }),
+    });
+}
+/** Checks whether a descriptor enables native DeepAgents capabilities.
+ * @param value - Capabilities to inspect.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(hasDeepAgentCapabilitiesEffect({ skills: ["/skills"] }));
+ */
+export const hasDeepAgentCapabilitiesEffect = Effect.fn("Agents.definition.hasDeep")((value) => Effect.sync(() => hasDeepAgentCapabilitiesValue(value)), (effect) => observeAgent("definition.has-deep", effect));
+/** Checks capabilities for existing synchronous authoring callers.
+ * @param value - Capabilities to inspect.
+ * @returns Whether native DeepAgents behavior is requested.
+ * @example if (hasDeepAgentCapabilities(options)) enableDeep();
+ */
+export function hasDeepAgentCapabilities(value) {
+    return Effect.runSync(hasDeepAgentCapabilitiesEffect(value));
+}
+function hasDeepAgentCapabilitiesValue(value) {
+    return (value.subagents !== undefined ||
+        value.skills !== undefined ||
+        value.memory !== undefined ||
+        value.backend !== undefined ||
+        value.interruptOn !== undefined);
+}
+function copyInterruptOn(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new TypeError("Agent interruptOn must be an object");
+    }
+    return Object.freeze(Object.fromEntries(Object.entries(value).map(([tool, config]) => {
+        if (tool.trim() === "")
+            throw new TypeError("Agent interruptOn tool names cannot be empty");
+        if (typeof config === "boolean")
+            return [tool, config];
+        if (typeof config !== "object" || config === null || Array.isArray(config)) {
+            throw new TypeError(`Agent interruptOn.${tool} must be boolean or an object`);
+        }
+        const allowed = config.allowedDecisions;
+        if (!Array.isArray(allowed) || allowed.length === 0) {
+            throw new TypeError(`Agent interruptOn.${tool}.allowedDecisions cannot be empty`);
+        }
+        if (allowed.some((decision) => !["approve", "edit", "reject"].includes(decision)) ||
+            new Set(allowed).size !== allowed.length) {
+            throw new TypeError(`Agent interruptOn.${tool}.allowedDecisions is invalid`);
+        }
+        return [tool, Object.freeze({ ...config, allowedDecisions: Object.freeze([...allowed]) })];
+    })));
+}
+function copySubagents(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value))
+        throw new TypeError("Agent subagents must be an array");
+    const ids = new Set();
+    for (const [index, subagent] of value.entries()) {
+        if (!isAgentDescriptor(subagent)) {
+            throw new TypeError(`Agent subagent at index ${index} must be an agent descriptor`);
+        }
+        if (ids.has(subagent.id))
+            throw new TypeError(`Duplicate agent subagent "${subagent.id}"`);
+        ids.add(subagent.id);
+    }
+    return Object.freeze([...value]);
+}
+function copyPaths(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value))
+        throw new TypeError(`Agent ${name} must be an array`);
+    const paths = value.map((entry) => {
+        if (typeof entry !== "string" || entry.trim() === "") {
+            throw new TypeError(`Agent ${name} paths must be non-empty text`);
+        }
+        return entry;
+    });
+    if (new Set(paths).size !== paths.length)
+        throw new TypeError(`Agent ${name} paths must be unique`);
+    return Object.freeze(paths);
+}
+//# sourceMappingURL=define-agent-deep.js.map

package/dist/define-agent-deep.js.map

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

package/dist/define-agent-deep.types.d.ts

@@ -0,0 +1,23 @@
+/** Normalizes optional DeepAgents authoring fields without loading the DeepAgents runtime; the same defined-field selection controls the graph marker. This companion preserves the native input and output types without starting runtime work. */
+import type { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph";
+import type { InterruptOnConfig } from "langchain";
+import type { CheckpointerResource, MemoryResource } from "./define-persistence.js";
+import type { AgentDescriptor } from "./define-agent.js";
+/** Agent descriptor nested under a DeepAgent. */
+export type AgentSubagent = AgentDescriptor<string, unknown, unknown>;
+/** DeepAgents filesystem backend or a state-bound backend factory. */
+export type AgentFilesystemBackend = object | ((context: {
+    readonly state: unknown;
+    readonly store?: unknown;
+}) => object);
+/** Optional capabilities enabled for a DeepAgent. */
+export interface DeepAgentCapabilities {
+    readonly subagents?: readonly AgentSubagent[];
+    readonly skills?: readonly string[];
+    readonly memory?: readonly string[];
+    readonly backend?: AgentFilesystemBackend;
+    readonly checkpointer?: BaseCheckpointSaver | CheckpointerResource;
+    readonly store?: BaseStore | MemoryResource;
+    readonly interruptOn?: Readonly<Record<string, boolean | InterruptOnConfig>>;
+}
+//# sourceMappingURL=define-agent-deep.types.d.ts.map

package/dist/define-agent-deep.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-deep.types.d.ts","sourceRoot":"","sources":["../src/define-agent-deep.types.ts"],"names":[],"mappings":"AAAA,oPAAoP;AAEpP,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEtE,sEAAsE;AACtE,MAAM,MAAM,sBAAsB,GAChC,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,MAAM,CAAC,CAAC;AAExF,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC;CAC9E"}

package/dist/define-agent-deep.types.js

@@ -0,0 +1,3 @@
+/** Normalizes optional DeepAgents authoring fields without loading the DeepAgents runtime; the same defined-field selection controls the graph marker. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=define-agent-deep.types.js.map

package/dist/define-agent-deep.types.js.map

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

package/dist/define-agent-native-middleware.d.ts

@@ -0,0 +1,34 @@
+/** Validates and retains SDK middleware supplied by native agent authors so runtime construction receives the original middleware objects. */
+import { Effect } from "effect";
+import type { AgentClientStateKey, AgentMiddleware } from "./define-agent-native.types.js";
+/** Validates middleware names and brands, retaining input order.
+ * @param value - Middleware definitions or undefined.
+ * @returns An Effect with a frozen list or AgentDefinitionFailure.
+ * @example Effect.runSync(copyAgentMiddlewareEffect([]));
+ */
+export declare const copyAgentMiddlewareEffect: <Middleware extends readonly AgentMiddleware[]>(value: Middleware | undefined) => Effect.Effect<Middleware, import("@relkit/agents/internal/define-agent-error").AgentDefinitionFailure, never>;
+/** Copies middleware for existing synchronous authoring callers.
+ * @param value - Middleware definitions or undefined.
+ * @returns A frozen middleware list.
+ * @throws The original invalid middleware error.
+ * @example const middleware = copyAgentMiddleware([]);
+ */
+export declare function copyAgentMiddleware<Middleware extends readonly AgentMiddleware[]>(value: Middleware | undefined): Middleware;
+/** Collects public state keys declared by middleware schemas.
+ * @param middleware - Validated middleware list.
+ * @returns An Effect with state keys or AgentDefinitionFailure.
+ * @example Effect.runSync(middlewareStateKeysEffect([]));
+ */
+export declare const middlewareStateKeysEffect: <Middleware extends readonly AgentMiddleware[]>(middleware: Middleware) => Effect.Effect<ReadonlySet<Middleware[number] extends infer T ? T extends Middleware[number] ? T extends AgentMiddleware ? [Exclude<T["stateSchema"], undefined>] extends [never] ? never : unknown extends T["stateSchema"] ? string : Extract<keyof (T extends infer T_1 ? T_1 extends T ? T_1 extends {
+    readonly stateSchema?: infer Schema;
+} ? (Exclude<Schema, undefined> extends infer T_3 ? T_3 extends Exclude<Schema, undefined> ? T_3 extends {
+    readonly _output: infer Output;
+} ? Output : import("langchain").InferSchemaValue<Extract<T_3, import("@langchain/langgraph").StateDefinitionInit>> : never : never) extends infer T_2 ? { [Key in keyof T_2 as Key extends `_${string}` ? never : Key]: T_2[Key]; } : never : {} : never : never), string> : never : never : never>, import("@relkit/agents/internal/define-agent-error").AgentDefinitionFailure, never>;
+/** Collects state keys for existing synchronous authoring callers.
+ * @param middleware - Validated middleware list.
+ * @returns Public middleware state keys.
+ * @throws The original schema access error.
+ * @example const keys = middlewareStateKeys([]);
+ */
+export declare function middlewareStateKeys<Middleware extends readonly AgentMiddleware[]>(middleware: Middleware): ReadonlySet<AgentClientStateKey<Middleware>>;
+//# sourceMappingURL=define-agent-native-middleware.d.ts.map

package/dist/define-agent-native-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-native-middleware.d.ts","sourceRoot":"","sources":["../src/define-agent-native-middleware.ts"],"names":[],"mappings":"AAAA,8IAA8I;AAG9I,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAE3F;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACnC,UAAU,SAAS,SAAS,eAAe,EAAE,iJAoB/C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,SAAS,SAAS,eAAe,EAAE,EAC/E,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,UAAU,CAMZ;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACnC,UAAU,SAAS,SAAS,eAAe,EAAE;;;;yXAiB/C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,SAAS,SAAS,eAAe,EAAE,EAC/E,UAAU,EAAE,UAAU,GACrB,WAAW,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAM9C"}

package/dist/define-agent-native-middleware.js

@@ -0,0 +1,83 @@
+/** Validates and retains SDK middleware supplied by native agent authors so runtime construction receives the original middleware objects. */
+import { MIDDLEWARE_BRAND } from "langchain";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentDefinitionFailure } from "@relkit/agents/internal/define-agent-error";
+/** Validates middleware names and brands, retaining input order.
+ * @param value - Middleware definitions or undefined.
+ * @returns An Effect with a frozen list or AgentDefinitionFailure.
+ * @example Effect.runSync(copyAgentMiddlewareEffect([]));
+ */
+export const copyAgentMiddlewareEffect = Effect.fn("Agents.definition.copyMiddleware")((value) => Effect.try({
+    try: () => {
+        if (value === undefined)
+            return Object.freeze([]);
+        if (!Array.isArray(value))
+            throw new TypeError("Agent middleware must be an array");
+        const names = new Set();
+        for (const [index, middleware] of value.entries()) {
+            if (!isAgentMiddleware(middleware)) {
+                throw new TypeError(`Agent middleware at index ${index} is invalid`);
+            }
+            if (names.has(middleware.name)) {
+                throw new TypeError(`Duplicate agent middleware "${middleware.name}"`);
+            }
+            names.add(middleware.name);
+        }
+        return Object.freeze([...value]);
+    },
+    catch: agentDefinitionFailure,
+}), (effect) => observeAgent("definition.copy-middleware", effect));
+/** Copies middleware for existing synchronous authoring callers.
+ * @param value - Middleware definitions or undefined.
+ * @returns A frozen middleware list.
+ * @throws The original invalid middleware error.
+ * @example const middleware = copyAgentMiddleware([]);
+ */
+export function copyAgentMiddleware(value) {
+    return Effect.runSync(copyAgentMiddlewareEffect(value).pipe(Effect.catchTag("AgentDefinitionFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Collects public state keys declared by middleware schemas.
+ * @param middleware - Validated middleware list.
+ * @returns An Effect with state keys or AgentDefinitionFailure.
+ * @example Effect.runSync(middlewareStateKeysEffect([]));
+ */
+export const middlewareStateKeysEffect = Effect.fn("Agents.definition.stateKeys")((middleware) => Effect.try({
+    try: () => {
+        const keys = new Set();
+        for (const entry of middleware) {
+            const schema = entry.stateSchema;
+            if (!isRecord(schema))
+                continue;
+            const fields = schema.fields;
+            if (isRecord(fields))
+                for (const key of Object.keys(fields))
+                    keys.add(key);
+            const shape = typeof schema.shape === "function" ? schema.shape() : schema.shape;
+            if (isRecord(shape))
+                for (const key of Object.keys(shape))
+                    keys.add(key);
+        }
+        return keys;
+    },
+    catch: agentDefinitionFailure,
+}), (effect) => observeAgent("definition.state-keys", effect));
+/** Collects state keys for existing synchronous authoring callers.
+ * @param middleware - Validated middleware list.
+ * @returns Public middleware state keys.
+ * @throws The original schema access error.
+ * @example const keys = middlewareStateKeys([]);
+ */
+export function middlewareStateKeys(middleware) {
+    return Effect.runSync(middlewareStateKeysEffect(middleware).pipe(Effect.catchTag("AgentDefinitionFailure", (failure) => Effect.fail(failure.cause))));
+}
+function isAgentMiddleware(value) {
+    return (isRecord(value) &&
+        value[MIDDLEWARE_BRAND] === true &&
+        typeof value.name === "string" &&
+        value.name.trim() !== "");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=define-agent-native-middleware.js.map

package/dist/define-agent-native-middleware.js.map

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

package/dist/define-agent-native-model.d.ts

@@ -0,0 +1,16 @@
+/** Accepts native chat-model instances or supported model selectors and preserves the model's inference contract for descriptor construction. */
+import { Effect } from "effect";
+import type { AgentModel } from "./define-agent-native.types.js";
+/** Checks whether a value can select or provide a native agent model.
+ * @param value - Candidate selector, model, or factory.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isAgentModelEffect("openai:gpt"));
+ */
+export declare const isAgentModelEffect: (value: unknown) => Effect.Effect<boolean, never, never>;
+/** Checks a model for existing synchronous authoring callers.
+ * @param value - Candidate selector, model, or factory.
+ * @returns Whether the value is a valid model form.
+ * @example if (isAgentModel(value)) use(value);
+ */
+export declare function isAgentModel(value: unknown): value is AgentModel;
+//# sourceMappingURL=define-agent-native-model.d.ts.map

package/dist/define-agent-native-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-native-model.d.ts","sourceRoot":"","sources":["../src/define-agent-native-model.ts"],"names":[],"mappings":"AAAA,iJAAiJ;AAEjJ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,0DAS9B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}

package/dist/define-agent-native-model.js

@@ -0,0 +1,23 @@
+/** Accepts native chat-model instances or supported model selectors and preserves the model's inference contract for descriptor construction. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+/** Checks whether a value can select or provide a native agent model.
+ * @param value - Candidate selector, model, or factory.
+ * @returns An Effect with a boolean and no typed failure.
+ * @example Effect.runSync(isAgentModelEffect("openai:gpt"));
+ */
+export const isAgentModelEffect = Effect.fn("Agents.definition.isModel")((value) => Effect.sync(() => typeof value === "string" ||
+    typeof value === "function" ||
+    (isRecord(value) && typeof value.invoke === "function")), (effect) => observeAgent("definition.is-model", effect));
+/** Checks a model for existing synchronous authoring callers.
+ * @param value - Candidate selector, model, or factory.
+ * @returns Whether the value is a valid model form.
+ * @example if (isAgentModel(value)) use(value);
+ */
+export function isAgentModel(value) {
+    return Effect.runSync(isAgentModelEffect(value));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=define-agent-native-model.js.map

package/dist/define-agent-native-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-native-model.js","sourceRoot":"","sources":["../src/define-agent-native-model.ts"],"names":[],"mappings":"AAAA,iJAAiJ;AAEjJ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CACtE,CAAC,KAAc,EAAE,EAAE,CACjB,MAAM,CAAC,IAAI,CACT,GAAG,EAAE,CACH,OAAO,KAAK,KAAK,QAAQ;IACzB,OAAO,KAAK,KAAK,UAAU;IAC3B,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAC1D,EACH,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CACxD,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AACnD,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/define-agent-native-tools.d.ts

@@ -0,0 +1,30 @@
+/** Separates native SDK tools from RELKIT callable references while retaining native identity and serializable generic tool references. */
+import { type ToolRefAny } from "@relkit/tools";
+import { Effect } from "effect";
+import type { AgentTool } from "./define-agent-native.types.js";
+/** Validates and freezes RELKIT and native agent tools in input order.
+ * @param value - Tool references and native tools.
+ * @returns An Effect with a frozen list or AgentDefinitionFailure.
+ * @example Effect.runSync(copyAgentToolsEffect([]));
+ */
+export declare const copyAgentToolsEffect: <Tools extends readonly AgentTool[]>(value: Tools) => Effect.Effect<Tools, import("@relkit/agents/internal/define-agent-error").AgentDefinitionFailure, never>;
+/** Copies tools for existing synchronous authoring callers.
+ * @param value - Tool references and native tools.
+ * @returns A frozen tool list.
+ * @throws The original invalid or duplicate tool error.
+ * @example const tools = copyAgentTools([]);
+ */
+export declare function copyAgentTools<Tools extends readonly AgentTool[]>(value: Tools): Tools;
+/** Selects RELKIT tool references from a mixed native tool list.
+ * @param tools - Agent tool list.
+ * @returns An Effect with RELKIT references and no typed failure.
+ * @example Effect.runSync(relkitToolRefsEffect([]));
+ */
+export declare const relkitToolRefsEffect: (tools: readonly AgentTool[]) => Effect.Effect<ToolRefAny[], never, never>;
+/** Selects RELKIT references for existing synchronous authoring callers.
+ * @param tools - Agent tool list.
+ * @returns RELKIT tool references in input order.
+ * @example const refs = relkitToolRefs(tools);
+ */
+export declare function relkitToolRefs(tools: readonly AgentTool[]): readonly ToolRefAny[];
+//# sourceMappingURL=define-agent-native-tools.d.ts.map

package/dist/define-agent-native-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-native-tools.d.ts","sourceRoot":"","sources":["../src/define-agent-native-tools.ts"],"names":[],"mappings":"AAAA,2IAA2I;AAG3I,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,gCAAgC,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC9B,KAAK,SAAS,SAAS,SAAS,EAAE,2HAuBpC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAMtF;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,4EAGhC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,UAAU,EAAE,CAEjF"}

package/dist/define-agent-native-tools.js

@@ -0,0 +1,72 @@
+/** Separates native SDK tools from RELKIT callable references while retaining native identity and serializable generic tool references. */
+import { isLangChainTool } from "@langchain/core/tools";
+import { isToolRef } from "@relkit/tools";
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { agentDefinitionFailure } from "@relkit/agents/internal/define-agent-error";
+/** Validates and freezes RELKIT and native agent tools in input order.
+ * @param value - Tool references and native tools.
+ * @returns An Effect with a frozen list or AgentDefinitionFailure.
+ * @example Effect.runSync(copyAgentToolsEffect([]));
+ */
+export const copyAgentToolsEffect = Effect.fn("Agents.definition.copyTools")((value) => Effect.try({
+    try: () => {
+        if (!Array.isArray(value))
+            throw new TypeError("Agent tools must be an array");
+        const ids = new Set();
+        const tools = value.map((entry, index) => {
+            if (isToolRef(entry)) {
+                const id = entry.ref.id;
+                duplicate(ids, id);
+                return Object.freeze({ ref: Object.freeze({ kind: "tool", id }) });
+            }
+            if (!isNativeAgentTool(entry)) {
+                throw new TypeError(`Agent tool at index ${index} is invalid`);
+            }
+            const name = nativeToolName(entry);
+            if (name !== undefined)
+                duplicate(ids, name);
+            return entry;
+        });
+        return Object.freeze(tools);
+    },
+    catch: agentDefinitionFailure,
+}), (effect) => observeAgent("definition.copy-tools", effect));
+/** Copies tools for existing synchronous authoring callers.
+ * @param value - Tool references and native tools.
+ * @returns A frozen tool list.
+ * @throws The original invalid or duplicate tool error.
+ * @example const tools = copyAgentTools([]);
+ */
+export function copyAgentTools(value) {
+    return Effect.runSync(copyAgentToolsEffect(value).pipe(Effect.catchTag("AgentDefinitionFailure", (failure) => Effect.fail(failure.cause))));
+}
+/** Selects RELKIT tool references from a mixed native tool list.
+ * @param tools - Agent tool list.
+ * @returns An Effect with RELKIT references and no typed failure.
+ * @example Effect.runSync(relkitToolRefsEffect([]));
+ */
+export const relkitToolRefsEffect = Effect.fn("Agents.definition.toolRefs")((tools) => Effect.sync(() => tools.filter(isToolRef)), (effect) => observeAgent("definition.tool-refs", effect));
+/** Selects RELKIT references for existing synchronous authoring callers.
+ * @param tools - Agent tool list.
+ * @returns RELKIT tool references in input order.
+ * @example const refs = relkitToolRefs(tools);
+ */
+export function relkitToolRefs(tools) {
+    return Effect.runSync(relkitToolRefsEffect(tools));
+}
+function isNativeAgentTool(value) {
+    return isLangChainTool(value) || (isRecord(value) && typeof value.type === "string");
+}
+function nativeToolName(value) {
+    return "name" in value && typeof value.name === "string" ? value.name : undefined;
+}
+function duplicate(ids, id) {
+    if (ids.has(id))
+        throw new TypeError(`Duplicate agent tool "${id}"`);
+    ids.add(id);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=define-agent-native-tools.js.map

package/dist/define-agent-native-tools.js.map

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

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

@@ -0,0 +1,6 @@
+/** Builds the native execution payload from model, tool and middleware inputs after validation, without starting model execution during authoring. */
+export type * from "./define-agent-native.types.js";
+export * from "./define-agent-native-model.js";
+export * from "./define-agent-native-middleware.js";
+export * from "./define-agent-native-tools.js";
+//# sourceMappingURL=define-agent-native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-native.d.ts","sourceRoot":"","sources":["../src/define-agent-native.ts"],"names":[],"mappings":"AAAA,sJAAsJ;AAEtJ,mBAAmB,gCAAgC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC"}

package/dist/define-agent-native.js

@@ -0,0 +1,5 @@
+/** Builds the native execution payload from model, tool and middleware inputs after validation, without starting model execution during authoring. */
+export * from "./define-agent-native-model.js";
+export * from "./define-agent-native-middleware.js";
+export * from "./define-agent-native-tools.js";
+//# sourceMappingURL=define-agent-native.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-native.js","sourceRoot":"","sources":["../src/define-agent-native.ts"],"names":[],"mappings":"AAAA,sJAAsJ;AAGtJ,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC"}