@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/testing/agent-state-setup.js

@@ -0,0 +1,52 @@
+/** Acquires one native test model and its trace, approval and cancellation state. */
+import { Effect, Ref } from "effect";
+import { SpanRuntime, spanSnapshot } from "@relkit/invocation";
+import { createIdSource, createFailures } from "@relkit/testing/internal/jobs-utils";
+import { createAgentApprovalState } from "./agent-approvals.js";
+import { createTestModel } from "./agents-model.js";
+import { captureHooks, createTrace } from "./agents-utils.js";
+export const acquireAgentHarness = Effect.fn("Testing.agent.acquire")(function* (options) {
+    const failures = options.failures ?? createFailures();
+    const model = yield* acquireTestModel(options);
+    const state = Ref.makeUnsafe({
+        closed: false,
+        invocationSequence: 0,
+        spans: [],
+        edges: [],
+        active: new Set(),
+        pending: new Set(),
+    });
+    const { spans, edges } = Ref.getUnsafe(state);
+    const approvals = createAgentApprovalState(options.approval);
+    const trace = createTrace(spans, edges);
+    const hooks = captureHooks(options.hooks, edges);
+    const spanRuntime = createSpanRuntime(spans);
+    const engine = {
+        invoke: async (request) => {
+            const result = await options.engine.invoke(request);
+            failures.check("model.after-tool-call");
+            return result;
+        },
+    };
+    return { failures, model, state, approvals, trace, hooks, spanRuntime, engine };
+});
+function acquireTestModel(options) {
+    return Effect.acquireRelease(Effect.sync(() => createTestModel({
+        ...(options.model ?? {}),
+        ...(options.logger === undefined || options.model?.logger !== undefined
+            ? {}
+            : { logger: options.logger }),
+        ...(options.script === undefined ? {} : { script: options.script }),
+    })), (model) => Effect.promise(() => model.close()));
+}
+function createSpanRuntime(spans) {
+    return new SpanRuntime({
+        ids: createIdSource(),
+        observer: (event) => {
+            if (event.span.name !== "relkit.testing.agent" && event.type !== "updated") {
+                spans.push(spanSnapshot(event));
+            }
+        },
+    });
+}
+//# sourceMappingURL=agent-state-setup.js.map

package/dist/testing/agent-state-setup.js.map

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

package/dist/testing/agent-state.d.ts

@@ -0,0 +1,12 @@
+/** Builds an isolated native test facade whose work is joined before release. */
+import { Effect } from "effect";
+import type { TestAgent, TestAgentDescriptor, TestAgentOptions } from "./agents-types.js";
+/** Creates a network-free test owner retaining descriptor schema inference.
+ * @param options - Native dependencies, scripts and capture policy.
+ * @returns The owned facade and cancellation-aware Effect release boundary.
+ */
+export declare function createAgentState<Agent extends TestAgentDescriptor>(options: TestAgentOptions<Agent>): Effect.Effect<{
+    value: TestAgent<Agent>;
+    close: Effect.Effect<void, unknown, never>;
+}, never, import("effect/Scope").Scope>;
+//# sourceMappingURL=agent-state.d.ts.map

package/dist/testing/agent-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.d.ts","sourceRoot":"","sources":["../../src/testing/agent-state.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,MAAM,EAAO,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1F;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,mBAAmB,EAChE,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC;;;wCA4BjC"}

package/dist/testing/agent-state.js

@@ -0,0 +1,40 @@
+/** Builds an isolated native test facade whose work is joined before release. */
+import { Effect, Ref } from "effect";
+import { runOwnedContext } from "@relkit/testing/internal/work-ownership";
+import { acquireAgentHarness } from "./agent-state-setup.js";
+import { invokeAgentHarness } from "./agent-state-invocation.js";
+import { agentHarnessClose, resetAgentHarness } from "./agent-state-lifecycle.js";
+/** Creates a network-free test owner retaining descriptor schema inference.
+ * @param options - Native dependencies, scripts and capture policy.
+ * @returns The owned facade and cancellation-aware Effect release boundary.
+ */
+export function createAgentState(options) {
+    return Effect.gen(function* () {
+        const context = yield* Effect.context();
+        const harness = yield* acquireAgentHarness(options);
+        const { model, failures, approvals, trace, state } = harness;
+        const invoke = (input, invocation) => {
+            const current = Ref.getUnsafe(state);
+            if (current.closed)
+                return Promise.reject(new Error("Test agent is closed"));
+            const pending = invokeAgentHarness(options, harness, input, invocation);
+            current.pending.add(pending);
+            void pending.finally(() => current.pending.delete(pending)).catch(() => undefined);
+            return pending;
+        };
+        const close = agentHarnessClose(context, harness);
+        const value = Object.freeze({
+            model,
+            failures,
+            approvals,
+            pending: approvals.pending,
+            trace,
+            script: model.script,
+            invoke,
+            close: () => runOwnedContext(context, close),
+            reset: () => resetAgentHarness(harness),
+        });
+        return { value, close };
+    });
+}
+//# sourceMappingURL=agent-state.js.map

package/dist/testing/agent-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.js","sourceRoot":"","sources":["../../src/testing/agent-state.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAElF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgC;IAEhC,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAS,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC7D,MAAM,MAAM,GAA+B,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;YAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,OAAO,CAAC,MAAM;gBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;YAC7E,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACxE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7B,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACnF,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAqB,MAAM,CAAC,MAAM,CAAC;YAC5C,KAAK;YACL,QAAQ;YACR,SAAS;YACT,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,KAAK;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM;YACN,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC;YAC5C,KAAK,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC;SACxC,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/testing/agents-model-native.d.ts

@@ -0,0 +1,37 @@
+/** Implements the scripted native chat-model adapter used by agent tests, preserving tool-call correlation and queued response ordering. */
+import type { CallbackManagerForLLMRun } from "@langchain/core/callbacks/manager";
+import { BaseChatModel, type BindToolsInput } from "@langchain/core/language_models/chat_models";
+import { type BaseMessage } from "@langchain/core/messages";
+import type { ChatResult } from "@langchain/core/outputs";
+import type { TestAgentModelCall, TestModelTurn } from "./agents-types.js";
+/** Native LangChain model transport; script and cancellation remain owned by TestModelScript. */
+export declare class ScriptedChatModel extends BaseChatModel {
+    private readonly turn;
+    private readonly provider;
+    private readonly modelId;
+    private boundTools;
+    /**
+     * Connects native generation to the acquired script service.
+     * @param turn Owner script workflow consuming the native AbortSignal.
+     * @param provider Native test provider identity.
+     * @param modelId Native test model identity.
+     */
+    constructor(turn: (request: TestAgentModelCall["request"], signal?: AbortSignal) => Promise<TestModelTurn>, provider: string, modelId: string);
+    /** @returns The native provider/model identity used by LangChain. */
+    _llmType(): string;
+    /**
+     * Records native presented tools for script-to-tool name matching.
+     * @param tools Model-presented tool declarations.
+     * @returns This native model, preserving LangChain binding behavior.
+     */
+    bindTools(tools: BindToolsInput[]): this;
+    /**
+     * Consumes one owned scripted turn using the native invocation signal.
+     * @param messages Native LangChain messages projected for assertions.
+     * @param _options Native generation options, including cancellation.
+     * @param _runManager Native callback manager retained by the base-model signature.
+     * @returns The original native tool-call/final-output ChatResult representation.
+     */
+    _generate(messages: BaseMessage[], _options?: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
+}
+//# sourceMappingURL=agents-model-native.d.ts.map

package/dist/testing/agents-model-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-model-native.d.ts","sourceRoot":"","sources":["../../src/testing/agents-model-native.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAE5I,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EACL,aAAa,EAEb,KAAK,cAAc,EACpB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE3E,iGAAiG;AACjG,qBAAa,iBAAkB,SAAQ,aAAa;IAUhD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAIrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAd1B,OAAO,CAAC,UAAU,CAAiC;IAEnD;;;;;OAKG;gBAEgB,IAAI,EAAE,CACrB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACtC,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,aAAa,CAAC,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;IAKlC,qEAAqE;IACrE,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACM,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAKjD;;;;;;OAMG;IACY,SAAS,CACtB,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,EACpC,WAAW,CAAC,EAAE,wBAAwB,GACrC,OAAO,CAAC,UAAU,CAAC;CA8BvB"}

package/dist/testing/agents-model-native.js

@@ -0,0 +1,111 @@
+/** Implements the scripted native chat-model adapter used by agent tests, preserving tool-call correlation and queued response ordering. */
+import { BaseChatModel, } from "@langchain/core/language_models/chat_models";
+import { AIMessage } from "@langchain/core/messages";
+/** Native LangChain model transport; script and cancellation remain owned by TestModelScript. */
+export class ScriptedChatModel extends BaseChatModel {
+    turn;
+    provider;
+    modelId;
+    boundTools = [];
+    /**
+     * Connects native generation to the acquired script service.
+     * @param turn Owner script workflow consuming the native AbortSignal.
+     * @param provider Native test provider identity.
+     * @param modelId Native test model identity.
+     */
+    constructor(turn, provider, modelId) {
+        super({});
+        this.turn = turn;
+        this.provider = provider;
+        this.modelId = modelId;
+    }
+    /** @returns The native provider/model identity used by LangChain. */
+    _llmType() {
+        return `${this.provider}:${this.modelId}`;
+    }
+    /**
+     * Records native presented tools for script-to-tool name matching.
+     * @param tools Model-presented tool declarations.
+     * @returns This native model, preserving LangChain binding behavior.
+     */
+    bindTools(tools) {
+        this.boundTools = [...tools];
+        return this;
+    }
+    /**
+     * Consumes one owned scripted turn using the native invocation signal.
+     * @param messages Native LangChain messages projected for assertions.
+     * @param _options Native generation options, including cancellation.
+     * @param _runManager Native callback manager retained by the base-model signature.
+     * @returns The original native tool-call/final-output ChatResult representation.
+     */
+    async _generate(messages, _options, _runManager) {
+        const turn = await this.turn({
+            messages: messages.map(snapshotMessage),
+            tools: this.boundTools.map(snapshotTool),
+        }, _options?.signal);
+        if (turn.type === "error" || turn.type === "cancelled") {
+            throw new Error(turn.type === "error" ? turn.message : (turn.reason ?? "cancelled"));
+        }
+        const toolCall = turn.type === "tool-call"
+            ? {
+                name: presentedToolName(turn.toolId, this.boundTools),
+                args: turn.input,
+                id: turn.callId,
+                type: "tool_call",
+            }
+            : {
+                name: "relkit_output",
+                args: { value: turn.output },
+                id: "relkit-test-output",
+                type: "tool_call",
+            };
+        return {
+            generations: [{ text: "", message: new AIMessage({ content: "", tool_calls: [toolCall] }) }],
+            llmOutput: {},
+        };
+    }
+}
+/**
+ * Projects the native message role and content for deterministic call assertions.
+ * @param message - Native language-model message.
+ * @returns The same visible message fields without exposing model internals.
+ */
+function snapshotMessage(message) {
+    return { role: message.getType(), content: contentValue(message.content) };
+}
+/**
+ * Decodes JSON text when valid while retaining native non-JSON content.
+ * @param value - Candidate native value checked or detached by this helper.
+ * @returns The existing JSON value or original content.
+ */
+function contentValue(value) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * Projects only the native tool name used by model call assertions.
+ * @param value - Candidate native value checked or detached by this helper.
+ * @returns A bounded tool name snapshot.
+ */
+function snapshotTool(value) {
+    return { name: "name" in value ? value.name : undefined };
+}
+/**
+ * Selects the native presented tool name corresponding to a declared tool ID.
+ * @param id - Declared resource or tool identity.
+ * @param tools - Native model-presented tool declarations.
+ * @returns The registered model name or the original tool ID.
+ */
+function presentedToolName(id, tools) {
+    const prefix = id.replaceAll(".", "_");
+    const tool = tools.find((entry) => "name" in entry && (entry.name === prefix || entry.name.startsWith(`${prefix}_`)));
+    return tool && "name" in tool ? tool.name : id;
+}
+//# sourceMappingURL=agents-model-native.js.map

package/dist/testing/agents-model-native.js.map

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

package/dist/testing/agents-model-operations.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Applies scripted native turns under the test model owner's cancellation state.
+ * Reset, replacement and detached evidence retain their existing ordering.
+ */
+import { Effect, Ref } from "effect";
+import type { ModelScriptOwnedState } from "./agents-model.types.js";
+import type { TestAgentModelCall, TestAgentModelOptions, TestModelTurn } from "./agents-types.js";
+/** Cancels active requests and clears this model's script position/evidence.
+ * @param state - This model's state.
+ * @returns An observed reset Effect.
+ */
+export declare function modelScriptResetEffect(state: Ref.Ref<ModelScriptOwnedState>): Effect.Effect<void, never, never>;
+/** Replaces scripted decisions after resetting active work.
+ * @param state - Owner state.
+ * @param reset - Existing model reset operation.
+ * @param turns - Detached replacement turns.
+ * @returns The existing checked script replacement Effect.
+ */
+export declare function modelScriptReplaceEffect(state: Ref.Ref<ModelScriptOwnedState>, reset: Effect.Effect<void>, turns: readonly TestModelTurn[]): Effect.Effect<undefined, TypeError, never>;
+/** Executes a turn through the original observed native cancellation boundary.
+ * @param state - Owner state.
+ * @param options - Native test model policy.
+ * @param request - Detached request evidence.
+ * @param signal - Optional caller cancellation.
+ * @returns The scripted decision or original failure.
+ */
+export declare function modelScriptTurnEffect(state: Ref.Ref<ModelScriptOwnedState>, options: TestAgentModelOptions, request: TestAgentModelCall["request"], signal?: AbortSignal): Effect.Effect<TestModelTurn, unknown, never>;
+//# sourceMappingURL=agents-model-operations.d.ts.map

package/dist/testing/agents-model-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-model-operations.d.ts","sourceRoot":"","sources":["../../src/testing/agents-model-operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElG;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,qCAY3E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,EACrC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAC1B,KAAK,EAAE,SAAS,aAAa,EAAE,8CAYhC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,EACrC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACtC,MAAM,CAAC,EAAE,WAAW,gDAYrB"}

package/dist/testing/agents-model-operations.js

@@ -0,0 +1,91 @@
+/**
+ * Applies scripted native turns under the test model owner's cancellation state.
+ * Reset, replacement and detached evidence retain their existing ordering.
+ */
+import { Effect, Ref } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { combineSignals } from "@relkit/testing/internal/runtime-clock";
+/** Cancels active requests and clears this model's script position/evidence.
+ * @param state - This model's state.
+ * @returns An observed reset Effect.
+ */
+export function modelScriptResetEffect(state) {
+    return observeExecution("testing", "model.reset", Effect.sync(() => {
+        const value = Ref.getUnsafe(state);
+        for (const controller of value.active)
+            controller.abort(new Error("Test model reset"));
+        value.active.clear();
+        value.next = 0;
+        value.calls.length = 0;
+    }));
+}
+/** Replaces scripted decisions after resetting active work.
+ * @param state - Owner state.
+ * @param reset - Existing model reset operation.
+ * @param turns - Detached replacement turns.
+ * @returns The existing checked script replacement Effect.
+ */
+export function modelScriptReplaceEffect(state, reset, turns) {
+    return observeExecution("testing", "model.script", Effect.gen(function* () {
+        if (!Array.isArray(turns))
+            return yield* Effect.fail(new TypeError("Test model script must be an array"));
+        yield* reset;
+        Ref.getUnsafe(state).turns = Object.freeze(structuredClone(turns));
+    }));
+}
+/** Executes a turn through the original observed native cancellation boundary.
+ * @param state - Owner state.
+ * @param options - Native test model policy.
+ * @param request - Detached request evidence.
+ * @param signal - Optional caller cancellation.
+ * @returns The scripted decision or original failure.
+ */
+export function modelScriptTurnEffect(state, options, request, signal) {
+    return observeExecution("testing", "model.turn", Effect.fn("Testing.model.turn")(() => Effect.tryPromise({
+        try: (fiberSignal) => runModelScriptTurn(state, options, request, signal, fiberSignal),
+        catch: (cause) => cause,
+    }))());
+}
+/** Settles one native turn and removes only listeners/controllers it acquired.
+ * @param state - Owner state.
+ * @param options - Hanging/script policy.
+ * @param request - Request evidence.
+ * @param signal - Optional caller signal.
+ * @param fiberSignal - Owning Effect cancellation.
+ * @returns Detached scripted turn after cancellation-aware work.
+ */
+async function runModelScriptTurn(state, options, request, signal, fiberSignal) {
+    const value = Ref.getUnsafe(state);
+    const controller = new AbortController();
+    value.active.add(controller);
+    const signals = combineSignals(signal, fiberSignal, controller.signal);
+    let abort;
+    try {
+        if (signals.signal.aborted)
+            throw signals.signal.reason ?? new Error("Test model cancelled");
+        if (options.hang === true)
+            return await new Promise((_resolve, reject) => {
+                abort = () => reject(signals.signal.reason ?? new Error("Test model cancelled"));
+                signals.signal.addEventListener("abort", abort, { once: true });
+                if (signals.signal.aborted)
+                    abort();
+            });
+        const turn = value.turns[value.next++];
+        if (turn === undefined)
+            throw new Error("Test model script exhausted");
+        const snapshot = structuredClone({ request, turn });
+        value.calls.push(Object.freeze({
+            index: value.calls.length,
+            request: Object.freeze(snapshot.request),
+            turn: snapshot.turn,
+        }));
+        return structuredClone(turn);
+    }
+    finally {
+        if (abort !== undefined)
+            signals.signal.removeEventListener("abort", abort);
+        signals.dispose();
+        value.active.delete(controller);
+    }
+}
+//# sourceMappingURL=agents-model-operations.js.map

package/dist/testing/agents-model-operations.js.map

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

package/dist/testing/agents-model.d.ts

@@ -0,0 +1,25 @@
+/** Constructs deterministic native test models from scripted steps and exposes their observed calls for invocation assertions. */
+import { Context, Layer } from "effect";
+import type { ModelScriptService, RuntimeTestAgentModel } from "./agents-model.types.js";
+import type { TestAgentModelOptions, TestModelTurn } from "./agents-types.js";
+/**
+ * Creates an isolated scripted native language model without network access.
+ * @param options - Explicit configuration and native dependencies for this test owner.
+ * @returns A synchronous model facade owning script state and cancellation-aware turns.
+ * @see tests/fixtures/checked-examples.ts ownedHelpersExample for checked script ownership.
+ */
+export declare function createTestModel(options?: TestAgentModelOptions & {
+    readonly script?: readonly TestModelTurn[];
+}): RuntimeTestAgentModel;
+declare const TestModelScript_base: Context.ServiceClass<TestModelScript, "relkit/testing/ModelScript", ModelScriptService>;
+/** Stateful scripted turns and cancellation belong to one model owner. */
+export declare class TestModelScript extends TestModelScript_base {
+}
+/**
+ * Builds a network-free script service with cooperative native cancellation.
+ * @param options Model policy and initial scripted turns.
+ * @returns A synchronously ready replaceable service Layer.
+ */
+export declare function modelScriptLayer(options?: TestAgentModelOptions): Layer.Layer<TestModelScript, never, never>;
+export {};
+//# sourceMappingURL=agents-model.d.ts.map

package/dist/testing/agents-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-model.d.ts","sourceRoot":"","sources":["../../src/testing/agents-model.ts"],"names":[],"mappings":"AAAA,kIAAkI;AASlI,OAAO,EAAE,OAAO,EAAU,KAAK,EAAuB,MAAM,QAAQ,CAAC;AAQrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEzF,OAAO,KAAK,EAAsB,qBAAqB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElG;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CAAO,GACnF,qBAAqB,CAiCvB;;AAED,0EAA0E;AAC1E,qBAAa,eAAgB,SAAQ,oBAEpC;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,qBAA0B,8CAQnE"}

package/dist/testing/agents-model.js

@@ -0,0 +1,72 @@
+/** Constructs deterministic native test models from scripted steps and exposes their observed calls for invocation assertions. */
+import { modelScriptResetEffect, modelScriptTurnEffect, modelScriptReplaceEffect, } from "./agents-model-operations.js";
+import { ScriptedChatModel } from "./agents-model-native.js";
+import { combineSignals } from "@relkit/testing/internal/runtime-clock";
+import { Context, Effect, Layer, ManagedRuntime, Ref } from "effect";
+import { observeExecution, runExecutionPromise, runExecutionSync, } from "@relkit/contracts/operation";
+import { disposeTestingOwner, testingLoggerLayer } from "@relkit/testing/internal/testing-owner";
+/**
+ * Creates an isolated scripted native language model without network access.
+ * @param options - Explicit configuration and native dependencies for this test owner.
+ * @returns A synchronous model facade owning script state and cancellation-aware turns.
+ * @see tests/fixtures/checked-examples.ts ownedHelpersExample for checked script ownership.
+ */
+export function createTestModel(options = {}) {
+    const owner = ManagedRuntime.make(modelScriptLayer(options).pipe(Layer.provideMerge(testingLoggerLayer(options.logger))));
+    try {
+        const service = runExecutionSync(owner, TestModelScript);
+        const provider = options.provider ?? "test";
+        const modelId = options.modelId ?? "default";
+        const languageModel = new ScriptedChatModel((request, signal) => runExecutionPromise(owner, service.turn(request, signal)), provider, modelId);
+        const script = (value) => runExecutionSync(owner, service.script(value));
+        const reset = () => runExecutionSync(owner, service.reset);
+        let closing;
+        script(options.script ?? []);
+        return Object.freeze({
+            provider,
+            modelId,
+            languageModel,
+            script,
+            reset,
+            close: () => (closing ??= disposeTestingOwner(owner)),
+            get calls() {
+                return runExecutionSync(owner, service.calls);
+            },
+        });
+    }
+    catch (error) {
+        void disposeTestingOwner(owner).catch(() => undefined);
+        throw error;
+    }
+}
+/** Stateful scripted turns and cancellation belong to one model owner. */
+export class TestModelScript extends Context.Service()("relkit/testing/ModelScript") {
+}
+/**
+ * Builds a network-free script service with cooperative native cancellation.
+ * @param options Model policy and initial scripted turns.
+ * @returns A synchronously ready replaceable service Layer.
+ */
+export function modelScriptLayer(options = {}) {
+    return Layer.effect(TestModelScript, Effect.acquireRelease(Effect.sync(() => makeModelScriptService(options)), (service) => service.reset));
+}
+/** Constructs one isolated script service after its owning Layer is acquired.
+ * @param options - Native model policy.
+ * @returns Script operations sharing one state and reset authority.
+ */
+function makeModelScriptService(options) {
+    const state = Ref.makeUnsafe({
+        turns: [],
+        next: 0,
+        calls: [],
+        active: new Set(),
+    });
+    const reset = modelScriptResetEffect(state);
+    return TestModelScript.of({
+        turn: (request, signal) => modelScriptTurnEffect(state, options, request, signal),
+        script: (turns) => modelScriptReplaceEffect(state, reset, turns),
+        reset,
+        calls: Effect.sync(() => Object.freeze(structuredClone(Ref.getUnsafe(state).calls))),
+    });
+}
+//# sourceMappingURL=agents-model.js.map

package/dist/testing/agents-model.js.map

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

package/dist/testing/agents-model.types.d.ts

@@ -0,0 +1,24 @@
+/** Constructs deterministic native test models from scripted steps and exposes their observed calls for invocation assertions. This companion preserves the native input and output types without starting runtime work. */
+import type { Effect } from "effect";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { TestAgentModel } from "./agents-types.js";
+import type { TestAgentModelCall, TestModelTurn } from "./agents-types.js";
+/** Effect script state, detached call capture and cancellable native turn decisions. */
+export interface ModelScriptService {
+    readonly turn: (request: TestAgentModelCall["request"], signal?: AbortSignal) => Effect.Effect<TestModelTurn, unknown>;
+    readonly script: (turns: readonly TestModelTurn[]) => Effect.Effect<void, unknown>;
+    readonly reset: Effect.Effect<void>;
+    readonly calls: Effect.Effect<readonly TestAgentModelCall[]>;
+}
+/** Native LangChain-compatible scripted model with owned release. */
+export interface RuntimeTestAgentModel extends TestAgentModel {
+    readonly languageModel: BaseChatModel;
+}
+/** Script index, detached evidence and cancellation owners for one model. */
+export interface ModelScriptOwnedState {
+    turns: readonly TestModelTurn[];
+    next: number;
+    readonly calls: TestAgentModelCall[];
+    readonly active: Set<AbortController>;
+}
+//# sourceMappingURL=agents-model.types.d.ts.map

package/dist/testing/agents-model.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-model.types.d.ts","sourceRoot":"","sources":["../../src/testing/agents-model.types.ts"],"names":[],"mappings":"AAAA,4NAA4N;AAE5N,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE3E,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,CACb,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACtC,MAAM,CAAC,EAAE,WAAW,KACjB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;CAC9D;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;CACvC"}

package/dist/testing/agents-model.types.js

@@ -0,0 +1,3 @@
+/** Constructs deterministic native test models from scripted steps and exposes their observed calls for invocation assertions. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=agents-model.types.js.map

package/dist/testing/agents-model.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-model.types.js","sourceRoot":"","sources":["../../src/testing/agents-model.types.ts"],"names":[],"mappings":"AAAA,4NAA4N"}

package/dist/testing/agents-types.d.ts

@@ -0,0 +1,3 @@
+/** Preserved compatibility entrypoint for the canonical domain type companion. */
+export type * from "./agents.types.js";
+//# sourceMappingURL=agents-types.d.ts.map

package/dist/testing/agents-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-types.d.ts","sourceRoot":"","sources":["../../src/testing/agents-types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,mBAAmB,mBAAmB,CAAC"}

package/dist/testing/agents-types.js

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

package/dist/testing/agents-types.js.map

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

package/dist/testing/agents-utils.d.ts

@@ -0,0 +1,26 @@
+/** Normalizes scripted native test values and observations for the agent harness without starting a separate execution owner. */
+import type { AgentObservedEdge, AgentRuntimeHooks } from "../index.js";
+import type { spanSnapshot } from "@relkit/invocation";
+import type { TestAgentTrace, TestAgentTraceExpectation, TestAgentTraceSnapshot } from "./agents-types.js";
+/**
+ * Asserts selected native agent trace fields in their observed order.
+ * @param trace - Captured native trace assertion snapshot.
+ * @param expected - Existing expected status or ordered captured values.
+ * @returns Nothing when the existing assertion contract matches.
+ */
+export declare function assertAgentTrace(trace: TestAgentTraceSnapshot, expected: TestAgentTraceExpectation): void;
+/**
+ * Creates isolated trace capture and the existing assertion facade.
+ * @param spans - Owner-local native span snapshots.
+ * @param edges - Compiled native graph relationships or captured agent relationship ledger.
+ * @returns A native trace helper exposing detached inspection and clear operations.
+ */
+export declare function createTrace(spans: ReturnType<typeof spanSnapshot>[], edges: AgentObservedEdge[]): TestAgentTrace;
+/**
+ * Records observed agent edges while forwarding the caller's native hooks.
+ * @param hooks - Caller-native hooks forwarded without changing ordering.
+ * @param edges - Compiled native graph relationships or captured agent relationship ledger.
+ * @returns Hooks preserving native callback order and caller behavior.
+ */
+export declare function captureHooks(hooks: AgentRuntimeHooks | undefined, edges: AgentObservedEdge[]): AgentRuntimeHooks;
+//# sourceMappingURL=agents-utils.d.ts.map

package/dist/testing/agents-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-utils.d.ts","sourceRoot":"","sources":["../../src/testing/agents-utils.ts"],"names":[],"mappings":"AAAA,iIAAiI;AAEjI,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CA4BN;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,EACxC,KAAK,EAAE,iBAAiB,EAAE,GACzB,cAAc,CAgBhB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,GAAG,SAAS,EACpC,KAAK,EAAE,iBAAiB,EAAE,GACzB,iBAAiB,CAQnB"}