@leemour/cli-messaging 0.97.0 → 0.99.0

package/dist/cli/messenger/watch-command.js.map

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

package/dist/embeddings/embed.d.ts

@@ -0,0 +1,22 @@
+import type { TextModel } from "./models.js";
+export declare const textModelsDirectory: (env?: NodeJS.ProcessEnv) => string;
+export declare const placedText: (model: TextModel, directory: string) => [import("../speech/models.js").ModelFile, string][];
+export declare const isTextModelInstalled: (model: TextModel, directory: string) => boolean;
+/** Past 8 threads one session gains nothing; Bun takes 1 unless told (`2026-10-02-embeddings.md`). */
+export declare const defaultThreads: () => number;
+export type Kind = "query" | "passage";
+export interface Embedder {
+    readonly model: TextModel;
+    /** One unit vector per text, in order. */
+    embed(texts: string[], kind: Kind): Promise<Float32Array[]>;
+    close(): Promise<void>;
+}
+/** A text longer than the model's limit keeps its beginning and the closing special token. */
+export declare const truncated: (ids: number[], max: number) => number[];
+export declare const unit: (vector: Float32Array) => Float32Array;
+/** The mean over a single text's tokens: one text a run, so no padding to mask. */
+export declare const meanOf: (data: Float32Array, tokens: number, dims: number) => Float32Array;
+export declare const openEmbedder: (model: TextModel, directory: string, { threads }?: {
+    threads?: number;
+}) => Promise<Embedder>;
+//# sourceMappingURL=embed.d.ts.map

package/dist/embeddings/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/embeddings/embed.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,eAAO,MAAM,mBAAmB,SAAS,MAAM,CAAC,UAAU,KAAiB,MAA4C,CAAA;AAEvH,eAAO,MAAM,UAAU,UAAW,SAAS,aAAa,MAAM,wDACoC,CAAA;AAElG,eAAO,MAAM,oBAAoB,UAAW,SAAS,aAAa,MAAM,KAAG,OAC/B,CAAA;AAE5C,sGAAsG;AACtG,eAAO,MAAM,cAAc,QAAO,MAA6C,CAAA;AAE/E,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,SAAS,CAAA;AAEtC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,0CAA0C;IAC1C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,8FAA8F;AAC9F,eAAO,MAAM,SAAS,QAAS,MAAM,EAAE,OAAO,MAAM,KAAG,MAAM,EACe,CAAA;AAE5E,eAAO,MAAM,IAAI,WAAY,YAAY,KAAG,YAK3C,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,MAAM,SAAU,YAAY,UAAU,MAAM,QAAQ,MAAM,KAAG,YAOzE,CAAA;AAED,eAAO,MAAM,YAAY,UAChB,SAAS,aACL,MAAM,gBACe;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACnD,OAAO,CAAC,QAAQ,CA6ClB,CAAA"}

package/dist/embeddings/embed.js

@@ -0,0 +1,69 @@
+import { readFileSync } from "node:fs";
+import { availableParallelism } from "node:os";
+import { basename, join } from "node:path";
+import { filesPresent, sharedModelsDirectory } from "../speech/install.js";
+export const textModelsDirectory = (env = process.env) => sharedModelsDirectory("text", env);
+export const placedText = (model, directory) => model.files.map((file) => [file, join(directory, model.id, file.name)]);
+export const isTextModelInstalled = (model, directory) => filesPresent(placedText(model, directory));
+/** Past 8 threads one session gains nothing; Bun takes 1 unless told (`2026-10-02-embeddings.md`). */
+export const defaultThreads = () => Math.min(8, availableParallelism());
+/** A text longer than the model's limit keeps its beginning and the closing special token. */
+export const truncated = (ids, max) => ids.length <= max ? ids : [...ids.slice(0, max - 1), ids.at(-1)];
+export const unit = (vector) => {
+    let sum = 0;
+    for (const value of vector)
+        sum += value * value;
+    const length = Math.sqrt(sum);
+    return length === 0 ? vector : vector.map((value) => value / length);
+};
+/** The mean over a single text's tokens: one text a run, so no padding to mask. */
+export const meanOf = (data, tokens, dims) => {
+    const mean = new Float32Array(dims);
+    for (let token = 0; token < tokens; token++) {
+        for (let dim = 0; dim < dims; dim++)
+            mean[dim] = mean[dim] + data[token * dims + dim] / tokens;
+    }
+    return mean;
+};
+export const openEmbedder = async (model, directory, { threads = defaultThreads() } = {}) => {
+    const [{ Tokenizer }, ort] = await Promise.all([
+        import("@huggingface/tokenizers"),
+        import("@leemour/cli-messaging-onnx"),
+    ]);
+    const path = (name) => join(directory, model.id, name);
+    const tokenizer = new Tokenizer(JSON.parse(readFileSync(path("tokenizer.json"), "utf8")), JSON.parse(readFileSync(path("tokenizer_config.json"), "utf8")));
+    ort.env.wasm.numThreads = threads;
+    const session = await ort.InferenceSession.create(readFileSync(path(model.onnx)), model.externalData
+        ? { externalData: [{ path: basename(model.externalData), data: readFileSync(path(model.externalData)) }] }
+        : {});
+    const typeIds = session.inputNames.includes("token_type_ids");
+    const one = async (text) => {
+        const ids = truncated(tokenizer.encode(text).ids, model.maxTokens);
+        const shape = [1, ids.length];
+        const feeds = {
+            input_ids: new ort.Tensor("int64", BigInt64Array.from(ids, BigInt), shape),
+            attention_mask: new ort.Tensor("int64", new BigInt64Array(ids.length).fill(1n), shape),
+        };
+        if (typeIds)
+            feeds.token_type_ids = new ort.Tensor("int64", new BigInt64Array(ids.length), shape);
+        const output = await session.run(feeds);
+        if (model.pooling === "sentence_embedding") {
+            return unit(Float32Array.from(output.sentence_embedding?.data));
+        }
+        const hidden = output.last_hidden_state;
+        if (!hidden)
+            throw new Error(`${model.id} gave no last_hidden_state`);
+        return unit(meanOf(hidden.data, ids.length, hidden.dims.at(-1)));
+    };
+    return {
+        model,
+        embed: async (texts, kind) => {
+            const vectors = [];
+            for (const text of texts)
+                vectors.push(await one(`${model.prefix[kind]}${text}`));
+            return vectors;
+        },
+        close: () => session.release(),
+    };
+};
+//# sourceMappingURL=embed.js.map

package/dist/embeddings/embed.js.map

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

package/dist/embeddings/models.d.ts

@@ -0,0 +1,33 @@
+import type { ModelFile } from "../speech/models.js";
+/**
+ * The text embedding models `conversations embed` can use, each **pinned to one commit** and checked by
+ * sha256, as the speech models are. Measured 2026-10-02 through `@leemour/cli-messaging-onnx`, 4 threads, a
+ * Ryzen AI 9 HX 470 laptop, 300-token chunks, Node 24 and Bun 1.3.14 alike
+ * (`docs/storage/research/2026-10-02-embeddings.md`): e5-small ~10 chunks a second, EmbeddingGemma ~1.5.
+ */
+export interface TextModel {
+    id: string;
+    title: string;
+    languages: string;
+    licence: string;
+    /** A licence the user accepts before the model is downloaded, or nothing for an open one. */
+    terms?: string;
+    dims: number;
+    /** What the model was trained on; a longer text is cut. */
+    maxTokens: number;
+    /** How the model's output becomes one vector. */
+    pooling: "mean" | "sentence_embedding";
+    /** Prepended to a search and to a stored chunk: the model was trained with them. */
+    prefix: {
+        query: string;
+        passage: string;
+    };
+    files: ModelFile[];
+    /** The ONNX file among `files`, and the weights it keeps beside itself, if any. */
+    onnx: string;
+    externalData?: string;
+}
+export declare const TEXT_MODELS: TextModel[];
+export declare const DEFAULT_TEXT_MODEL = "e5-small";
+export declare const textModel: (id: string) => TextModel;
+//# sourceMappingURL=models.d.ts.map

package/dist/embeddings/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/embeddings/models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAA;IACtC,oFAAoF;IACpF,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAQD,eAAO,MAAM,WAAW,EAAE,SAAS,EAuElC,CAAA;AAED,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAE5C,eAAO,MAAM,SAAS,OAAQ,MAAM,KAAG,SAStC,CAAA"}

package/dist/embeddings/models.js

@@ -0,0 +1,85 @@
+import { CliError } from "@leemour/cli-core";
+const huggingFace = (repository, commit) => (name) => `https://huggingface.co/${repository}/resolve/${commit}/${name}`;
+const e5 = huggingFace("Xenova/multilingual-e5-small", "761b726dd34fb83930e26aab4e9ac3899aa1fa78");
+const gemma = huggingFace("onnx-community/embeddinggemma-300m-ONNX", "5090578d9565bb06545b4552f76e6bc2c93e4a66");
+export const TEXT_MODELS = [
+    {
+        id: "e5-small",
+        title: "multilingual-e5-small, 8-bit",
+        languages: "about 100 languages, Russian and English among them",
+        licence: "MIT",
+        dims: 384,
+        maxTokens: 512,
+        pooling: "mean",
+        prefix: { query: "query: ", passage: "passage: " },
+        onnx: "onnx/model_quantized.onnx",
+        files: [
+            {
+                name: "onnx/model_quantized.onnx",
+                url: e5("onnx/model_quantized.onnx"),
+                sha256: "f80102d3f2a1229f387d3c81909990d8945513e347b0eab049f7de3c6f98c193",
+                bytes: 118_308_185,
+            },
+            {
+                name: "tokenizer.json",
+                url: e5("tokenizer.json"),
+                sha256: "0b44a9d7b51c3c62626640cda0e2c2f70fdacdc25bbbd68038369d14ebdf4c39",
+                bytes: 17_082_730,
+            },
+            {
+                name: "tokenizer_config.json",
+                url: e5("tokenizer_config.json"),
+                sha256: "a1d6bc8734a6f635dc158508bef000f8e2e5a759c7d92f984b2c86e5ff53425b",
+                bytes: 443,
+            },
+        ],
+    },
+    {
+        id: "embeddinggemma",
+        title: "EmbeddingGemma 300M, 4-bit",
+        languages: "over 100 languages — the best of the two on chat, about seven times slower",
+        licence: "Gemma Terms of Use",
+        terms: "https://ai.google.dev/gemma/terms",
+        dims: 768,
+        maxTokens: 2048,
+        pooling: "sentence_embedding",
+        prefix: { query: "task: search result | query: ", passage: "title: none | text: " },
+        onnx: "onnx/model_q4.onnx",
+        externalData: "onnx/model_q4.onnx_data",
+        files: [
+            {
+                name: "onnx/model_q4.onnx",
+                url: gemma("onnx/model_q4.onnx"),
+                sha256: "ad1dfee81a70f7944b9b9d1cc6e48075b832881cf33fab2f2b248be78f3f0043",
+                bytes: 519_322,
+            },
+            {
+                name: "onnx/model_q4.onnx_data",
+                url: gemma("onnx/model_q4.onnx_data"),
+                sha256: "599962c3143b040de2dd05e5975be3e9091dd067cacc6a8f7186e3203bab9e02",
+                bytes: 196_725_760,
+            },
+            {
+                name: "tokenizer.json",
+                url: gemma("tokenizer.json"),
+                sha256: "4dda02faaf32bc91031dc8c88457ac272b00c1016cc679757d1c441b248b9c47",
+                bytes: 20_323_312,
+            },
+            {
+                name: "tokenizer_config.json",
+                url: gemma("tokenizer_config.json"),
+                sha256: "3ca953eea6c3c9fcda9cf3df22949ff18b216f7c74bd6459230f3f1013953f3a",
+                bytes: 1_156_830,
+            },
+        ],
+    },
+];
+export const DEFAULT_TEXT_MODEL = "e5-small";
+export const textModel = (id) => {
+    const found = TEXT_MODELS.find((model) => model.id === id);
+    if (!found) {
+        throw new CliError("validation_error", `no text model ${id} — one of: ${TEXT_MODELS.map((model) => model.id).join(", ")}`);
+    }
+    return found;
+};
+//# sourceMappingURL=models.js.map

package/dist/embeddings/models.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export type { Capabilities } from "./domain/capabilities.js";
 export { formatLocator, isLocator, type MessageLocator, parseLocator } from "./domain/locator.js";
 export { type Markup, parseMarkdown } from "./domain/markdown.js";
 export type * from "./domain/models.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACjG,OAAO,EAAE,KAAK,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACjE,mBAAmB,oBAAoB,CAAA;AACvC,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,IAAI,EAAE,KAAK,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACjG,OAAO,EAAE,KAAK,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACjE,mBAAmB,oBAAoB,CAAA;AACvC,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,IAAI,EAAE,KAAK,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAuB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACjG,OAAO,EAAe,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGjE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAsB,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAsB,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,IAAI,EAAqB,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAuB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACjG,OAAO,EAAe,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGjE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAsB,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAsB,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,IAAI,EAAqB,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/kit/contract.d.ts

@@ -0,0 +1,39 @@
+import { type MessengerAdapter } from "../cli/messenger/port.js";
+import { type IdMaker, type Seed } from "./seed.js";
+export interface ContractCase {
+    name: string;
+    /** What the adapter's fake must do beyond holding the seed, where a case asks more of it. */
+    needs?: string;
+    /** Throws an `AssertionError` on a broken promise; `skipped` names the optional method the adapter lacks. */
+    run(): Promise<undefined | {
+        skipped: string;
+    }>;
+}
+export interface ContractOptions {
+    /** A fresh adapter over `seed` — the CLI's own fake, filled from it. Called once for every case. */
+    connect: (seed: Seed) => MessengerAdapter | Promise<MessengerAdapter>;
+    /** How the seed names things; non-digit `wordIds` unless the messenger's ids have a shape of their own. */
+    ids?: IdMaker;
+    /** As the messenger's `fetching.orderBy`: whether `history`'s `before` is a message id or an ISO time. */
+    orderBy?: "id" | "time";
+    /** How long `watch` may take to say it listens, and to end once aborted. */
+    waitMs?: number;
+    /** As the messenger's `history`: a `"server"` messenger's adapter must have every `ServerReads` method. */
+    history?: "server" | "store";
+}
+/** Every method of the optional groups, which `capability` hands over or refuses. */
+export declare const OPTIONAL_METHODS: readonly ["chats", "history", "around", "contact", "historyAfter", "historyBefore", "topics", "inspect", "edit", "forward", "delete", "pin", "unpin", "react", "markRead", "poll", "vote", "closePoll", "createPoll", "watch", "feed", "download", "transcribe", "scheduled", "members", "admins", "chatEvents", "sessions", "lookup", "addressBook", "people", "createGroup", "join", "leave", "group", "updateGroup", "resetInviteLink", "addMembers", "removeMembers", "addAdmin", "removeAdmin", "folders", "createFolder", "updateFolder", "deleteFolder", "addContact", "removeContact", "block", "unblock", "renameContact", "importContacts", "updateProfile", "endOtherSessions"];
+/**
+ * The port's promises as cases any test runner can run: each connects through `connect`, checks
+ * with `node:assert/strict` and closes the adapter. None needs a live service.
+ *
+ * ```ts
+ * for (const one of contractCases({ connect: (seed) => myAdapter(fakeClientFrom(seed)) }))
+ *   it(one.name, async (context) => {
+ *     const result = await one.run()
+ *     if (result) context.skip(result.skipped)
+ *   })
+ * ```
+ */
+export declare const contractCases: ({ connect, ids, orderBy, waitMs, history, }: ContractOptions) => ContractCase[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/kit/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/kit/contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiC,KAAK,gBAAgB,EAAoB,MAAM,0BAA0B,CAAA;AAGjH,OAAO,EAA2B,KAAK,OAAO,EAAE,KAAK,IAAI,EAAW,MAAM,WAAW,CAAA;AAErF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6GAA6G;IAC7G,GAAG,IAAI,OAAO,CAAC,SAAS,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,oGAAoG;IACpG,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACrE,2GAA2G;IAC3G,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,0GAA0G;IAC1G,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACvB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2GAA2G;IAC3G,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAC7B;AAWD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,4pBAmD2B,CAAA;AAmCxD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,gDAMvB,eAAe,KAAG,YAAY,EAkWhC,CAAA"}