@oharness/engine 0.1.0

package/dist/providers/http.d.ts

@@ -0,0 +1,24 @@
+export interface SseEvent {
+    event?: string;
+    data: string;
+}
+/**
+ * Parse a `text/event-stream` body into events. Handles multi-line `data:`
+ * fields and CRLF, and tolerates servers that omit the trailing blank line.
+ */
+export declare function parseSse(body: ReadableStream<Uint8Array>): AsyncGenerator<SseEvent, void, void>;
+export interface PostOptions {
+    url: string;
+    headers: Record<string, string>;
+    body: unknown;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    maxRetries?: number;
+    provider: string;
+}
+/**
+ * POST JSON and return the raw response, retrying retryable statuses with
+ * exponential backoff + jitter. Honors `retry-after` when present.
+ */
+export declare function postJson(opts: PostOptions): Promise<Response>;
+export declare function streamBody(response: Response, provider: string): Promise<ReadableStream<Uint8Array>>;

package/dist/providers/http.js

@@ -0,0 +1,139 @@
+import { ProviderError, isRetryableStatus } from "../core/errors.js";
+/**
+ * Parse a `text/event-stream` body into events. Handles multi-line `data:`
+ * fields and CRLF, and tolerates servers that omit the trailing blank line.
+ */
+export async function* parseSse(body) {
+    const decoder = new TextDecoder();
+    const reader = body.getReader();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            buffer = buffer.replaceAll("\r\n", "\n");
+            let idx;
+            while ((idx = buffer.indexOf("\n\n")) !== -1) {
+                const chunk = buffer.slice(0, idx);
+                buffer = buffer.slice(idx + 2);
+                const parsed = parseChunk(chunk);
+                if (parsed)
+                    yield parsed;
+            }
+        }
+        const tail = parseChunk(buffer);
+        if (tail)
+            yield tail;
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+function parseChunk(chunk) {
+    let event;
+    const dataLines = [];
+    for (const line of chunk.split("\n")) {
+        if (line === "" || line.startsWith(":"))
+            continue;
+        const colon = line.indexOf(":");
+        const field = colon === -1 ? line : line.slice(0, colon);
+        let value = colon === -1 ? "" : line.slice(colon + 1);
+        if (value.startsWith(" "))
+            value = value.slice(1);
+        if (field === "event")
+            event = value;
+        else if (field === "data")
+            dataLines.push(value);
+    }
+    if (dataLines.length === 0)
+        return undefined;
+    return { event, data: dataLines.join("\n") };
+}
+/**
+ * POST JSON and return the raw response, retrying retryable statuses with
+ * exponential backoff + jitter. Honors `retry-after` when present.
+ */
+export async function postJson(opts) {
+    const maxRetries = opts.maxRetries ?? 2;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const timeout = AbortSignal.timeout(opts.timeoutMs ?? 600_000);
+        const signal = opts.signal
+            ? AbortSignal.any([opts.signal, timeout])
+            : timeout;
+        let response;
+        try {
+            response = await fetch(opts.url, {
+                method: "POST",
+                headers: { "content-type": "application/json", ...opts.headers },
+                body: JSON.stringify(opts.body),
+                signal,
+            });
+        }
+        catch (err) {
+            // A caller-initiated abort is final; anything else may be transient.
+            if (opts.signal?.aborted)
+                throw err;
+            lastError = err;
+            if (attempt === maxRetries) {
+                throw new ProviderError(opts.provider, `request failed: ${String(err)}`, {
+                    retryable: true,
+                    cause: err,
+                });
+            }
+            await sleep(backoffMs(attempt));
+            continue;
+        }
+        if (response.ok)
+            return response;
+        const detail = await safeText(response);
+        if (isRetryableStatus(response.status) && attempt < maxRetries) {
+            await sleep(retryAfterMs(response) ?? backoffMs(attempt));
+            continue;
+        }
+        throw new ProviderError(opts.provider, `HTTP ${response.status} ${response.statusText}: ${truncate(detail, 800)}`, { status: response.status });
+    }
+    throw new ProviderError(opts.provider, `request failed: ${String(lastError)}`, {
+        retryable: true,
+        cause: lastError,
+    });
+}
+export async function streamBody(response, provider) {
+    if (!response.body) {
+        throw new ProviderError(provider, "response had no body");
+    }
+    return response.body;
+}
+function backoffMs(attempt) {
+    const base = Math.min(1_000 * 2 ** attempt, 16_000);
+    return base + Math.random() * 250;
+}
+function retryAfterMs(response) {
+    const header = response.headers.get("retry-after");
+    if (!header)
+        return undefined;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds))
+        return seconds * 1_000;
+    const date = Date.parse(header);
+    if (Number.isFinite(date))
+        return Math.max(0, date - Date.now());
+    return undefined;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function safeText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return "<unreadable body>";
+    }
+}
+function truncate(s, n) {
+    return s.length > n ? `${s.slice(0, n)}…` : s;
+}
+//# sourceMappingURL=http.js.map

package/dist/providers/http.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,10 @@
+export { PiAiProvider } from "./piai.ts";
+export type { PiAiProviderOptions, PiApi } from "./piai.ts";
+export { discoverModels } from "./discovery.ts";
+export { ProviderRegistry } from "./registry.ts";
+export { ResilientProvider } from "./resilient.ts";
+export { loadCatalog, mergeCatalog, normalizeModel, parseCatalog, userCatalogPath, } from "./catalog.ts";
+export type { Catalog, CatalogProvider, DiscoveryFormat, ProtocolId } from "./catalog.ts";
+export { estimateCost, resolveEffort } from "./types.ts";
+export type { EffortLevel, GenerateRequest, ModelSpec, Provider, ProviderCredentials, StreamEvent, ThinkingConfig, ToolChoice, } from "./types.ts";
+export { parseSse } from "./http.ts";

package/dist/providers/index.js

@@ -0,0 +1,8 @@
+export { PiAiProvider } from "./piai.js";
+export { discoverModels } from "./discovery.js";
+export { ProviderRegistry } from "./registry.js";
+export { ResilientProvider } from "./resilient.js";
+export { loadCatalog, mergeCatalog, normalizeModel, parseCatalog, userCatalogPath, } from "./catalog.js";
+export { estimateCost, resolveEffort } from "./types.js";
+export { parseSse } from "./http.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWzD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/providers/piai.d.ts

@@ -0,0 +1,124 @@
+import type { Message as PiMessage } from "@earendil-works/pi-ai";
+import type { Message } from "../core/types.ts";
+import type { DiscoveryFormat, ProtocolId } from "./catalog.ts";
+import type { GenerateRequest, ModelSpec, Provider, ProviderCredentials, StreamEvent } from "./types.ts";
+/**
+ * The wire adapter, backed by pi-ai.
+ *
+ * Every vendor protocol the harness speaks now goes through one of pi-ai's API
+ * implementations. What stays here is the translation in both directions:
+ * harness types in, harness types out. That boundary is the whole point — the
+ * agent loop, session storage and `/model` keep talking about `Message`,
+ * `ModelSpec` and `StreamEvent`, so which library drives the socket stays an
+ * implementation detail.
+ *
+ * Auth deliberately does *not* go through pi-ai's provider auth. Credentials
+ * here are resolved per request by `AuthManager` — a subscription token valid
+ * at startup is not valid an hour later — so the API implementations are
+ * called directly and handed the resolved key and headers. pi-ai's own
+ * credential store would be a second, competing source of truth.
+ */
+/** The pi-ai API implementations the catalog can name. */
+export type PiApi = "anthropic-messages" | "openai-completions" | "openai-responses" | "google-generative-ai" | "google-vertex" | "bedrock-converse-stream";
+/**
+ * The pi-ai API implementation behind each catalog protocol.
+ *
+ * The catalog's names are the harness's own and predate pi-ai; keeping the
+ * mapping explicit means a rename upstream is a one-line change here rather
+ * than a migration of every user's catalog.json. It lives beside `PiApi`
+ * because both the registry (which builds providers) and the builtin seed
+ * (which decides whether a pi-ai model can even be driven over a catalog
+ * entry's protocol) have to agree on it.
+ */
+export declare const PI_APIS: Record<ProtocolId, PiApi>;
+export interface PiAiProviderOptions extends ProviderCredentials {
+    id: string;
+    name?: string;
+    /** Which pi-ai API implementation serves this endpoint. */
+    api: PiApi;
+    /** Env var consulted when `apiKey` is absent. */
+    apiKeyEnv?: string;
+    /**
+     * Whether this endpoint needs a credential. Local servers (Ollama, vLLM,
+     * LM Studio) do not; every hosted vendor does. Defaults to true — claiming a
+     * hosted provider is ready without a key produces a 401 at first use.
+     */
+    requiresKey?: boolean;
+    /** Some compatible servers reject `stream_options: {include_usage: true}`. */
+    includeUsage?: boolean;
+    /** Whether this endpoint requires an `Idempotency-Key` on each request. */
+    idempotencyKey?: boolean;
+    /** A ceiling the endpoint imposes on `max_tokens`, below what models state. */
+    maxOutputTokens?: number;
+    /** How to read `/models`; absent means the endpoint is not worth calling. */
+    discoveryFormat?: DiscoveryFormat;
+    /** Base URL used for discovery and as the model's endpoint. */
+    baseUrl?: string;
+}
+export declare class PiAiProvider implements Provider {
+    readonly id: string;
+    readonly name: string;
+    private readonly opts;
+    /**
+     * Only defined when the endpoint publishes a `/models` listing — callers
+     * test for its presence, so defining it unconditionally would make every
+     * provider claim it can enumerate models.
+     */
+    readonly listModels?: () => Promise<ModelSpec[]>;
+    constructor(opts: PiAiProviderOptions);
+    isConfigured(): boolean;
+    private apiKey;
+    private baseUrl;
+    stream(request: GenerateRequest): AsyncGenerator<StreamEvent, void, void>;
+    /**
+     * Sampling knobs pi-ai does not model. They are merged into the request body
+     * verbatim by the OpenAI-compatible adapters only, so anything sent here is
+     * silently dropped by the Anthropic, Google and Bedrock protocols.
+     */
+    private samplingParams;
+    /**
+     * How many tokens to ask for, under whatever ceiling the endpoint imposes.
+     *
+     * The model's own limit is the usual answer. A gateway that caps output
+     * below it is a separate fact — the models it serves still advertise their
+     * real maximum, and a request over the gateway's line is refused rather than
+     * truncated, so the clamp has to happen here on the way out.
+     */
+    private maxTokensFor;
+    /**
+     * Provider headers plus whatever the resolver produced. A `null` value
+     * suppresses a header the SDK would otherwise set: bearer-token auth must
+     * remove the `x-api-key` the Anthropic client adds from `apiKey`, or the API
+     * sees two conflicting credentials and rejects the request.
+     *
+     * Called once per `stream()`, which is what makes the idempotency key below
+     * correct: pi-ai's own retries reuse this object and so resend the same key,
+     * which is how a gateway is told "this is the call that already reserved,
+     * not a new one" — while a retry the harness decides on comes back through
+     * `stream()` and gets a fresh key, because by then the first attempt may
+     * have been billed.
+     */
+    private requestHeaders;
+    /** Translate a harness model spec into the shape pi-ai dispatches on. */
+    private toPiModel;
+    /**
+     * Per-protocol quirks the catalog knows about. pi-ai auto-detects these from
+     * the base URL for vendors it recognizes; everything here is the subset the
+     * catalog states outright, which must win over a guess made from a hostname.
+     */
+    private compatFor;
+}
+export interface ContextOptions {
+    /** The provider about to be called, for deciding what is replayable. */
+    providerId: string;
+    thinkingOn: boolean;
+}
+/**
+ * One harness message can become several pi-ai messages.
+ *
+ * The harness stores tool results as blocks inside the *user* message that
+ * carries them, because that is how the conversation reads. pi-ai models them
+ * as their own `toolResult` role, so they are split out here — in order, since
+ * every provider requires a tool result to directly follow the call it answers.
+ */
+export declare function toPiMessages(message: Message, opts: ContextOptions): PiMessage[];