bulkhead-runtime 0.1.0 → 2026.4.5-beta.2

package/dist/runtime/context-guard.js

@@ -0,0 +1,61 @@
+// Ported from OpenClaw src/agents/context-window-guard.ts
+// Identical thresholds (16K hard min, 32K warn) and resolution logic.
+import { createSubsystemLogger } from "../logging/subsystem.js";
+const log = createSubsystemLogger("context-guard");
+export const CONTEXT_WINDOW_HARD_MIN_TOKENS = 16_000;
+export const CONTEXT_WINDOW_WARN_BELOW_TOKENS = 32_000;
+const DEFAULT_CONTEXT_TOKENS = 128_000;
+const CHARS_PER_TOKEN = 4;
+function normalizePositiveInt(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    const int = Math.floor(value);
+    return int > 0 ? int : null;
+}
+export function resolveContextWindowInfo(params) {
+    // Check models.providers config first (highest priority override)
+    if (params.modelsProviderConfig && params.modelId) {
+        const match = params.modelsProviderConfig.find((m) => m?.id === params.modelId);
+        const fromConfig = normalizePositiveInt(match?.contextWindow);
+        if (fromConfig)
+            return { tokens: fromConfig, source: "modelsConfig" };
+    }
+    const fromModel = normalizePositiveInt(params.modelContextWindow);
+    const baseInfo = fromModel
+        ? { tokens: fromModel, source: "model" }
+        : { tokens: Math.floor(params.defaultTokens ?? DEFAULT_CONTEXT_TOKENS), source: "default" };
+    const capTokens = normalizePositiveInt(params.configContextTokens);
+    if (capTokens && capTokens < baseInfo.tokens) {
+        return { tokens: capTokens, source: "agentContextTokens" };
+    }
+    return baseInfo;
+}
+export function evaluateContextWindowGuard(params) {
+    const warnBelow = Math.max(1, Math.floor(params.warnBelowTokens ?? CONTEXT_WINDOW_WARN_BELOW_TOKENS));
+    const hardMin = Math.max(1, Math.floor(params.hardMinTokens ?? CONTEXT_WINDOW_HARD_MIN_TOKENS));
+    const tokens = Math.max(0, Math.floor(params.info.tokens));
+    const result = {
+        ...params.info,
+        tokens,
+        shouldWarn: tokens > 0 && tokens < warnBelow,
+        shouldBlock: tokens > 0 && tokens < hardMin,
+    };
+    if (result.shouldBlock) {
+        log.error(`context window too small: ${tokens} tokens (minimum: ${hardMin})`);
+    }
+    else if (result.shouldWarn) {
+        log.warn(`context window is small: ${tokens} tokens (recommended: >${warnBelow})`);
+    }
+    return result;
+}
+export function estimateTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+export function estimateMessagesTokens(messages) {
+    let total = 0;
+    for (const msg of messages) {
+        total += estimateTokens(msg.content ?? "") + 4;
+    }
+    return total;
+}
+//# sourceMappingURL=context-guard.js.map

package/dist/runtime/context-guard.js.map

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

package/dist/runtime/failover-error.d.ts

@@ -0,0 +1,62 @@
+export type FailoverReason = "auth" | "auth_permanent" | "format" | "rate_limit" | "overloaded" | "billing" | "timeout" | "model_not_found" | "session_expired" | "unknown";
+export type FailoverSignal = {
+    status?: number;
+    code?: string;
+    message?: string;
+};
+export type FailoverClassification = {
+    kind: "reason";
+    reason: FailoverReason;
+} | {
+    kind: "context_overflow";
+};
+export declare class FailoverError extends Error {
+    readonly reason: FailoverReason;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly profileId?: string;
+    readonly status?: number;
+    readonly code?: string;
+    constructor(message: string, params: {
+        reason: FailoverReason;
+        provider?: string;
+        model?: string;
+        profileId?: string;
+        status?: number;
+        code?: string;
+        cause?: unknown;
+    });
+}
+export declare function isFailoverError(err: unknown): err is FailoverError;
+export declare function resolveFailoverStatus(reason: FailoverReason): number | undefined;
+export declare function isRateLimitErrorMessage(raw: string): boolean;
+export declare function isTimeoutErrorMessage(raw: string): boolean;
+export declare function isOverloadedErrorMessage(raw: string): boolean;
+export declare function isBillingErrorMessage(raw: string): boolean;
+export declare function isAuthPermanentErrorMessage(raw: string): boolean;
+export declare function isAuthErrorMessage(raw: string): boolean;
+export declare function isTransientHttpError(raw: string): boolean;
+export declare function isModelNotFoundErrorMessage(raw: string): boolean;
+export declare function isImageDimensionErrorMessage(raw: string): boolean;
+export declare function isImageSizeError(errorMessage?: string): boolean;
+export declare function isCliSessionExpiredErrorMessage(raw: string): boolean;
+export declare function isPeriodicUsageLimitErrorMessage(raw: string): boolean;
+export declare function matchesProviderContextOverflow(errorMessage: string): boolean;
+export declare function classifyProviderSpecificError(errorMessage: string): FailoverReason | null;
+export declare function isContextOverflowError(errorMessage?: string): boolean;
+export declare function isLikelyContextOverflowError(errorMessage?: string): boolean;
+export declare function classifyFailoverSignal(signal: FailoverSignal): FailoverClassification | null;
+export declare function isTimeoutError(err: unknown): boolean;
+export declare function resolveFailoverReasonFromError(err: unknown): FailoverReason | null;
+export declare function describeFailoverError(err: unknown): {
+    message: string;
+    reason?: FailoverReason;
+    status?: number;
+    code?: string;
+};
+export declare function coerceToFailoverError(err: unknown, context?: {
+    provider?: string;
+    model?: string;
+    profileId?: string;
+}): FailoverError | null;
+//# sourceMappingURL=failover-error.d.ts.map

package/dist/runtime/failover-error.d.ts.map

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