akribes 0.21.17

package/dist/sse.js

@@ -0,0 +1,218 @@
+/** Parse a complete SSE message block (lines between blank-line delimiters). */
+export function parseSseMessage(block) {
+    let event = '';
+    let data = '';
+    let id;
+    for (const line of block.split('\n')) {
+        if (line.startsWith('data: ')) {
+            if (data)
+                data += '\n';
+            data += line.slice(6);
+        }
+        else if (line.startsWith('data:')) {
+            if (data)
+                data += '\n';
+            data += line.slice(5);
+        }
+        else if (line.startsWith('event: ')) {
+            event = line.slice(7);
+        }
+        else if (line.startsWith('event:')) {
+            event = line.slice(6);
+        }
+        else if (line.startsWith('id: ')) {
+            id = line.slice(4);
+        }
+        else if (line.startsWith('id:')) {
+            id = line.slice(3);
+        }
+        // retry: field is still ignored
+    }
+    if (!data)
+        return null;
+    return id !== undefined ? { event, data, id } : { event, data };
+}
+/**
+ * Open an SSE connection with proper message parsing and auto-reconnection.
+ * Uses EventSource when available, fetch-based ReadableStream otherwise.
+ *
+ * On reconnect the connector sends `Last-Event-ID: <lastSeenId>` per the
+ * SSE spec — the server-side replay layer can use it to resume from the
+ * gap. EventSource handles this natively; the fetch fallback wires it
+ * through the request headers.
+ *
+ * Returns a dispose function.
+ */
+export function connectSse(options) {
+    const { url, headers, onMessage, onError, onOpen, reconnect = true, reconnectDelayMs = 1000, reconnectMaxDelayMs = 30000, } = options;
+    // Merged abort controller: combines external signal + internal dispose
+    const internal = new AbortController();
+    const disposed = () => internal.signal.aborted || options.signal?.aborted;
+    const resolveUrl = async () => typeof url === 'function' ? await url() : url;
+    // `Last-Event-ID` tracking: every message with an `id:` line updates this
+    // cursor. On reconnect we replay it as the header so the server can backfill
+    // events emitted during the gap. The cursor is captured by every parser
+    // path (EventSource native + fetch-fallback parseSseMessage).
+    let lastEventId;
+    const wrappedOnMessage = (msg) => {
+        if (msg.id !== undefined)
+            lastEventId = msg.id;
+        onMessage(msg);
+    };
+    // Reconnect backoff state. Exponential with full jitter, base 1s, cap 30s
+    // (the SDK-wide canonical curve — see #1182).
+    let attempt = 0;
+    const nextDelay = () => {
+        attempt += 1;
+        const exp = Math.min(reconnectDelayMs * 2 ** (attempt - 1), reconnectMaxDelayMs);
+        return Math.random() * exp;
+    };
+    const resetBackoff = () => { attempt = 0; };
+    // EventSource cannot set custom request headers, so it is only useful
+    // when the caller authenticates via a URL-embedded credential (e.g.
+    // `?token=…`). When the caller has supplied an Authorization header,
+    // we deliberately skip EventSource and use the fetch-fallback instead:
+    // the header path keeps long-lived tokens out of reverse-proxy access
+    // logs and OTel `http.url` span attributes.
+    const hasAuthHeader = headers && (headers['Authorization'] || headers['authorization']);
+    if (typeof globalThis.EventSource !== 'undefined' && !hasAuthHeader) {
+        // EventSource has no public API for replacing the URL on reconnect, so
+        // when the URL is dynamic we fall back to a manual reconnect loop: tear
+        // down the current EventSource on error, build a fresh URL, and open a
+        // new one. EventSource's native reconnect also sends `Last-Event-ID`
+        // automatically — but only on the same instance, not after we tear it
+        // down and re-open. So we track + replay it explicitly.
+        let es = null;
+        let reconnecting = false;
+        const open = async () => {
+            if (disposed() || reconnecting)
+                return;
+            reconnecting = true;
+            try {
+                let resolved = await resolveUrl();
+                if (disposed())
+                    return;
+                if (lastEventId !== undefined) {
+                    // EventSource does not let callers set headers, so we encode the
+                    // last-event-id in the query string for the fallback path on the
+                    // server. Browsers that ALSO send the native `Last-Event-ID`
+                    // header in this scenario are fine — the server reads whichever
+                    // it finds first. (See server `sse.rs`.)
+                    const u = new URL(resolved);
+                    u.searchParams.set('last_event_id', lastEventId);
+                    resolved = u.toString();
+                }
+                es = new EventSource(resolved);
+                es.onopen = () => { resetBackoff(); onOpen?.(); };
+                es.addEventListener('batch', (e) => {
+                    wrappedOnMessage({ event: 'batch', data: e.data, id: e.lastEventId });
+                });
+                es.onmessage = (e) => {
+                    wrappedOnMessage({ event: '', data: e.data, id: e.lastEventId });
+                };
+                es.onerror = () => {
+                    if (disposed())
+                        return;
+                    onError?.(new Error('EventSource connection error'));
+                    if (typeof url === 'function' && reconnect) {
+                        try {
+                            es?.close();
+                        }
+                        catch { /* ignore */ }
+                        setTimeout(() => { if (!disposed())
+                            open(); }, nextDelay());
+                    }
+                };
+            }
+            finally {
+                reconnecting = false;
+            }
+        };
+        open();
+        const dispose = () => { internal.abort(); if (es)
+            try {
+                es.close();
+            }
+            catch { /* ignore */ } };
+        options.signal?.addEventListener('abort', dispose, { once: true });
+        return dispose;
+    }
+    // Fetch-based fallback with reconnection
+    const run = async () => {
+        while (!disposed()) {
+            try {
+                const resolved = await resolveUrl();
+                if (disposed())
+                    return;
+                const reqHeaders = { 'Accept': 'text/event-stream', ...headers };
+                if (lastEventId !== undefined) {
+                    reqHeaders['Last-Event-ID'] = lastEventId;
+                }
+                const res = await fetch(resolved, {
+                    headers: reqHeaders,
+                    signal: internal.signal,
+                });
+                if (!res.ok || !res.body)
+                    return;
+                // Subscribe-before-POST hand-off: the server has accepted the GET
+                // (and thus attached its broadcast subscriber) the moment fetch
+                // resolves with a 2xx response and a body. Fire `onOpen` before
+                // we start parsing so callers waiting on the ready signal can
+                // proceed to issue their dependent POST.
+                resetBackoff();
+                onOpen?.();
+                const reader = res.body.getReader();
+                const decoder = new TextDecoder();
+                let buf = '';
+                while (!disposed()) {
+                    const { value, done } = await reader.read();
+                    if (done)
+                        break;
+                    buf += decoder.decode(value, { stream: true });
+                    // Process complete SSE messages delimited by blank lines.
+                    // Per the SSE spec, \n\n, \r\n\r\n, and \r\r are all valid
+                    // separators — servers or intermediaries may emit any of them.
+                    while (true) {
+                        const split = findSseDelimiter(buf);
+                        if (!split)
+                            break;
+                        const block = buf.slice(0, split.pos);
+                        buf = buf.slice(split.pos + split.len);
+                        const msg = parseSseMessage(block);
+                        if (msg)
+                            wrappedOnMessage(msg);
+                    }
+                }
+            }
+            catch (e) {
+                if (disposed() || (e instanceof Error && e.name === 'AbortError'))
+                    return;
+                onError?.(e instanceof Error ? e : new Error(String(e)));
+            }
+            if (!reconnect || disposed())
+                return;
+            await new Promise(r => setTimeout(r, nextDelay()));
+        }
+    };
+    run();
+    options.signal?.addEventListener('abort', () => internal.abort(), { once: true });
+    return () => internal.abort();
+}
+/** Find the earliest SSE message delimiter in `buf`. Returns its position
+ *  and length, or `null` if no complete delimiter is present yet. */
+function findSseDelimiter(buf) {
+    const delimiters = [
+        ['\r\n\r\n', 4],
+        ['\n\n', 2],
+        ['\r\r', 2],
+    ];
+    let best = null;
+    for (const [d, len] of delimiters) {
+        const pos = buf.indexOf(d);
+        if (pos !== -1 && (best === null || pos < best.pos)) {
+            best = { pos, len };
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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

package/dist/sub/bench.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Sub-client for the akribes-server bench substrate.
+ *
+ * Mirrors `crates/akribes-sdk-rust/src/sub/bench.rs`. Two surfaces glued onto
+ * one TypeScript class for ergonomic Studio consumption:
+ *
+ *  - Project-scoped operations live under
+ *    `/projects/{id}/scripts/{name}/bench/...`. The `projectId` is captured
+ *    at construction (`new AkribesClient({ projectId })`) and the script
+ *    name is the first argument to each method.
+ *  - Run-scoped + case-id-keyed operations live under `/bench-runs/{id}/...`
+ *    and `/cases/{id}` and aren't tied to a project (the server resolves
+ *    the owning project from the row). These are exposed on the same class
+ *    so studios don't juggle two client instances.
+ *
+ * Typed errors:
+ *  - 404 with a `{"error": ...}` body → `AkribesNotFoundError`.
+ *  - 400 `{"error": "case_type_mismatch", "field_errors": [...]}` →
+ *    `CaseTypeMismatchError`.
+ *  - 400 with a `Judge contract mismatch: ...` prefix → `JudgeContractError`
+ *    (with the trailing `breaks` list parsed when present).
+ *  - 409 with `error_type: "..._already_exists"` → `AkribesAlreadyExistsError`
+ *    (handled by the shared `fetchOk`).
+ *  - All other 4xx/5xx → `AkribesHttpError`.
+ */
+import type { HttpClient } from '../http';
+import type { Bench, BenchCase, BenchResult, BenchRun, BenchRunEventsPage, BenchRunTagSessionResponse, CompareReport, ContractPreview, CreateBenchCaseRequest, CreateOrUpdateBenchRequest, DriftReport, PatchBenchCaseRequest, ProjectBenchSummary, PromoteExecutionRequest, ScriptSignature, TriggerBenchRunRequest } from '../types';
+export declare class BenchClient {
+    private http;
+    private projectId;
+    constructor(http: HttpClient, projectId: number);
+    private benchPath;
+    private scriptOnlyPath;
+    private runUrl;
+    private caseUrl;
+    /** `GET /projects/{id}/scripts/{name}/bench` — 404 → `null`. Other 4xx/5xx
+     *  surface via {@link AkribesHttpError}. */
+    get(scriptName: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Bench | null>;
+    /** `POST /projects/{id}/scripts/{name}/bench` — create or update. The
+     *  server upserts on `(script_id)`, so this is idempotent w.r.t. an
+     *  existing bench config. */
+    save(scriptName: string, req: CreateOrUpdateBenchRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Bench>;
+    /** `DELETE /projects/{id}/scripts/{name}/bench`. The server emits a
+     *  `{"deleted": true}` body either way; we discard it. */
+    delete(scriptName: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** `GET /projects/{id}/benches` — one row per script with a bench
+     *  configured, joined with the latest run's summary. Backs the project-
+     *  level evals landing page. */
+    listProjectSummaries(opts?: {
+        signal?: AbortSignal;
+    }): Promise<ProjectBenchSummary[]>;
+    /** `GET /projects/{id}/scripts/{name}/signature` — parsed script inputs +
+     *  outputs + named type defs. Used by the case-builder modal. */
+    getSignature(scriptName: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ScriptSignature>;
+    /** `GET /projects/{id}/scripts/{name}/bench/contract-preview` — workflow
+     *  + judge signature pair plus the structured `breaks` list. Used by the
+     *  judge-picker UI to surface incompatibilities before a save. */
+    contractPreview(scriptName: string, args: {
+        judgeScriptId: number;
+        channel?: string;
+    }, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ContractPreview>;
+    /** `GET /projects/{id}/scripts/{name}/bench/cases`. 404 (no bench
+     *  configured) → empty list. */
+    listCases(scriptName: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchCase[]>;
+    /** `POST /projects/{id}/scripts/{name}/bench/cases` — form-builder create.
+     *  Throws {@link CaseTypeMismatchError} on a 400 `case_type_mismatch`
+     *  envelope so form layers can surface per-field violations. */
+    createCase(scriptName: string, req: CreateBenchCaseRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchCase>;
+    /** `GET /projects/{id}/scripts/{name}/bench/cases/contract-drift`. Returns
+     *  an empty drift report when the endpoint 404s (script never published). */
+    caseContractDrift(scriptName: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<DriftReport>;
+    /** `PATCH /cases/{id}` — sparse update. */
+    patchCase(caseId: string, req: PatchBenchCaseRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchCase>;
+    /** `DELETE /cases/{id}`. The server emits `{"deleted": true}`; we discard
+     *  it for an idiomatic `void` return. */
+    deleteCase(caseId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** `POST /executions/{exec_id}/promote-to-case` — promote a completed
+     *  execution into a bench case, with an optional `edits` overlay. Lives
+     *  on `/executions` rather than `/bench-runs` but is the natural
+     *  counterpart to the case-builder flow, so it lives on this client. */
+    promoteExecution(executionId: string, req?: PromoteExecutionRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchCase>;
+    /** `GET /projects/{id}/scripts/{name}/bench/runs` — paginated via
+     *  `limit` / `offset`. 404 → empty list. */
+    listRuns(scriptName: string, params?: {
+        limit?: number;
+        offset?: number;
+    }, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchRun[]>;
+    /** `POST /projects/{id}/scripts/{name}/bench/runs` — trigger a run.
+     *  `case_ids` constrains the fan-out to a subset. Throws
+     *  {@link JudgeContractError} on the contract pre-flight 400. */
+    triggerRun(scriptName: string, req: TriggerBenchRunRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchRun>;
+    /** `GET /bench-runs/{id}` — 404 → `null`. */
+    getRun(runId: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchRun | null>;
+    /** `DELETE /bench-runs/{id}`. Cancels first (best-effort) before
+     *  dropping. The server emits a JSON receipt; we discard it. */
+    deleteRun(runId: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** `GET /bench-runs/{id}/results`. 404 → empty list. */
+    listResults(runId: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchResult[]>;
+    /** `POST /bench-runs/{id}/cancel`. Flips the cancel token; in-flight cases
+     *  complete naturally. Returns the run row as it stands. */
+    cancelRun(runId: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchRun>;
+    /** `GET /bench-runs/{a}/compare/{b}` — diff two runs of the same bench. */
+    compareRuns(runA: number, runB: number, opts?: {
+        signal?: AbortSignal;
+    }): Promise<CompareReport>;
+    /** `GET /bench-runs/{id}/events?after_id=N` — JSON-page form of the
+     *  bench-run event stream. Use for MCP-style polling; for live UI prefer
+     *  {@link BenchClient.subscribeRunEvents}. */
+    runEvents(runId: number, params?: {
+        afterId?: number;
+    }, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchRunEventsPage>;
+    /** `PATCH /bench-runs/{id}/tag-session` — attribute the run to an MCP
+     *  session id so the coordinator's finalize step writes the cost into
+     *  `mcp_session_cost`. */
+    tagSession(runId: number, mcpSessionId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<BenchRunTagSessionResponse>;
+    /**
+     * Subscribe to a bench run's live result stream via SSE.
+     *
+     * The server emits two event types on `/bench-runs/{id}/events`:
+     *  - `result` — a new {@link BenchResult} row.
+     *  - `lagged` — broadcast-stream lag report (`{ dropped: N }`).
+     *
+     * Built on the shared {@link connectSse} helper, which uses
+     * {@link EventSource} in browsers and a fetch-based reader in Node / Bun.
+     * Auth rides on the Authorization header from the SDK's `HttpClient`.
+     * Older revisions also appended `opts.token` to the URL as a `?token=`
+     * fallback so EventSource (which can't set headers) would authenticate;
+     * that leaked long-lived service-token secrets into reverse-proxy
+     * access logs. `sse.ts` now skips EventSource whenever an Authorization
+     * header is present and uses the fetch-fallback path instead — so the
+     * `opts.token` URL fallback is no longer needed. `opts.token` is kept
+     * on the API for now (a no-op) to avoid breaking compiled callers.
+     * Returns an unsubscribe function.
+     */
+    subscribeRunEvents(runId: number, handlers: {
+        onResult?: (result: BenchResult) => void;
+        onLagged?: (dropped: number) => void;
+        onError?: (error: Error) => void;
+    }, opts?: {
+        token?: string;
+        signal?: AbortSignal;
+    }): () => void;
+}
+//# sourceMappingURL=bench.d.ts.map

package/dist/sub/bench.d.ts.map

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