@compilr-dev/sdk 0.7.27 → 0.7.28

package/dist/agent.js

@@ -298,15 +298,17 @@ class CompilrAgentImpl {
             observationMask: contextManager ? observationMask : undefined,
             windowing: contextManager
                 ? config?.context?.windowing !== false
-                    ? {
-                        // Scale windowing targets to model's context window:
-                        //   targetHistoryTokens: 10% of context (e.g., 100K for 1M, 20K for 200K, 12.8K for 128K)
-                        //   recentWindowTokens: 25% of target (e.g., 25K for 1M, 5K for 200K)
-                        targetHistoryTokens: Math.round(contextLimit * 0.10),
-                        recentWindowTokens: Math.round(contextLimit * 0.025),
-                        // User overrides take precedence
-                        ...(typeof config?.context?.windowing === 'object' ? config.context.windowing : {}),
-                    }
+                    ? (() => {
+                        const wCfg = typeof config?.context?.windowing === 'object' ? config.context.windowing : {};
+                        const historyRatio = wCfg.targetHistoryRatio ?? 0.1;
+                        const recentRatio = wCfg.recentWindowRatio ?? 0.025;
+                        return {
+                            // Derive from model context window, overridable with explicit values
+                            targetHistoryTokens: wCfg.targetHistoryTokens ?? Math.round(contextLimit * historyRatio),
+                            recentWindowTokens: wCfg.recentWindowTokens ?? Math.round(contextLimit * recentRatio),
+                            enabled: wCfg.enabled,
+                        };
+                    })()
                     : false
                 : undefined,
             hooks: mergedHooks,

package/dist/config.d.ts

@@ -110,10 +110,20 @@ export interface ContextConfig {
      * Smart windowing — programmatic context compaction.
      * Compacts old messages when history exceeds token budget.
      * Three zones: recent (intact), middle (truncated), old (event log).
-     * When omitted, SDK defaults are used (60K target, 15K recent window).
+     *
+     * When omitted, targets are derived from the model's context window:
+     *   targetHistoryTokens = contextLimit * targetHistoryRatio (default 0.10)
+     *   recentWindowTokens  = contextLimit * recentWindowRatio  (default 0.025)
+     *
      * Set to false to disable windowing entirely.
+     * Set explicit targetHistoryTokens/recentWindowTokens to override proportional defaults.
      */
-    windowing?: Partial<WindowingConfig> | false;
+    windowing?: (Partial<WindowingConfig> & {
+        /** Fraction of context window for target history. Default: 0.10 (10%) */
+        targetHistoryRatio?: number;
+        /** Fraction of context window for recent window. Default: 0.025 (2.5%) */
+        recentWindowRatio?: number;
+    }) | false;
 }
 /**
  * Usage information for the agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.7.27",
+  "version": "0.7.28",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",