@compilr-dev/sdk 0.7.31 → 0.8.0

package/dist/agent.js

@@ -314,7 +314,16 @@ class CompilrAgentImpl {
                     : false
                 : undefined,
             hooks: mergedHooks,
-            pins: {},
+            enableFileTracking: config?.enableFileTracking ?? true,
+            pins: config?.pins
+                ? {
+                    maxAnchors: config.pins.maxAnchors ?? 50,
+                    maxTokens: config.pins.maxTokens ?? 4000,
+                    includeDefaults: config.pins.includeDefaults ?? true,
+                }
+                : {},
+            onIterationLimitReached: config?.onIterationLimitReached,
+            iterationLimitBehavior: config?.iterationLimitBehavior,
             permissions: {
                 defaultLevel: permissionsConfig.defaultLevel,
                 onPermissionRequest: permissionsConfig.onPermissionRequest,
@@ -334,6 +343,8 @@ class CompilrAgentImpl {
                     this.totalUsage.outputTokens += event.tokens.outputTokens;
                     this.totalUsage.totalTokens += event.tokens.inputTokens + event.tokens.outputTokens;
                 }
+                // Forward to user-provided onEvent callback
+                config?.onEvent?.(event);
                 // Forward ALL events to external listener (if set via run/stream)
                 this.externalEventListener?.(event);
             },

package/dist/config.d.ts

@@ -223,6 +223,8 @@ export interface CompilrAgentConfig {
      * Default: true when a PermissionCallback is provided, false otherwise.
      */
     includeDefaultRules?: boolean;
+    /** Logger instance for structured logging. When omitted, logging is disabled. */
+    logger?: import('@compilr-dev/logger').Logger;
     /** Guardrail configuration. Default: true */
     guardrails?: boolean | GuardrailConfig;
     /** Tool execution timeout in milliseconds. 0 = no timeout. Default: 30000 (30s) */
@@ -243,6 +245,45 @@ export interface CompilrAgentConfig {
         action: string;
         reason?: string;
     }) => void;
+    /**
+     * Event handler for monitoring agent execution.
+     * Called alongside the SDK's internal usage tracking — both run on every event.
+     */
+    onEvent?: (event: AgentEvent) => void;
+    /**
+     * Enable file access tracking for context restoration hints.
+     * When enabled, the agent tracks which files were read, referenced, and modified.
+     * After context compaction, hints are injected to help the LLM understand
+     * what files it previously accessed.
+     * Default: true when contextManager is created (i.e., almost always).
+     */
+    enableFileTracking?: boolean;
+    /**
+     * Pin/anchor configuration. Controls the AnchorManager for critical information
+     * that survives context compaction.
+     */
+    pins?: {
+        /** Maximum number of pins. Default: 50 */
+        maxAnchors?: number;
+        /** Maximum total tokens for pins. Default: 4000 */
+        maxTokens?: number;
+        /** Include built-in safety pins. Default: true */
+        includeDefaults?: boolean;
+    };
+    /**
+     * Callback invoked when the agent reaches its iteration limit.
+     * Return a positive number to extend by that many iterations, or false to stop.
+     */
+    onIterationLimitReached?: (context: {
+        iteration: number;
+        maxIterations: number;
+        toolCallCount: number;
+    }) => Promise<number | false>;
+    /**
+     * Behavior when max iterations is reached and no onIterationLimitReached callback
+     * is provided. Default: 'error'.
+     */
+    iterationLimitBehavior?: 'error' | 'summarize' | 'continue';
     /**
      * Dynamic capability loading configuration.
      * When enabled, tools are loaded on-demand for token efficiency.

package/dist/index.d.ts

@@ -77,3 +77,5 @@ export { generateProject, isGitConfigured, generateCompilrMd, generateConfigJson
 export type { TechStack, CodingStandards, GeneratorRepoPattern, ProjectConfig, GenerationResult, CompilrConfig, DetectedProject, GitInfo, ImportProjectConfig, } from './project-generator/index.js';
 export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
 export { gitStatusTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, gitStashTool, gitBlameTool, gitFileHistoryTool, detectProjectTool, findProjectRootTool, runTestsTool, runLintTool, runBuildTool, runFormatTool, findDefinitionTool, findReferencesTool, findTodosTool, checkOutdatedTool, findVulnerabilitiesTool, analyzeTestCoverageTool, getFileStructureTool, getComplexityTool, allCodingTools, unifiedTools, } from '@compilr-dev/agents-coding';
+export { createLogger, createSilentLogger } from '@compilr-dev/logger';
+export type { Logger, LoggerOptions, LogLevel } from '@compilr-dev/logger';

package/dist/index.js

@@ -221,3 +221,7 @@ analyzeTestCoverageTool,
 getFileStructureTool, getComplexityTool, 
 // Bulk exports
 allCodingTools, unifiedTools, } from '@compilr-dev/agents-coding';
+// =============================================================================
+// Logger (re-export for consumers)
+// =============================================================================
+export { createLogger, createSilentLogger } from '@compilr-dev/logger';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.7.31",
+  "version": "0.8.0",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -54,6 +54,7 @@
   },
   "dependencies": {
     "@compilr-dev/agents": "^0.5.1",
+    "@compilr-dev/logger": "^0.1.0",
     "ajv": "^6.14.0"
   },
   "peerDependencies": {