modelpact 2.0.2

package/dist/lifecycle/04_generate.js

@@ -0,0 +1,154 @@
+/**
+ * Stage four, once per turn: refuse at the door, hold the session, guard the
+ * stream, record the turn, free the session.
+ *
+ * `prompt` is `promptStream` drained, unless the backend has a whole-answer
+ * call. Either way a turn cannot leave the session held: every exit from the
+ * guarded stream — done, error, abort, reader cancel — ends it.
+ */
+import { abortFailure } from "../helpers/abort.js";
+import { err, ok } from "../types/foundations.js";
+import { AiError, failureFromError, } from "../types/failures.js";
+/**
+ * The one place a turn counts: the record and the meter move together, so a
+ * turn that reached here is in both and one that did not is in neither.
+ */
+const completeTurn = (state, input, answer) => {
+    state.transcript.append(input, answer);
+    const usage = state.model.usage();
+    state.events.report(usage);
+};
+const toGenerateRequest = (state, signal, options) => {
+    const history = state.transcript.entries();
+    return options?.schema === undefined
+        ? { signal, history }
+        : { signal, history, schema: options.schema };
+};
+const toFailure = (error) => error instanceof AiError ? error.failure : failureFromError(error);
+const toAiError = (error) => error instanceof AiError ? error : new AiError(failureFromError(error));
+/** Every refusal a generating call owes is `begin`'s to make; past it, the session is held. */
+const startTurn = (state, callName, options) => {
+    const turnResult = state.lifetime.begin(callName, options?.signal);
+    if (!turnResult.ok)
+        return turnResult;
+    const turn = turnResult.value;
+    const request = toGenerateRequest(state, turn.signal, options);
+    return ok({ turn, request });
+};
+/** `cancel` on a source that already errored rejects, and there is nothing to do about that. */
+const releaseReader = (reader) => {
+    reader.cancel().catch(() => undefined);
+};
+/**
+ * The backend's stream under the lifecycle's rules. An abort errors it with an
+ * `AiError` — a reader has nowhere to put a Result — and so does anything the
+ * source throws, mapped through `failureFromError`.
+ */
+const guardStream = (sourceStream, signal, hooks) => {
+    const reader = sourceStream.getReader();
+    const answerParts = [];
+    return new ReadableStream({
+        pull: async (controller) => {
+            try {
+                const chunk = await reader.read();
+                if (signal.aborted)
+                    throw new AiError(abortFailure(signal));
+                if (chunk.done) {
+                    hooks.finish(answerParts.join(""));
+                    controller.close();
+                    return;
+                }
+                answerParts.push(chunk.value);
+                controller.enqueue(chunk.value);
+            }
+            catch (error) {
+                hooks.abandon();
+                releaseReader(reader);
+                throw toAiError(error);
+            }
+        },
+        cancel: (reason) => {
+            hooks.abandon();
+            return reader.cancel(reason);
+        },
+    });
+};
+const callGenerate = async (model, input, request) => {
+    try {
+        return await model.generateStream(input, request);
+    }
+    catch (error) {
+        return err(toFailure(error));
+    }
+};
+const startStream = async (state, callName, input, options) => {
+    const startedTurnResult = startTurn(state, callName, options);
+    if (!startedTurnResult.ok)
+        return startedTurnResult;
+    const { turn, request } = startedTurnResult.value;
+    const streamResult = await callGenerate(state.model, input, request);
+    if (!streamResult.ok) {
+        state.lifetime.end(turn);
+        return streamResult;
+    }
+    // The token travels into the hooks, so a stream abandoned long ago cannot
+    // end the turn running when its `cancel` finally arrives.
+    const guardedStream = guardStream(streamResult.value, turn.signal, {
+        finish: (answer) => {
+            completeTurn(state, input, answer);
+            state.lifetime.end(turn);
+        },
+        abandon: () => {
+            state.lifetime.end(turn);
+        },
+    });
+    return ok(guardedStream);
+};
+const drainStream = async (stream) => {
+    const reader = stream.getReader();
+    const answerParts = [];
+    try {
+        for (;;) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                return ok(answerParts.join(""));
+            answerParts.push(chunk.value);
+        }
+    }
+    catch (error) {
+        return err(toFailure(error));
+    }
+};
+const promptWhole = async (state, generateWhole, input, options) => {
+    const startedTurnResult = startTurn(state, "prompt", options);
+    if (!startedTurnResult.ok)
+        return startedTurnResult;
+    const { turn, request } = startedTurnResult.value;
+    try {
+        const answerResult = await generateWhole(input, request);
+        if (!answerResult.ok)
+            return answerResult;
+        if (turn.signal.aborted)
+            return err(abortFailure(turn.signal));
+        completeTurn(state, input, answerResult.value);
+        return answerResult;
+    }
+    catch (error) {
+        return err(toFailure(error));
+    }
+    finally {
+        state.lifetime.end(turn);
+    }
+};
+export const prompt = async (state, input, options) => {
+    const generateWhole = state.model.generateWhole;
+    if (generateWhole !== undefined)
+        return promptWhole(state, generateWhole, input, options);
+    const streamResult = await startStream(state, "prompt", input, options);
+    if (!streamResult.ok)
+        return streamResult;
+    const answerResult = await drainStream(streamResult.value);
+    return answerResult;
+};
+export const promptStream = (state, input, options) => startStream(state, "promptStream", input, options);
+//# sourceMappingURL=04_generate.js.map

package/dist/lifecycle/04_generate.js.map

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

package/dist/lifecycle/05_close.d.ts

@@ -0,0 +1,4 @@
+/** Stage five: the closed phase ends the call in flight and refuses the later ones; the model is released on the one close that does it. */
+import type { SessionState } from "./03_open.js";
+export declare const closeSession: (state: SessionState) => void;
+//# sourceMappingURL=05_close.d.ts.map

package/dist/lifecycle/05_close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"05_close.d.ts","sourceRoot":"","sources":["../../src/lifecycle/05_close.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAE5I,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,eAAO,MAAM,YAAY,GAAI,OAAO,YAAY,KAAG,IAIlD,CAAC"}

package/dist/lifecycle/05_close.js

@@ -0,0 +1,8 @@
+/** Stage five: the closed phase ends the call in flight and refuses the later ones; the model is released on the one close that does it. */
+export const closeSession = (state) => {
+    const closeOutcome = state.lifetime.close();
+    if (closeOutcome === "already-closed")
+        return;
+    state.model.dispose();
+};
+//# sourceMappingURL=05_close.js.map

package/dist/lifecycle/05_close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"05_close.js","sourceRoot":"","sources":["../../src/lifecycle/05_close.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAI5I,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAmB,EAAQ,EAAE;IACxD,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC5C,IAAI,YAAY,KAAK,gBAAgB;QAAE,OAAO;IAC9C,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;AACxB,CAAC,CAAC"}

package/dist/providers/create.d.ts

@@ -0,0 +1,5 @@
+/** The entry: a backend behind the lifecycle is an `AiProvider`. */
+import type { ModelBackend } from "../types/backend.js";
+import type { AiProvider } from "../types/provider.js";
+export declare const createProvider: (backend: ModelBackend) => AiProvider;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/providers/create.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAGpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,cAAc,GAAI,SAAS,YAAY,KAAG,UAGrD,CAAC"}

package/dist/providers/create.js

@@ -0,0 +1,7 @@
+/** The entry: a backend behind the lifecycle is an `AiProvider`. */
+import { checkAccess } from "../lifecycle/01_access.js";
+export const createProvider = (backend) => ({
+    name: backend.name,
+    access: (request) => checkAccess(backend, request),
+});
+//# sourceMappingURL=create.js.map

package/dist/providers/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/providers/create.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAIxD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAqB,EAAc,EAAE,CAAC,CAAC;IACpE,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC;CACnD,CAAC,CAAC"}

package/dist/providers/mock.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A backend with nothing behind it: no daemon, no browser, no network.
+ *
+ * It exists to hold the contract still. `../lifecycle` supplies every
+ * guarantee in `../types`, this file supplies only the model — words in,
+ * words out, a download that never happens — and `../testing/contract.js`
+ * runs against the pair on every commit. A backend that cannot be reached from
+ * a test runner is checked against the same assertions this one passes.
+ */
+import type { AiProvider } from "../types/provider.js";
+export interface MockConfig {
+    /**
+     * Narrow it and one ordinary turn overflows, which is the only way to reach
+     * the `contextoverflow` path without generating for minutes.
+     */
+    readonly contextWindow?: number;
+    /**
+     * The answer, already cut into deltas. More than one, or a caller cannot
+     * tell a stream from a single write.
+     */
+    readonly reply?: (input: string) => readonly string[];
+    /**
+     * What to answer when a caller sends a schema. Absent, the provider refuses
+     * such a call — the contract allows honouring or refusing, never ignoring,
+     * and a mock that answered prose would be the ignoring case.
+     */
+    readonly schemaReply?: string;
+    /** Which branch `access` takes; `ready` unless said otherwise. */
+    readonly access?: "ready" | "unavailable" | "needs-download";
+    /** Progress to report before opening on the `needs-download` branch. */
+    readonly downloadSteps?: readonly number[];
+    /** Milliseconds per delta, and per download step. Zero would make "while the first runs" untestable. */
+    readonly delayMs?: number;
+}
+export declare function makeMockProvider(config?: MockConfig): AiProvider;
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/providers/mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,wGAAwG;IACxG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAyID,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,UAAe,GAAG,UAAU,CAQpE"}

package/dist/providers/mock.js

@@ -0,0 +1,128 @@
+/**
+ * A backend with nothing behind it: no daemon, no browser, no network.
+ *
+ * It exists to hold the contract still. `../lifecycle` supplies every
+ * guarantee in `../types`, this file supplies only the model — words in,
+ * words out, a download that never happens — and `../testing/contract.js`
+ * runs against the pair on every commit. A backend that cannot be reached from
+ * a test runner is checked against the same assertions this one passes.
+ */
+import { err, fraction, ok, tokens, } from "../types/foundations.js";
+import { contextUsage } from "../types/usage.js";
+import { createProvider } from "./create.js";
+const DEFAULTS = {
+    contextWindow: 4096,
+    reply: (input) => {
+        const preview = input.slice(0, 40);
+        const sentence = `Answering «${preview}». `;
+        const words = sentence.match(/\S+\s*/g);
+        return words ?? ["Answer."];
+    },
+    downloadSteps: [0, 0.5, 1],
+    delayMs: 1,
+};
+const NO_SCHEMA_REPLY = {
+    kind: "failed",
+    detail: "no schemaReply configured",
+};
+const ZERO_TOKENS = tokens(0);
+/** Words in, words out: a count that grows the way a real one does, without pretending to be a tokenizer. */
+const countTokens = (text) => {
+    const pieces = text.split(/\s+/);
+    const words = pieces.filter(Boolean);
+    return words.length;
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+class MockModel {
+    #contextWindow;
+    #reply;
+    #schemaReply;
+    #delayMs;
+    #usedTokens = 0;
+    constructor(config, history) {
+        this.#contextWindow = config.contextWindow ?? DEFAULTS.contextWindow;
+        this.#reply = config.reply ?? DEFAULTS.reply;
+        this.#schemaReply = config.schemaReply;
+        this.#delayMs = config.delayMs ?? DEFAULTS.delayMs;
+        // Charged at open, as a real backend charges a transcript it was handed.
+        for (const message of history ?? []) {
+            this.#usedTokens += countTokens(message.content);
+        }
+    }
+    generateStream = (input, request) => {
+        const replyParts = this.#chooseReply(input, request.schema);
+        if (replyParts === null)
+            return Promise.resolve(err(NO_SCHEMA_REPLY));
+        const stream = this.#streamReply(input, replyParts);
+        return Promise.resolve(ok(stream));
+    };
+    usage = () => {
+        const used = tokens(this.#usedTokens) ?? ZERO_TOKENS;
+        return contextUsage(used, this.#contextWindow);
+    };
+    dispose = () => undefined;
+    /** Null is the refusal: a schema with no reply configured for it. */
+    #chooseReply(input, schema) {
+        if (schema === undefined)
+            return this.#reply(input);
+        if (this.#schemaReply === undefined)
+            return null;
+        return [this.#schemaReply];
+    }
+    /** One delta per pull, `delayMs` apart: the pace is what makes "while the first one runs" a reachable state. */
+    #streamReply(input, replyParts) {
+        let index = 0;
+        return new ReadableStream({
+            pull: async (controller) => {
+                await sleep(this.#delayMs);
+                const part = replyParts[index];
+                if (part === undefined) {
+                    this.#charge(input, replyParts.join(""));
+                    controller.close();
+                    return;
+                }
+                index += 1;
+                controller.enqueue(part);
+            },
+        });
+    }
+    #charge(input, answer) {
+        this.#usedTokens += countTokens(input) + countTokens(answer);
+    }
+}
+const getAvailability = (config) => {
+    if (config.access === "unavailable") {
+        return { kind: "unavailable", reason: { kind: "unsupported" } };
+    }
+    if (config.access === "needs-download") {
+        return { kind: "needs-download", started: false };
+    }
+    return { kind: "ready" };
+};
+const reportDownload = async (steps, delayMs, reportProgress) => {
+    for (const step of steps) {
+        await sleep(delayMs);
+        const progress = fraction(step);
+        if (progress !== null)
+            reportProgress(progress);
+    }
+};
+const connectMock = async (config, options) => {
+    if (config.access === "needs-download") {
+        const steps = config.downloadSteps ?? DEFAULTS.downloadSteps;
+        const delayMs = config.delayMs ?? DEFAULTS.delayMs;
+        await reportDownload(steps, delayMs, options.reportProgress);
+    }
+    const model = new MockModel(config, options.session.history);
+    return ok(model);
+};
+export function makeMockProvider(config = {}) {
+    const backend = {
+        name: "mock",
+        modalities: ["text"],
+        availability: () => getAvailability(config),
+        connect: (options) => connectMock(config, options),
+    };
+    return createProvider(backend);
+}
+//# sourceMappingURL=mock.js.map

package/dist/providers/mock.js.map

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

package/dist/providers/ollama.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 type { AiProvider } from "../types/provider.js";
+export interface OllamaConfig {
+    /** The tag as `/api/tags` lists it, such as `granite4:350m`. */
+    readonly model: string;
+    /**
+     * `127.0.0.1` and not `localhost`: the daemon binds the one, and the name
+     * can resolve to the other family first and refuse the connection.
+     */
+    readonly host?: string;
+    /**
+     * Sent as `num_ctx`, and therefore the window in force rather than a guess
+     * at one. The default matches the daemon's own; a model that can take more
+     * will, at the price of the memory the cache for it costs.
+     */
+    readonly contextWindow?: number;
+    /** For a proxy, an auth header, or a test with no daemon behind it. */
+    readonly fetch?: typeof globalThis.fetch;
+}
+export declare function makeOllamaProvider(config: OllamaConfig): AiProvider;
+//# sourceMappingURL=ollama.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/providers/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIvD,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C;AA+TD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAQnE"}