llm-mock-server 1.0.0 → 1.0.2

package/dist/logger.d.ts

@@ -0,0 +1,21 @@
+export declare const LEVEL_PRIORITY: {
+    readonly none: 0;
+    readonly error: 1;
+    readonly warning: 2;
+    readonly info: 3;
+    readonly debug: 4;
+    readonly all: 5;
+};
+/** Log verbosity, from `"none"` (silent) through to `"all"` (everything). */
+export type LogLevel = keyof typeof LEVEL_PRIORITY;
+export declare class Logger {
+    readonly level: LogLevel;
+    private threshold;
+    constructor(level?: LogLevel);
+    private log;
+    error(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc;;;;;;;CAOgB,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,cAAc,CAAC;AAkBnD,qBAAa,MAAM;IACjB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,OAAO,CAAC,SAAS,CAAS;gBAEd,KAAK,GAAE,QAAiB;IAKpC,OAAO,CAAC,GAAG;IAQX,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAC3C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAC3C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAC7C"}

package/dist/logger.js

@@ -0,0 +1,42 @@
+import pc from "picocolors";
+export const LEVEL_PRIORITY = {
+    none: 0,
+    error: 1,
+    warning: 2,
+    info: 3,
+    debug: 4,
+    all: 5,
+};
+const LEVEL_STYLE = {
+    error: { label: pc.red(pc.bold("ERROR")), symbol: pc.red("✗") },
+    warn: { label: pc.yellow(pc.bold("WARN")), symbol: pc.yellow("!") },
+    info: { label: pc.cyan("INFO"), symbol: pc.cyan("●") },
+    debug: { label: pc.dim("DEBUG"), symbol: pc.dim("·") },
+};
+const LEVEL_CONFIG = {
+    error: { priority: LEVEL_PRIORITY.error, method: "error" },
+    warn: { priority: LEVEL_PRIORITY.warning, method: "warn" },
+    info: { priority: LEVEL_PRIORITY.info, method: "log" },
+    debug: { priority: LEVEL_PRIORITY.debug, method: "log", dim: true },
+};
+export class Logger {
+    level;
+    threshold;
+    constructor(level = "info") {
+        this.level = level;
+        this.threshold = LEVEL_PRIORITY[level];
+    }
+    log(key, msg, args) {
+        const config = LEVEL_CONFIG[key];
+        if (this.threshold < config.priority)
+            return;
+        const { label, symbol } = LEVEL_STYLE[key];
+        const text = config.dim ? pc.dim(msg) : msg;
+        console[config.method](`${pc.dim(new Date().toISOString())} ${symbol} ${label} ${text}`, ...args);
+    }
+    error(msg, ...args) { this.log("error", msg, args); }
+    warn(msg, ...args) { this.log("warn", msg, args); }
+    info(msg, ...args) { this.log("info", msg, args); }
+    debug(msg, ...args) { this.log("debug", msg, args); }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/mock-server.d.ts

@@ -0,0 +1,102 @@
+import type { Match, PendingRule, Reply, RuleHandle, RuleSummary } from "./types.js";
+import { RequestHistory } from "./history.js";
+import type { LogLevel } from "./logger.js";
+export interface MockServerOptions {
+    readonly port?: number;
+    /** Defaults to `"127.0.0.1"`. Set to `"0.0.0.0"` to listen on all interfaces. */
+    readonly host?: string;
+    /** Defaults to `"none"` (silent). */
+    readonly logLevel?: LogLevel;
+    /** Default ms delay between SSE chunks. Individual rules can override this. */
+    readonly defaultLatency?: number;
+    /** Default characters per SSE text chunk. Individual rules can override this. */
+    readonly defaultChunkSize?: number;
+}
+/**
+ * Mock LLM server that handles OpenAI, Anthropic, and Responses API formats.
+ * Register rules with `when()`, point your SDK at `url`, and go.
+ *
+ * Supports `await using` for automatic cleanup.
+ *
+ * @example
+ * ```ts
+ * const server = new MockServer({ logLevel: "info" });
+ * server.when("hello").reply("Hi there!");
+ * await server.start();
+ * // Point your client at server.url
+ * await server.stop();
+ * ```
+ */
+export declare class MockServer {
+    private readonly app;
+    private readonly engine;
+    private readonly history_;
+    private readonly logger;
+    private readonly host;
+    private readonly defaultOptions;
+    private fallbackReply;
+    private listening;
+    constructor(options?: MockServerOptions);
+    /**
+     * Register a matching rule. Call `.reply()` on the result to set the response.
+     *
+     * @example
+     * ```ts
+     * server.when("hello").reply("Hi!");
+     * server.when(/explain (\w+)/i).reply((req) => `Let me explain ${req.lastMessage}`);
+     * server.when({ model: /claude/ }).reply("I'm Claude.");
+     * ```
+     */
+    when(match: Match): PendingRule;
+    /**
+     * Register a rule that matches when the request includes a tool with this name.
+     *
+     * @example
+     * ```ts
+     * server.whenTool("get_weather").reply({
+     *   tools: [{ name: "get_weather", args: { location: "London" } }],
+     * });
+     * ```
+     */
+    whenTool(toolName: string): PendingRule;
+    /**
+     * Register a rule that matches when the last message is a tool result with this call ID.
+     *
+     * @example
+     * ```ts
+     * server.whenToolResult("call_abc").reply("Got your result, cheers!");
+     * ```
+     */
+    whenToolResult(toolCallId: string): PendingRule;
+    /**
+     * Queue a one-shot error for the very next request, regardless of content.
+     * Fires once then removes itself.
+     *
+     * @example
+     * ```ts
+     * server.nextError(429, "Rate limited");
+     * // next request gets a 429, after that normal matching resumes
+     * ```
+     */
+    nextError(status: number, message: string, type?: string): RuleHandle;
+    /** Set the reply used when no rule matches. Defaults to a generic message. */
+    fallback(reply: Reply): void;
+    /** Load rules from a `.json5` file, a `.ts`/`.js` handler file, or a directory containing them. */
+    load(pathOrDir: string): Promise<void>;
+    /** Every request the server has handled. */
+    get history(): RequestHistory;
+    /** Returns `true` when all rules with a `.times()` limit have been consumed. */
+    isDone(): boolean;
+    /** Clear all rules, request history, and reset the fallback to its default. */
+    reset(): void;
+    /** The base URL the server is listening on, e.g. `http://127.0.0.1:12345`. Throws if the server hasn't started. */
+    get url(): string;
+    get ruleCount(): number;
+    /** A snapshot of all registered rules with their descriptions and remaining match counts. */
+    get rules(): readonly RuleSummary[];
+    /** Start listening. Pass `0` (the default) for a random port. */
+    start(port?: number): Promise<void>;
+    stop(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=mock-server.d.ts.map

package/dist/mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../src/mock-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,KAAK,EAAE,WAAW,EAAE,KAAK,EAAgC,UAAU,EAAE,WAAW,EACjF,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAe;IAC9C,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE,iBAAsB;IAsB3C;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;IAiC/B;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAIvC;;;;;;;OAOG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAI/C;;;;;;;;;OASG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU;IAOrE,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B,mGAAmG;IAC7F,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C,4CAA4C;IAC5C,IAAI,OAAO,IAAI,cAAc,CAE5B;IAED,gFAAgF;IAChF,MAAM,IAAI,OAAO;IAIjB,+EAA+E;IAC/E,KAAK,IAAI,IAAI;IAOb,mHAAmH;IACnH,IAAI,GAAG,IAAI,MAAM,CAKhB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,6FAA6F;IAC7F,IAAI,KAAK,IAAI,SAAS,WAAW,EAAE,CAElC;IAED,iEAAiE;IAC3D,KAAK,CAAC,IAAI,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/mock-server.js

@@ -0,0 +1,195 @@
+import Fastify from "fastify";
+import { RuleEngine, createSequenceResolver } from "./rule-engine.js";
+import { RequestHistory } from "./history.js";
+import { openaiFormat } from "./formats/openai/index.js";
+import { anthropicFormat } from "./formats/anthropic/index.js";
+import { responsesFormat } from "./formats/responses/index.js";
+import { Logger } from "./logger.js";
+import { createRouteHandler } from "./route-handler.js";
+const formats = [openaiFormat, anthropicFormat, responsesFormat];
+/**
+ * Mock LLM server that handles OpenAI, Anthropic, and Responses API formats.
+ * Register rules with `when()`, point your SDK at `url`, and go.
+ *
+ * Supports `await using` for automatic cleanup.
+ *
+ * @example
+ * ```ts
+ * const server = new MockServer({ logLevel: "info" });
+ * server.when("hello").reply("Hi there!");
+ * await server.start();
+ * // Point your client at server.url
+ * await server.stop();
+ * ```
+ */
+export class MockServer {
+    app;
+    engine = new RuleEngine();
+    history_ = new RequestHistory();
+    logger;
+    host;
+    defaultOptions;
+    fallbackReply = "Mock server: no matching rule.";
+    listening = false;
+    constructor(options = {}) {
+        this.host = options.host ?? "127.0.0.1";
+        this.logger = new Logger(options.logLevel ?? "none");
+        this.defaultOptions = {
+            ...(options.defaultLatency !== undefined && { latency: options.defaultLatency }),
+            ...(options.defaultChunkSize !== undefined && { chunkSize: options.defaultChunkSize }),
+        };
+        this.app = Fastify({ logger: false });
+        const deps = {
+            engine: this.engine,
+            history: this.history_,
+            logger: this.logger,
+            defaultOptions: this.defaultOptions,
+            getFallback: () => this.fallbackReply,
+        };
+        for (const format of formats) {
+            this.app.post(format.route, createRouteHandler(format, deps));
+        }
+    }
+    /**
+     * Register a matching rule. Call `.reply()` on the result to set the response.
+     *
+     * @example
+     * ```ts
+     * server.when("hello").reply("Hi!");
+     * server.when(/explain (\w+)/i).reply((req) => `Let me explain ${req.lastMessage}`);
+     * server.when({ model: /claude/ }).reply("I'm Claude.");
+     * ```
+     */
+    when(match) {
+        const engine = this.engine;
+        const makeHandle = (rule) => ({
+            times(n) {
+                rule.remaining = n;
+                return this;
+            },
+            first() {
+                engine.moveToFront(rule);
+                return this;
+            },
+        });
+        return {
+            reply(response, options) {
+                return makeHandle(engine.add(match, response, options));
+            },
+            replySequence(entries) {
+                const steps = entries.map((entry) => typeof entry === "string" || !("reply" in entry)
+                    ? { reply: entry }
+                    : { reply: entry.reply, options: entry.options });
+                const rule = engine.add(match, "");
+                const { resolver, entryCount } = createSequenceResolver(steps, rule);
+                rule.resolve = resolver;
+                rule.remaining = entryCount;
+                return makeHandle(rule);
+            },
+        };
+    }
+    /**
+     * Register a rule that matches when the request includes a tool with this name.
+     *
+     * @example
+     * ```ts
+     * server.whenTool("get_weather").reply({
+     *   tools: [{ name: "get_weather", args: { location: "London" } }],
+     * });
+     * ```
+     */
+    whenTool(toolName) {
+        return this.when({ toolName });
+    }
+    /**
+     * Register a rule that matches when the last message is a tool result with this call ID.
+     *
+     * @example
+     * ```ts
+     * server.whenToolResult("call_abc").reply("Got your result, cheers!");
+     * ```
+     */
+    whenToolResult(toolCallId) {
+        return this.when({ toolCallId });
+    }
+    /**
+     * Queue a one-shot error for the very next request, regardless of content.
+     * Fires once then removes itself.
+     *
+     * @example
+     * ```ts
+     * server.nextError(429, "Rate limited");
+     * // next request gets a 429, after that normal matching resumes
+     * ```
+     */
+    nextError(status, message, type) {
+        return this.when(() => true)
+            .reply({ error: { status, message, type } })
+            .times(1)
+            .first();
+    }
+    /** Set the reply used when no rule matches. Defaults to a generic message. */
+    fallback(reply) {
+        this.fallbackReply = reply;
+    }
+    /** Load rules from a `.json5` file, a `.ts`/`.js` handler file, or a directory containing them. */
+    async load(pathOrDir) {
+        const before = this.engine.ruleCount;
+        const { loadRulesFromPath } = await import("./loader.js");
+        await loadRulesFromPath(pathOrDir, {
+            engine: this.engine,
+            setFallback: (reply) => { this.fallbackReply = reply; },
+        });
+        const loaded = this.engine.ruleCount - before;
+        this.logger.info(`Loaded ${loaded} rule${loaded !== 1 ? "s" : ""} from ${pathOrDir}`);
+    }
+    /** Every request the server has handled. */
+    get history() {
+        return this.history_;
+    }
+    /** Returns `true` when all rules with a `.times()` limit have been consumed. */
+    isDone() {
+        return this.engine.isDone();
+    }
+    /** Clear all rules, request history, and reset the fallback to its default. */
+    reset() {
+        this.engine.clear();
+        this.history_.clear();
+        this.fallbackReply = "Mock server: no matching rule.";
+        this.logger.info("Server reset: rules and history cleared");
+    }
+    /** The base URL the server is listening on, e.g. `http://127.0.0.1:12345`. Throws if the server hasn't started. */
+    get url() {
+        if (!this.listening)
+            throw new Error("Server is not running. Call start() first.");
+        const addr = this.app.server.address();
+        const port = addr !== null && typeof addr === "object" ? addr.port : 0;
+        return `http://${this.host}:${port}`;
+    }
+    get ruleCount() {
+        return this.engine.ruleCount;
+    }
+    /** A snapshot of all registered rules with their descriptions and remaining match counts. */
+    get rules() {
+        return this.engine.describe();
+    }
+    /** Start listening. Pass `0` (the default) for a random port. */
+    async start(port = 0) {
+        if (this.listening)
+            throw new Error("Server is already running.");
+        await this.app.listen({ port, host: this.host });
+        this.listening = true;
+        this.logger.info(`Listening on ${this.url}`);
+    }
+    async stop() {
+        if (!this.listening)
+            return;
+        await this.app.close();
+        this.listening = false;
+        this.logger.info("Server stopped");
+    }
+    async [Symbol.asyncDispose]() {
+        await this.stop();
+    }
+}
+//# sourceMappingURL=mock-server.js.map

package/dist/mock-server.js.map

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

package/dist/route-handler.d.ts

@@ -0,0 +1,16 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { Reply, ReplyOptions } from "./types.js";
+import type { Format } from "./formats/types.js";
+import type { RuleEngine } from "./rule-engine.js";
+import type { RequestHistory } from "./history.js";
+import type { Logger } from "./logger.js";
+interface RouteHandlerDeps {
+    engine: RuleEngine;
+    history: RequestHistory;
+    logger: Logger;
+    defaultOptions: ReplyOptions;
+    getFallback: () => Reply;
+}
+export declare function createRouteHandler(format: Format, deps: RouteHandlerDeps): (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+export {};
+//# sourceMappingURL=route-handler.d.ts.map

package/dist/route-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-handler.d.ts","sourceRoot":"","sources":["../src/route-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE5D,OAAO,KAAK,EAAE,KAAK,EAAe,YAAY,EAAqB,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiC1C,UAAU,gBAAgB;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,YAAY,CAAC;IAC7B,WAAW,EAAE,MAAM,KAAK,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAiE1I"}

package/dist/route-handler.js

@@ -0,0 +1,75 @@
+import { ZodError } from "zod";
+import { writeSSE } from "./sse-writer.js";
+const HTTP_BAD_REQUEST = 400;
+function normalizeReply(reply) {
+    if (typeof reply === "string")
+        return { text: reply };
+    return reply;
+}
+async function resolveReply(matched, mockReq, fallback, logger) {
+    if (!matched) {
+        logger.warn(`No matching rule for "${mockReq.lastMessage}", using fallback`);
+        return { reply: normalizeReply(fallback), ruleDesc: undefined };
+    }
+    try {
+        const raw = typeof matched.resolve === "function"
+            ? await matched.resolve(mockReq)
+            : matched.resolve;
+        logger.debug(`Matched rule ${matched.description}`);
+        return { reply: normalizeReply(raw), ruleDesc: matched.description };
+    }
+    catch (err) {
+        logger.error(`Resolver threw for rule ${matched.description}`, err);
+        return { reply: normalizeReply(fallback), ruleDesc: matched.description };
+    }
+}
+export function createRouteHandler(format, deps) {
+    const { engine, history, logger, defaultOptions, getFallback } = deps;
+    return async (request, reply) => {
+        const body = request.body;
+        const headers = {};
+        for (const [key, val] of Object.entries(request.headers)) {
+            headers[key] = Array.isArray(val) ? val.join(", ") : val;
+        }
+        const meta = { headers, path: request.url };
+        let mockReq;
+        try {
+            mockReq = format.parseRequest(body, meta);
+        }
+        catch (err) {
+            if (err instanceof ZodError) {
+                logger.warn(`Invalid ${format.name} request: ${err.issues.map((i) => i.message).join(", ")}`);
+                return reply.status(HTTP_BAD_REQUEST).type("application/json").send(format.serializeError({ status: HTTP_BAD_REQUEST, message: "Invalid request body", type: "invalid_request_error" }));
+            }
+            throw err;
+        }
+        const startTime = Date.now();
+        logger.debug(`${format.name} request: model=${mockReq.model} streaming=${mockReq.streaming} messages=${mockReq.messages.length}`);
+        const matched = engine.match(mockReq);
+        const { reply: resolvedReply, ruleDesc } = await resolveReply(matched, mockReq, getFallback(), logger);
+        if (resolvedReply.error) {
+            const { error } = resolvedReply;
+            logger.info(`Error reply: ${String(error.status)} ${error.message}`);
+            history.record(mockReq, ruleDesc);
+            return reply.status(error.status).type("application/json").send(format.serializeError(error));
+        }
+        history.record(mockReq, ruleDesc);
+        const isStreaming = format.isStreaming(body);
+        const effectiveOptions = { ...defaultOptions, ...matched?.options };
+        const elapsed = Date.now() - startTime;
+        const mode = isStreaming ? "stream" : "json";
+        logger.info(`POST ${format.route} [${mode}] "${mockReq.lastMessage}" -> ${ruleDesc ?? "fallback"} (${elapsed}ms)`);
+        if (resolvedReply.text) {
+            logger.debug(`Reply text: "${resolvedReply.text}"`);
+        }
+        if (resolvedReply.tools?.length) {
+            logger.debug(`Reply tool calls: ${resolvedReply.tools.map((t) => t.name).join(", ")}`);
+        }
+        if (!isStreaming) {
+            return reply.type("application/json").send(format.serializeComplete(resolvedReply, mockReq.model));
+        }
+        const chunks = format.serialize(resolvedReply, mockReq.model, effectiveOptions);
+        await writeSSE(reply, chunks, effectiveOptions);
+    };
+}
+//# sourceMappingURL=route-handler.js.map

package/dist/route-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-handler.js","sourceRoot":"","sources":["../src/route-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAM/B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,SAAS,cAAc,CAAC,KAAY;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAyB,EACzB,OAAoB,EACpB,QAAe,EACf,MAAc;IAEd,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,yBAAyB,OAAO,CAAC,WAAW,mBAAmB,CAAC,CAAC;QAC7E,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;YAC/C,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YAChC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,gBAAgB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;QACpE,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC;AAUD,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAsB;IACvE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAEtE,OAAO,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;QAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,MAAM,OAAO,GAAuC,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3D,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QAE5C,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,aAAa,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9F,OAAO,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CACjE,MAAM,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CACpH,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,CAAC,KAAK,CACV,GAAG,MAAM,CAAC,IAAI,mBAAmB,OAAO,CAAC,KAAK,cAAc,OAAO,CAAC,SAAS,aAAa,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CACpH,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CAC3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,CACxC,CAAC;QAEF,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAClC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAChG,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAElC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,gBAAgB,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAE7C,MAAM,CAAC,IAAI,CACT,QAAQ,MAAM,CAAC,KAAK,KAAK,IAAI,MAAM,OAAO,CAAC,WAAW,QAAQ,QAAQ,IAAI,UAAU,KAAK,OAAO,KAAK,CACtG,CAAC;QACF,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,gBAAgB,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,qBAAqB,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACrG,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QAChF,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC"}

package/dist/rule-engine.d.ts

@@ -0,0 +1,24 @@
+import type { Match, MockRequest, Resolver, Reply, ReplyOptions, Rule, RuleSummary } from "./types.js";
+interface SequenceStep {
+    readonly reply: Reply;
+    readonly options?: ReplyOptions | undefined;
+}
+export declare function createSequenceResolver(steps: readonly SequenceStep[], rule: {
+    options: ReplyOptions;
+}): {
+    resolver: () => Reply;
+    entryCount: number;
+};
+export declare class RuleEngine {
+    private readonly rules;
+    add(match: Match, resolve: Resolver, options?: ReplyOptions): Rule;
+    moveToFront(rule: Rule): void;
+    addHandler(matchFn: (req: MockRequest) => boolean, respond: Resolver, description?: string): Rule;
+    match(req: MockRequest): Rule | undefined;
+    isDone(): boolean;
+    get ruleCount(): number;
+    describe(): readonly RuleSummary[];
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=rule-engine.d.ts.map

package/dist/rule-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.d.ts","sourceRoot":"","sources":["../src/rule-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAe,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgEpH,UAAU,YAAY;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,IAAI,EAAE;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,GAC9B;IAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAY/C;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAMtE,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQ7B,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,SAAc,GAAG,IAAI;IAMtG,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS;IAgBzC,MAAM,IAAI,OAAO;IAIjB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,QAAQ,IAAI,SAAS,WAAW,EAAE;IAIlC,KAAK,IAAI,IAAI;CAGd"}

package/dist/rule-engine.js

@@ -0,0 +1,129 @@
+function safeRegex(re) {
+    return (re.global || re.sticky) ? new RegExp(re.source, re.flags.replace(/[gy]/g, "")) : re;
+}
+function compilePattern(pattern) {
+    if (typeof pattern === "string") {
+        const lower = pattern.toLowerCase();
+        return (value) => value.toLowerCase().includes(lower);
+    }
+    const re = safeRegex(pattern);
+    return (value) => re.test(value);
+}
+function compileMatcher(match) {
+    if (typeof match === "string") {
+        const test = compilePattern(match);
+        return (req) => test(req.lastMessage);
+    }
+    if (match instanceof RegExp) {
+        const test = compilePattern(match);
+        return (req) => test(req.lastMessage);
+    }
+    if (typeof match === "function") {
+        return match;
+    }
+    const obj = match;
+    const messageTest = obj.message !== undefined ? compilePattern(obj.message) : undefined;
+    const modelTest = obj.model !== undefined ? compilePattern(obj.model) : undefined;
+    const systemTest = obj.system !== undefined ? compilePattern(obj.system) : undefined;
+    return (req) => {
+        if (messageTest && !messageTest(req.lastMessage))
+            return false;
+        if (modelTest && !modelTest(req.model))
+            return false;
+        if (systemTest && !systemTest(req.systemMessage))
+            return false;
+        if (obj.format !== undefined && req.format !== obj.format)
+            return false;
+        if (obj.toolName !== undefined && !req.toolNames.includes(obj.toolName))
+            return false;
+        if (obj.toolCallId !== undefined && req.lastToolCallId !== obj.toolCallId)
+            return false;
+        if (obj.predicate && !obj.predicate(req))
+            return false;
+        return true;
+    };
+}
+function describeMatch(match) {
+    if (typeof match === "string")
+        return `"${match}"`;
+    if (match instanceof RegExp)
+        return match.toString();
+    if (typeof match === "function")
+        return "(predicate)";
+    const obj = match;
+    const parts = Object.entries(obj)
+        .filter(([, v]) => v !== undefined && typeof v !== "function")
+        .map(([k, v]) => `${k}=${String(v)}`);
+    return `{${parts.join(", ")}}`;
+}
+function createRule(match, resolve, options, description) {
+    return {
+        description: description ?? describeMatch(match),
+        match: compileMatcher(match),
+        resolve,
+        options,
+        remaining: Infinity,
+    };
+}
+export function createSequenceResolver(steps, rule) {
+    if (steps.length === 0)
+        throw new Error("Sequence requires at least one entry.");
+    let index = 0;
+    const last = steps[steps.length - 1];
+    return {
+        resolver: () => {
+            const step = steps[index++] ?? last;
+            rule.options = step.options ?? {};
+            return step.reply;
+        },
+        entryCount: steps.length,
+    };
+}
+export class RuleEngine {
+    rules = [];
+    add(match, resolve, options = {}) {
+        const rule = createRule(match, resolve, options);
+        this.rules.push(rule);
+        return rule;
+    }
+    moveToFront(rule) {
+        const idx = this.rules.indexOf(rule);
+        if (idx > 0) {
+            this.rules.splice(idx, 1);
+            this.rules.unshift(rule);
+        }
+    }
+    addHandler(matchFn, respond, description = "(handler)") {
+        const rule = createRule(matchFn, respond, {}, description);
+        this.rules.push(rule);
+        return rule;
+    }
+    match(req) {
+        for (let i = 0; i < this.rules.length; i++) {
+            const rule = this.rules[i];
+            if (rule.remaining <= 0)
+                continue;
+            if (!rule.match(req))
+                continue;
+            rule.remaining--;
+            if (rule.remaining <= 0) {
+                this.rules.splice(i, 1);
+            }
+            return rule;
+        }
+        return undefined;
+    }
+    isDone() {
+        return this.rules.every((r) => !Number.isFinite(r.remaining) || r.remaining <= 0);
+    }
+    get ruleCount() {
+        return this.rules.length;
+    }
+    describe() {
+        return this.rules.map((r) => ({ description: r.description, remaining: r.remaining }));
+    }
+    clear() {
+        this.rules.length = 0;
+    }
+}
+//# sourceMappingURL=rule-engine.js.map