import { AgentContract } from "../contracts/agent/agent.contract.mjs";
import { ToolContract } from "../tool/tool.mjs";
import { MockModelResponse } from "./mock-config.type.mjs";

//#region ../ai/src/mock/mock-agent.d.ts
/**
 * Test helper that wires `MockSDK` → mock model → `agent()` in one call.
 *
 * Replaces the 4-line ritual specs typically write:
 * ```ts
 * const mock = MockSDK({ responses: [...] });
 * const myAgent = agent({ name: "x", model: mock.model({ name: "m" }) });
 * ```
 *
 * Defaults to a single empty `"stop"` response — enough to exercise an
 * agent that doesn't need a scripted reply (composition wiring,
 * anonymous-name tests, etc.). Pass `responses` to script outputs.
 *
 * `name` is optional — when omitted the resulting agent runs through
 * the normal anonymous-name fingerprint
 * (`anon_<provider>_<model>[_<tool1>+<tool2>...]`), which is the
 * default for `agent({ model })`.
 *
 * @example
 * const a = mockAgent({ name: "writer", responses: [{ content: "hi", finishReason: "stop" }] });
 * const result = await a.execute("anything");
 */
declare function mockAgent<TOutput = unknown>(options?: {
  name?: string;
  responses?: MockModelResponse[];
  tools?: ToolContract<unknown, unknown>[];
  /**
   * Override the model name reported by the mock model. Defaults to
   * `"mock-model"` (the MockSDK default). Useful when a test needs
   * deterministic provider/model fingerprinting.
   */
  modelName?: string;
}): AgentContract<TOutput>;
//#endregion
export { mockAgent };
//# sourceMappingURL=mock-agent.d.mts.map