@dexto/core 1.4.0 → 1.5.0

package/dist/llm/errors.js

@@ -24,6 +24,15 @@ class LLMError {
       { provider }
     );
   }
+  static missingConfig(provider, configName) {
+    return new DextoRuntimeError(
+      LLMErrorCode.CONFIG_MISSING,
+      ErrorScope.LLM,
+      ErrorType.USER,
+      `Provider '${provider}' requires ${configName}`,
+      { provider, configName }
+    );
+  }
   static unsupportedProvider(provider) {
     const availableProviders = getSupportedProviders();
     return new DextoRuntimeError(
@@ -34,6 +43,21 @@ class LLMError {
       { provider, availableProviders }
     );
   }
+  /**
+   * Runtime error when API key is missing for a provider that requires it.
+   * This occurs when relaxed validation allowed the app to start without an API key,
+   * and the user then tries to use the LLM functionality.
+   */
+  static apiKeyMissing(provider, envVar) {
+    return new DextoRuntimeError(
+      LLMErrorCode.API_KEY_MISSING,
+      ErrorScope.LLM,
+      ErrorType.USER,
+      `API key required for provider '${provider}'`,
+      { provider, envVar },
+      `Set the ${envVar} environment variable or configure it in Settings`
+    );
+  }
   static modelProviderUnknown(model) {
     const availableProviders = getSupportedProviders();
     return new DextoRuntimeError(

package/dist/llm/executor/stream-processor.cjs

@@ -88,22 +88,30 @@ class StreamProcessor {
               });
             }
             break;
-          case "tool-call":
+          case "tool-call": {
             if (!this.assistantMessageId) {
               this.assistantMessageId = await this.createAssistantMessage();
             }
-            await this.contextManager.addToolCall(this.assistantMessageId, {
+            const toolCall = {
               id: event.toolCallId,
               type: "function",
               function: {
                 name: event.toolName,
                 arguments: JSON.stringify(event.input)
               }
-            });
+            };
+            const shouldPersistProviderMetadata = this.config.provider === "google" || this.config.provider === "vertex";
+            if (shouldPersistProviderMetadata && event.providerMetadata) {
+              toolCall.providerOptions = {
+                ...event.providerMetadata
+              };
+            }
+            await this.contextManager.addToolCall(this.assistantMessageId, toolCall);
             this.pendingToolCalls.set(event.toolCallId, {
               toolName: event.toolName
             });
             break;
+          }
           case "tool-result": {
             const rawResult = event.output;
             this.logger.debug("Tool result received", {

package/dist/llm/executor/stream-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-processor.d.ts","sourceRoot":"","sources":["../../../src/llm/executor/stream-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAwBpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,gBAAgB,CAAC;IA9B7B,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,YAAY,CAAmE;IACvF,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,MAAM,CAAe;IAC7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAgD;IAExE;;;;;;;;;OASG;gBAES,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,eAAe,EACzB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,qBAAqB,EACrC,MAAM,EAAE,YAAY,EACZ,SAAS,GAAE,OAAc,EACzB,gBAAgB,CAAC,EAAE,GAAG,CAC1B,MAAM,EACN;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;KAAE,CACzE,YAAA;IAKC,OAAO,CACT,QAAQ,EAAE,MAAM,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACzD,OAAO,CAAC,qBAAqB,CAAC;YAmYnB,sBAAsB;YAKtB,gBAAgB;IAO9B;;;;OAIG;YACW,2BAA2B;CAmC5C"}
+{"version":3,"file":"stream-processor.d.ts","sourceRoot":"","sources":["../../../src/llm/executor/stream-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAwBpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,gBAAgB,CAAC;IA9B7B,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,YAAY,CAAmE;IACvF,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,MAAM,CAAe;IAC7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAgD;IAExE;;;;;;;;;OASG;gBAES,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,eAAe,EACzB,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,qBAAqB,EACrC,MAAM,EAAE,YAAY,EACZ,SAAS,GAAE,OAAc,EACzB,gBAAgB,CAAC,EAAE,GAAG,CAC1B,MAAM,EACN;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;KAAE,CACzE,YAAA;IAKC,OAAO,CACT,QAAQ,EAAE,MAAM,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACzD,OAAO,CAAC,qBAAqB,CAAC;YAoZnB,sBAAsB;YAKtB,gBAAgB;IAO9B;;;;OAIG;YACW,2BAA2B;CAmC5C"}

package/dist/llm/executor/stream-processor.js

@@ -66,22 +66,30 @@ class StreamProcessor {
               });
             }
             break;
-          case "tool-call":
+          case "tool-call": {
             if (!this.assistantMessageId) {
               this.assistantMessageId = await this.createAssistantMessage();
             }
-            await this.contextManager.addToolCall(this.assistantMessageId, {
+            const toolCall = {
               id: event.toolCallId,
               type: "function",
               function: {
                 name: event.toolName,
                 arguments: JSON.stringify(event.input)
               }
-            });
+            };
+            const shouldPersistProviderMetadata = this.config.provider === "google" || this.config.provider === "vertex";
+            if (shouldPersistProviderMetadata && event.providerMetadata) {
+              toolCall.providerOptions = {
+                ...event.providerMetadata
+              };
+            }
+            await this.contextManager.addToolCall(this.assistantMessageId, toolCall);
             this.pendingToolCalls.set(event.toolCallId, {
               toolName: event.toolName
             });
             break;
+          }
           case "tool-result": {
             const rawResult = event.output;
             this.logger.debug("Tool result received", {

package/dist/llm/executor/turn-executor.cjs

@@ -85,11 +85,12 @@ var import_DextoRuntimeError = require("../../errors/DextoRuntimeError.js");
 var import_types7 = require("../../errors/types.js");
 var import_error_codes = require("../error-codes.js");
 var import_error_conversion = require("../../utils/error-conversion.js");
-var import_overflow = require("../../context/compression/overflow.js");
-var import_reactive_overflow = require("../../context/compression/reactive-overflow.js");
+var import_overflow = require("../../context/compaction/overflow.js");
+var import_reactive_overflow = require("../../context/compaction/strategies/reactive-overflow.js");
 const toolSupportCache = /* @__PURE__ */ new Map();
+const LOCAL_PROVIDERS = ["ollama", "local"];
 class TurnExecutor {
-  constructor(model, toolManager, contextManager, eventBus, resourceManager, sessionId, config, llmContext, logger, messageQueue, modelLimits, externalSignal) {
+  constructor(model, toolManager, contextManager, eventBus, resourceManager, sessionId, config, llmContext, logger, messageQueue, modelLimits, externalSignal, compactionStrategy) {
     this.model = model;
     this.toolManager = toolManager;
     this.contextManager = contextManager;
@@ -103,8 +104,10 @@ class TurnExecutor {
     this.externalSignal = externalSignal;
     this.logger = logger.createChild(import_types4.DextoLogComponent.EXECUTOR);
     this.stepAbortController = new AbortController();
-    if (modelLimits) {
-      this.compressionStrategy = new import_reactive_overflow.ReactiveOverflowStrategy(model, {}, this.logger);
+    if (compactionStrategy !== void 0) {
+      this.compactionStrategy = compactionStrategy;
+    } else if (modelLimits) {
+      this.compactionStrategy = new import_reactive_overflow.ReactiveOverflowStrategy(model, {}, this.logger);
     }
   }
   logger;
@@ -113,8 +116,7 @@ class TurnExecutor {
    * This allows soft cancel (abort current step) while still continuing with queued messages.
    */
   stepAbortController;
-  // TODO: improve compression configurability
-  compressionStrategy = null;
+  compactionStrategy = null;
   /**
    * Map to track approval metadata by toolCallId.
    * Used to pass approval info from tool execution to result persistence.
@@ -147,6 +149,24 @@ class TurnExecutor {
       let lastText = "";
       this.eventBus.emit("llm:thinking");
       const supportsTools = await this.validateToolSupport();
+      if (!supportsTools) {
+        const modelKey = `${this.llmContext.provider}:${this.llmContext.model}`;
+        this.eventBus.emit("llm:unsupported-input", {
+          errors: [
+            `Model '${modelKey}' does not support tool calling.`,
+            "You can still chat, but the model will not be able to use tools or execute commands."
+          ],
+          provider: this.llmContext.provider,
+          model: this.llmContext.model,
+          details: {
+            feature: "tool-calling",
+            supported: false
+          }
+        });
+        this.logger.warn(
+          `Model ${modelKey} does not support tools - continuing without tool calling`
+        );
+      }
       let currentAbortHandler = null;
       try {
         while (true) {
@@ -299,20 +319,25 @@ class TurnExecutor {
    * Validates if the current model supports tools.
    * Uses a static cache to avoid repeated validation calls.
    *
-   * For models using custom baseURL endpoints, makes a test call to verify tool support.
-   * Built-in providers without baseURL are assumed to support tools.
+   * For local providers (Ollama, local) and custom baseURL endpoints, makes a test call to verify tool support.
+   * Known cloud providers without baseURL are assumed to support tools.
    */
   async validateToolSupport() {
     const modelKey = `${this.llmContext.provider}:${this.llmContext.model}:${this.config.baseURL ?? ""}`;
     if (toolSupportCache.has(modelKey)) {
       return toolSupportCache.get(modelKey);
     }
-    if (!this.config.baseURL) {
-      this.logger.debug(`Skipping tool validation for ${modelKey} - no custom baseURL`);
+    const isLocalProvider = LOCAL_PROVIDERS.includes(this.llmContext.provider);
+    if (!this.config.baseURL && !isLocalProvider) {
+      this.logger.debug(
+        `Skipping tool validation for ${modelKey} - known cloud provider without custom baseURL`
+      );
       toolSupportCache.set(modelKey, true);
       return true;
     }
-    this.logger.debug(`Testing tool support for custom endpoint model: ${modelKey}`);
+    this.logger.debug(
+      `Testing tool support for ${isLocalProvider ? "local provider" : "custom endpoint"} model: ${modelKey}`
+    );
     const testTool = {
       test_tool: {
         inputSchema: (0, import_ai.jsonSchema)({
@@ -342,7 +367,9 @@ class TurnExecutor {
       const errorMessage = error instanceof Error ? error.message : String(error);
       if (errorMessage.includes("does not support tools")) {
         toolSupportCache.set(modelKey, false);
-        this.logger.debug(`Model ${modelKey} does not support tools`);
+        this.logger.debug(
+          `Detected that model ${modelKey} does not support tool calling - tool functionality will be disabled`
+        );
         return false;
       }
       this.logger.debug(
@@ -623,7 +650,7 @@ class TurnExecutor {
    * Check if context has overflowed based on actual token usage from API.
    */
   checkAndHandleOverflow(tokens) {
-    if (!this.modelLimits || !this.compressionStrategy) {
+    if (!this.modelLimits || !this.compactionStrategy) {
       return false;
     }
     return (0, import_overflow.isOverflow)(tokens, this.modelLimits);
@@ -638,16 +665,16 @@ class TurnExecutor {
    * @param originalTokens The actual input token count from API that triggered overflow
    */
   async compress(originalTokens) {
-    if (!this.compressionStrategy) {
+    if (!this.compactionStrategy) {
       return;
     }
     this.logger.info(
       `Context overflow detected (${originalTokens} tokens), running compression`
     );
     const history = await this.contextManager.getHistory();
-    const summaryMessages = await this.compressionStrategy.compress(history);
+    const summaryMessages = await this.compactionStrategy.compact(history);
     if (summaryMessages.length === 0) {
-      this.logger.debug("Compression returned no summary (history too short)");
+      this.logger.debug("Compaction returned no summary (history too short)");
       return;
     }
     for (const summary of summaryMessages) {
@@ -656,17 +683,17 @@ class TurnExecutor {
     const { filterCompacted, estimateMessagesTokens } = await import("../../context/utils.js");
     const updatedHistory = await this.contextManager.getHistory();
     const filteredHistory = filterCompacted(updatedHistory);
-    const compressedTokens = estimateMessagesTokens(filteredHistory);
-    this.eventBus.emit("context:compressed", {
+    const compactedTokens = estimateMessagesTokens(filteredHistory);
+    this.eventBus.emit("context:compacted", {
       originalTokens,
-      compressedTokens,
+      compactedTokens,
       originalMessages: history.length,
-      compressedMessages: filteredHistory.length,
-      strategy: this.compressionStrategy.name,
+      compactedMessages: filteredHistory.length,
+      strategy: this.compactionStrategy.name,
       reason: "overflow"
     });
     this.logger.info(
-      `Compression complete: ${originalTokens} \u2192 ~${compressedTokens} tokens (${history.length} \u2192 ${filteredHistory.length} messages after filtering)`
+      `Compaction complete: ${originalTokens} \u2192 ~${compactedTokens} tokens (${history.length} \u2192 ${filteredHistory.length} messages after filtering)`
     );
   }
   /**

package/dist/llm/executor/turn-executor.d.ts

@@ -8,7 +8,8 @@ import type { ResourceManager } from '../../resources/index.js';
 import { DynamicContributorContext } from '../../systemPrompt/types.js';
 import { LLMContext } from '../types.js';
 import type { MessageQueueService } from '../../session/message-queue.js';
-import { type ModelLimits } from '../../context/compression/overflow.js';
+import { type ModelLimits } from '../../context/compaction/overflow.js';
+import type { ICompactionStrategy } from '../../context/compaction/types.js';
 /**
  * TurnExecutor orchestrates the agent loop using `stopWhen: stepCountIs(1)`.
  *
@@ -39,7 +40,7 @@ export declare class TurnExecutor {
      * This allows soft cancel (abort current step) while still continuing with queued messages.
      */
     private stepAbortController;
-    private compressionStrategy;
+    private compactionStrategy;
     /**
      * Map to track approval metadata by toolCallId.
      * Used to pass approval info from tool execution to result persistence.
@@ -50,7 +51,7 @@ export declare class TurnExecutor {
         maxOutputTokens?: number | undefined;
         temperature?: number | undefined;
         baseURL?: string | undefined;
-    }, llmContext: LLMContext, logger: IDextoLogger, messageQueue: MessageQueueService, modelLimits?: ModelLimits | undefined, externalSignal?: AbortSignal | undefined);
+    }, llmContext: LLMContext, logger: IDextoLogger, messageQueue: MessageQueueService, modelLimits?: ModelLimits | undefined, externalSignal?: AbortSignal | undefined, compactionStrategy?: ICompactionStrategy | null);
     /**
      * Get StreamProcessor config from TurnExecutor state.
      */
@@ -77,8 +78,8 @@ export declare class TurnExecutor {
      * Validates if the current model supports tools.
      * Uses a static cache to avoid repeated validation calls.
      *
-     * For models using custom baseURL endpoints, makes a test call to verify tool support.
-     * Built-in providers without baseURL are assumed to support tools.
+     * For local providers (Ollama, local) and custom baseURL endpoints, makes a test call to verify tool support.
+     * Known cloud providers without baseURL are assumed to support tools.
      */
     private validateToolSupport;
     /**

package/dist/llm/executor/turn-executor.d.ts.map

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

package/dist/llm/executor/turn-executor.js

@@ -17,11 +17,12 @@ import { DextoRuntimeError } from "../../errors/DextoRuntimeError.js";
 import { ErrorScope, ErrorType } from "../../errors/types.js";
 import { LLMErrorCode } from "../error-codes.js";
 import { toError } from "../../utils/error-conversion.js";
-import { isOverflow } from "../../context/compression/overflow.js";
-import { ReactiveOverflowStrategy } from "../../context/compression/reactive-overflow.js";
+import { isOverflow } from "../../context/compaction/overflow.js";
+import { ReactiveOverflowStrategy } from "../../context/compaction/strategies/reactive-overflow.js";
 const toolSupportCache = /* @__PURE__ */ new Map();
+const LOCAL_PROVIDERS = ["ollama", "local"];
 class TurnExecutor {
-  constructor(model, toolManager, contextManager, eventBus, resourceManager, sessionId, config, llmContext, logger, messageQueue, modelLimits, externalSignal) {
+  constructor(model, toolManager, contextManager, eventBus, resourceManager, sessionId, config, llmContext, logger, messageQueue, modelLimits, externalSignal, compactionStrategy) {
     this.model = model;
     this.toolManager = toolManager;
     this.contextManager = contextManager;
@@ -35,8 +36,10 @@ class TurnExecutor {
     this.externalSignal = externalSignal;
     this.logger = logger.createChild(DextoLogComponent.EXECUTOR);
     this.stepAbortController = new AbortController();
-    if (modelLimits) {
-      this.compressionStrategy = new ReactiveOverflowStrategy(model, {}, this.logger);
+    if (compactionStrategy !== void 0) {
+      this.compactionStrategy = compactionStrategy;
+    } else if (modelLimits) {
+      this.compactionStrategy = new ReactiveOverflowStrategy(model, {}, this.logger);
     }
   }
   logger;
@@ -45,8 +48,7 @@ class TurnExecutor {
    * This allows soft cancel (abort current step) while still continuing with queued messages.
    */
   stepAbortController;
-  // TODO: improve compression configurability
-  compressionStrategy = null;
+  compactionStrategy = null;
   /**
    * Map to track approval metadata by toolCallId.
    * Used to pass approval info from tool execution to result persistence.
@@ -79,6 +81,24 @@ class TurnExecutor {
       let lastText = "";
       this.eventBus.emit("llm:thinking");
       const supportsTools = await this.validateToolSupport();
+      if (!supportsTools) {
+        const modelKey = `${this.llmContext.provider}:${this.llmContext.model}`;
+        this.eventBus.emit("llm:unsupported-input", {
+          errors: [
+            `Model '${modelKey}' does not support tool calling.`,
+            "You can still chat, but the model will not be able to use tools or execute commands."
+          ],
+          provider: this.llmContext.provider,
+          model: this.llmContext.model,
+          details: {
+            feature: "tool-calling",
+            supported: false
+          }
+        });
+        this.logger.warn(
+          `Model ${modelKey} does not support tools - continuing without tool calling`
+        );
+      }
       let currentAbortHandler = null;
       try {
         while (true) {
@@ -231,20 +251,25 @@ class TurnExecutor {
    * Validates if the current model supports tools.
    * Uses a static cache to avoid repeated validation calls.
    *
-   * For models using custom baseURL endpoints, makes a test call to verify tool support.
-   * Built-in providers without baseURL are assumed to support tools.
+   * For local providers (Ollama, local) and custom baseURL endpoints, makes a test call to verify tool support.
+   * Known cloud providers without baseURL are assumed to support tools.
    */
   async validateToolSupport() {
     const modelKey = `${this.llmContext.provider}:${this.llmContext.model}:${this.config.baseURL ?? ""}`;
     if (toolSupportCache.has(modelKey)) {
       return toolSupportCache.get(modelKey);
     }
-    if (!this.config.baseURL) {
-      this.logger.debug(`Skipping tool validation for ${modelKey} - no custom baseURL`);
+    const isLocalProvider = LOCAL_PROVIDERS.includes(this.llmContext.provider);
+    if (!this.config.baseURL && !isLocalProvider) {
+      this.logger.debug(
+        `Skipping tool validation for ${modelKey} - known cloud provider without custom baseURL`
+      );
       toolSupportCache.set(modelKey, true);
       return true;
     }
-    this.logger.debug(`Testing tool support for custom endpoint model: ${modelKey}`);
+    this.logger.debug(
+      `Testing tool support for ${isLocalProvider ? "local provider" : "custom endpoint"} model: ${modelKey}`
+    );
     const testTool = {
       test_tool: {
         inputSchema: jsonSchema({
@@ -274,7 +299,9 @@ class TurnExecutor {
       const errorMessage = error instanceof Error ? error.message : String(error);
       if (errorMessage.includes("does not support tools")) {
         toolSupportCache.set(modelKey, false);
-        this.logger.debug(`Model ${modelKey} does not support tools`);
+        this.logger.debug(
+          `Detected that model ${modelKey} does not support tool calling - tool functionality will be disabled`
+        );
         return false;
       }
       this.logger.debug(
@@ -555,7 +582,7 @@ class TurnExecutor {
    * Check if context has overflowed based on actual token usage from API.
    */
   checkAndHandleOverflow(tokens) {
-    if (!this.modelLimits || !this.compressionStrategy) {
+    if (!this.modelLimits || !this.compactionStrategy) {
       return false;
     }
     return isOverflow(tokens, this.modelLimits);
@@ -570,16 +597,16 @@ class TurnExecutor {
    * @param originalTokens The actual input token count from API that triggered overflow
    */
   async compress(originalTokens) {
-    if (!this.compressionStrategy) {
+    if (!this.compactionStrategy) {
       return;
     }
     this.logger.info(
       `Context overflow detected (${originalTokens} tokens), running compression`
     );
     const history = await this.contextManager.getHistory();
-    const summaryMessages = await this.compressionStrategy.compress(history);
+    const summaryMessages = await this.compactionStrategy.compact(history);
     if (summaryMessages.length === 0) {
-      this.logger.debug("Compression returned no summary (history too short)");
+      this.logger.debug("Compaction returned no summary (history too short)");
       return;
     }
     for (const summary of summaryMessages) {
@@ -588,17 +615,17 @@ class TurnExecutor {
     const { filterCompacted, estimateMessagesTokens } = await import("../../context/utils.js");
     const updatedHistory = await this.contextManager.getHistory();
     const filteredHistory = filterCompacted(updatedHistory);
-    const compressedTokens = estimateMessagesTokens(filteredHistory);
-    this.eventBus.emit("context:compressed", {
+    const compactedTokens = estimateMessagesTokens(filteredHistory);
+    this.eventBus.emit("context:compacted", {
       originalTokens,
-      compressedTokens,
+      compactedTokens,
       originalMessages: history.length,
-      compressedMessages: filteredHistory.length,
-      strategy: this.compressionStrategy.name,
+      compactedMessages: filteredHistory.length,
+      strategy: this.compactionStrategy.name,
       reason: "overflow"
     });
     this.logger.info(
-      `Compression complete: ${originalTokens} \u2192 ~${compressedTokens} tokens (${history.length} \u2192 ${filteredHistory.length} messages after filtering)`
+      `Compaction complete: ${originalTokens} \u2192 ~${compactedTokens} tokens (${history.length} \u2192 ${filteredHistory.length} messages after filtering)`
     );
   }
   /**

package/dist/llm/formatters/vercel.cjs

@@ -183,12 +183,16 @@ class VercelMessageFormatter {
         } else {
           parsed = rawArgs ?? {};
         }
-        contentParts.push({
+        const toolCallPart = {
           type: "tool-call",
           toolCallId: toolCall.id,
           toolName: toolCall.function.name,
           input: parsed
-        });
+        };
+        if (toolCall.providerOptions) {
+          toolCallPart.providerOptions = toolCall.providerOptions;
+        }
+        contentParts.push(toolCallPart);
       }
       const firstToolCall = msg.toolCalls?.[0];
       if (firstToolCall) {

package/dist/llm/formatters/vercel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/llm/formatters/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiD,MAAM,IAAI,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAmB7D;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAGhC;;;;;;OAMG;IACH,MAAM,CACF,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,EACpC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC5B,YAAY,EAAE;IAwIjB;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAK1B,OAAO,CAAC,sBAAsB;IAuE9B,OAAO,CAAC,iBAAiB;CAoE5B"}
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/llm/formatters/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiD,MAAM,IAAI,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAmB7D;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAGhC;;;;;;OAMG;IACH,MAAM,CACF,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,EACpC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC5B,YAAY,EAAE;IAwIjB;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAK1B,OAAO,CAAC,sBAAsB;IA8E9B,OAAO,CAAC,iBAAiB;CAoE5B"}

package/dist/llm/formatters/vercel.js

@@ -161,12 +161,16 @@ class VercelMessageFormatter {
         } else {
           parsed = rawArgs ?? {};
         }
-        contentParts.push({
+        const toolCallPart = {
           type: "tool-call",
           toolCallId: toolCall.id,
           toolName: toolCall.function.name,
           input: parsed
-        });
+        };
+        if (toolCall.providerOptions) {
+          toolCallPart.providerOptions = toolCall.providerOptions;
+        }
+        contentParts.push(toolCallPart);
       }
       const firstToolCall = msg.toolCalls?.[0];
       if (firstToolCall) {

package/dist/llm/index.cjs

@@ -3,6 +3,10 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -14,6 +18,12 @@ var __copyProps = (to, from, except, desc) => {
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var llm_exports = {};
+__export(llm_exports, {
+  getOpenRouterModelContextLength: () => import_openrouter_model_registry.getOpenRouterModelContextLength,
+  getOpenRouterModelInfo: () => import_openrouter_model_registry.getOpenRouterModelInfo,
+  lookupOpenRouterModel: () => import_openrouter_model_registry.lookupOpenRouterModel,
+  refreshOpenRouterModelCache: () => import_openrouter_model_registry.refreshOpenRouterModelCache
+});
 module.exports = __toCommonJS(llm_exports);
 __reExport(llm_exports, require("./errors.js"), module.exports);
 __reExport(llm_exports, require("./error-codes.js"), module.exports);
@@ -22,13 +32,20 @@ __reExport(llm_exports, require("./validation.js"), module.exports);
 __reExport(llm_exports, require("./types.js"), module.exports);
 __reExport(llm_exports, require("./services/index.js"), module.exports);
 __reExport(llm_exports, require("./schemas.js"), module.exports);
+var import_openrouter_model_registry = require("./providers/openrouter-model-registry.js");
+__reExport(llm_exports, require("./providers/local/index.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getOpenRouterModelContextLength,
+  getOpenRouterModelInfo,
+  lookupOpenRouterModel,
+  refreshOpenRouterModelCache,
   ...require("./errors.js"),
   ...require("./error-codes.js"),
   ...require("./registry.js"),
   ...require("./validation.js"),
   ...require("./types.js"),
   ...require("./services/index.js"),
-  ...require("./schemas.js")
+  ...require("./schemas.js"),
+  ...require("./providers/local/index.js")
 });

package/dist/llm/index.d.ts

@@ -5,4 +5,6 @@ export * from './validation.js';
 export * from './types.js';
 export * from './services/index.js';
 export * from './schemas.js';
+export { lookupOpenRouterModel, refreshOpenRouterModelCache, getOpenRouterModelContextLength, getOpenRouterModelInfo, type LookupStatus, type OpenRouterModelInfo, } from './providers/openrouter-model-registry.js';
+export * from './providers/local/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,OAAO,EACH,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GAC3B,MAAM,0CAA0C,CAAC;AAGlD,cAAc,4BAA4B,CAAC"}

package/dist/llm/index.js

@@ -1,3 +1,4 @@
+import "../chunk-PTJYTZNU.js";
 export * from "./errors.js";
 export * from "./error-codes.js";
 export * from "./registry.js";
@@ -5,3 +6,16 @@ export * from "./validation.js";
 export * from "./types.js";
 export * from "./services/index.js";
 export * from "./schemas.js";
+import {
+  lookupOpenRouterModel,
+  refreshOpenRouterModelCache,
+  getOpenRouterModelContextLength,
+  getOpenRouterModelInfo
+} from "./providers/openrouter-model-registry.js";
+export * from "./providers/local/index.js";
+export {
+  getOpenRouterModelContextLength,
+  getOpenRouterModelInfo,
+  lookupOpenRouterModel,
+  refreshOpenRouterModelCache
+};