@qitqode/qitqore 0.0.0-stage → 0.2.0

package/dist/errors.js

@@ -0,0 +1,254 @@
+import { parseRecoveryDirective } from "./recovery-directive.js";
+import { redactSensitiveText } from "./redaction.js";
+const SAFE_CODE = /^[A-Za-z0-9_.:-]{1,128}$/;
+const SAFE_REQUEST_ID = /^[A-Za-z0-9_.:-]{1,160}$/;
+const ACCEPTANCE_STATES = new Set(["unknown", "not-accepted", "accepted"]);
+const REPLAY_FLAGS = ["accepted", "partialOutput", "sideEffectStarted"];
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function boundedText(value, maxLength) {
+    if (typeof value !== "string")
+        return undefined;
+    return redactSensitiveText(value, maxLength) || undefined;
+}
+function safeCode(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const candidate = value.trim();
+    if (!SAFE_CODE.test(candidate))
+        return undefined;
+    // Error codes are useful evidence, but long unstructured identifiers can be
+    // API keys or tokens echoed into a server's code field.
+    if (candidate.length > 32 &&
+        !/^(?:ERR|E_|QORTEX|QLEX|AUTH|GATEWAY|VALIDATION|RATE_LIMIT|HTTP_)/i.test(candidate)) {
+        return undefined;
+    }
+    return candidate;
+}
+function safeRequestId(value) {
+    const candidate = value?.trim();
+    return candidate && SAFE_REQUEST_ID.test(candidate) ? candidate : undefined;
+}
+/** The first safe request ID named in an error body, read from the documented envelope locations. */
+export function qortexErrorRequestId(payload) {
+    return envelopeRecords(payload)
+        .map((item) => safeRequestId(typeof item.requestId === "string" ? item.requestId : undefined))
+        .find((value) => value !== undefined);
+}
+/**
+ * The error envelope may appear at the top level, under `error`, or under
+ * `details`. Those are the documented locations, and each is read once here,
+ * before the raw payload is discarded.
+ */
+function envelopeRecords(payload) {
+    const outer = record(payload);
+    if (!outer)
+        return [];
+    return [outer, record(outer.error), record(outer.details)].filter((item) => item !== undefined);
+}
+function replayEvidence(records) {
+    const evidence = {};
+    for (const flag of REPLAY_FLAGS) {
+        // Any value other than an explicit `false` is ambiguous, and ambiguity blocks replay.
+        if (records.some((item) => item[flag] != null && item[flag] !== false))
+            evidence[flag] = true;
+    }
+    const reported = records.map((item) => item.acceptance).filter((value) => value != null);
+    if (reported.some((value) => value !== "not-accepted"))
+        evidence.accepted = true;
+    if (reported.length === 0)
+        return evidence;
+    if (reported.includes("accepted"))
+        evidence.acceptance = "accepted";
+    else if (reported.includes("unknown"))
+        evidence.acceptance = "unknown";
+    else if (reported.every((value) => value === "not-accepted"))
+        evidence.acceptance = "not-accepted";
+    return evidence;
+}
+/**
+ * Read only the bounded evidence from an error payload. Raw strings, unknown
+ * fields, and credentials are never copied into the result.
+ */
+export function qortexErrorEvidence(payload) {
+    const records = envelopeRecords(payload);
+    if (records.length === 0)
+        return { contractVersion: 1, replayEvidenceAvailable: false };
+    const directiveSource = records.map((item) => item.recoveryDirective).find((value) => value !== undefined);
+    const directive = directiveSource === undefined ? undefined : parseDirectiveSafely(directiveSource);
+    const retryable = explicitRetryable(records, directive);
+    return {
+        contractVersion: 1,
+        replayEvidenceAvailable: true,
+        ...replayEvidence(records),
+        ...(directive === undefined ? {} : { recoveryDirective: directive }),
+        ...(retryable === undefined ? {} : { retryable }),
+    };
+}
+/**
+ * The server's own verdict. An explicit `false` is terminal. Otherwise a valid
+ * directive decides, and then an explicit `true` from the envelope.
+ */
+function explicitRetryable(records, directive) {
+    const verdicts = records
+        .map((item) => item.retryable)
+        .filter((value) => typeof value === "boolean");
+    if (verdicts.includes(false))
+        return false;
+    if (directive !== undefined)
+        return directive.retryable;
+    if (verdicts.includes(true))
+        return true;
+    return undefined;
+}
+function parseDirectiveSafely(value) {
+    // A malformed or future directive is omitted rather than reflected to the caller.
+    try {
+        return parseRecoveryDirective(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** True when any server evidence forbids replaying the failed attempt. */
+export function hasReplayBlockingEvidence(evidence) {
+    return (evidence !== undefined &&
+        (evidence.accepted === true ||
+            evidence.partialOutput === true ||
+            evidence.sideEffectStarted === true ||
+            (evidence.acceptance !== undefined && evidence.acceptance !== "not-accepted")));
+}
+/** The server's explicit verdict wins. Otherwise the HTTP status decides. */
+function resolveRetryable(status, evidence) {
+    if (evidence.retryable !== undefined)
+        return evidence.retryable;
+    return status === 408 || status === 425 || status === 429 || status >= 500;
+}
+export class QortexError extends Error {
+    category;
+    code;
+    status;
+    requestId;
+    retryable;
+    evidence;
+    constructor(details, options = {}) {
+        super(details.message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "QortexError";
+        this.category = details.category;
+        this.code = details.code;
+        this.status = details.status;
+        this.requestId = details.requestId;
+        this.retryable = details.retryable;
+        this.evidence = details.evidence;
+    }
+    toJSON() {
+        return {
+            category: this.category,
+            message: this.message,
+            ...(this.code ? { code: this.code } : {}),
+            ...(this.status === undefined ? {} : { status: this.status }),
+            ...(this.requestId ? { requestId: this.requestId } : {}),
+            retryable: this.retryable,
+            ...(this.evidence ? { evidence: this.evidence } : {}),
+        };
+    }
+}
+export class QortexHttpError extends QortexError {
+    constructor(details, options = {}) {
+        super(details, options);
+        this.name = "QortexHttpError";
+    }
+}
+export class QortexTimeoutError extends QortexError {
+    constructor(timeoutMs, options = {}) {
+        super({
+            category: "timeout",
+            code: "QORTEX_REQUEST_TIMEOUT",
+            message: `Qortex did not complete the request within ${timeoutMs}ms`,
+            retryable: true,
+        }, options);
+        this.name = "QortexTimeoutError";
+    }
+}
+export class QortexTransportError extends QortexError {
+    constructor(options = {}) {
+        super({
+            category: "transport",
+            code: "QORTEX_TRANSPORT_ERROR",
+            message: "The Qortex request failed before a response was received",
+            retryable: true,
+        }, options);
+        this.name = "QortexTransportError";
+    }
+}
+export class QortexProtocolError extends QortexError {
+    constructor(message, status, requestId) {
+        super({
+            category: "protocol",
+            code: "QORTEX_PROTOCOL_ERROR",
+            message: boundedText(message, 512) ?? "Qortex returned an invalid response",
+            ...(status === undefined ? {} : { status }),
+            ...(requestId ? { requestId } : {}),
+            retryable: false,
+        });
+        this.name = "QortexProtocolError";
+    }
+}
+export function qortexHttpError(status, payload, headers) {
+    const outer = record(payload);
+    const nested = record(outer?.error);
+    const evidence = qortexErrorEvidence(payload);
+    const code = safeCode(outer?.code) ??
+        safeCode(nested?.code) ??
+        (typeof outer?.error === "string" ? safeCode(outer.error) : undefined) ??
+        `QORTEX_HTTP_${status}`;
+    const message = boundedText(outer?.message, 512) ??
+        boundedText(outer?.error_description, 512) ??
+        boundedText(nested?.message, 512) ??
+        (typeof outer?.error === "string" ? boundedText(outer.error, 512) : undefined) ??
+        `Qortex returned HTTP ${status}`;
+    const requestHeaders = new Headers(headers);
+    const requestId = safeRequestId(requestHeaders.get("x-request-id")) ??
+        safeRequestId(requestHeaders.get("request-id")) ??
+        safeRequestId(requestHeaders.get("x-qlex-request-id")) ??
+        qortexErrorRequestId(payload);
+    const envelopeFailure = outer?.success === false;
+    let category;
+    if (envelopeFailure && status < 400)
+        category = "protocol";
+    else if (status === 401 ||
+        (status === 403 && /credential|authentication|unauthori[sz]ed/i.test(code))) {
+        category = "credentials";
+    }
+    else if (status === 403)
+        category = "authorization";
+    else if (/gateway|routing|upstream/i.test(code))
+        category = "gateway";
+    else if (status === 400 || status === 422)
+        category = "validation";
+    else if (status === 429)
+        category = "rate-limit";
+    else if (status === 502 || status === 503 || status === 504)
+        category = "gateway";
+    else if (status >= 500)
+        category = "server";
+    else
+        category = "http";
+    return new QortexHttpError({
+        category,
+        message,
+        code,
+        status,
+        ...(requestId ? { requestId } : {}),
+        retryable: resolveRetryable(status, evidence),
+        evidence,
+    });
+}
+export function isAbortError(error) {
+    return ((error instanceof Error && error.name === "AbortError") ||
+        (error instanceof Error && error.name === "TimeoutError"));
+}
+//# 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/index.d.ts

@@ -0,0 +1,13 @@
+export { QortexError, QortexHttpError, QortexProtocolError, QortexTimeoutError, QortexTransportError, hasReplayBlockingEvidence, isAbortError, qortexErrorEvidence, qortexErrorRequestId, qortexHttpError, type QortexAcceptanceState, type QortexErrorCategory, type QortexErrorDetails, type QortexErrorEvidence, } from "./errors.js";
+export { classifyQortexStreamPayload, type QortexCostFrameID, type QortexStreamPayload, type QortexUsageFrameID, } from "./stream-payload.js";
+export { createSecretRedactor, secretEncodings, type SecretRedactionStream, type SecretRedactor, type SecretRedactorOptions, } from "./redaction.js";
+export { DeviceAuthorizationProtocolError, classifyDeviceTokenPoll, deviceAuthorizationExpired, parseDeviceAuthorizationStart, type DeviceAuthorizationStart, type DeviceTokenPollOutcome, } from "./device-authorization.js";
+export { QortexClient, createQortexClient, isQortexHttpError, unwrapSuccessEnvelope, type QortexClientOptions, type QortexJsonResult, type QortexRequestPolicy, } from "./transport.js";
+export { SseDecoder, iterateSse, type QortexSseEvent, } from "./sse.js";
+export { parseRecoveryStatus, type QortexExecutionState, type QortexRecoveryStatus, type QortexResultRecovery, } from "./recovery-status.js";
+export { parseRecoveryCapabilities, parseRecoveryCapability, type QortexRecoveryCapabilities, type QortexRecoveryCapability, type QortexRecoveryMode, type QortexRecoveryRetry, type QortexRecoveryReplay, type QortexRecoveryResume, type QortexRecoveryReconciliation, } from "./recovery-capabilities.js";
+export { parseRecoveryDirective, type QortexRecoveryDirective, type QortexRecoveryFailureLayer, type QortexRecoveryFailureCategory, type QortexRecommendedRecoveryAction, } from "./recovery-directive.js";
+export { MAX_RECOVERY_ADDITIONAL_WORK, MAX_RECOVERY_ROOT_REMAINING_MS, QORTEX_RECOVERY_CONTROL_HEADER, decodeRecoveryControlHeader, encodeRecoveryControlEnvelope, parseRecoveryControlEnvelope, parseRecoveryLeaseUsage, withRecoveryControlHeader, type QortexRecoveryAction, type QortexRecoveryAdditionalWorkAction, type QortexRecoveryConsumedWork, type QortexRecoveryControlEnvelope, type QortexRecoveryControlOperation, type QortexRecoveryLeaseUsage, } from "./recovery-lease.js";
+export { qortexModuleEndpoint, qortexRequestHeaders, recoveryRouteID, } from "./route-contract.js";
+export { abortableDelay, runWithRecovery, type AttemptOutcome, type QortexAttemptContext, type RecoveryAttemptOutcomeContext, type RecoveryOptions, type RemoteAcceptance, type ReplayAuthorizationContext, } from "./recovery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,UAAU,EACV,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,GACrC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kCAAkC,EACvC,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { QortexError, QortexHttpError, QortexProtocolError, QortexTimeoutError, QortexTransportError, hasReplayBlockingEvidence, isAbortError, qortexErrorEvidence, qortexErrorRequestId, qortexHttpError, } from "./errors.js";
+export { classifyQortexStreamPayload, } from "./stream-payload.js";
+export { createSecretRedactor, secretEncodings, } from "./redaction.js";
+export { DeviceAuthorizationProtocolError, classifyDeviceTokenPoll, deviceAuthorizationExpired, parseDeviceAuthorizationStart, } from "./device-authorization.js";
+export { QortexClient, createQortexClient, isQortexHttpError, unwrapSuccessEnvelope, } from "./transport.js";
+export { SseDecoder, iterateSse, } from "./sse.js";
+export { parseRecoveryStatus, } from "./recovery-status.js";
+export { parseRecoveryCapabilities, parseRecoveryCapability, } from "./recovery-capabilities.js";
+export { parseRecoveryDirective, } from "./recovery-directive.js";
+export { MAX_RECOVERY_ADDITIONAL_WORK, MAX_RECOVERY_ROOT_REMAINING_MS, QORTEX_RECOVERY_CONTROL_HEADER, decodeRecoveryControlHeader, encodeRecoveryControlEnvelope, parseRecoveryControlEnvelope, parseRecoveryLeaseUsage, withRecoveryControlHeader, } from "./recovery-lease.js";
+export { qortexModuleEndpoint, qortexRequestHeaders, recoveryRouteID, } from "./route-contract.js";
+export { abortableDelay, runWithRecovery, } from "./recovery.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,GAKhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,2BAA2B,GAI5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,eAAe,GAIhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,GAG9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GAItB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,UAAU,GAEX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,mBAAmB,GAIpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GAQxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,GAKvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,GAO1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,eAAe,GAOhB,MAAM,eAAe,CAAC"}

package/dist/recovery-capabilities.d.ts

@@ -0,0 +1,26 @@
+export type QortexRecoveryMode = "buffered" | "streaming" | "async_job" | "utility";
+export type QortexRecoveryRetry = "pre_execution_only" | "safe_observation" | "unsupported";
+export type QortexRecoveryReplay = "retained_result" | "unsupported";
+export type QortexRecoveryResume = "supported" | "unsupported";
+export type QortexRecoveryReconciliation = "recovery_status" | "billing_status_only" | "job_status" | "unsupported";
+export interface QortexRecoveryCapability {
+    contractVersion: 1;
+    routeID: string;
+    mode: QortexRecoveryMode;
+    retry: QortexRecoveryRetry;
+    replay: QortexRecoveryReplay;
+    resume: QortexRecoveryResume;
+    reconciliation: QortexRecoveryReconciliation;
+    requiresIdempotencyKey: boolean;
+    retentionMs?: number;
+    maxBackendAdditionalWork: number;
+}
+export interface QortexRecoveryCapabilities {
+    contractVersion: 1;
+    capabilities: QortexRecoveryCapability[];
+}
+/** Parse one route capability. Unrecognized fields are rejected rather than forwarded. */
+export declare function parseRecoveryCapability(value: unknown): QortexRecoveryCapability;
+/** Parse only bounded route facts; never pass through unrecognized server metadata. */
+export declare function parseRecoveryCapabilities(value: unknown): QortexRecoveryCapabilities;
+//# sourceMappingURL=recovery-capabilities.d.ts.map

package/dist/recovery-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-capabilities.d.ts","sourceRoot":"","sources":["../src/recovery-capabilities.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AACpF,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAC5F,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,aAAa,CAAC;AACrE,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,aAAa,CAAC;AAC/D,MAAM,MAAM,4BAA4B,GACpC,iBAAiB,GACjB,qBAAqB,GACrB,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,CAAC,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,cAAc,EAAE,4BAA4B,CAAC;IAC7C,sBAAsB,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,CAAC,CAAC;IACnB,YAAY,EAAE,wBAAwB,EAAE,CAAC;CAC1C;AAsCD,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAqDhF;AAED,uFAAuF;AACvF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAyBpF"}

package/dist/recovery-capabilities.js

@@ -0,0 +1,113 @@
+const MODES = new Set(["buffered", "streaming", "async_job", "utility"]);
+const RETRIES = new Set(["pre_execution_only", "safe_observation", "unsupported"]);
+const REPLAYS = new Set(["retained_result", "unsupported"]);
+const RESUMES = new Set(["supported", "unsupported"]);
+const RECONCILIATIONS = new Set([
+    "recovery_status",
+    "billing_status_only",
+    "job_status",
+    "unsupported",
+]);
+const MANIFEST_FIELDS = new Set(["success", "contractVersion", "capabilities"]);
+const CAPABILITY_FIELDS = new Set([
+    "contractVersion",
+    "routeID",
+    "mode",
+    "retry",
+    "replay",
+    "resume",
+    "reconciliation",
+    "requiresIdempotencyKey",
+    "retentionMs",
+    "maxBackendAdditionalWork",
+]);
+const MAX_CAPABILITIES = 512;
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function boundedString(value, field, maxLength) {
+    if (typeof value !== "string" || value.length === 0 || value.length > maxLength) {
+        throw new TypeError(`Qortex recovery capabilities have an invalid ${field}`);
+    }
+    return value;
+}
+/** Parse one route capability. Unrecognized fields are rejected rather than forwarded. */
+export function parseRecoveryCapability(value) {
+    if (!isRecord(value))
+        throw new TypeError("Qortex recovery capability must be an object");
+    for (const key of Object.keys(value)) {
+        if (!CAPABILITY_FIELDS.has(key)) {
+            throw new TypeError("Qortex recovery capability contains an unsupported field");
+        }
+    }
+    if (value.contractVersion !== 1) {
+        throw new TypeError("Qortex recovery capability uses an unsupported contract version");
+    }
+    if (typeof value.mode !== "string" || !MODES.has(value.mode)) {
+        throw new TypeError("Qortex recovery capability has an invalid mode");
+    }
+    if (typeof value.retry !== "string" || !RETRIES.has(value.retry)) {
+        throw new TypeError("Qortex recovery capability has an invalid retry policy");
+    }
+    if (typeof value.replay !== "string" || !REPLAYS.has(value.replay)) {
+        throw new TypeError("Qortex recovery capability has an invalid replay policy");
+    }
+    if (typeof value.resume !== "string" || !RESUMES.has(value.resume)) {
+        throw new TypeError("Qortex recovery capability has an invalid resume policy");
+    }
+    if (typeof value.reconciliation !== "string" || !RECONCILIATIONS.has(value.reconciliation)) {
+        throw new TypeError("Qortex recovery capability has an invalid reconciliation policy");
+    }
+    if (typeof value.requiresIdempotencyKey !== "boolean") {
+        throw new TypeError("Qortex recovery capability has an invalid idempotency requirement");
+    }
+    if (!Number.isSafeInteger(value.maxBackendAdditionalWork) ||
+        value.maxBackendAdditionalWork < 0) {
+        throw new TypeError("Qortex recovery capability has an invalid additional-work limit");
+    }
+    if (value.retentionMs !== undefined &&
+        (!Number.isSafeInteger(value.retentionMs) || value.retentionMs <= 0)) {
+        throw new TypeError("Qortex recovery capability has an invalid retention period");
+    }
+    return {
+        contractVersion: 1,
+        routeID: boundedString(value.routeID, "routeID", 256),
+        mode: value.mode,
+        retry: value.retry,
+        replay: value.replay,
+        resume: value.resume,
+        reconciliation: value.reconciliation,
+        requiresIdempotencyKey: value.requiresIdempotencyKey,
+        ...(value.retentionMs === undefined ? {} : { retentionMs: value.retentionMs }),
+        maxBackendAdditionalWork: value.maxBackendAdditionalWork,
+    };
+}
+/** Parse only bounded route facts; never pass through unrecognized server metadata. */
+export function parseRecoveryCapabilities(value) {
+    if (!isRecord(value))
+        throw new TypeError("Qortex recovery capabilities must be an object");
+    let candidate = value;
+    if (value.success === true && Object.hasOwn(value, "data"))
+        candidate = value.data;
+    if (!isRecord(candidate))
+        throw new TypeError("Qortex recovery capabilities data must be an object");
+    for (const key of Object.keys(candidate)) {
+        if (!MANIFEST_FIELDS.has(key)) {
+            throw new TypeError("Qortex recovery capabilities contain an unsupported field");
+        }
+    }
+    if (candidate.success !== undefined && candidate.success !== true) {
+        throw new TypeError("Qortex recovery capabilities have an invalid success marker");
+    }
+    if (candidate.contractVersion !== 1) {
+        throw new TypeError("Qortex recovery capabilities use an unsupported contract version");
+    }
+    if (!Array.isArray(candidate.capabilities) || candidate.capabilities.length > MAX_CAPABILITIES) {
+        throw new TypeError("Qortex recovery capabilities have an invalid capability list");
+    }
+    return {
+        contractVersion: 1,
+        capabilities: candidate.capabilities.map(parseRecoveryCapability),
+    };
+}
+//# sourceMappingURL=recovery-capabilities.js.map

package/dist/recovery-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-capabilities.js","sourceRoot":"","sources":["../src/recovery-capabilities.ts"],"names":[],"mappings":"AA4BA,MAAM,KAAK,GAAG,IAAI,GAAG,CAAqB,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7F,MAAM,OAAO,GAAG,IAAI,GAAG,CAAsB,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC;AACxG,MAAM,OAAO,GAAG,IAAI,GAAG,CAAuB,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;AAClF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAuB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AAC5E,MAAM,eAAe,GAAG,IAAI,GAAG,CAA+B;IAC5D,iBAAiB;IACjB,qBAAqB;IACrB,YAAY;IACZ,aAAa;CACd,CAAC,CAAC;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC,CAAC;AAChF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,iBAAiB;IACjB,SAAS;IACT,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,gBAAgB;IAChB,wBAAwB;IACxB,aAAa;IACb,0BAA0B;CAC3B,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,KAAa,EAAE,SAAiB;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAChF,MAAM,IAAI,SAAS,CAAC,gDAAgD,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IAC1F,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAA0B,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAA4B,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAA8B,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAA8B,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,cAA8C,CAAC,EAAE,CAAC;QAC3H,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC,mEAAmE,CAAC,CAAC;IAC3F,CAAC;IACD,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,wBAAwB,CAAC;QACpD,KAAK,CAAC,wBAAmC,GAAG,CAAC,EAC9C,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;IACzF,CAAC;IACD,IACE,KAAK,CAAC,WAAW,KAAK,SAAS;QAC/B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,IAAK,KAAK,CAAC,WAAsB,IAAI,CAAC,CAAC,EAChF,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,4DAA4D,CAAC,CAAC;IACpF,CAAC;IAED,OAAO;QACL,eAAe,EAAE,CAAC;QAClB,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC;QACrD,IAAI,EAAE,KAAK,CAAC,IAA0B;QACtC,KAAK,EAAE,KAAK,CAAC,KAA4B;QACzC,MAAM,EAAE,KAAK,CAAC,MAA8B;QAC5C,MAAM,EAAE,KAAK,CAAC,MAA8B;QAC5C,cAAc,EAAE,KAAK,CAAC,cAA8C;QACpE,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAqB,EAAE,CAAC;QACxF,wBAAwB,EAAE,KAAK,CAAC,wBAAkC;KACnE,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IAC5F,IAAI,SAAS,GAAY,KAAK,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;QAAE,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;IACnF,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAErG,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,SAAS,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,SAAS,CAAC,kEAAkE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC/F,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACtF,CAAC;IAED,OAAO;QACL,eAAe,EAAE,CAAC;QAClB,YAAY,EAAE,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAuB,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/recovery-directive.d.ts

@@ -0,0 +1,20 @@
+import type { QortexExecutionState } from "./recovery-status.js";
+export type QortexRecoveryFailureLayer = "client" | "qortex_transport" | "qortex_auth" | "qortex_harness" | "omniquery_inference" | "tool" | "verification" | "capability";
+export type QortexRecoveryFailureCategory = "backend_unavailable" | "authentication_rejected" | "backend_harness_failed" | "inference_failed" | "tool_failed" | "tool_running" | "verification_failed" | "unsupported_capability" | "rate_limited" | "operation_budget_exhausted" | "operation_deadline_expired" | "effect_outcome_unknown" | "cancelled" | "invalid_request" | "internal_failure";
+export type QortexRecommendedRecoveryAction = "retry_same_work" | "replay_retained_result" | "continue_partial" | "change_approach" | "reconcile" | "wait" | "reauthenticate" | "stop";
+export interface QortexRecoveryDirective {
+    contractVersion: 1;
+    policyVersion: string;
+    category: QortexRecoveryFailureCategory;
+    layer: QortexRecoveryFailureLayer;
+    stage: string;
+    executionState: QortexExecutionState | "accepted" | "cancelled";
+    recommendedAction: QortexRecommendedRecoveryAction;
+    retryable: boolean;
+    reasonCode: string;
+    requestID?: string;
+    retryAfterMs?: number;
+}
+/** Parse the public directive without retaining unrecognized provider or server fields. */
+export declare function parseRecoveryDirective(value: unknown): QortexRecoveryDirective;
+//# sourceMappingURL=recovery-directive.d.ts.map

package/dist/recovery-directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-directive.d.ts","sourceRoot":"","sources":["../src/recovery-directive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,kBAAkB,GAClB,aAAa,GACb,gBAAgB,GAChB,qBAAqB,GACrB,MAAM,GACN,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,MAAM,6BAA6B,GACrC,qBAAqB,GACrB,yBAAyB,GACzB,wBAAwB,GACxB,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,qBAAqB,GACrB,wBAAwB,GACxB,cAAc,GACd,4BAA4B,GAC5B,4BAA4B,GAC5B,wBAAwB,GACxB,WAAW,GACX,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,+BAA+B,GACvC,iBAAiB,GACjB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,GACjB,WAAW,GACX,MAAM,GACN,gBAAgB,GAChB,MAAM,CAAC;AAEX,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,CAAC,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,6BAA6B,CAAC;IACxC,KAAK,EAAE,0BAA0B,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,oBAAoB,GAAG,UAAU,GAAG,WAAW,CAAC;IAChE,iBAAiB,EAAE,+BAA+B,CAAC;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA8DD,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAyD9E"}

package/dist/recovery-directive.js

@@ -0,0 +1,116 @@
+const CATEGORIES = new Set([
+    "backend_unavailable",
+    "authentication_rejected",
+    "backend_harness_failed",
+    "inference_failed",
+    "tool_failed",
+    "tool_running",
+    "verification_failed",
+    "unsupported_capability",
+    "rate_limited",
+    "operation_budget_exhausted",
+    "operation_deadline_expired",
+    "effect_outcome_unknown",
+    "cancelled",
+    "invalid_request",
+    "internal_failure",
+]);
+const LAYERS = new Set([
+    "client",
+    "qortex_transport",
+    "qortex_auth",
+    "qortex_harness",
+    "omniquery_inference",
+    "tool",
+    "verification",
+    "capability",
+]);
+const ACTIONS = new Set([
+    "retry_same_work",
+    "replay_retained_result",
+    "continue_partial",
+    "change_approach",
+    "reconcile",
+    "wait",
+    "reauthenticate",
+    "stop",
+]);
+const EXECUTION_STATES = new Set(["not_started", "accepted", "running", "succeeded", "failed", "unknown", "cancelled"]);
+const FIELDS = new Set([
+    "contractVersion",
+    "policyVersion",
+    "category",
+    "layer",
+    "stage",
+    "executionState",
+    "recommendedAction",
+    "retryable",
+    "reasonCode",
+    "requestID",
+    "retryAfterMs",
+]);
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function matches(value, pattern) {
+    return typeof value === "string" && pattern.test(value);
+}
+/** Parse the public directive without retaining unrecognized provider or server fields. */
+export function parseRecoveryDirective(value) {
+    if (!isRecord(value))
+        throw new TypeError("Qortex recovery directive must be an object");
+    for (const key of Object.keys(value)) {
+        if (!FIELDS.has(key))
+            throw new TypeError("Qortex recovery directive contains an unsupported field");
+    }
+    if (value.contractVersion !== 1) {
+        throw new TypeError("Qortex recovery directive uses an unsupported contract version");
+    }
+    if (!matches(value.policyVersion, /^[A-Za-z0-9_.:-]{1,256}$/)) {
+        throw new TypeError("Qortex recovery directive has an invalid policyVersion");
+    }
+    if (typeof value.category !== "string" || !CATEGORIES.has(value.category)) {
+        throw new TypeError("Qortex recovery directive has an invalid category");
+    }
+    if (typeof value.layer !== "string" || !LAYERS.has(value.layer)) {
+        throw new TypeError("Qortex recovery directive has an invalid layer");
+    }
+    if (!matches(value.stage, /^[A-Za-z0-9_.:-]{1,128}$/)) {
+        throw new TypeError("Qortex recovery directive has an invalid stage");
+    }
+    if (typeof value.executionState !== "string" || !EXECUTION_STATES.has(value.executionState)) {
+        throw new TypeError("Qortex recovery directive has an invalid executionState");
+    }
+    if (typeof value.recommendedAction !== "string" || !ACTIONS.has(value.recommendedAction)) {
+        throw new TypeError("Qortex recovery directive has an invalid recommendedAction");
+    }
+    if (typeof value.retryable !== "boolean") {
+        throw new TypeError("Qortex recovery directive has an invalid retryable flag");
+    }
+    if (!matches(value.reasonCode, /^[a-z0-9_:-]{1,256}$/)) {
+        throw new TypeError("Qortex recovery directive has an invalid reasonCode");
+    }
+    if (value.requestID !== undefined && !matches(value.requestID, /^[A-Za-z0-9_.:/-]{1,256}$/)) {
+        throw new TypeError("Qortex recovery directive has an invalid requestID");
+    }
+    if (value.retryAfterMs !== undefined &&
+        (!Number.isSafeInteger(value.retryAfterMs) ||
+            value.retryAfterMs < 0 ||
+            value.retryAfterMs > 86_400_000)) {
+        throw new TypeError("Qortex recovery directive has an invalid retryAfterMs");
+    }
+    return {
+        contractVersion: 1,
+        policyVersion: value.policyVersion,
+        category: value.category,
+        layer: value.layer,
+        stage: value.stage,
+        executionState: value.executionState,
+        recommendedAction: value.recommendedAction,
+        retryable: value.retryable,
+        reasonCode: value.reasonCode,
+        ...(value.requestID === undefined ? {} : { requestID: value.requestID }),
+        ...(value.retryAfterMs === undefined ? {} : { retryAfterMs: value.retryAfterMs }),
+    };
+}
+//# sourceMappingURL=recovery-directive.js.map

package/dist/recovery-directive.js.map

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