@polyxd/runtime 0.4.0

package/dist/adapters/http.d.ts

@@ -0,0 +1,25 @@
+/** A model provider refused or failed. The message never contains the key or the prompt. */
+export declare class GeneratorError extends Error {
+    readonly provider: string;
+    /** The HTTP status, when the provider answered with one. */
+    readonly status?: number;
+    constructor(provider: string, message: string, status?: number);
+}
+/** Options every adapter takes. */
+export interface HttpOptions {
+    /** Your own `fetch`, for a proxy, retries or tests. Defaults to the global one. */
+    fetch?: typeof fetch;
+    /** Extra request headers. */
+    headers?: Record<string, string>;
+}
+/** POSTs JSON and returns the streaming response, or throws a `GeneratorError` for a non-2xx answer. */
+export declare function post(provider: string, http: HttpOptions, url: string, headers: Record<string, string>, body: unknown, signal?: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+export interface ServerEvent {
+    event?: string;
+    data: string;
+}
+/** Server-sent events from a response body, whatever the chunk boundaries. */
+export declare function serverEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<ServerEvent>;
+/** Parses one event's data, or throws a `GeneratorError` that says which provider sent something odd. */
+export declare function json(provider: string, data: string): any;
+export declare const trimSlash: (url: string) => string;

package/dist/adapters/http.js

@@ -0,0 +1,92 @@
+/** A model provider refused or failed. The message never contains the key or the prompt. */
+export class GeneratorError extends Error {
+    provider;
+    /** The HTTP status, when the provider answered with one. */
+    status;
+    constructor(provider, message, status) {
+        super(message);
+        this.name = "GeneratorError";
+        this.provider = provider;
+        this.status = status;
+    }
+}
+/** POSTs JSON and returns the streaming response, or throws a `GeneratorError` for a non-2xx answer. */
+export async function post(provider, http, url, headers, body, signal) {
+    const f = http.fetch ?? globalThis.fetch;
+    const res = await f(url, { method: "POST", headers: { "content-type": "application/json", ...headers, ...http.headers }, body: JSON.stringify(body), signal });
+    if (!res.ok) {
+        let detail = "";
+        try {
+            detail = (await res.text()).slice(0, 500);
+        }
+        catch {
+            // The status alone will do.
+        }
+        throw new GeneratorError(provider, `${provider} answered ${res.status}${detail ? `: ${detail}` : ""}`, res.status);
+    }
+    if (!res.body)
+        throw new GeneratorError(provider, `${provider} answered with no body`, res.status);
+    return res.body;
+}
+/** Server-sent events from a response body, whatever the chunk boundaries. */
+export async function* serverEvents(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let event;
+    let data = [];
+    const ready = [];
+    const line = (l) => {
+        if (l === "") {
+            if (data.length)
+                ready.push({ event, data: data.join("\n") });
+            event = undefined;
+            data = [];
+        }
+        else if (l.startsWith(":")) {
+            // A comment, used as a keep-alive.
+        }
+        else {
+            const colon = l.indexOf(":");
+            const field = colon < 0 ? l : l.slice(0, colon);
+            const value = colon < 0 ? "" : l.slice(colon + 1).replace(/^ /, "");
+            if (field === "event")
+                event = value;
+            else if (field === "data")
+                data.push(value);
+        }
+    };
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            buffer += done ? decoder.decode() : decoder.decode(value, { stream: true });
+            let nl;
+            while ((nl = buffer.indexOf("\n")) >= 0) {
+                line(buffer.slice(0, nl).replace(/\r$/, ""));
+                buffer = buffer.slice(nl + 1);
+            }
+            if (done) {
+                if (buffer)
+                    line(buffer.replace(/\r$/, ""));
+                line("");
+            }
+            yield* ready.splice(0);
+            if (done)
+                return;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/** Parses one event's data, or throws a `GeneratorError` that says which provider sent something odd. */
+export function json(provider, data) {
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        throw new GeneratorError(provider, `${provider} sent an event that isn't JSON`);
+    }
+}
+export const trimSlash = (url) => url.replace(/\/+$/, "");
+//# sourceMappingURL=http.js.map

package/dist/adapters/http.js.map

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

package/dist/adapters/openai.d.ts

@@ -0,0 +1,31 @@
+import type { Generator } from "../types.ts";
+import { type HttpOptions } from "./http.ts";
+export interface OpenAIOptions extends HttpOptions {
+    /** Your API key. Leave it out only when a proxy at `baseURL` adds it. */
+    apiKey?: string;
+    /** The model id. There is no default. */
+    model: string;
+    /** `chat` for Chat Completions (the default), `responses` for the Responses API. */
+    api?: "chat" | "responses";
+    /** Default `https://api.openai.com/v1`. */
+    baseURL?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface LocalOptions extends HttpOptions {
+    /** The model name the server knows, e.g. `qwen3:8b` in Ollama. */
+    model: string;
+    /**
+     * The server's OpenAI-compatible base URL. Default `http://localhost:11434/v1` (Ollama).
+     * llama.cpp's server is usually `http://localhost:8080/v1`, LM Studio's `http://localhost:1234/v1`.
+     */
+    baseURL?: string;
+    /** Only if your server wants one. */
+    apiKey?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+/** OpenAI, through Chat Completions or the Responses API, streaming. */
+export declare function openai(options: OpenAIOptions): Generator;
+/** A model on your own machine or server behind an OpenAI-compatible endpoint: Ollama, llama.cpp, LM Studio. */
+export declare function local(options: LocalOptions): Generator;

package/dist/adapters/openai.js

@@ -0,0 +1,89 @@
+import { GeneratorError, json, post, serverEvents, trimSlash } from "./http.js";
+const auth = (apiKey) => (apiKey ? { authorization: `Bearer ${apiKey}` } : {});
+/** Chat Completions, streaming: OpenAI and every server that copies its API. */
+async function chat(provider, http, url, headers, extra, { system, messages, signal, onText }) {
+    const body = { ...extra, messages: [{ role: "system", content: system }, ...messages.map((m) => ({ role: m.role, content: m.content }))], stream: true };
+    const stream = await post(provider, http, url, headers, body, signal);
+    let text = "";
+    let usage;
+    for await (const e of serverEvents(stream)) {
+        if (e.data === "[DONE]")
+            break;
+        const d = json(provider, e.data);
+        if (d.error)
+            throw new GeneratorError(provider, `${provider} stopped: ${d.error.message ?? "error"}`);
+        const piece = d.choices?.[0]?.delta?.content;
+        if (typeof piece === "string" && piece) {
+            text += piece;
+            onText?.(piece);
+        }
+        if (d.usage)
+            usage = { inputTokens: d.usage.prompt_tokens ?? 0, outputTokens: d.usage.completion_tokens ?? 0 };
+    }
+    return { text, usage };
+}
+/** The Responses API, streaming. Responses aren't stored on OpenAI's side (`store: false`). */
+async function responses(http, url, headers, extra, { system, messages, signal, onText }) {
+    const body = { ...extra, instructions: system, input: messages.map((m) => ({ role: m.role, content: m.content })), stream: true, store: false };
+    const stream = await post("openai", http, url, headers, body, signal);
+    let text = "";
+    let usage;
+    for await (const e of serverEvents(stream)) {
+        const d = json("openai", e.data);
+        const type = d.type ?? e.event;
+        if (type === "response.output_text.delta" && typeof d.delta === "string") {
+            text += d.delta;
+            onText?.(d.delta);
+        }
+        else if (type === "response.completed" || type === "response.incomplete") {
+            const u = d.response?.usage;
+            if (u)
+                usage = { inputTokens: u.input_tokens ?? 0, outputTokens: u.output_tokens ?? 0 };
+        }
+        else if (type === "response.failed") {
+            throw new GeneratorError("openai", `openai stopped: ${d.response?.error?.message ?? "the response failed"}`);
+        }
+        else if (type === "error") {
+            throw new GeneratorError("openai", `openai stopped: ${d.message ?? d.error?.message ?? "error"}`);
+        }
+    }
+    return { text, usage };
+}
+/** OpenAI, through Chat Completions or the Responses API, streaming. */
+export function openai(options) {
+    const base = trimSlash(options.baseURL ?? "https://api.openai.com/v1");
+    const api = options.api ?? "chat";
+    return {
+        name: "openai",
+        generate(request) {
+            const extra = { model: options.model };
+            if (options.temperature !== undefined)
+                extra.temperature = options.temperature;
+            if (api === "responses") {
+                if (options.maxTokens !== undefined)
+                    extra.max_output_tokens = options.maxTokens;
+                return responses(options, `${base}/responses`, auth(options.apiKey), extra, request);
+            }
+            if (options.maxTokens !== undefined)
+                extra.max_completion_tokens = options.maxTokens;
+            extra.stream_options = { include_usage: true };
+            return chat("openai", options, `${base}/chat/completions`, auth(options.apiKey), extra, request);
+        },
+    };
+}
+/** A model on your own machine or server behind an OpenAI-compatible endpoint: Ollama, llama.cpp, LM Studio. */
+export function local(options) {
+    const base = trimSlash(options.baseURL ?? "http://localhost:11434/v1");
+    return {
+        name: "local",
+        generate(request) {
+            const extra = { model: options.model };
+            if (options.temperature !== undefined)
+                extra.temperature = options.temperature;
+            if (options.maxTokens !== undefined)
+                extra.max_tokens = options.maxTokens;
+            return chat("local", options, `${base}/chat/completions`, auth(options.apiKey), extra, request);
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/adapters/openai.js.map

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

package/dist/audit.d.ts

@@ -0,0 +1,17 @@
+import type { AuditOptions, Direction, Finding, Report } from "./types.ts";
+/**
+ * The document checks the runtime runs by default: the verifier's `staticAudit`, from its
+ * `@polyxd/verifier/static` entry, which needs no file system and no browser. That is the spec
+ * validator (with the Direction's `emphasisBudget`, and bindings checked against the data), the
+ * pattern the document declares, the capabilities on offer, the Design Direction's rules, and the
+ * verifier's agent-readiness checks. A binding that reads nothing is a warning unless `missingData`
+ * says otherwise; the runtime makes it an error when the ask carries data.
+ */
+export declare function checkDocument(doc: unknown, options?: AuditOptions): Finding[];
+/**
+ * What only a generated document is held to: it is never the product's shell, uses only the
+ * components the host allows, and follows none of the patterns the Direction disallows.
+ */
+export declare function generatedChecks(doc: any, direction?: Direction, components?: string[]): Finding[];
+/** Findings, with the same finding reported once. */
+export declare function toReport(findings: Finding[]): Report;

package/dist/audit.js

@@ -0,0 +1,48 @@
+import { staticAudit } from "@polyxd/verifier/static";
+import { COMPONENTS } from "./catalog.generated.js";
+/**
+ * The document checks the runtime runs by default: the verifier's `staticAudit`, from its
+ * `@polyxd/verifier/static` entry, which needs no file system and no browser. That is the spec
+ * validator (with the Direction's `emphasisBudget`, and bindings checked against the data), the
+ * pattern the document declares, the capabilities on offer, the Design Direction's rules, and the
+ * verifier's agent-readiness checks. A binding that reads nothing is a warning unless `missingData`
+ * says otherwise; the runtime makes it an error when the ask carries data.
+ */
+export function checkDocument(doc, options = {}) {
+    return staticAudit(doc, { ...options, missingData: options.missingData ?? "warning" });
+}
+const SHELL = new Set(COMPONENTS.filter((c) => c.shell).map((c) => c.name));
+/**
+ * What only a generated document is held to: it is never the product's shell, uses only the
+ * components the host allows, and follows none of the patterns the Direction disallows.
+ */
+export function generatedChecks(doc, direction, components) {
+    const out = [];
+    if (doc?.surface?.kind === "shell")
+        out.push({ severity: "error", check: "generated:shell", message: "surface.kind is \"shell\": the product's shell is authored, and a generated surface renders inside it" });
+    const allowed = components ? new Set(components) : undefined;
+    for (const c of Array.isArray(doc?.components) ? doc.components : []) {
+        if (SHELL.has(c?.component))
+            continue; // the validator and the shell check above already report these
+        if (allowed && typeof c?.component === "string" && !allowed.has(c.component))
+            out.push({ severity: "error", check: "generated:component", message: `${c.id}: ${c.component} is not one of the components this product allows` });
+    }
+    const pattern = doc?.surface?.pattern;
+    if (pattern && direction?.patterns?.disallow?.includes(pattern))
+        out.push({ severity: "error", check: "direction:pattern-disallowed", message: `surface.pattern "${pattern}" is a pattern the design direction disallows` });
+    return out;
+}
+/** Findings, with the same finding reported once. */
+export function toReport(findings) {
+    const seen = new Set();
+    const unique = findings.filter((f) => {
+        const k = `${f.severity}\u0000${f.check}\u0000${f.message}`;
+        if (seen.has(k))
+            return false;
+        seen.add(k);
+        return true;
+    });
+    const errors = unique.filter((f) => f.severity === "error").length;
+    return { valid: errors === 0, errors, warnings: unique.length - errors, findings: unique };
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

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

package/dist/catalog.generated.d.ts

@@ -0,0 +1,4 @@
+import type { CatalogComponent, CatalogPattern } from "./types.ts";
+export declare const SPEC_VERSION = "0.3.0";
+export declare const COMPONENTS: CatalogComponent[];
+export declare const PATTERNS: CatalogPattern[];