@compilr-dev/sdk 0.7.27 → 0.7.29

package/dist/agent.js

@@ -97,6 +97,7 @@ class CompilrAgentImpl {
             provider: config?.provider,
             model: config?.model,
             apiKey: config?.apiKey,
+            extendedContext: config?.context?.extendedContext,
         });
         // Resolve preset — non-software projects get 'general' by default
         const defaultPreset = config?.projectCategory && config.projectCategory !== 'software' ? 'general' : 'coding';
@@ -121,9 +122,10 @@ class CompilrAgentImpl {
         }
         // Build context manager if configured
         let contextManager;
+        const extendedContext = config?.context?.extendedContext ?? false;
         const contextLimit = config?.context
-            ? (config.context.contextLimit ?? getContextWindow(config.model))
-            : getContextWindow(config?.model);
+            ? (config.context.contextLimit ?? getContextWindow(config.model, extendedContext))
+            : getContextWindow(config?.model, extendedContext);
         if (config?.context) {
             contextManager = new ContextManager({
                 provider,
@@ -298,15 +300,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

@@ -96,6 +96,21 @@ export interface GuardrailConfig {
 export interface ContextConfig {
     /** Context window limit in tokens. Auto-detected from model if omitted. */
     contextLimit?: number;
+    /**
+     * Enable extended context window when available for the model.
+     *
+     * - **Claude Opus 4.6 / Sonnet 4.5**: activates 1M context (default: 200K)
+     *   via `context-1m-2025-08-07` beta header.
+     *   Long-context pricing applies above 200K tokens per request.
+     *
+     * - Other providers: no effect (context window is fixed).
+     *
+     * When enabled, `contextLimit` auto-detects to the extended window (1M for Claude).
+     * When disabled, `contextLimit` auto-detects to the standard window (200K for Claude).
+     *
+     * Default: false
+     */
+    extendedContext?: boolean;
     /** Threshold (0-1) to trigger compaction. Default: 0.5 */
     compactionThreshold?: number;
     /** Threshold (0-1) to trigger emergency summarization. Default: 0.9 */
@@ -110,10 +125,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/dist/models/model-registry.d.ts

@@ -39,8 +39,10 @@ export interface ModelInfo {
     status: ModelStatus;
     /** Notes shown in UI (e.g., why unsupported) */
     notes?: string;
-    /** Context window size in tokens (for display) */
+    /** Standard context window size in tokens */
     contextWindow?: number;
+    /** Extended context window (requires opt-in, e.g., beta header). Undefined = no extended option */
+    extendedContextWindow?: number;
 }
 /**
  * Registry of known models with their metadata.
@@ -105,7 +107,7 @@ export declare function shouldClearHistoryOnModelChange(_fromModelId: string | u
  * Get context window size for a model ID.
  * Falls back to provider default if model not found or contextWindow not set.
  */
-export declare function getModelContextWindow(modelId: string, provider?: ProviderType): number;
+export declare function getModelContextWindow(modelId: string, provider?: ProviderType, extendedContext?: boolean): number;
 /**
  * Get model display name by ID.
  * Returns the model ID if not found in registry.

package/dist/models/model-registry.js

@@ -37,7 +37,8 @@ export const MODEL_REGISTRY = [
         defaultTier: 'balanced',
         thinkingFormat: 'claude',
         status: 'supported',
-        contextWindow: 1000000,
+        contextWindow: 200000,
+        extendedContextWindow: 1000000,
     },
     {
         id: 'claude-opus-4-6',
@@ -47,7 +48,8 @@ export const MODEL_REGISTRY = [
         defaultTier: 'powerful',
         thinkingFormat: 'claude',
         status: 'supported',
-        contextWindow: 1000000,
+        contextWindow: 200000,
+        extendedContextWindow: 1000000,
     },
     // Legacy Claude models (still supported)
     {
@@ -78,6 +80,7 @@ export const MODEL_REGISTRY = [
         thinkingFormat: 'claude',
         status: 'supported',
         contextWindow: 200000,
+        extendedContextWindow: 1000000,
         notes: 'Legacy',
     },
     // ---------------------------------------------------------------------------
@@ -606,10 +609,15 @@ function getProviderContextLimitFallback(provider) {
  * Get context window size for a model ID.
  * Falls back to provider default if model not found or contextWindow not set.
  */
-export function getModelContextWindow(modelId, provider) {
+export function getModelContextWindow(modelId, provider, extendedContext) {
     const info = getModelInfo(modelId);
-    if (info?.contextWindow) {
-        return info.contextWindow;
+    if (info) {
+        if (extendedContext && info.extendedContextWindow) {
+            return info.extendedContextWindow;
+        }
+        if (info.contextWindow) {
+            return info.contextWindow;
+        }
     }
     return getProviderContextLimitFallback(provider);
 }

package/dist/models.d.ts

@@ -18,4 +18,4 @@ export declare const DEFAULT_CONTEXT_WINDOW = 128000;
  * Get the context window size for a model.
  * Delegates to the full registry with prefix-matching fallback.
  */
-export declare function getContextWindow(model?: string): number;
+export declare function getContextWindow(model?: string, extendedContext?: boolean): number;

package/dist/models.js

@@ -44,12 +44,12 @@ export const DEFAULT_CONTEXT_WINDOW = 128000;
  * Get the context window size for a model.
  * Delegates to the full registry with prefix-matching fallback.
  */
-export function getContextWindow(model) {
+export function getContextWindow(model, extendedContext) {
     if (!model) {
         return DEFAULT_CONTEXT_WINDOW;
     }
     // Use the registry-backed implementation
-    const result = getModelContextWindow(model);
+    const result = getModelContextWindow(model, undefined, extendedContext);
     // getModelContextWindow returns the provider fallback (200000) for unknown models,
     // but the original getContextWindow returned DEFAULT_CONTEXT_WINDOW (128000).
     // Check if the model was actually found in the registry.
@@ -59,14 +59,17 @@ export function getContextWindow(model) {
     }
     // Prefix match against registry entries (e.g., new dated variant of known model)
     for (const entry of MODEL_REGISTRY) {
-        if (!entry.contextWindow)
+        const cw = extendedContext
+            ? (entry.extendedContextWindow ?? entry.contextWindow)
+            : entry.contextWindow;
+        if (!cw)
             continue;
         const parts = entry.id.split('-');
         if (parts.length < 2)
             continue;
         const prefix = parts.slice(0, -1).join('-');
         if (prefix && model.startsWith(prefix)) {
-            return entry.contextWindow;
+            return cw;
         }
     }
     return DEFAULT_CONTEXT_WINDOW;

package/dist/provider.d.ts

@@ -17,6 +17,7 @@ export declare function createProviderFromType(type: ProviderType, options?: {
     baseUrl?: string;
     siteName?: string;
     estimateTokens?: (text: string) => number;
+    extendedContext?: boolean;
 }): LLMProvider;
 /**
  * Resolve a provider from config.
@@ -26,4 +27,5 @@ export declare function resolveProvider(config?: {
     provider?: ProviderType | LLMProvider;
     model?: string;
     apiKey?: string;
+    extendedContext?: boolean;
 }): LLMProvider;

package/dist/provider.js

@@ -32,10 +32,15 @@ export function detectProviderFromEnv() {
  * Create an LLM provider from a provider type string.
  */
 export function createProviderFromType(type, options) {
-    const { model, apiKey, baseUrl, siteName, estimateTokens } = options ?? {};
+    const { model, apiKey, baseUrl, siteName, estimateTokens, extendedContext } = options ?? {};
     switch (type) {
         case 'claude':
-            return createClaudeProvider({ model, apiKey, estimateTokens });
+            return createClaudeProvider({
+                model,
+                apiKey,
+                estimateTokens,
+                enableExtendedContext: extendedContext,
+            });
         case 'openai':
             return createOpenAIProvider({ model, apiKey, estimateTokens });
         case 'gemini':
@@ -71,6 +76,7 @@ export function resolveProvider(config) {
         return createProviderFromType(config.provider, {
             model: config.model,
             apiKey: config.apiKey,
+            extendedContext: config.extendedContext,
         });
     }
     // Auto-detect from env
@@ -79,6 +85,7 @@ export function resolveProvider(config) {
         return createProviderFromType(detected, {
             model: config?.model,
             apiKey: config?.apiKey,
+            extendedContext: config?.extendedContext,
         });
     }
     throw new Error('No LLM provider configured. Either:\n' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.7.27",
+  "version": "0.7.29",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -53,7 +53,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@compilr-dev/agents": "^0.4.0",
+    "@compilr-dev/agents": "^0.4.1",
     "@compilr-dev/sdk": "^0.5.4",
     "ajv": "^6.14.0"
   },