bulkhead-runtime 0.1.0 → 2026.4.5-beta.1

package/dist/runtime/agent.js

@@ -6,12 +6,32 @@ import { createEmbeddingProvider } from "../memory/embeddings.js";
 import { getOrCreateSession, updateSession, } from "../sessions/index.js";
 import { loadWorkspaceSkills } from "../skills/index.js";
 import { loadConfig, resolveStateDir, } from "../config/index.js";
+import { DEFAULT_MODEL, DEFAULT_PROVIDER, LINUX_REQUIRED_MESSAGE, buildProviderEnvKey, resolveSessionManager, extractAssistantResponse, } from "../shared/index.js";
+import { createMemoryTools } from "./memory-tools.js";
+import { runWithModelFallback } from "./model-fallback.js";
+import { resolveContextWindowInfo, evaluateContextWindowGuard, CONTEXT_WINDOW_HARD_MIN_TOKENS, } from "./context-guard.js";
+import { retryAsync } from "./retry.js";
+import { isLikelyContextOverflowError, isTimeoutErrorMessage, isRateLimitErrorMessage } from "./failover-error.js";
+import { executeWithApiKeyRotation, collectProviderApiKeys, } from "./api-key-rotation.js";
+import { createSubagentTool } from "./subagent.js";
+import { shouldRunMemoryFlush, createMemoryFlushState, markMemoryFlushed, MEMORY_FLUSH_PROMPT, MEMORY_FLUSH_SYSTEM_PROMPT, } from "./memory-flush.js";
+import { createSubsystemLogger, configureLogger } from "../logging/subsystem.js";
 import * as path from "node:path";
 import * as fs from "node:fs";
+const log = createSubsystemLogger("runtime");
+function assertLinux() {
+    if (process.platform !== "linux") {
+        throw new Error(LINUX_REQUIRED_MESSAGE);
+    }
+}
 export async function createRuntime(overrides) {
-    const fileConfig = loadConfig(overrides?.stateDir);
+    assertLinux();
+    const fileConfig = loadConfig(overrides?.configPath);
     const config = { ...fileConfig, ...overrides };
     const stateDir = resolveStateDir(config);
+    if (config.logging) {
+        configureLogger(config.logging);
+    }
     const hooks = createHookRunner();
     const memoryDir = config.memory?.dir ?? path.join(stateDir, "memory");
     // Create embedding provider from config if available
@@ -20,21 +40,20 @@ export async function createRuntime(overrides) {
         : undefined;
     const memory = createSimpleMemoryManager({ dbDir: memoryDir, embeddingProvider });
     fs.mkdirSync(stateDir, { recursive: true });
+    const memoryFlushState = createMemoryFlushState();
     async function run(options) {
         const sessionId = options.sessionId ?? `session_${Date.now()}`;
-        const modelId = options.model ?? config.model ?? "claude-sonnet-4-20250514";
-        const provider = (options.provider ?? config.provider ?? "anthropic");
-        const providerEnvKey = `${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`;
-        const apiKey = options.apiKey ?? config.apiKey ?? process.env[providerEnvKey] ?? "";
+        const requestedModelId = options.model ?? config.model ?? DEFAULT_MODEL;
+        const requestedProvider = (options.provider ?? config.provider ?? DEFAULT_PROVIDER);
         const workspaceDir = options.workspaceDir ?? config.workspaceDir ?? process.cwd();
-        const sessionsDir = path.join(stateDir, "sessions");
+        const sessionsDir = path.join(stateDir, "sessions", sessionId);
         fs.mkdirSync(sessionsDir, { recursive: true });
-        getOrCreateSession(stateDir, sessionId, { model: modelId });
+        await getOrCreateSession(stateDir, sessionId, { model: requestedModelId });
         await hooks.run("session_start", { sessionId });
         await hooks.run("before_agent_start", {
             sessionId,
             message: options.message,
-            model: modelId,
+            model: requestedModelId,
         });
         let skillsPrompt = "";
         if (config.skills?.enabled !== false) {
@@ -52,50 +71,179 @@ export async function createRuntime(overrides) {
         ]
             .filter(Boolean)
             .join("\n\n");
-        const model = getModel(provider, modelId);
-        // Set API key in environment for the provider
-        if (apiKey) {
-            const envKey = `${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`;
-            process.env[envKey] = apiKey;
-        }
-        const sessionManager = SessionManager.create(workspaceDir, sessionsDir);
-        const sessionOpts = {
-            cwd: workspaceDir,
-            model,
-            tools: [...codingTools],
-            customTools: options.tools,
-            sessionManager,
-        };
-        const { session } = await createAgentSession(sessionOpts);
-        let responseText = "";
-        const unsubscribe = session.subscribe((event) => {
-            options.onEvent?.(event);
-        });
-        try {
-            await session.sendUserMessage(options.message);
-        }
-        finally {
-            unsubscribe();
-        }
-        // Extract text from the last assistant message's content blocks
-        const messages = session.messages;
-        for (let i = messages.length - 1; i >= 0; i--) {
-            const msg = messages[i];
-            if (msg.role === "assistant" && Array.isArray(msg.content)) {
-                responseText = msg.content
-                    .filter((block) => block.type === "text")
-                    .map((block) => block.text ?? "")
-                    .join("");
-                break;
+        async function executeWithModel(provider, modelId) {
+            const envKey = buildProviderEnvKey(provider);
+            const apiKeys = [];
+            if (options.apiKey)
+                apiKeys.push(options.apiKey);
+            if (options.apiKeys)
+                apiKeys.push(...options.apiKeys);
+            if (config.apiKey)
+                apiKeys.push(config.apiKey);
+            apiKeys.push(...collectProviderApiKeys(provider));
+            const uniqueKeys = [...new Set(apiKeys.filter((k) => k.length > 0))];
+            if (uniqueKeys.length === 0) {
+                const envVal = process.env[envKey];
+                if (envVal)
+                    uniqueKeys.push(envVal);
+            }
+            async function runWithKey(apiKey) {
+                const model = getModel(provider, modelId);
+                const ctxInfo = resolveContextWindowInfo({
+                    modelContextWindow: model.contextWindow,
+                    configContextTokens: options.contextTokens,
+                });
+                const ctxGuard = evaluateContextWindowGuard({ info: ctxInfo });
+                if (ctxGuard.shouldBlock) {
+                    throw new Error(`Context window too small (${ctxGuard.tokens} tokens). Minimum: ${CONTEXT_WINDOW_HARD_MIN_TOKENS}.`);
+                }
+                const previousEnvValue = process.env[envKey];
+                if (apiKey)
+                    process.env[envKey] = apiKey;
+                try {
+                    const sessionManager = resolveSessionManager(SessionManager, workspaceDir, sessionsDir);
+                    const memoryTools = config.memory?.enabled !== false
+                        ? createMemoryTools(memory)
+                        : [];
+                    const customTools = [
+                        ...memoryTools,
+                        ...(options.tools ?? []),
+                    ];
+                    if (options.enableSubagents !== false) {
+                        const subTool = createSubagentTool({
+                            runtime: {
+                                run: (opts) => {
+                                    const subOpts = opts;
+                                    return run({
+                                        ...subOpts,
+                                        systemPrompt: subOpts.systemPrompt ?? "You are a helpful sub-agent. Be concise and focused on the task.",
+                                    });
+                                },
+                            },
+                        });
+                        customTools.push(subTool);
+                    }
+                    const sessionOpts = {
+                        cwd: workspaceDir,
+                        model,
+                        tools: [...codingTools],
+                        customTools,
+                        sessionManager,
+                    };
+                    return await retryAsync(async () => {
+                        const { session } = await createAgentSession(sessionOpts);
+                        const pendingToolArgs = new Map();
+                        const unsubscribe = session.subscribe((event) => {
+                            options.onEvent?.(event);
+                            if (event.type === "tool_execution_start") {
+                                pendingToolArgs.set(event.toolCallId, event.args ?? {});
+                                hooks
+                                    .run("before_tool_call", {
+                                    toolName: event.toolName,
+                                    input: event.args ?? {},
+                                })
+                                    .catch(() => { });
+                            }
+                            if (event.type === "tool_execution_end") {
+                                const input = pendingToolArgs.get(event.toolCallId) ?? {};
+                                pendingToolArgs.delete(event.toolCallId);
+                                hooks
+                                    .run("after_tool_call", {
+                                    toolName: event.toolName,
+                                    input,
+                                    result: event.result,
+                                })
+                                    .catch(() => { });
+                            }
+                        });
+                        try {
+                            await session.sendUserMessage(options.message);
+                        }
+                        finally {
+                            unsubscribe();
+                        }
+                        const responseText = extractAssistantResponse(session.messages);
+                        return {
+                            response: responseText,
+                            sessionId,
+                            provider,
+                            model: modelId,
+                        };
+                    }, {
+                        attempts: options.maxRetries ?? 2,
+                        minDelayMs: 1000,
+                        maxDelayMs: 10_000,
+                        shouldRetry: (err) => {
+                            const msg = err instanceof Error ? err.message : String(err);
+                            if (isLikelyContextOverflowError(msg)) {
+                                log.warn("context overflow detected");
+                                if (config.memory?.enabled !== false &&
+                                    shouldRunMemoryFlush({
+                                        estimatedTokens: ctxInfo.tokens,
+                                        contextWindowTokens: ctxInfo.tokens,
+                                        sessionId,
+                                        state: memoryFlushState,
+                                    })) {
+                                    log.info("running pre-compaction memory flush");
+                                    markMemoryFlushed(memoryFlushState, sessionId);
+                                    run({
+                                        message: MEMORY_FLUSH_PROMPT,
+                                        sessionId,
+                                        model: modelId,
+                                        provider,
+                                        apiKey,
+                                        systemPrompt: MEMORY_FLUSH_SYSTEM_PROMPT,
+                                        enableSubagents: false,
+                                        maxRetries: 1,
+                                    }).catch((flushErr) => {
+                                        log.warn(`memory flush failed: ${flushErr instanceof Error ? flushErr.message : String(flushErr)}`);
+                                    });
+                                }
+                                return true;
+                            }
+                            return isRateLimitErrorMessage(msg) || isTimeoutErrorMessage(msg);
+                        },
+                        onRetry: ({ attempt, err }) => {
+                            log.warn(`retry attempt ${attempt}: ${err instanceof Error ? err.message : String(err)}`);
+                        },
+                    });
+                }
+                finally {
+                    if (previousEnvValue === undefined) {
+                        delete process.env[envKey];
+                    }
+                    else {
+                        process.env[envKey] = previousEnvValue;
+                    }
+                }
+            }
+            if (uniqueKeys.length > 1) {
+                return executeWithApiKeyRotation({
+                    provider,
+                    apiKeys: uniqueKeys,
+                    execute: runWithKey,
+                });
             }
+            return runWithKey(uniqueKeys[0] ?? "");
         }
+        const fallbackResult = await runWithModelFallback({
+            provider: requestedProvider,
+            model: requestedModelId,
+            fallbacks: options.fallbacks,
+            run: executeWithModel,
+        });
         await hooks.run("after_agent_end", {
             sessionId,
-            result: responseText,
+            result: fallbackResult.result.response,
         });
         await hooks.run("session_end", { sessionId });
-        updateSession(stateDir, sessionId, { model: modelId });
-        return { response: responseText, sessionId };
+        await updateSession(stateDir, sessionId, {
+            model: fallbackResult.model,
+        });
+        return {
+            ...fallbackResult.result,
+            fallbackUsed: fallbackResult.attempts.length > 0,
+        };
     }
     return { run, hooks, memory, config };
 }

package/dist/runtime/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/runtime/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/runtime/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,WAAW,GAKZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAmB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAA4B,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAsB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EACL,UAAU,EACV,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnH,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,GAAG,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAmC7C,SAAS,WAAW;IAClB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAuC;IAEvC,WAAW,EAAE,CAAC;IACd,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,MAAM,GAAuB,EAAE,GAAG,UAAU,EAAE,GAAG,SAAS,EAAE,CAAC;IACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAEzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEtE,qDAAqD;IACrD,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB;QACxD,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GAAG,yBAAyB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAElF,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;IAElD,KAAK,UAAU,GAAG,CAAC,OAAwB;QACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC/D,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;QACxE,MAAM,iBAAiB,GACrB,CAAC,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAW,CAAC;QACtE,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAE/D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAC/D,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAE3E,MAAM,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE;YACpC,SAAS;YACT,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,gBAAgB;SACxB,CAAC,CAAC;QAEH,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAkB,mBAAmB,CAAC,YAAY,CAAC,CAAC;gBAClE,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG;YACnB,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,IAAI,EAAE;YACjD,YAAY;SACb;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,KAAK,UAAU,gBAAgB,CAC7B,QAAgB,EAChB,OAAe;YAEf,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE7C,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,OAAO,CAAC,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAElD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACrE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,MAAM;oBAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC;YAED,KAAK,UAAU,UAAU,CAAC,MAAc;gBACtC,MAAM,KAAK,GAAG,QAAQ,CACpB,QAA0C,EAC1C,OAAgB,CACjB,CAAC;gBAEF,MAAM,OAAO,GAAG,wBAAwB,CAAC;oBACvC,kBAAkB,EAAE,KAAK,CAAC,aAAa;oBACvC,mBAAmB,EAAE,OAAO,CAAC,aAAa;iBAC3C,CAAC,CAAC;gBACH,MAAM,QAAQ,GAAG,0BAA0B,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/D,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,CAAC,MAAM,sBAAsB,8BAA8B,GAAG,CACpG,CAAC;gBACJ,CAAC;gBAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC7C,IAAI,MAAM;oBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;gBAEzC,IAAI,CAAC;oBACH,MAAM,cAAc,GAAG,qBAAqB,CAC1C,cAAc,EACd,YAAY,EACZ,WAAW,CACZ,CAAC;oBAEF,MAAM,WAAW,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK;wBAC9B,CAAC,CAAE,iBAAiB,CAAC,MAAM,CAAiC;wBAC5D,CAAC,CAAC,EAAE,CAAC;oBAET,MAAM,WAAW,GAAqB;wBACpC,GAAG,WAAW;wBACd,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;qBACzB,CAAC;oBAEF,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;wBACtC,MAAM,OAAO,GAAG,kBAAkB,CAAC;4BACjC,OAAO,EAAE;gCACP,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;oCACZ,MAAM,OAAO,GAAG,IAAkC,CAAC;oCACnD,OAAO,GAAG,CAAC;wCACT,GAAG,OAAO;wCACV,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,kEAAkE;qCACzG,CAAC,CAAC;gCACL,CAAC;6BACF;yBACF,CAAC,CAAC;wBACH,WAAW,CAAC,IAAI,CAAC,OAAoC,CAAC,CAAC;oBACzD,CAAC;oBAED,MAAM,WAAW,GAA8B;wBAC7C,GAAG,EAAE,YAAY;wBACjB,KAAK;wBACL,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC;wBACvB,WAAW;wBACX,cAAc;qBACf,CAAC;oBAEF,OAAO,MAAM,UAAU,CACrB,KAAK,IAAI,EAAE;wBACT,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;wBAE1D,MAAM,eAAe,GAAG,IAAI,GAAG,EAG5B,CAAC;wBACJ,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CACnC,CAAC,KAAwB,EAAE,EAAE;4BAC3B,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;4BACzB,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gCAC1C,eAAe,CAAC,GAAG,CACjB,KAAK,CAAC,UAAU,EACf,KAAK,CAAC,IAAgC,IAAI,EAAE,CAC9C,CAAC;gCACF,KAAK;qCACF,GAAG,CAAC,kBAAkB,EAAE;oCACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oCACxB,KAAK,EACF,KAAK,CAAC,IAAgC,IAAI,EAAE;iCAChD,CAAC;qCACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;4BACrB,CAAC;4BACD,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;gCACxC,MAAM,KAAK,GACT,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;gCAC9C,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gCACzC,KAAK;qCACF,GAAG,CAAC,iBAAiB,EAAE;oCACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oCACxB,KAAK;oCACL,MAAM,EAAE,KAAK,CAAC,MAAM;iCACrB,CAAC;qCACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;4BACrB,CAAC;wBACH,CAAC,CACF,CAAC;wBAEF,IAAI,CAAC;4BACH,MAAM,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;wBACjD,CAAC;gCAAS,CAAC;4BACT,WAAW,EAAE,CAAC;wBAChB,CAAC;wBAED,MAAM,YAAY,GAAG,wBAAwB,CAC3C,OAAO,CAAC,QAAQ,CACjB,CAAC;wBACF,OAAO;4BACL,QAAQ,EAAE,YAAY;4BACtB,SAAS;4BACT,QAAQ;4BACR,KAAK,EAAE,OAAO;yBACf,CAAC;oBACJ,CAAC,EACD;wBACE,QAAQ,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;wBACjC,UAAU,EAAE,IAAI;wBAChB,UAAU,EAAE,MAAM;wBAClB,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;4BACnB,MAAM,GAAG,GACP,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;4BACnD,IAAI,4BAA4B,CAAC,GAAG,CAAC,EAAE,CAAC;gCACtC,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;gCACtC,IACE,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK;oCAChC,oBAAoB,CAAC;wCACnB,eAAe,EAAE,OAAO,CAAC,MAAM;wCAC/B,mBAAmB,EAAE,OAAO,CAAC,MAAM;wCACnC,SAAS;wCACT,KAAK,EAAE,gBAAgB;qCACxB,CAAC,EACF,CAAC;oCACD,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;oCAChD,iBAAiB,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;oCAC/C,GAAG,CAAC;wCACF,OAAO,EAAE,mBAAmB;wCAC5B,SAAS;wCACT,KAAK,EAAE,OAAO;wCACd,QAAQ;wCACR,MAAM;wCACN,YAAY,EAAE,0BAA0B;wCACxC,eAAe,EAAE,KAAK;wCACtB,UAAU,EAAE,CAAC;qCACd,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE;wCACpB,GAAG,CAAC,IAAI,CAAC,wBAAwB,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oCACtG,CAAC,CAAC,CAAC;gCACL,CAAC;gCACD,OAAO,IAAI,CAAC;4BACd,CAAC;4BACD,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC;wBACpE,CAAC;wBACD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;4BAC5B,GAAG,CAAC,IAAI,CACN,iBAAiB,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;wBACJ,CAAC;qBACF,CACF,CAAC;gBACJ,CAAC;wBAAS,CAAC;oBACT,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;wBACnC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC7B,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC;oBACzC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,yBAAyB,CAAC;oBAC/B,QAAQ;oBACR,OAAO,EAAE,UAAU;oBACnB,OAAO,EAAE,UAAU;iBACpB,CAAC,CAAC;YACL,CAAC;YAED,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC;YAChD,QAAQ,EAAE,iBAAiB;YAC3B,KAAK,EAAE,gBAAgB;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,EAAE,gBAAgB;SACtB,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACjC,SAAS;YACT,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,QAAQ;SACvC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAE9C,MAAM,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE;YACvC,KAAK,EAAE,cAAc,CAAC,KAAK;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,cAAc,CAAC,MAAM;YACxB,YAAY,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC"}

package/dist/runtime/api-key-rotation.d.ts

@@ -0,0 +1,26 @@
+export declare function collectProviderApiKeys(provider: string): string[];
+export declare function isApiKeyRateLimitError(message: string): boolean;
+export declare function isAnthropicBillingError(message: string): boolean;
+export declare function collectProviderApiKeysForExecution(params: {
+    provider: string;
+    primaryApiKey?: string;
+}): string[];
+export interface ApiKeyRotationOptions<T> {
+    provider: string;
+    apiKeys: string[];
+    execute: (apiKey: string) => Promise<T>;
+    shouldRetry?: (params: {
+        apiKey: string;
+        error: unknown;
+        attempt: number;
+        message: string;
+    }) => boolean;
+    onRetry?: (params: {
+        apiKey: string;
+        error: unknown;
+        attempt: number;
+        message: string;
+    }) => void;
+}
+export declare function executeWithApiKeyRotation<T>(params: ApiKeyRotationOptions<T>): Promise<T>;
+//# sourceMappingURL=api-key-rotation.d.ts.map

package/dist/runtime/api-key-rotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key-rotation.d.ts","sourceRoot":"","sources":["../../src/runtime/api-key-rotation.ts"],"names":[],"mappings":"AAmFA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBjE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAS/D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAWhE;AAgBD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,EAAE,CAGX;AAOD,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,KAAK,IAAI,CAAC;CACZ;AAED,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/dist/runtime/api-key-rotation.js

@@ -0,0 +1,174 @@
+// Ported from OpenClaw src/agents/api-key-rotation.ts + src/agents/live-auth-keys.ts
+// --- Key collection (from live-auth-keys.ts) ---
+const KEY_SPLIT_RE = /[\s,;]+/g;
+const PROVIDER_PREFIX_OVERRIDES = {
+    google: "GEMINI",
+    "google-vertex": "GEMINI",
+};
+const PROVIDER_API_KEY_CONFIG = {
+    anthropic: {
+        liveSingle: "BULKHEAD_LIVE_ANTHROPIC_KEY",
+        listVar: "BULKHEAD_LIVE_ANTHROPIC_KEYS",
+        primaryVar: "ANTHROPIC_API_KEY",
+        prefixedVar: "ANTHROPIC_API_KEY_",
+    },
+    google: {
+        liveSingle: "BULKHEAD_LIVE_GEMINI_KEY",
+        listVar: "GEMINI_API_KEYS",
+        primaryVar: "GEMINI_API_KEY",
+        prefixedVar: "GEMINI_API_KEY_",
+    },
+    "google-vertex": {
+        liveSingle: "BULKHEAD_LIVE_GEMINI_KEY",
+        listVar: "GEMINI_API_KEYS",
+        primaryVar: "GEMINI_API_KEY",
+        prefixedVar: "GEMINI_API_KEY_",
+    },
+    openai: {
+        liveSingle: "BULKHEAD_LIVE_OPENAI_KEY",
+        listVar: "OPENAI_API_KEYS",
+        primaryVar: "OPENAI_API_KEY",
+        prefixedVar: "OPENAI_API_KEY_",
+    },
+};
+function normalizeProviderId(raw) {
+    return raw.trim().toLowerCase().replace(/[^a-z0-9-]/g, "");
+}
+function parseKeyList(raw) {
+    if (!raw)
+        return [];
+    return raw.split(KEY_SPLIT_RE).map((v) => v.trim()).filter(Boolean);
+}
+function collectEnvPrefixedKeys(prefix) {
+    const keys = [];
+    for (const [name, value] of Object.entries(process.env)) {
+        if (!name.startsWith(prefix))
+            continue;
+        const trimmed = value?.trim();
+        if (!trimmed)
+            continue;
+        keys.push(trimmed);
+    }
+    return keys;
+}
+function resolveProviderApiKeyConfig(provider) {
+    const normalized = normalizeProviderId(provider);
+    const custom = PROVIDER_API_KEY_CONFIG[normalized];
+    const base = PROVIDER_PREFIX_OVERRIDES[normalized] ?? normalized.toUpperCase().replace(/-/g, "_");
+    const liveSingle = custom?.liveSingle ?? `BULKHEAD_LIVE_${base}_KEY`;
+    const listVar = custom?.listVar ?? `${base}_API_KEYS`;
+    const primaryVar = custom?.primaryVar ?? `${base}_API_KEY`;
+    const prefixedVar = custom?.prefixedVar ?? `${base}_API_KEY_`;
+    if (normalized === "google" || normalized === "google-vertex") {
+        return { liveSingle, listVar, primaryVar, prefixedVar, fallbackVars: ["GOOGLE_API_KEY"] };
+    }
+    return { liveSingle, listVar, primaryVar, prefixedVar, fallbackVars: [] };
+}
+export function collectProviderApiKeys(provider) {
+    const config = resolveProviderApiKeyConfig(provider);
+    const forcedSingle = config.liveSingle ? process.env[config.liveSingle]?.trim() : undefined;
+    if (forcedSingle)
+        return [forcedSingle];
+    const fromList = parseKeyList(config.listVar ? process.env[config.listVar] : undefined);
+    const primary = config.primaryVar ? process.env[config.primaryVar]?.trim() : undefined;
+    const fromPrefixed = config.prefixedVar ? collectEnvPrefixedKeys(config.prefixedVar) : [];
+    const fallback = config.fallbackVars
+        .map((envVar) => process.env[envVar]?.trim())
+        .filter(Boolean);
+    const seen = new Set();
+    const add = (value) => {
+        if (!value || seen.has(value))
+            return;
+        seen.add(value);
+    };
+    for (const value of fromList)
+        add(value);
+    add(primary);
+    for (const value of fromPrefixed)
+        add(value);
+    for (const value of fallback)
+        add(value);
+    return Array.from(seen);
+}
+export function isApiKeyRateLimitError(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("rate_limit"))
+        return true;
+    if (lower.includes("rate limit"))
+        return true;
+    if (lower.includes("429"))
+        return true;
+    if (lower.includes("quota exceeded") || lower.includes("quota_exceeded"))
+        return true;
+    if (lower.includes("resource exhausted") || lower.includes("resource_exhausted"))
+        return true;
+    if (lower.includes("too many requests"))
+        return true;
+    return false;
+}
+export function isAnthropicBillingError(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("credit balance"))
+        return true;
+    if (lower.includes("insufficient credit"))
+        return true;
+    if (lower.includes("insufficient credits"))
+        return true;
+    if (lower.includes("payment required"))
+        return true;
+    if (lower.includes("billing") && lower.includes("disabled"))
+        return true;
+    if (/["']?(?:status|code)["']?\s*[:=]\s*402\b|\bhttp\s*402\b|\berror(?:\s+code)?\s*[:=]?\s*402\b|\b(?:got|returned|received)\s+(?:a\s+)?402\b|^\s*402\spayment/i.test(lower))
+        return true;
+    return false;
+}
+// --- API key rotation (from api-key-rotation.ts) ---
+function dedupeApiKeys(raw) {
+    const seen = new Set();
+    const keys = [];
+    for (const value of raw) {
+        const apiKey = value.trim();
+        if (!apiKey || seen.has(apiKey))
+            continue;
+        seen.add(apiKey);
+        keys.push(apiKey);
+    }
+    return keys;
+}
+export function collectProviderApiKeysForExecution(params) {
+    const { primaryApiKey, provider } = params;
+    return dedupeApiKeys([primaryApiKey?.trim() ?? "", ...collectProviderApiKeys(provider)]);
+}
+function formatErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+export async function executeWithApiKeyRotation(params) {
+    const keys = dedupeApiKeys(params.apiKeys);
+    if (keys.length === 0) {
+        throw new Error(`No API keys configured for provider "${params.provider}".`);
+    }
+    let lastError;
+    for (let attempt = 0; attempt < keys.length; attempt += 1) {
+        const apiKey = keys[attempt];
+        try {
+            return await params.execute(apiKey);
+        }
+        catch (error) {
+            lastError = error;
+            const message = formatErrorMessage(error);
+            const retryable = params.shouldRetry
+                ? params.shouldRetry({ apiKey, error, attempt, message })
+                : isApiKeyRateLimitError(message);
+            if (!retryable || attempt + 1 >= keys.length)
+                break;
+            params.onRetry?.({ apiKey, error, attempt, message });
+        }
+    }
+    if (lastError === undefined) {
+        throw new Error(`Failed to run API request for ${params.provider}.`);
+    }
+    throw lastError;
+}
+//# sourceMappingURL=api-key-rotation.js.map

package/dist/runtime/api-key-rotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key-rotation.js","sourceRoot":"","sources":["../../src/runtime/api-key-rotation.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,kDAAkD;AAElD,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC,MAAM,yBAAyB,GAA2B;IACxD,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,QAAQ;CAC1B,CAAC;AAUF,MAAM,uBAAuB,GAA+D;IAC1F,SAAS,EAAE;QACT,UAAU,EAAE,6BAA6B;QACzC,OAAO,EAAE,8BAA8B;QACvC,UAAU,EAAE,mBAAmB;QAC/B,WAAW,EAAE,oBAAoB;KAClC;IACD,MAAM,EAAE;QACN,UAAU,EAAE,0BAA0B;QACtC,OAAO,EAAE,iBAAiB;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,iBAAiB;KAC/B;IACD,eAAe,EAAE;QACf,UAAU,EAAE,0BAA0B;QACtC,OAAO,EAAE,iBAAiB;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,iBAAiB;KAC/B;IACD,MAAM,EAAE;QACN,UAAU,EAAE,0BAA0B;QACtC,OAAO,EAAE,iBAAiB;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,iBAAiB;KAC/B;CACF,CAAC;AAEF,SAAS,mBAAmB,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,YAAY,CAAC,GAAmB;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC5C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QACvC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAgB;IACnD,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,yBAAyB,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAElG,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,iBAAiB,IAAI,MAAM,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,GAAG,IAAI,WAAW,CAAC;IACtD,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,GAAG,IAAI,UAAU,CAAC;IAC3D,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,GAAG,IAAI,WAAW,CAAC;IAE9D,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,eAAe,EAAE,CAAC;QAC9D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAC5F,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,MAAM,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAErD,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,IAAI,YAAY;QAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAExC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY;SACjC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;SAC5C,MAAM,CAAC,OAAO,CAAa,CAAC;IAE/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,KAAc,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QACtC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,QAAQ;QAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,GAAG,CAAC,OAAO,CAAC,CAAC;IACb,KAAK,MAAM,KAAK,IAAI,YAAY;QAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,QAAQ;QAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,IAAI,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9F,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,KAAK,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,IACE,4JAA4J,CAAC,IAAI,CAAC,KAAK,CAAC;QACxK,OAAO,IAAI,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sDAAsD;AAEtD,SAAS,aAAa,CAAC,GAAa;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,MAGlD;IACC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC3C,OAAO,aAAa,CAAC,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAoBD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAgC;IAEhC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW;gBAClC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;gBACzD,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAEpC,IAAI,CAAC,SAAS,IAAI,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM;gBAAE,MAAM;YACpD,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/runtime/context-guard.d.ts

@@ -0,0 +1,32 @@
+export declare const CONTEXT_WINDOW_HARD_MIN_TOKENS = 16000;
+export declare const CONTEXT_WINDOW_WARN_BELOW_TOKENS = 32000;
+export type ContextWindowSource = "model" | "modelsConfig" | "agentContextTokens" | "default";
+export interface ContextWindowInfo {
+    tokens: number;
+    source: ContextWindowSource;
+}
+export interface ContextWindowGuardResult extends ContextWindowInfo {
+    shouldWarn: boolean;
+    shouldBlock: boolean;
+}
+export declare function resolveContextWindowInfo(params: {
+    modelContextWindow?: number;
+    configContextTokens?: number;
+    modelsProviderConfig?: Array<{
+        id?: string;
+        contextWindow?: number;
+    }>;
+    modelId?: string;
+    defaultTokens?: number;
+}): ContextWindowInfo;
+export declare function evaluateContextWindowGuard(params: {
+    info: ContextWindowInfo;
+    warnBelowTokens?: number;
+    hardMinTokens?: number;
+}): ContextWindowGuardResult;
+export declare function estimateTokens(text: string): number;
+export declare function estimateMessagesTokens(messages: Array<{
+    role: string;
+    content: string;
+}>): number;
+//# sourceMappingURL=context-guard.d.ts.map

package/dist/runtime/context-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-guard.d.ts","sourceRoot":"","sources":["../../src/runtime/context-guard.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAKvD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,cAAc,GAAG,oBAAoB,GAAG,SAAS,CAAC;AAE9F,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAQD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,iBAAiB,CAmBpB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE,iBAAiB,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,wBAAwB,CAyB3B;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,MAAM,CAMR"}

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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"}