npm - modelpact-providers - Versions diffs - 1.1.0 → 1.2.0 - Mend

modelpact-providers 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md CHANGED Viewed

@@ -6,14 +6,15 @@
 [![license: MIT](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)
 **The transports for [modelpact](https://github.com/AvdienkoSergey/modelpact):
-a daemon on your machine, the model inside Chrome, and a model in the tab
-itself. Three backends, one dialect, and the contract suite green on each.**
+a daemon on your machine, any OpenAI-compatible server, the model inside
+Chrome, and a model in the tab itself. Four backends, one contract, and that
+contract's suite green on each.**
 The engine holds the contract, the lifecycle and one backend with nothing
 behind it. This package holds the ones with something behind them. They are
-apart because they change for different reasons: a daemon's JSON, a browser's
-origin trial and a WebGPU runtime each move on their own clock, and none of
-them should move the contract.
+apart because they change for different reasons: a daemon's JSON, a hosted
+API's dialect, a browser's origin trial and a WebGPU runtime each move on their
+own clock, and none of them should move the contract.
 ## Install
@@ -24,13 +25,14 @@ npm install modelpact-providers modelpact
 `modelpact` is a peer dependency: this package is written against its contract
 and carries no copy of it.
-## The three
+## The four
-| Provider                | Reaches                           | Wants                                   | Import from                  |
-| ----------------------- | --------------------------------- | --------------------------------------- | ---------------------------- |
-| `makeOllamaProvider`    | a daemon over HTTP, usually local | Ollama on `127.0.0.1:11434`             | `modelpact-providers`        |
-| `makePromptApiProvider` | Chrome's built-in Gemini Nano     | Chrome, and the weights downloaded once | `modelpact-providers`        |
-| `makeWebGpuProvider`    | a model in the tab, on WebGPU     | `@mlc-ai/web-llm`, and a GPU            | `modelpact-providers/webgpu` |
+| Provider                | Reaches                                   | Wants                                              | Import from                  |
+| ----------------------- | ----------------------------------------- | -------------------------------------------------- | ---------------------------- |
+| `makeOllamaProvider`    | a daemon over HTTP, usually local         | Ollama on `127.0.0.1:11434`                        | `modelpact-providers`        |
+| `makeOpenAiProvider`    | anything speaking the OpenAI HTTP dialect | a `baseUrl`; a key only where the server wants one | `modelpact-providers`        |
+| `makePromptApiProvider` | Chrome's built-in Gemini Nano             | Chrome, and the weights downloaded once            | `modelpact-providers`        |
+| `makeWebGpuProvider`    | a model in the tab, on WebGPU             | `@mlc-ai/web-llm`, and a GPU                       | `modelpact-providers/webgpu` |
 ```ts
 import { makeOllamaProvider } from "modelpact-providers";
@@ -41,14 +43,15 @@ const opened = await access.open({ system: "Answer in one sentence." });
 ```
 Everything after the provider line is the contract's, and identical across the
-three — see [modelpact's README](https://github.com/AvdienkoSergey/modelpact#readme)
+four — see [modelpact's README](https://github.com/AvdienkoSergey/modelpact#readme)
 for what a session promises.
 ## Two entries, and the reason
-`modelpact-providers` is the two that cost a consumer nothing: `fetch` and JSON
-for the daemon, a global for the browser's own model, no runtime dependency
-behind either. `modelpact-providers/webgpu` is the third, because it carries
+`modelpact-providers` is the three that cost a consumer nothing: `fetch` and
+JSON for the daemon and for the OpenAI dialect, a global for the browser's own
+model, no runtime dependency behind any of them.
+`modelpact-providers/webgpu` is the fourth, because it carries
 `@mlc-ai/web-llm` — an optional peer dependency, so an app on the daemon never
 installs it. The split is by dependency, not by kind: the same reason
 `modelpact/testing` is a separate entry for `vitest`.
@@ -62,6 +65,27 @@ carries the counts, a pull line carries `completed` and `total` per layer, and
 an error is an HTTP status with a body. The daemon keeps nothing between
 requests, so the session's record is resent whole every turn.
+**An OpenAI-compatible server.** A dialect rather than a company:
+`https://api.openai.com/v1` is the default and one instance of it, and the same
+two endpoints answer on vLLM, llama.cpp, LM Studio, OpenRouter, Groq and
+Ollama's own `/v1`. So `baseUrl` is the whole difference between them and
+`apiKey` is optional — a model on your machine wants no key, and a type that
+demanded one would be describing a service instead of a protocol. It is also
+the only backend here that never answers `needs-download`: the weights are the
+server's problem, and there is nothing this side could fetch.
+Two things the wire does that the daemon next door does not, and both are
+handled rather than assumed: a tool call arrives fragmented across frames,
+keyed by `index`, with its arguments as a JSON string rather than an object;
+and the counts arrive in a frame of their own after the last one carrying text,
+which is what `stream_options: { include_usage: true }` asks for.
+`contextWindow` is optional, and absent it `usage()` answers `unknown`. No
+server in this dialect reports the window it loaded a model with, so a number
+there is your declaration, not a discovery — and being a declaration is what
+makes it a budget too: a transcript past it is an overflow, told by the counts
+rather than by the server.
 **Chrome's built-in model.** The one backend that keeps the conversation
 itself: `LanguageModel` is a session object and `prompt()` appends to it, so
 the record travels with the session rather than in the request. It fires its
@@ -80,14 +104,15 @@ was, and it needed nothing added to the contract.
 ## Tools
-All three accept `ModelRequest.tools`, and each executes them the way its
+All four accept `ModelRequest.tools`, and each executes them the way its
 transport can.
-| Provider   | How a call happens                                                                                |
-| ---------- | ------------------------------------------------------------------------------------------------- |
-| Ollama     | native `tool_calls`, answered under the `tool` role, in rounds bounded by `maxToolRounds`         |
-| Prompt API | handed to `create()`, and the browser calls `execute` itself                                      |
-| WebGPU     | not yet: the request is refused at `access`, which is the contract's answer for a backend without |
+| Provider   | How a call happens                                                                                  |
+| ---------- | --------------------------------------------------------------------------------------------------- |
+| Ollama     | native `tool_calls`, answered under the `tool` role, in rounds bounded by `maxToolRounds`           |
+| OpenAI     | the same, tied by `tool_call_id` rather than by name, so two calls to one tool in a turn stay apart |
+| Prompt API | handed to `create()`, and the browser calls `execute` itself                                        |
+| WebGPU     | not yet: the request is refused at `access`, which is the contract's answer for a backend without   |
 Chrome 152 answers `available` to `availability()` with tools and then throws
 `InvalidStateError` from `create()` — measured, and it arrives as a refusal at
@@ -124,19 +149,131 @@ Three tsconfigs, and each has one job:
 | [`tsconfig.patched.json`](tsconfig.patched.json) | everything but WebGPU, with `skipLibCheck` off — the patch, still applying |
 | [`tsconfig.surface.json`](tsconfig.surface.json) | the emitted declarations, as a consumer receives them                      |
+[`demo/tsconfig.json`](demo/tsconfig.json) is the fourth, and the only one that
+is an application rather than a check: `types: ["vite/client"]`, no ambient
+Prompt API and no `@mlc-ai/web-llm`, which is the same claim made by code that
+actually imports and calls the things. It is where the demo caught the
+`MLCEngineInterface` leak the first time.
 ## Scripts
 | Script                  | What it does                                           |
 | ----------------------- | ------------------------------------------------------ |
-| `npm run typecheck`     | both source configs                                    |
+| `npm run typecheck`     | both source configs, and the specs                     |
 | `npm run lint`          | ESLint, type-aware                                     |
 | `npm run format:check`  | Prettier, check only                                   |
 | `npm test`              | Vitest; the Ollama contract suite skips with no daemon |
+| `npm run test:e2e`      | Playwright; starts the demo itself                     |
 | `npm run check:surface` | builds, then reads the declarations from outside       |
+| `npm run demo`          | the demo on a dev server                               |
+| `npm run demo:check`    | the demo's own tsconfig — a consumer with no `@types`  |
 | `npm run build`         | `dist/` — JS, declarations, maps                       |
-The Ollama suite wants a daemon on `127.0.0.1:11434` holding `granite4:350m`.
-Without one it skips loudly rather than passing quietly.
+The Ollama suite wants a daemon on `127.0.0.1:11434` holding `granite4:350m`,
+and the OpenAI suite wants an OpenAI-compatible server — that same daemon's
+`/v1`, by default, which is a genuine third-party implementation of the dialect
+and already there. Without one, each skips loudly rather than passing quietly.
+## The demo
+[`demo/`](demo) is a chat with all four transports behind one picker, and
+nothing else behind it: no mock, because the engine's demo has one and this
+repository is about what happens when there is something on the other end. On a
+machine with no daemon, no Gemini Nano and no GPU, every entry therefore answers
+`unavailable` — honest, and dull. A daemon on `127.0.0.1:11434` holding
+`granite4:350m` is what makes two of the four entries answer.
+```sh
+npm install
+npm run demo
+```
+It takes `modelpact` from npm, at the version a stranger would get, and this
+package from `file:..` through its own `exports` — so what runs in the page is
+`dist/`, never `src/`. Both land on one copy of the engine because `demo` is a
+workspace of this repository; the reason that matters, and what breaks without
+it, is in [`demo/README.md`](demo/README.md).
+Export `OPENAI_API_KEY` before `npm run demo` and the `openai` entry reaches
+`api.openai.com` instead of the daemon, through a dev-server proxy that holds
+the key in Node — the page is never told it, and a build never carries it. See
+[`demo/README.md`](demo/README.md#pointing-it-at-hosted-openai).
+It also type-checks itself with `types: ["vite/client"]` and nothing else,
+which makes it the second half of the surface guard above: a declaration that
+needs an ambient global fails in an app that never installed one.
+## The browser suite
+[`e2e/demo-e2e.spec.ts`](e2e/demo-e2e.spec.ts) drives the demo in Chromium.
+```sh
+npx playwright install chromium   # once
+npm run test:e2e                  # the demo server starts itself
+```
+Eleven specs. The vitest suites next to each backend check its logic against
+the contract from node; these check what node cannot see:
+- a page is not node. `fetch` held on its own throws `Illegal invocation` in
+  one and works in the other, and that bug is invisible to any vitest run;
+- `LanguageModel` and `navigator.gpu` exist in a browser and nowhere else, so
+  the Prompt API and WebGPU backends have their first real `availability()`
+  call here;
+- the emitted `.d.ts` files, a bundler, and React sit between the app and the
+  backend, which no unit test reproduces.
+Seven of them want a daemon and skip without one — everything that needs a
+session to actually open, which since the mock left the picker means every
+promise the contract makes about a session. That is the cost of a demo about
+transports, and it is paid where it belongs: CI installs a daemon for this job.
+The other four assert a branch rather than a machine, and are green anywhere. A
+runner with no Gemini Nano and no GPU still has `unavailable` to land on, and
+landing on it is the claim. Both HTTP transports get their refusal answer on
+every machine too, including a laptop with Ollama running, because that spec
+refuses the connection itself rather than waiting for a machine without one.
+## CI
+[`.github/workflows/ci.yml`](.github/workflows/ci.yml) has three jobs, and each
+can go red on its own:
+| Job      | Runs                                                                     |
+| -------- | ------------------------------------------------------------------------ |
+| `check`  | typecheck, lint, format, vitest, `check:surface` — one install, no model |
+| `ollama` | the same vitest suites with a daemon answering                           |
+| `e2e`    | Playwright against the demo, with a daemon, in Chromium                  |
+**Adding the browser suite to a fork or another pipeline** is four steps:
+```yaml
+- uses: actions/setup-node@v7
+  with:
+    node-version-file: .nvmrc
+    cache: npm
+# `demo` is a workspace, so this installs it too — and puts one copy of
+# `modelpact` where both it and this package find it.
+- run: npm ci
+- run: npx playwright install --with-deps chromium
+- run: npm run test:e2e
+```
+`npm run test:e2e` starts the demo itself, and the demo's `predev` builds
+`dist/` first, so there is no build step to add and no server to start.
+Two options on top of that:
+- **A daemon**, which is not really optional any more: half the specs skip
+  without one. Install Ollama, `ollama serve`, `ollama pull granite4:350m`, and
+  cache `~/.ollama/models` — the `e2e` job does exactly this, restore-only,
+  sharing the key the `ollama` job saves. Without it the suite still passes,
+  on the four specs that assert a branch rather than a session.
+- **The report on failure**, which is `actions/upload-artifact` over
+  `playwright-report/`. Playwright writes it whether or not anyone collects it.
+Nothing here needs a GPU or a Chrome with Gemini Nano. Those two backends
+answer `unavailable` on a plain runner, and the specs assert the branch.
 ## Releases

package/dist/index.d.ts CHANGED Viewed

@@ -1,12 +1,14 @@
 /**
  * The transports that cost a consumer nothing but this package: `fetch` and
- * JSON for the daemon, a global for the browser's own model, no runtime
- * dependency behind either. Import one and a bundler drops the other.
+ * JSON for the daemon and for the OpenAI dialect, a global for the browser's
+ * own model, no runtime dependency behind any of them. Import one and a
+ * bundler drops the rest.
  *
  * The WebGPU backend is `modelpact-providers/webgpu` instead, because it
  * carries `@mlc-ai/web-llm` — a separate entry for a separate dependency, the
  * way `modelpact/testing` is separate for `vitest`.
  */
 export { makeOllamaProvider, type OllamaConfig } from "./ollama.js";
+export { makeOpenAiProvider, type OpenAiConfig } from "./openai.js";
 export { makePromptApiProvider } from "./prompt-api.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;GAQG~~;AAEH,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js CHANGED Viewed

@@ -1,12 +1,14 @@
 /**
  * The transports that cost a consumer nothing but this package: `fetch` and
- * JSON for the daemon, a global for the browser's own model, no runtime
- * dependency behind either. Import one and a bundler drops the other.
+ * JSON for the daemon and for the OpenAI dialect, a global for the browser's
+ * own model, no runtime dependency behind any of them. Import one and a
+ * bundler drops the rest.
  *
  * The WebGPU backend is `modelpact-providers/webgpu` instead, because it
  * carries `@mlc-ai/web-llm` — a separate entry for a separate dependency, the
  * way `modelpact/testing` is separate for `vitest`.
  */
 export { makeOllamaProvider } from "./ollama.js";
+export { makeOpenAiProvider } from "./openai.js";
 export { makePromptApiProvider } from "./prompt-api.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;GAQG~~;AAEH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/openai.d.ts ADDED Viewed

@@ -0,0 +1,60 @@
+/**
+ * An OpenAI-compatible server, which is a dialect rather than a company.
+ *
+ * `https://api.openai.com/v1` is the default and one instance of it. The same
+ * two endpoints answer on vLLM, llama.cpp, LM Studio, OpenRouter, Groq and
+ * Ollama's own compatibility layer, so `baseUrl` is the whole difference
+ * between them and `apiKey` is optional — a model on this machine wants no key,
+ * and a type that demanded one would be describing a service instead of a
+ * protocol.
+ *
+ * Two endpoints are the whole backend: `/models` says what is served,
+ * `/chat/completions` generates. There is no third, because there is nothing to
+ * download — the weights are the server's problem, which is why this is the one
+ * backend here that never answers `needs-download`.
+ *
+ * Shapes were read off the wire, not off the docs: a stream is Server-Sent
+ * Events whose last frame carries the counts, a tool call arrives in fragments
+ * keyed by `index` with its arguments as a JSON string rather than an object,
+ * and an error is an HTTP status with `{"error": {"message": "…"}}` — or with
+ * `{"error": "…"}`, which is what several compatible servers send instead.
+ */
+import { type AiProvider } from "modelpact/backend";
+export interface OpenAiConfig {
+    /** The id as `/models` lists it, such as `gpt-4o-mini` or `qwen2.5-coder`. */
+    readonly model: string;
+    /**
+     * Up to and including the version segment, because that is where servers
+     * disagree: OpenAI serves `/v1`, LM Studio serves `/v1`, and a proxy can
+     * serve neither. A trailing slash is trimmed rather than doubled into the
+     * path.
+     */
+    readonly baseUrl?: string;
+    /**
+     * Absent, no `Authorization` header is sent at all — which is what a local
+     * server wants, and what an unauthenticated one refuses. Note where this
+     * ends up: a key in a browser bundle is a key handed to everyone who loads
+     * the page. Point `baseUrl` at your own server there and keep the key on it.
+     */
+    readonly apiKey?: string;
+    /**
+     * The window to measure against. Optional and defaulted to nothing on
+     * purpose: no OpenAI-compatible server reports the window it loaded a model
+     * with, so a number here is the caller's declaration and not a discovery.
+     * Absent, `usage()` answers `unknown` rather than inventing a denominator.
+     *
+     * Declared, it is also a budget: a transcript past it is an overflow, told
+     * by the counts rather than by the server. See `#hasSpentTheWindow`.
+     */
+    readonly contextWindow?: number;
+    /** For a proxy, an extra header, or a test with no server behind it. */
+    readonly fetch?: typeof globalThis.fetch;
+    /**
+     * How many times one turn may come back with tool calls before it is failed.
+     * Per turn, not per session: a model that keeps asking spends the window on
+     * its own questions and never answers.
+     */
+    readonly maxToolRounds?: number;
+}
+export declare function makeOpenAiProvider(config: OpenAiConfig): AiProvider;
+//# sourceMappingURL=openai.d.ts.map

package/dist/openai.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../src/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAYL,KAAK,UAAU,EAUhB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAgnBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CASnE"}

package/dist/openai.js ADDED Viewed

@@ -0,0 +1,488 @@
+/**
+ * An OpenAI-compatible server, which is a dialect rather than a company.
+ *
+ * `https://api.openai.com/v1` is the default and one instance of it. The same
+ * two endpoints answer on vLLM, llama.cpp, LM Studio, OpenRouter, Groq and
+ * Ollama's own compatibility layer, so `baseUrl` is the whole difference
+ * between them and `apiKey` is optional — a model on this machine wants no key,
+ * and a type that demanded one would be describing a service instead of a
+ * protocol.
+ *
+ * Two endpoints are the whole backend: `/models` says what is served,
+ * `/chat/completions` generates. There is no third, because there is nothing to
+ * download — the weights are the server's problem, which is why this is the one
+ * backend here that never answers `needs-download`.
+ *
+ * Shapes were read off the wire, not off the docs: a stream is Server-Sent
+ * Events whose last frame carries the counts, a tool call arrives in fragments
+ * keyed by `index` with its arguments as a JSON string rather than an object,
+ * and an error is an HTTP status with `{"error": {"message": "…"}}` — or with
+ * `{"error": "…"}`, which is what several compatible servers send instead.
+ */
+import { AiError, contextUsage, createProvider, err, findTool, ndjsonLines, ok, runTool, tokens, } from "modelpact/backend";
+const DEFAULTS = {
+    baseUrl: "https://api.openai.com/v1",
+    maxToolRounds: 8,
+};
+const asRecord = (value) => {
+    const isObject = typeof value === "object" && value !== null;
+    return isObject && !Array.isArray(value)
+        ? value
+        : null;
+};
+const asArray = (value) => Array.isArray(value) ? value : [];
+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;
+    }
+};
+/**
+ * `baseUrl` without its trailing slashes, walked rather than matched.
+ *
+ * `/\/+$/` is a polynomial backtrack: on a long run of slashes the engine
+ * retries the greedy `\/+` from every position in it before `$` can fail. That
+ * is harmless on a URL somebody typed into a config and not harmless as a
+ * published API, where a consumer is free to build this string from something a
+ * user sent — which is what CodeQL means by uncontrolled, and it is right. An
+ * index walk is linear and says plainly what it does.
+ */
+const withoutTrailingSlashes = (url) => {
+    let end = url.length;
+    while (end > 0 && url[end - 1] === "/")
+        end -= 1;
+    return url.slice(0, end);
+};
+const toEndpoint = (config) => ({
+    baseUrl: withoutTrailingSlashes(config.baseUrl ?? DEFAULTS.baseUrl),
+    headers: config.apiKey === undefined
+        ? {}
+        : { authorization: `Bearer ${config.apiKey}` },
+    // 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.
+    call: config.fetch ?? globalThis.fetch.bind(globalThis),
+});
+const postTo = (endpoint, path, body, signal) => endpoint.call(`${endpoint.baseUrl}${path}`, {
+    method: "POST",
+    headers: { ...endpoint.headers, "content-type": "application/json" },
+    body: JSON.stringify(body),
+    ...(signal === undefined ? {} : { signal }),
+});
+/** `{"error": {"message": "…"}}` is OpenAI's; `{"error": "…"}` is what several compatible servers send. */
+const readErrorText = (body) => {
+    const errorValue = asRecord(body)?.error;
+    return asString(errorValue) ?? asString(asRecord(errorValue)?.message);
+};
+const failureFromResponse = async (response) => {
+    const text = await response.text().catch(() => "");
+    const detail = readErrorText(parseJson(text)) ?? `${response.status} from the server`;
+    // Three moves, three kinds. 400 is this side building the request badly; 401
+    // and 403 are the key, which no retry of the same request will fix; anything
+    // else — a 404 on a wrong `baseUrl`, a 429, a 500 — is the server's own
+    // trouble, and the detail is where it says which.
+    if (response.status === 400)
+        return { kind: "invalid-input", detail };
+    if (response.status === 401 || response.status === 403)
+        return { kind: "not-allowed" };
+    return { kind: "failed", detail };
+};
+const listModels = async (endpoint) => {
+    const response = await endpoint.call(`${endpoint.baseUrl}/models`, {
+        headers: endpoint.headers,
+    });
+    if (response.status === 401 || response.status === 403)
+        return { kind: "refused" };
+    if (!response.ok)
+        return { kind: "unlisted" };
+    const listed = asArray(asRecord(await response.json().catch(() => null))?.data);
+    const names = listed
+        .map((entry) => asString(asRecord(entry)?.id))
+        .filter((name) => name !== null);
+    return names.length === 0 ? { kind: "unlisted" } : { kind: "listed", names };
+};
+const getAvailability = async (config) => {
+    const endpoint = toEndpoint(config);
+    let listing;
+    try {
+        listing = await listModels(endpoint);
+    }
+    catch (cause) {
+        // Nothing answering is not a failed request, it is no server here.
+        return { kind: "unavailable", reason: { kind: "unsupported", cause } };
+    }
+    if (listing.kind === "refused")
+        return { kind: "unavailable", reason: { kind: "not-allowed" } };
+    // A listing that named models and did not name this one is the one case
+    // where the absence is evidence.
+    if (listing.kind === "listed" && !listing.names.includes(config.model))
+        return {
+            kind: "unavailable",
+            reason: { kind: "unsupported-config", languages: [] },
+        };
+    return { kind: "ready" };
+};
+const toWireTools = (tools) => tools.map((tool) => ({
+    type: "function",
+    function: {
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.inputSchema,
+    },
+}));
+/**
+ * Server-Sent Events, as much of the protocol as a chat completion uses:
+ * frames separated by a blank line, one `data:` field each, and a last frame
+ * of `[DONE]`.
+ *
+ * `ndjsonLines` upstream does the cutting and drops the blank separators, so
+ * what arrives here is one field per call. Anything that is not `data:` is a
+ * field this protocol does not send — a `:` keep-alive comment from a proxy is
+ * the one seen in practice, and dropping it is the whole handling it needs.
+ */
+const serverSentData = () => new TransformStream({
+    transform: (line, controller) => {
+        if (!line.startsWith("data:"))
+            return;
+        const data = line.slice("data:".length).trim();
+        if (data === "" || data === "[DONE]")
+            return;
+        controller.enqueue(data);
+    },
+});
+/**
+ * A call arrives in pieces: the id and the name once, the arguments as
+ * fragments of one JSON string, every piece carrying the `index` it belongs to.
+ * Concatenating in arrival order without that key would interleave two calls
+ * made in the same turn into one unparseable string.
+ */
+const readToolCallDeltas = (delta, drafts) => {
+    for (const listed of asArray(delta?.tool_calls)) {
+        const listedCall = asRecord(listed);
+        // A server that omits `index` is sending one call at a time, so the count
+        // so far is the key it would have used.
+        const index = asNumber(listedCall?.index) ?? drafts.size;
+        const draft = drafts.get(index) ?? {
+            id: null,
+            name: null,
+            argumentParts: [],
+        };
+        drafts.set(index, draft);
+        draft.id ??= asString(listedCall?.id);
+        const calledFunction = asRecord(listedCall?.function);
+        draft.name ??= asString(calledFunction?.name);
+        const argumentPart = asString(calledFunction?.arguments);
+        if (argumentPart !== null)
+            draft.argumentParts.push(argumentPart);
+    }
+};
+/** In `index` order, because that is the order the model made them in; one with no name never happened. */
+const toToolCalls = (drafts) => {
+    const indexes = [...drafts.keys()].sort((one, other) => one - other);
+    const calls = [];
+    for (const index of indexes) {
+        const draft = drafts.get(index);
+        if (draft?.name == null)
+            continue;
+        calls.push({
+            // Several compatible servers leave the id out. The next round needs one
+            // to tie each answer to its call, so an index-shaped one stands in.
+            id: draft.id ?? `call_${index}`,
+            type: "function",
+            function: { name: draft.name, arguments: draft.argumentParts.join("") },
+        });
+    }
+    return calls;
+};
+/** Whatever the model sent, read as an object; a fragmented string that never closed is no arguments at all. */
+const toToolInput = (call) => asRecord(parseJson(call.function.arguments)) ?? {};
+const readWhole = async (stream) => {
+    const reader = stream.getReader();
+    const parts = [];
+    try {
+        for (;;) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                return ok(parts.join(""));
+            parts.push(chunk.value);
+        }
+    }
+    catch (error) {
+        return err(error instanceof AiError
+            ? error.failure
+            : { kind: "failed", detail: "the chat stream broke", cause: error });
+    }
+};
+class OpenAiModel {
+    #endpoint;
+    #model;
+    #contextWindow;
+    #system;
+    #tools;
+    #maxToolRounds;
+    #reportOverflow;
+    /** 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;
+        this.#system = options.session.system;
+        this.#tools = options.request.tools ?? [];
+        this.#maxToolRounds = config.maxToolRounds ?? DEFAULTS.maxToolRounds;
+        this.#reportOverflow = options.reportOverflow;
+    }
+    generateStream = async (input, request) => {
+        const conversation = this.#toConversation(input, request);
+        const responseResult = await this.#chat(conversation, 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" });
+        return ok(this.#streamRounds(body, conversation, request));
+    };
+    generateWhole = async (input, request) => {
+        // A turn with tools is rounds, and rounds are the streaming path read to
+        // its end; only a plain turn has a whole-answer call worth a second shape.
+        if (this.#tools.length > 0) {
+            const streamResult = await this.generateStream(input, request);
+            return streamResult.ok ? readWhole(streamResult.value) : streamResult;
+        }
+        const conversation = this.#toConversation(input, request);
+        const responseResult = await this.#chat(conversation, 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 choice = asRecord(asArray(parsedBody.choices)[0]);
+        const answerText = asString(asRecord(choice?.message)?.content);
+        if (answerText === null)
+            return err({ kind: "failed", detail: "the chat sent no message" });
+        this.#charge(asRecord(parsedBody.usage), asString(choice?.finish_reason));
+        return ok(answerText);
+    };
+    usage = () => {
+        if (this.#contextWindow === undefined)
+            return { kind: "unknown" };
+        const used = tokens(this.#usedTokens) ?? ZERO_TOKENS;
+        return contextUsage(used, this.#contextWindow);
+    };
+    /**
+     * Nothing to release. The connection is one `fetch` per turn and the server
+     * keeps nothing between them, so there is no session on the other end to
+     * close.
+     */
+    dispose = () => undefined;
+    #toConversation(input, request) {
+        const askedMessage = { role: "user", content: input };
+        const conversation = [...request.history, askedMessage];
+        // A real role here, unlike the daemon next door: this dialect has one, and
+        // a server that prefers `developer` maps `system` onto it itself.
+        return this.#system === undefined
+            ? conversation
+            : [{ role: "system", content: this.#system }, ...conversation];
+    }
+    async #chat(messages, request, stream) {
+        const body = {
+            model: this.#model,
+            messages,
+            stream,
+            // Only with `stream`: sent alongside `stream: false` it is a 400.
+            ...(stream ? { stream_options: { include_usage: true } } : {}),
+            ...(request.schema === undefined
+                ? {}
+                : {
+                    response_format: {
+                        type: "json_schema",
+                        json_schema: { name: "answer", schema: request.schema },
+                    },
+                }),
+            ...(this.#tools.length === 0 ? {} : { tools: toWireTools(this.#tools) }),
+        };
+        const response = await postTo(this.#endpoint, "/chat/completions", body, request.signal);
+        return response.ok
+            ? ok(response)
+            : err(await failureFromResponse(response));
+    }
+    /**
+     * Rounds: an answer is read to its end, and where it ends in tool calls the
+     * calls are answered and the conversation sent again. Only text reaches the
+     * caller, so a turn that is all calls is silent until its last round.
+     * Bounded, because a model that keeps calling would spend the window on it.
+     */
+    #streamRounds(firstBody, firstConversation, request) {
+        let conversation = firstConversation;
+        let currentRound = this.#openRound(firstBody);
+        let roundsTaken = 0;
+        const advance = async (controller) => {
+            for (;;) {
+                const chunk = await currentRound.reader.read();
+                if (!chunk.done) {
+                    controller.enqueue(chunk.value);
+                    return;
+                }
+                const calls = toToolCalls(currentRound.drafts);
+                if (calls.length === 0) {
+                    controller.close();
+                    return;
+                }
+                roundsTaken += 1;
+                if (roundsTaken > this.#maxToolRounds) {
+                    throw new AiError({
+                        kind: "failed",
+                        detail: `the model called tools ${roundsTaken} times without answering`,
+                    });
+                }
+                conversation = await this.#answerToolCalls(conversation, currentRound.contentParts.join(""), calls, request.signal);
+                const nextResult = await this.#chat(conversation, request, true);
+                if (!nextResult.ok)
+                    throw new AiError(nextResult.error);
+                const nextBody = nextResult.value.body;
+                if (nextBody === null)
+                    throw new AiError({
+                        kind: "failed",
+                        detail: "the chat sent no body",
+                    });
+                currentRound = this.#openRound(nextBody);
+            }
+        };
+        return new ReadableStream({
+            pull: (controller) => advance(controller),
+            cancel: (reason) => currentRound.reader.cancel(reason),
+        });
+    }
+    /**
+     * Content out, calls and counts kept.
+     *
+     * `finish_reason` and the counts arrive in different frames — the reason on
+     * the last frame that has a choice, the counts on one after it whose
+     * `choices` is empty — so the reason is remembered and every frame from there
+     * on charges. `reportOverflow` is idempotent, which is what makes charging
+     * twice cost nothing; a server that ignored `stream_options` and sent no
+     * counts at all still reaches the `length` half of the check.
+     */
+    #openRound(body) {
+        const contentParts = [];
+        const drafts = new Map();
+        let finishReason = null;
+        const readFrames = new TransformStream({
+            transform: (data, controller) => {
+                const frame = asRecord(parseJson(data));
+                if (frame === null)
+                    return;
+                const errorText = readErrorText(frame);
+                if (errorText !== null)
+                    throw new AiError({ kind: "failed", detail: errorText });
+                const choice = asRecord(asArray(frame.choices)[0]);
+                finishReason = asString(choice?.finish_reason) ?? finishReason;
+                const usage = asRecord(frame.usage);
+                if (usage !== null || finishReason !== null)
+                    this.#charge(usage, finishReason);
+                const delta = asRecord(choice?.delta);
+                readToolCallDeltas(delta, drafts);
+                const text = asString(delta?.content) ?? "";
+                if (text === "")
+                    return;
+                contentParts.push(text);
+                controller.enqueue(text);
+            },
+        });
+        const deltas = body
+            .pipeThrough(new TextDecoderStream())
+            .pipeThrough(ndjsonLines())
+            .pipeThrough(serverSentData())
+            .pipeThrough(readFrames);
+        return { reader: deltas.getReader(), contentParts, drafts };
+    }
+    /**
+     * The model's call goes back as its own turn, then each answer under the
+     * `tool` role tied to it by `tool_call_id` — the dialect matches answers to
+     * calls by id, not by name, so two calls to the same tool in one turn stay
+     * apart. A name the model made up is answered rather than failing the turn:
+     * the model can pick again, where a failed turn could not. A tool that throws
+     * cannot be answered for, and ends the turn.
+     */
+    async #answerToolCalls(conversation, saidText, calls, signal) {
+        const answered = [
+            ...conversation,
+            { role: "assistant", content: saidText, tool_calls: calls },
+        ];
+        for (const call of calls) {
+            const name = call.function.name;
+            const tool = findTool(this.#tools, name);
+            if (tool === undefined) {
+                answered.push({
+                    role: "tool",
+                    content: `there is no tool called "${name}"`,
+                    tool_call_id: call.id,
+                });
+                continue;
+            }
+            const toolResult = await runTool(tool, toToolInput(call), signal);
+            if (!toolResult.ok)
+                throw new AiError(toolResult.error);
+            answered.push({
+                role: "tool",
+                content: toolResult.value,
+                tool_call_id: call.id,
+            });
+        }
+        return answered;
+    }
+    /**
+     * `prompt_tokens` 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. `total_tokens` is preferred where
+     * the server sends it, because a server that bills for reasoning tokens puts
+     * them there and in neither of the other two.
+     */
+    #charge(usage, finishReason) {
+        if (usage !== null) {
+            const promptTokens = asNumber(usage.prompt_tokens) ?? 0;
+            const answerTokens = asNumber(usage.completion_tokens) ?? 0;
+            this.#usedTokens =
+                asNumber(usage.total_tokens) ?? promptTokens + answerTokens;
+        }
+        if (this.#hasSpentTheWindow(finishReason))
+            this.#reportOverflow();
+    }
+    /**
+     * Two ways to learn it, and they are independent.
+     *
+     * The server can say so: `max_tokens` is deliberately never sent, so
+     * `finish_reason: "length"` can only mean the model ran out of context. And
+     * the counts can say so against a `contextWindow` the caller declared, which
+     * is the only reading available for a server that stopped without saying why
+     * — and the only one at all for the many that never report a window.
+     */
+    #hasSpentTheWindow(finishReason) {
+        if (finishReason === "length")
+            return true;
+        return (this.#contextWindow !== undefined &&
+            this.#usedTokens >= this.#contextWindow);
+    }
+}
+const ZERO_TOKENS = tokens(0);
+/**
+ * Nothing to do but hand back a connection. There are no weights to fetch and
+ * no session to open on the far side — `availability` already asked the only
+ * question there was, and every turn is a request of its own.
+ */
+const connectOpenAi = (config, options) => Promise.resolve(ok(new OpenAiModel(config, options)));
+export function makeOpenAiProvider(config) {
+    const backend = {
+        name: "openai",
+        modalities: ["text"],
+        tools: true,
+        availability: () => getAvailability(config),
+        connect: (options) => connectOpenAi(config, options),
+    };
+    return createProvider(backend);
+}
+//# sourceMappingURL=openai.js.map

package/dist/openai.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json CHANGED Viewed

@@ -1,12 +1,14 @@
 {
   "name": "modelpact-providers",
-  "version": "1.1.0",
-  "description": "Language-model backends written against the modelpact contract — one transport per runtime, each green on the contract suite",
+  "version": "1.2.0",
+  "description": "Language-model backends written against the modelpact contract — a daemon, the OpenAI dialect, the browser's own model, one in the tab, each green on the contract suite",
   "keywords": [
     "llm",
     "modelpact",
     "typescript",
     "ollama",
+    "openai",
+    "openai-compatible",
     "prompt-api",
     "webgpu",
     "on-device",
@@ -37,6 +39,9 @@
   "files": [
     "dist"
   ],
+  "workspaces": [
+    "demo"
+  ],
   "sideEffects": false,
   "engines": {
     "node": ">=22"
@@ -46,11 +51,14 @@
     "build": "tsc -p tsconfig.build.json",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "demo": "npm --prefix demo run dev",
+    "demo:check": "npm --prefix demo run typecheck",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.patched.json",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.patched.json && tsc -p e2e --noEmit",
     "check:surface": "npm run build && tsc -p tsconfig.surface.json",
     "prepublishOnly": "npm run build"
   },
@@ -60,12 +68,13 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@playwright/test": "^1.62.1",
     "@mlc-ai/web-llm": "^0.2.84",
     "@types/dom-chromium-ai": "^0.0.17",
     "@types/node": "^26.4.1",
     "eslint": "^10.9.1",
     "eslint-config-prettier": "^10.1.8",
-    "modelpact": "^2.2.0",
+    "modelpact": "^2.2.1",
     "patch-package": "^8.0.1",
     "prettier": "^3.9.6",
     "typescript": "~6.0.3",