modelpact 2.0.2

package/dist/providers/ollama.js

@@ -0,0 +1,275 @@
+/**
+ * Ollama on a machine you can reach over HTTP.
+ *
+ * The daemon keeps nothing between requests: `/api/chat` is handed the whole
+ * conversation every time, which is what `request.history` is for. Three
+ * endpoints are the whole backend — `/api/tags` says what is downloaded,
+ * `/api/pull` downloads, `/api/chat` generates — and everything else the
+ * contract promises is `../lifecycle`'s.
+ *
+ * Shapes here were read off a running daemon, not off the docs: a chat stream
+ * is NDJSON whose last line carries the counts, a pull line carries `completed`
+ * and `total` per layer, and an error is an HTTP status with `{"error": "…"}`.
+ */
+import { ndjsonLines } from "../helpers/ndjson.js";
+import { err, fraction, ok, tokens, } from "../types/foundations.js";
+import { AiError } from "../types/failures.js";
+import { contextUsage } from "../types/usage.js";
+import { createProvider } from "./create.js";
+const DEFAULTS = {
+    host: "http://127.0.0.1:11434",
+    contextWindow: 4096,
+};
+const asRecord = (value) => {
+    const isObject = typeof value === "object" && value !== null;
+    return isObject && !Array.isArray(value)
+        ? value
+        : null;
+};
+const asString = (value) => typeof value === "string" ? value : null;
+const asNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
+const parseJson = (text) => {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+};
+const toEndpoint = (config) => ({
+    host: config.host ?? DEFAULTS.host,
+    // Bound, and not optional: in a browser `fetch` is a method of the window and
+    // throws `TypeError: Illegal invocation` once it is held on its own. Node
+    // does not care, so nothing but a page catches this (measured).
+    call: config.fetch ?? globalThis.fetch.bind(globalThis),
+});
+const postTo = (endpoint, path, body, signal) => endpoint.call(`${endpoint.host}${path}`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(body),
+    ...(signal === undefined ? {} : { signal }),
+});
+/** The daemon says what went wrong in the body; a status alone would lose it. */
+const failureFromResponse = async (response) => {
+    const text = await response.text().catch(() => "");
+    const errorText = asString(asRecord(parseJson(text))?.error);
+    const detail = errorText ?? `${response.status} from the daemon`;
+    // 400 is the daemon reading the request and refusing it, which is a bug on
+    // this side. Everything else is the daemon's own trouble.
+    return response.status === 400
+        ? { kind: "invalid-input", detail }
+        : { kind: "failed", detail };
+};
+const listModels = async (endpoint) => {
+    const response = await endpoint.call(`${endpoint.host}/api/tags`);
+    if (!response.ok)
+        return [];
+    const listedModels = asRecord(await response.json().catch(() => null))?.models;
+    if (!Array.isArray(listedModels))
+        return [];
+    const names = listedModels.map((entry) => asString(asRecord(entry)?.model));
+    return names.filter((name) => name !== null);
+};
+const getAvailability = async (config) => {
+    const endpoint = toEndpoint(config);
+    let downloadedModels;
+    try {
+        downloadedModels = await listModels(endpoint);
+    }
+    catch (cause) {
+        // Nothing answering is not a failed request, it is no Ollama here.
+        return { kind: "unavailable", reason: { kind: "unsupported", cause } };
+    }
+    const isDownloaded = downloadedModels.includes(config.model);
+    return isDownloaded
+        ? { kind: "ready" }
+        : { kind: "needs-download", started: false };
+};
+/**
+ * Pull progress is per layer, and layers are announced as the pull reaches
+ * them, so the denominator grows while it runs. The share can therefore stall,
+ * and `ProgressMonitor` drops it if it would step back. `success` is what
+ * makes the last report a 1, since that line carries no numbers.
+ */
+const readPullProgress = (reportProgress) => {
+    const layers = new Map();
+    return new TransformStream({
+        transform: (line, controller) => {
+            const parsedLine = asRecord(parseJson(line));
+            if (parsedLine === null)
+                return;
+            const errorText = asString(parsedLine.error);
+            if (errorText !== null)
+                throw new AiError({ kind: "failed", detail: errorText });
+            const digest = asString(parsedLine.digest);
+            const total = asNumber(parsedLine.total);
+            const completed = asNumber(parsedLine.completed) ?? 0;
+            if (digest !== null && total !== null && total > 0) {
+                layers.set(digest, { total, completed });
+            }
+            const isDone = asString(parsedLine.status) === "success";
+            const pulledShare = isDone ? 1 : getPulledShare(layers);
+            const progress = fraction(pulledShare);
+            if (progress !== null)
+                reportProgress(progress);
+            controller.enqueue(line);
+        },
+    });
+};
+const getPulledShare = (layers) => {
+    let total = 0;
+    let completed = 0;
+    for (const layer of layers.values()) {
+        total += layer.total;
+        completed += layer.completed;
+    }
+    return total === 0 ? 0 : completed / total;
+};
+const pullModel = async (endpoint, model, reportProgress) => {
+    const response = await postTo(endpoint, "/api/pull", { model, stream: true });
+    if (!response.ok)
+        return err(await failureFromResponse(response));
+    if (response.body === null)
+        return err({ kind: "failed", detail: "the pull sent no body" });
+    const lines = response.body
+        .pipeThrough(new TextDecoderStream())
+        .pipeThrough(ndjsonLines())
+        .pipeThrough(readPullProgress(reportProgress));
+    const reader = lines.getReader();
+    try {
+        // Read to the end: the transform above is where the reporting happens, and
+        // the body is not finished until it stops yielding.
+        for (;;) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                return ok(null);
+        }
+    }
+    catch (error) {
+        return err(error instanceof AiError
+            ? error.failure
+            : { kind: "failed", detail: "the pull was interrupted", cause: error });
+    }
+};
+class OllamaModel {
+    #endpoint;
+    #model;
+    #contextWindow;
+    #system;
+    /** The last turn's counts, which is what the context holds now rather than a running sum. */
+    #usedTokens = 0;
+    constructor(config, options) {
+        this.#endpoint = toEndpoint(config);
+        this.#model = config.model;
+        this.#contextWindow = config.contextWindow ?? DEFAULTS.contextWindow;
+        this.#system = options.session.system;
+    }
+    generateStream = async (input, request) => {
+        const responseResult = await this.#chat(input, request, true);
+        if (!responseResult.ok)
+            return responseResult;
+        const body = responseResult.value.body;
+        if (body === null)
+            return err({ kind: "failed", detail: "the chat sent no body" });
+        const deltas = body
+            .pipeThrough(new TextDecoderStream())
+            .pipeThrough(ndjsonLines())
+            .pipeThrough(this.#readChatLines());
+        return ok(deltas);
+    };
+    generateWhole = async (input, request) => {
+        const responseResult = await this.#chat(input, request, false);
+        if (!responseResult.ok)
+            return responseResult;
+        const parsedBody = asRecord(await responseResult.value.json().catch(() => null));
+        if (parsedBody === null)
+            return err({ kind: "failed", detail: "the chat sent no JSON" });
+        const answerText = asString(asRecord(parsedBody.message)?.content);
+        if (answerText === null)
+            return err({ kind: "failed", detail: "the chat sent no message" });
+        this.#charge(parsedBody);
+        return ok(answerText);
+    };
+    usage = () => {
+        const used = tokens(this.#usedTokens) ?? ZERO_TOKENS;
+        return contextUsage(used, this.#contextWindow);
+    };
+    /**
+     * Nothing to release. The daemon unloads on its own timer, and telling it to
+     * unload here would take the model out from under whoever else is on it.
+     */
+    dispose = () => undefined;
+    async #chat(input, request, stream) {
+        const askedMessage = { role: "user", content: input };
+        const conversation = [...request.history, askedMessage];
+        const messages = this.#system === undefined
+            ? conversation
+            : [{ role: "user", content: this.#system }, ...conversation];
+        const body = {
+            model: this.#model,
+            messages,
+            stream,
+            options: { num_ctx: this.#contextWindow },
+            ...(request.schema === undefined ? {} : { format: request.schema }),
+        };
+        const response = await postTo(this.#endpoint, "/api/chat", body, request.signal);
+        return response.ok
+            ? ok(response)
+            : err(await failureFromResponse(response));
+    }
+    /** Content out, counts kept: the last line carries both `done` and the totals. */
+    #readChatLines() {
+        return new TransformStream({
+            transform: (line, controller) => {
+                const parsedLine = asRecord(parseJson(line));
+                if (parsedLine === null)
+                    return;
+                const errorText = asString(parsedLine.error);
+                if (errorText !== null)
+                    throw new AiError({ kind: "failed", detail: errorText });
+                if (parsedLine.done === true)
+                    this.#charge(parsedLine);
+                const delta = asString(asRecord(parsedLine.message)?.content) ?? "";
+                if (delta !== "")
+                    controller.enqueue(delta);
+            },
+        });
+    }
+    /**
+     * `prompt_eval_count` is the whole prompt, history included, so the two
+     * counts together are what the window holds after this turn. Summing across
+     * turns would count the history once per turn.
+     */
+    #charge(finishedLine) {
+        const promptTokens = asNumber(finishedLine.prompt_eval_count) ?? 0;
+        const answerTokens = asNumber(finishedLine.eval_count) ?? 0;
+        this.#usedTokens = promptTokens + answerTokens;
+    }
+}
+const ZERO_TOKENS = tokens(0);
+const connectOllama = async (config, options) => {
+    const endpoint = toEndpoint(config);
+    let downloadedModels;
+    try {
+        downloadedModels = await listModels(endpoint);
+    }
+    catch (cause) {
+        return err({ kind: "unsupported", cause });
+    }
+    if (!downloadedModels.includes(config.model)) {
+        const pullResult = await pullModel(endpoint, config.model, options.reportProgress);
+        if (!pullResult.ok)
+            return pullResult;
+    }
+    return ok(new OllamaModel(config, options));
+};
+export function makeOllamaProvider(config) {
+    const backend = {
+        name: "ollama",
+        modalities: ["text"],
+        availability: () => getAvailability(config),
+        connect: (options) => connectOllama(config, options),
+    };
+    return createProvider(backend);
+}
+//# sourceMappingURL=ollama.js.map

package/dist/providers/ollama.js.map

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

package/dist/providers/prompt-api.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Chrome's built-in model, through the Prompt API.
+ *
+ * The one backend that keeps the conversation itself: `LanguageModel` is a
+ * session object, `prompt()` appends to it, and `request.history` is therefore
+ * read by nobody here. Two more things it owns that the others do not — it
+ * fires its own `contextoverflow`, which is forwarded rather than re-derived,
+ * and it reports usage against a window it decides.
+ *
+ * It lives in a page and nowhere else. In node the global is missing, and
+ * `access` answers `unavailable` with `unsupported` rather than throwing.
+ *
+ * The declarations are `@types/dom-chromium-ai`, patched under `patches/` to
+ * close the gap between the IDL and the spec; `src/types.test-d.ts` is where
+ * the two meet. They are named in function bodies and nowhere in a signature
+ * that leaves this file: an exported type naming `LanguageModel` puts the same
+ * name in the emitted `.d.ts`, and a consumer who has not installed those
+ * declarations, or who lists `types` explicitly, then cannot compile the
+ * package at all. `external/webgpu-provider` is where that was found.
+ */
+import type { AiProvider } from "../types/provider.js";
+export declare function makePromptApiProvider(): AiProvider;
+//# sourceMappingURL=prompt-api.d.ts.map

package/dist/providers/prompt-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-api.d.ts","sourceRoot":"","sources":["../../src/providers/prompt-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAkBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AA4NvD,wBAAgB,qBAAqB,IAAI,UAAU,CAUlD"}

package/dist/providers/prompt-api.js

@@ -0,0 +1,203 @@
+/**
+ * Chrome's built-in model, through the Prompt API.
+ *
+ * The one backend that keeps the conversation itself: `LanguageModel` is a
+ * session object, `prompt()` appends to it, and `request.history` is therefore
+ * read by nobody here. Two more things it owns that the others do not — it
+ * fires its own `contextoverflow`, which is forwarded rather than re-derived,
+ * and it reports usage against a window it decides.
+ *
+ * It lives in a page and nowhere else. In node the global is missing, and
+ * `access` answers `unavailable` with `unsupported` rather than throwing.
+ *
+ * The declarations are `@types/dom-chromium-ai`, patched under `patches/` to
+ * close the gap between the IDL and the spec; `src/types.test-d.ts` is where
+ * the two meet. They are named in function bodies and nowhere in a signature
+ * that leaves this file: an exported type naming `LanguageModel` puts the same
+ * name in the emitted `.d.ts`, and a consumer who has not installed those
+ * declarations, or who lists `types` explicitly, then cannot compile the
+ * package at all. `external/webgpu-provider` is where that was found.
+ */
+import { failureFromError } from "../types/failures.js";
+import { err, fraction, ok, tokens, } from "../types/foundations.js";
+import { contextUsage } from "../types/usage.js";
+import { createProvider } from "./create.js";
+/**
+ * The page's own class, or nothing.
+ *
+ * There is no way to hand one in. A polyfill is already this — it defines the
+ * global — and a test sets the global too, which is the same path the browser
+ * takes rather than one beside it.
+ *
+ * `typeof` and not a bare read: outside a page the name is not declared, and
+ * naming it there throws rather than answering undefined.
+ */
+const getPlatformApi = () => typeof LanguageModel === "undefined" ? null : LanguageModel;
+const toExpectations = (askedExpectations) => {
+    if (askedExpectations === undefined || askedExpectations.length === 0)
+        return undefined;
+    return askedExpectations.map((expectation) => ({
+        type: expectation.type,
+        ...(expectation.languages === undefined
+            ? {}
+            : { languages: [...expectation.languages] }),
+    }));
+};
+const toCoreOptions = (request) => {
+    const inputs = toExpectations(request.inputs);
+    const outputs = toExpectations(request.outputs);
+    return {
+        ...(inputs === undefined ? {} : { expectedInputs: inputs }),
+        ...(outputs === undefined ? {} : { expectedOutputs: outputs }),
+    };
+};
+/**
+ * The four the spec has, against the three the contract has. `downloading` and
+ * `downloadable` are one branch here and differ only in `started`, which is the
+ * question a caller actually has: is someone already fetching this.
+ */
+const toAvailability = (specAvailability) => {
+    switch (specAvailability) {
+        case "available":
+            return { kind: "ready" };
+        case "downloadable":
+            return { kind: "needs-download", started: false };
+        case "downloading":
+            return { kind: "needs-download", started: true };
+        case "unavailable":
+            // Empty lists: the spec says no for the whole request without naming a
+            // part, and inventing one would be worse than saying nothing.
+            return {
+                kind: "unavailable",
+                reason: { kind: "unsupported-config", languages: [] },
+            };
+    }
+};
+const getAvailability = async (request) => {
+    const api = getPlatformApi();
+    if (api === null)
+        return { kind: "unavailable", reason: { kind: "unsupported" } };
+    try {
+        const specAvailability = await api.availability(toCoreOptions(request));
+        return toAvailability(specAvailability);
+    }
+    catch (error) {
+        // `NotAllowedError` for the permissions policy, `InvalidStateError` for a
+        // document that is not fully active: both are refusals, not crashes.
+        return { kind: "unavailable", reason: failureFromError(error) };
+    }
+};
+/** System first or not at all, which is what the patched tuple type says too. */
+const toInitialPrompts = (session) => {
+    const historyPrompts = (session.history ?? []).map((message) => ({ role: message.role, content: message.content }));
+    if (session.system === undefined)
+        return historyPrompts.length === 0 ? undefined : historyPrompts;
+    return [{ role: "system", content: session.system }, ...historyPrompts];
+};
+const toPromptOptions = (request) => request.schema === undefined
+    ? { signal: request.signal }
+    : { signal: request.signal, responseConstraint: request.schema };
+/**
+ * `contextUsage` and `contextWindow` replaced `inputUsage` and `inputQuota`,
+ * and a browser in the field may have either pair. Read as unknown because the
+ * declarations promise the new names on a version that has only the old.
+ */
+const readUsage = (session) => {
+    const sessionFields = session;
+    const used = readNumber(sessionFields, "contextUsage", "inputUsage");
+    const windowTokens = readNumber(sessionFields, "contextWindow", "inputQuota");
+    if (used === null || windowTokens === null)
+        return { kind: "unknown" };
+    const usedTokens = tokens(used);
+    return usedTokens === null
+        ? { kind: "unknown" }
+        : contextUsage(usedTokens, windowTokens);
+};
+const readNumber = (sessionFields, currentName, olderName) => {
+    const value = sessionFields[currentName] ?? sessionFields[olderName];
+    return typeof value === "number" ? value : null;
+};
+class PromptApiModel {
+    #session;
+    constructor(session) {
+        this.#session = session;
+    }
+    generateStream = (input, request) => {
+        try {
+            const deltas = this.#session.promptStreaming(input, toPromptOptions(request));
+            return Promise.resolve(ok(deltas));
+        }
+        catch (error) {
+            return Promise.resolve(err(this.#refineFailure(error)));
+        }
+    };
+    generateWhole = async (input, request) => {
+        try {
+            const answerText = await this.#session.prompt(input, toPromptOptions(request));
+            return ok(answerText);
+        }
+        catch (error) {
+            return err(this.#refineFailure(error));
+        }
+    };
+    usage = () => readUsage(this.#session);
+    dispose = () => {
+        this.#session.destroy();
+    };
+    /**
+     * `QuotaExceededError` carries no measurement, and the generic mapping says
+     * so; holding the session is what lets this one attach the reading.
+     */
+    #refineFailure(error) {
+        const failure = failureFromError(error);
+        return failure.kind === "context-overflow"
+            ? { ...failure, usage: this.usage() }
+            : failure;
+    }
+}
+const connectPromptApi = async (options) => {
+    const api = getPlatformApi();
+    if (api === null)
+        return err({ kind: "unsupported" });
+    const initialPrompts = toInitialPrompts(options.session);
+    try {
+        const session = await api.create({
+            ...toCoreOptions(options.request),
+            ...(initialPrompts === undefined ? {} : { initialPrompts }),
+            ...(options.session.signal === undefined
+                ? {}
+                : { signal: options.session.signal }),
+            // Translated rather than forwarded, though the browser's monitor would
+            // satisfy `DownloadMonitor` as it stands: going through the lifecycle's
+            // own is what applies the never-decreasing rule to every backend alike.
+            monitor: (monitor) => {
+                monitor.ondownloadprogress = (event) => {
+                    const progress = fraction(event.total === 0 ? 0 : event.loaded / event.total);
+                    if (progress !== null)
+                        options.reportProgress(progress);
+                };
+            },
+        });
+        // Forwarded, not re-derived: by the time a listener reads the counters the
+        // dropped turns are gone, and `used` can be back under the window.
+        session.oncontextoverflow = () => {
+            options.reportOverflow();
+        };
+        return ok(new PromptApiModel(session));
+    }
+    catch (error) {
+        return err(failureFromError(error));
+    }
+};
+export function makePromptApiProvider() {
+    const backend = {
+        name: "prompt-api",
+        // Text only, because that is all `AiMessage` carries. The model takes more,
+        // and asking for it would promise a message this contract cannot build.
+        modalities: ["text"],
+        availability: (request) => getAvailability(request),
+        connect: (options) => connectPromptApi(options),
+    };
+    return createProvider(backend);
+}
+//# sourceMappingURL=prompt-api.js.map

package/dist/providers/prompt-api.js.map

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

package/dist/providers/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The app's list of providers, which is the only place the full set is known.
+ *
+ * A backend written outside this package names itself, so `ProviderName` is a
+ * plain string and the closed union moved here. `keyof typeof registry` is the
+ * app's own set, and a switch over it stays exhaustive the way one over a
+ * hand-written union did.
+ *
+ * `defineProviders` exists for the trap in doing it by hand: annotating with
+ * `const providers: ProviderRegistry = {…}` widens the keys back to `string`
+ * and takes the exhaustiveness with them.
+ */
+import type { AiProvider } from "../types/provider.js";
+export type ProviderRegistry = Readonly<Record<string, AiProvider>>;
+/** Identity at runtime: it checks the values and leaves the keys as literals. */
+export declare const defineProviders: <Registry extends ProviderRegistry>(registry: Registry) => Registry;
+/**
+ * A saved choice comes back from storage as a string. This is the one place it
+ * becomes a name the registry holds, or nothing.
+ */
+export declare function findProviderName<Name extends string>(registry: Readonly<Record<Name, AiProvider>>, saved: string): Name | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAEpE,iFAAiF;AACjF,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,gBAAgB,EAC/D,UAAU,QAAQ,KACjB,QAAoB,CAAC;AAExB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,MAAM,EAClD,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EAC5C,KAAK,EAAE,MAAM,GACZ,IAAI,GAAG,IAAI,CASb"}

package/dist/providers/registry.js

@@ -0,0 +1,30 @@
+/**
+ * The app's list of providers, which is the only place the full set is known.
+ *
+ * A backend written outside this package names itself, so `ProviderName` is a
+ * plain string and the closed union moved here. `keyof typeof registry` is the
+ * app's own set, and a switch over it stays exhaustive the way one over a
+ * hand-written union did.
+ *
+ * `defineProviders` exists for the trap in doing it by hand: annotating with
+ * `const providers: ProviderRegistry = {…}` widens the keys back to `string`
+ * and takes the exhaustiveness with them.
+ */
+/** Identity at runtime: it checks the values and leaves the keys as literals. */
+export const defineProviders = (registry) => registry;
+/**
+ * A saved choice comes back from storage as a string. This is the one place it
+ * becomes a name the registry holds, or nothing.
+ */
+export function findProviderName(registry, saved) {
+    // `Object.hasOwn`, not `in`: an inherited `toString` is not a provider, and
+    // `__proto__` is not a name anyone registered.
+    const registered = Object.hasOwn(registry, saved);
+    if (!registered)
+        return null;
+    // The check on the line above is what makes this cast honest. The names are
+    // a parameter rather than `keyof Registry` so that it stays one: under that
+    // constraint the compiler reads every key as a plain string.
+    return saved;
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAkB,EACR,EAAE,CAAC,QAAQ,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA4C,EAC5C,KAAa;IAEb,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,4EAA4E;IAC5E,6DAA6D;IAC7D,OAAO,KAAa,CAAC;AACvB,CAAC"}

package/dist/testing/contract.d.ts

@@ -0,0 +1,47 @@
+/**
+ * One set of assertions, run against every `AiProvider`.
+ *
+ * Written once and called for each backend, which sets a hard rule for what
+ * may be asserted here: only what `../types` promises. Anything about how a
+ * provider works inside — how many requests it made, what the prompt string
+ * looked like, which internal method ran first — differs between backends and
+ * would quietly turn this into a test of one of them.
+ *
+ * Published as `modelpact/testing`, so a backend written outside this package
+ * is held to the same standard as the ones inside it. `vitest` is a peer
+ * dependency: the file is `describe`/`test` calls, and two copies of the runner
+ * would register them in the wrong one.
+ *
+ * The filename carries no `.test` — the runner's glob is `src/**\/*.test.ts`
+ * and misses this file, which is a function others call rather than a suite of
+ * its own.
+ */
+import { type JsonSchema } from "../types/foundations.js";
+import type { AiProvider } from "../types/provider.js";
+/**
+ * `unavailable`, `needs-download` and a narrow window cannot be staged by every
+ * backend, so the factory returns null for a scenario it cannot produce and
+ * those tests skip. Skipping shows in the run output; silently passing would
+ * not.
+ */
+export type ContractScenario = "ready" | "unavailable" | "needs-download"
+/**
+ * A window so narrow that one ordinary turn spends more than it holds. Its
+ * own scenario because overflowing a real window means minutes of
+ * generation, and a backend that cannot be told how wide to load returns
+ * null for it.
+ */
+ | "tiny-window";
+export type ProviderFactory = (scenario: ContractScenario) => AiProvider | null | Promise<AiProvider | null>;
+/**
+ * The constraint the suite sends, and the shape a provider that honours one is
+ * measured against.
+ *
+ * Exported because a backend able to honour a schema has to be handed an answer
+ * that fits this exact one — a mock configures its reply against it. Kept to
+ * four keywords because the suite validates the answer itself: a general JSON
+ * Schema validator would be a dependency, and a second thing that can be wrong.
+ */
+export declare const CONTRACT_SCHEMA: JsonSchema;
+export declare function describeContract(name: string, makeProvider: ProviderFactory): void;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/testing/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOvD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,aAAa,GACb,gBAAgB;AAClB;;;;;GAKG;GACD,aAAa,CAAC;AAElB,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,gBAAgB,KACvB,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AAiBpD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,YAK1B,CAAC;AAiCH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,eAAe,GAC5B,IAAI,CA2bN"}