akribes 0.21.17

package/dist/errors.js

@@ -0,0 +1,274 @@
+/** Base error class for all Akribes SDK errors. */
+export class AkribesError extends Error {
+    name = 'AkribesError';
+}
+/** Structured HTTP error with status code and server message.
+ *
+ *  `errorType` and `reason` are populated when the server returns a structured
+ *  error body of the shape `{ error, error_type, reason, ... }` (currently
+ *  used by the document conversion path). Callers that care about typed
+ *  failures should branch on these instead of regex-matching `message`.
+ *
+ *  As of #987, this is the abstract parent for typed HTTP-status subclasses
+ *  (`AkribesAuthError`, `AkribesNotFoundError`, `AkribesRateLimitError`,
+ *  `AkribesTransientHttpError`, `AkribesAlreadyExistsError`,
+ *  `CaseTypeMismatchError`, `JudgeContractError`). `instanceof AkribesHttpError`
+ *  still works as a catch-all for any non-2xx. */
+export class AkribesHttpError extends AkribesError {
+    status;
+    body;
+    serverMessage;
+    errorType;
+    reason;
+    name = 'AkribesHttpError';
+    constructor(status, body, serverMessage, errorType, reason) {
+        super(`HTTP ${status}: ${serverMessage ?? body}`);
+        this.status = status;
+        this.body = body;
+        this.serverMessage = serverMessage;
+        this.errorType = errorType;
+        this.reason = reason;
+    }
+}
+/** Thrown on HTTP 401/403. Auth / authorization failure — do not retry; mint
+ *  a fresh scoped token (or rotate the service-token secret) and try again. */
+export class AkribesAuthError extends AkribesHttpError {
+    name = 'AkribesAuthError';
+    constructor(status, body, serverMessage) {
+        super(status, body, serverMessage);
+    }
+}
+/** Thrown on HTTP 429. Carries `retryAfter` (parsed from the `Retry-After`
+ *  header) in **seconds** when the server sent numeric-seconds form; `null`
+ *  when the header is absent or in HTTP-date form (matching Python). */
+export class AkribesRateLimitError extends AkribesHttpError {
+    retryAfter;
+    name = 'AkribesRateLimitError';
+    constructor(body, serverMessage, retryAfter) {
+        super(429, body, serverMessage);
+        this.retryAfter = retryAfter;
+    }
+}
+/** Recommended base backoff (in milliseconds) for a retriable HTTP status
+ *  after #1296 split the umbrella `AkribesTransientHttpError` into one
+ *  subclass per 5xx variant. Mirrors `ErrorKind::base_backoff_ms` on the
+ *  Rust side so server + SDK retry cadences agree:
+ *
+ *  - 500: maybe-transient origin error — start short (1s).
+ *  - 502: edge fronted a failing origin — start short (1s).
+ *  - 503: rate-limit-adjacent — honour `Retry-After`; default 2s.
+ *  - 504: slow upstream — start longer (4s) before retrying.
+ *  - 429: rate-limit — 2s default; honour `Retry-After` when present.
+ *
+ *  Returned in milliseconds; callers convert to seconds with `/ 1000`.
+ *  Returns `null` for non-transient statuses. */
+export function recommendedBackoffMs(status) {
+    switch (status) {
+        case 429: return 2_000;
+        case 500: return 1_000;
+        case 502: return 1_000;
+        case 503: return 2_000;
+        case 504: return 4_000;
+        default: return null;
+    }
+}
+/** Thrown on HTTP 500/502/503/504. Retriable server-side failure (#1296
+ *  splits this into status-specific subclasses below). `retryAfter` (in
+ *  seconds) is populated when the server sent a numeric `Retry-After`.
+ *  Use `instanceof AkribesTransientHttpError` for the umbrella check, or
+ *  branch on the specific subclass (`AkribesServerError500`,
+ *  `AkribesBadGatewayError502`, `AkribesServiceUnavailableError503`,
+ *  `AkribesGatewayTimeoutError504`) for per-status retry cadence. */
+export class AkribesTransientHttpError extends AkribesHttpError {
+    retryAfter;
+    name = 'AkribesTransientHttpError';
+    constructor(status, body, serverMessage, retryAfter) {
+        super(status, body, serverMessage);
+        this.retryAfter = retryAfter;
+    }
+    /** Recommended base backoff in milliseconds for this transient status
+     *  (#1296). Prefer `retryAfter * 1000` when the server sent the header;
+     *  fall back to this when it didn't. */
+    recommendedBackoffMs() {
+        return recommendedBackoffMs(this.status) ?? 1_000;
+    }
+}
+/** Thrown on HTTP 500 (internal server error). The origin reported a
+ *  generic failure; retry with a short exponential backoff. (#1296) */
+export class AkribesServerError500 extends AkribesTransientHttpError {
+    name = 'AkribesServerError500';
+    constructor(body, serverMessage, retryAfter) {
+        super(500, body, serverMessage, retryAfter);
+    }
+}
+/** Thrown on HTTP 502 (bad gateway). The provider's edge fronted a
+ *  failing origin; retry with a short backoff. (#1296) */
+export class AkribesBadGatewayError502 extends AkribesTransientHttpError {
+    name = 'AkribesBadGatewayError502';
+    constructor(body, serverMessage, retryAfter) {
+        super(502, body, serverMessage, retryAfter);
+    }
+}
+/** Thrown on HTTP 503 (service unavailable). Rate-limit-adjacent; honour
+ *  `Retry-After` aggressively, otherwise back off at the rate-limit
+ *  cadence. (#1296) */
+export class AkribesServiceUnavailableError503 extends AkribesTransientHttpError {
+    name = 'AkribesServiceUnavailableError503';
+    constructor(body, serverMessage, retryAfter) {
+        super(503, body, serverMessage, retryAfter);
+    }
+}
+/** Thrown on HTTP 504 (gateway timeout). The upstream is slow or stuck;
+ *  start with a longer base backoff than for 500/502. (#1296) */
+export class AkribesGatewayTimeoutError504 extends AkribesTransientHttpError {
+    name = 'AkribesGatewayTimeoutError504';
+    constructor(body, serverMessage, retryAfter) {
+        super(504, body, serverMessage, retryAfter);
+    }
+}
+/** Parse a `Retry-After` header value into a numeric **seconds** value.
+ *  Returns `null` for missing, empty, or HTTP-date values (matching the
+ *  Python SDK's `_parse_retry_after`). Exported for tests + reuse. */
+export function parseRetryAfter(headerValue) {
+    if (headerValue == null)
+        return null;
+    const trimmed = headerValue.trim();
+    if (!trimmed)
+        return null;
+    const n = Number(trimmed);
+    if (Number.isFinite(n) && n >= 0)
+        return n;
+    return null;
+}
+/** Thrown when the server returns 409 with `error_type: "suite_already_exists"`
+ *  (or any other future "this resource already exists" condition). The
+ *  `existingId` field carries the conflicting row's id so callers can
+ *  redirect the operator to it. */
+export class AkribesAlreadyExistsError extends AkribesHttpError {
+    existingId;
+    name = 'AkribesAlreadyExistsError';
+    constructor(status, body, serverMessage, existingId) {
+        super(status, body, serverMessage);
+        this.existingId = existingId;
+    }
+}
+export class AkribesTransientError extends AkribesError {
+    executionId;
+    name = 'AkribesTransientError';
+    constructor(message, executionId) {
+        super(message);
+        this.executionId = executionId;
+    }
+}
+export class AkribesFatalError extends AkribesError {
+    executionId;
+    name = 'AkribesFatalError';
+    constructor(message, executionId) {
+        super(message);
+        this.executionId = executionId;
+    }
+}
+export class AkribesScriptError extends AkribesError {
+    executionId;
+    name = 'AkribesScriptError';
+    constructor(message, executionId) {
+        super(message);
+        this.executionId = executionId;
+    }
+}
+/** Thrown by polling helpers (`waitFor` / `await`) when an execution does
+ *  not reach a terminal state within the supplied timeout. Carries the
+ *  execution id + elapsed budget so callers can route timeouts distinctly
+ *  from script / transient failures. Mirrors Python's `AkribesTimeoutError`.
+ *
+ *  The message still contains "timed out" verbatim for back-compat with
+ *  pre-#109 callers that grep on it. */
+export class AkribesTimeoutError extends AkribesError {
+    executionId;
+    timeoutMs;
+    name = 'AkribesTimeoutError';
+    constructor(message, executionId, timeoutMs) {
+        super(message);
+        this.executionId = executionId;
+        this.timeoutMs = timeoutMs;
+    }
+}
+/** Thrown when run() is called after a ScriptUpdated event with schema_changed=true. */
+export class ScriptSchemaChangedError extends AkribesError {
+    scriptName;
+    name = 'ScriptSchemaChangedError';
+    constructor(scriptName) {
+        super(`Script "${scriptName}" schema has changed since init(). Re-register to continue.`);
+        this.scriptName = scriptName;
+    }
+}
+/** Parse a 400 `input_validation_failed` body off an AkribesHttpError.
+ *  Returns null when the error is something else or the body doesn't match. */
+export function tryParseInputValidationErrors(err) {
+    if (!(err instanceof AkribesHttpError) || err.status !== 400)
+        return null;
+    try {
+        const body = JSON.parse(err.body);
+        if (body?.error === 'input_validation_failed' && Array.isArray(body.errors)) {
+            return body.errors;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Thrown when run() is called with document keys that don't match the cached schema. */
+export class ScriptInputMismatchError extends AkribesError {
+    scriptName;
+    missing;
+    extra;
+    name = 'ScriptInputMismatchError';
+    constructor(scriptName, missing, extra) {
+        const parts = [];
+        if (missing.length)
+            parts.push(`missing: ${missing.join(', ')}`);
+        if (extra.length)
+            parts.push(`extra: ${extra.join(', ')}`);
+        super(`Script "${scriptName}" input mismatch: ${parts.join('; ')}`);
+        this.scriptName = scriptName;
+        this.missing = missing;
+        this.extra = extra;
+    }
+}
+/** Thrown when the server returns 404 with a structured `{"error": ...}`
+ *  body. Carries the parsed `error` message so callers can distinguish
+ *  "no bench configured" from "bench run not found" without regex-matching
+ *  `message`. Status is always 404. */
+export class AkribesNotFoundError extends AkribesHttpError {
+    name = 'AkribesNotFoundError';
+    constructor(body, serverMessage) {
+        super(404, body, serverMessage, undefined, undefined);
+    }
+}
+/** Thrown by case-create / promote-execution when the server rejects the
+ *  payload with structured per-field violations (HTTP 400 +
+ *  `error: "case_type_mismatch"`). Callers in the form layer catch this
+ *  and populate `errorsByPath` from {@link CaseTypeMismatchError.fieldErrors}. */
+export class CaseTypeMismatchError extends AkribesHttpError {
+    fieldErrors;
+    name = 'CaseTypeMismatchError';
+    constructor(body, serverMessage, fieldErrors) {
+        super(400, body, serverMessage, 'case_type_mismatch', undefined);
+        this.fieldErrors = fieldErrors;
+    }
+}
+/** Thrown by `bench.triggerRun()` when the workflow's outputs are
+ *  incompatible with the judge's `inputs.{expected,actual}` slots. The
+ *  server returns 400 with a `Judge contract mismatch: ...` message; the
+ *  SDK parses the trailing `N field(s) incompatible: ...` fragment into a
+ *  `breaks` list when present, leaving it empty otherwise. */
+export class JudgeContractError extends AkribesHttpError {
+    breaks;
+    name = 'JudgeContractError';
+    constructor(body, serverMessage, breaks) {
+        super(400, body, serverMessage, 'judge_contract_mismatch', undefined);
+        this.breaks = breaks;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,3 @@
+export { reduceExecutionEvent, buildRunFromParams, type ExecutionStep, type StepVisibility, type StepTokens, type SubScriptTokens, type SubScriptTaskSummary, type LoopTurnSummary, type ActiveLineRef, type ActiveNodeRef, type ReducerSideEffects, type ValidationFailurePayload, } from './steps';
+export { replayEvents, createReplayController, type ReplayController, type ReplayState, } from './replay';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,3 @@
+export { reduceExecutionEvent, buildRunFromParams, } from './steps';
+export { replayEvents, createReplayController, } from './replay';
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAWnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,YAAY,EACZ,sBAAsB,GAGvB,MAAM,UAAU,CAAC"}

package/dist/execution/replay.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Replay stored EngineEvent[] arrays into ExecutionStep[] for display.
+ *
+ * Uses the same reducer as the live handler but processes events in bulk
+ * (no incremental state). Also exposes a step-through controller for
+ * historical debugging.
+ */
+import type { EngineEvent } from '../types';
+import { type ExecutionStep } from './steps';
+/** Apply the reducer to every event in order and return the resulting steps. */
+export declare function replayEvents(events: EngineEvent[]): ExecutionStep[];
+/**
+ * Step-through replay controller for historical executions. Allows stepping
+ * forward/backward through events one at a time, seeking to arbitrary
+ * positions, and getting the current active line.
+ */
+export type ReplayController = {
+    eventIndex: number;
+    totalEvents: number;
+    steps: ExecutionStep[];
+    activeLine: number | null;
+    stepForward(): ReplayState;
+    stepBackward(): ReplayState;
+    seekTo(index: number): ReplayState;
+};
+export type ReplayState = {
+    steps: ExecutionStep[];
+    activeLine: number | null;
+    eventIndex: number;
+    done: boolean;
+};
+/**
+ * Create a replay controller from a list of engine events. The controller
+ * replays from scratch on backward/seek (events are small, this is fast).
+ */
+export declare function createReplayController(events: EngineEvent[]): ReplayController;
+//# sourceMappingURL=replay.d.ts.map

package/dist/execution/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/execution/replay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,UAAU,CAAC;AACtD,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,SAAS,CAAC;AAEjB,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,CAenE;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,IAAI,WAAW,CAAC;IAC3B,YAAY,IAAI,WAAW,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CA2C9E"}

package/dist/execution/replay.js

@@ -0,0 +1,59 @@
+import { reduceExecutionEvent, } from './steps';
+/** Apply the reducer to every event in order and return the resulting steps. */
+export function replayEvents(events) {
+    let steps = [];
+    const activeLineRef = { current: null };
+    const activeNodeRef = { current: null };
+    for (const evt of events) {
+        const hubEvt = {
+            type: 'Execution',
+            payload: { project_id: 0, script_name: '', execution_id: '', event: evt },
+        };
+        const result = reduceExecutionEvent(steps, hubEvt, activeLineRef, activeNodeRef);
+        steps = result.steps;
+    }
+    return steps;
+}
+/**
+ * Create a replay controller from a list of engine events. The controller
+ * replays from scratch on backward/seek (events are small, this is fast).
+ */
+export function createReplayController(events) {
+    let currentIndex = 0;
+    let currentSteps = [];
+    let currentActiveLine = null;
+    function replayTo(targetIndex) {
+        const clamped = Math.max(0, Math.min(targetIndex, events.length));
+        let steps = [];
+        const activeLineRef = { current: null };
+        const activeNodeRef = { current: null };
+        for (let i = 0; i < clamped; i++) {
+            const hubEvt = {
+                type: 'Execution',
+                payload: { project_id: 0, script_name: '', execution_id: '', event: events[i] },
+            };
+            const result = reduceExecutionEvent(steps, hubEvt, activeLineRef, activeNodeRef);
+            steps = result.steps;
+        }
+        currentIndex = clamped;
+        currentSteps = steps;
+        currentActiveLine = activeLineRef.current;
+        return {
+            steps,
+            activeLine: activeLineRef.current,
+            eventIndex: clamped,
+            done: clamped >= events.length,
+        };
+    }
+    const controller = {
+        get eventIndex() { return currentIndex; },
+        get totalEvents() { return events.length; },
+        get steps() { return currentSteps; },
+        get activeLine() { return currentActiveLine; },
+        stepForward() { return replayTo(currentIndex + 1); },
+        stepBackward() { return replayTo(currentIndex - 1); },
+        seekTo(index) { return replayTo(index); },
+    };
+    return controller;
+}
+//# sourceMappingURL=replay.js.map

package/dist/execution/replay.js.map

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