@compilr-dev/agents 0.5.7 → 0.5.8

package/dist/agent.d.ts

@@ -151,6 +151,10 @@ export type AgentEvent = {
     type: 'iteration_limit_extended';
     newMaxIterations: number;
     addedIterations: number;
+} | {
+    type: 'model_changed';
+    previousModel: string;
+    newModel: string;
 } | {
     type: 'llm_retry';
     attempt: number;
@@ -1128,6 +1132,17 @@ export declare class Agent {
      * Check if pins are enabled
      */
     hasPins(): boolean;
+    /**
+     * Get the current model ID for this agent.
+     */
+    getModel(): string;
+    /**
+     * Change the model for subsequent LLM calls. Same provider only.
+     * Takes effect on the next chat() call, not mid-stream.
+     *
+     * @param modelId - The new model ID (e.g., 'claude-opus-4-20250514')
+     */
+    setModel(modelId: string): void;
     /** @deprecated Use addPin() instead */
     addAnchor(input: AnchorInput): Anchor | undefined;
     /** @deprecated Use getPin() instead */

package/dist/agent.js

@@ -523,6 +523,27 @@ export class Agent {
     hasPins() {
         return this.pinManager !== undefined;
     }
+    // --- Model management -------------------------------------------------------
+    /**
+     * Get the current model ID for this agent.
+     */
+    getModel() {
+        return this.provider.getModel();
+    }
+    /**
+     * Change the model for subsequent LLM calls. Same provider only.
+     * Takes effect on the next chat() call, not mid-stream.
+     *
+     * @param modelId - The new model ID (e.g., 'claude-opus-4-20250514')
+     */
+    setModel(modelId) {
+        if (!modelId || typeof modelId !== 'string') {
+            throw new Error('modelId must be a non-empty string');
+        }
+        const previousModel = this.provider.getModel();
+        this.provider.setModel(modelId);
+        this.onEvent?.({ type: 'model_changed', previousModel, newModel: modelId });
+    }
     // --- Deprecated aliases (use pin methods instead) --------------------------
     /** @deprecated Use addPin() instead */
     addAnchor(input) {

package/dist/providers/claude.d.ts

@@ -72,13 +72,15 @@ export interface ClaudeProviderConfig {
 export declare class ClaudeProvider implements LLMProvider {
     readonly name = "claude";
     private readonly client;
-    private readonly defaultModel;
+    private defaultModel;
     private readonly defaultMaxTokens;
     private readonly enablePromptCaching;
     private readonly enableTokenEfficientTools;
     private readonly enableExtendedContext;
     private readonly estimateTokensFn;
     constructor(config: ClaudeProviderConfig);
+    getModel(): string;
+    setModel(modelId: string): void;
     /**
      * Send messages and stream the response
      */

package/dist/providers/claude.js

@@ -46,6 +46,12 @@ export class ClaudeProvider {
         this.estimateTokensFn =
             config.estimateTokens ?? ((s) => Math.ceil(s.length / 4));
     }
+    getModel() {
+        return this.defaultModel;
+    }
+    setModel(modelId) {
+        this.defaultModel = modelId;
+    }
     /**
      * Send messages and stream the response
      */

package/dist/providers/gemini-native.d.ts

@@ -50,10 +50,12 @@ export interface GeminiNativeProviderConfig {
 export declare class GeminiNativeProvider implements LLMProvider {
     readonly name = "gemini";
     private readonly client;
-    private readonly defaultModel;
+    private defaultModel;
     private readonly defaultMaxTokens;
     private readonly estimateTokensFn;
     constructor(config: GeminiNativeProviderConfig);
+    getModel(): string;
+    setModel(modelId: string): void;
     /**
      * Send messages and stream the response
      */

package/dist/providers/gemini-native.js

@@ -45,6 +45,12 @@ export class GeminiNativeProvider {
         this.estimateTokensFn =
             config.estimateTokens ?? ((s) => Math.ceil(s.length / 4));
     }
+    getModel() {
+        return this.defaultModel;
+    }
+    setModel(modelId) {
+        this.defaultModel = modelId;
+    }
     /**
      * Send messages and stream the response
      */

package/dist/providers/mock.d.ts

@@ -78,7 +78,10 @@ export declare class MockProvider implements LLMProvider {
     private readonly throwOnEmpty;
     private callCount;
     private readonly callHistory;
+    private mockModel;
     constructor(config?: MockProviderConfig);
+    getModel(): string;
+    setModel(modelId: string): void;
     /**
      * Add a response (text string or structured response with tool calls)
      */

package/dist/providers/mock.js

@@ -38,10 +38,17 @@ export class MockProvider {
     throwOnEmpty;
     callCount = 0;
     callHistory = [];
+    mockModel = 'mock-model';
     constructor(config = {}) {
         this.defaultDelay = config.defaultDelay ?? 0;
         this.throwOnEmpty = config.throwOnEmpty ?? true;
     }
+    getModel() {
+        return this.mockModel;
+    }
+    setModel(modelId) {
+        this.mockModel = modelId;
+    }
     /**
      * Add a response (text string or structured response with tool calls)
      */

package/dist/providers/openai-compatible.d.ts

@@ -121,11 +121,13 @@ export declare abstract class OpenAICompatibleProvider implements LLMProvider {
      */
     abstract readonly name: string;
     protected readonly baseUrl: string;
-    protected readonly defaultModel: string;
+    protected defaultModel: string;
     protected readonly defaultMaxTokens: number;
     protected readonly timeout: number;
     protected readonly estimateTokensFn: (text: string) => number;
     constructor(config: OpenAICompatibleConfig);
+    getModel(): string;
+    setModel(modelId: string): void;
     /**
      * Get authentication headers for API requests
      * @returns Headers object with auth credentials

package/dist/providers/openai-compatible.js

@@ -46,6 +46,12 @@ export class OpenAICompatibleProvider {
         this.estimateTokensFn =
             config.estimateTokens ?? ((s) => Math.ceil(s.length / 4));
     }
+    getModel() {
+        return this.defaultModel;
+    }
+    setModel(modelId) {
+        this.defaultModel = modelId;
+    }
     /**
      * Extract cache statistics from response headers.
      * Override in subclasses for providers that return cache stats in headers (e.g., Fireworks).

package/dist/providers/types.d.ts

@@ -239,4 +239,15 @@ export interface LLMProvider {
      * Count tokens in messages (optional, provider-specific)
      */
     countTokens?(messages: Message[]): Promise<number>;
+    /**
+     * Get the current default model ID.
+     */
+    getModel(): string;
+    /**
+     * Change the default model for subsequent calls. Same provider only.
+     * Takes effect on the next chat() call, not mid-stream.
+     *
+     * @param modelId - The new model ID (e.g., 'claude-opus-4-20250514')
+     */
+    setModel(modelId: string): void;
 }

package/dist/rate-limit/provider-wrapper.d.ts

@@ -32,6 +32,8 @@ export declare class RateLimitedProvider implements LLMProvider {
     private readonly rateLimiter;
     private readonly retryConfig;
     constructor(provider: LLMProvider, config?: RateLimitRetryConfig);
+    getModel(): string;
+    setModel(modelId: string): void;
     /**
      * Get the rate limiter instance for statistics
      */

package/dist/rate-limit/provider-wrapper.js

@@ -38,6 +38,12 @@ export class RateLimitedProvider {
         this.rateLimiter = config.rateLimit ? createRateLimiter(config.rateLimit) : createRateLimiter();
         this.retryConfig = config.retry ?? {};
     }
+    getModel() {
+        return this.provider.getModel();
+    }
+    setModel(modelId) {
+        this.provider.setModel(modelId);
+    }
     /**
      * Get the rate limiter instance for statistics
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "Lightweight multi-LLM agent library for building CLI AI assistants",
   "type": "module",
   "main": "dist/index.js",