@compilr-dev/agents 0.3.23 → 0.3.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/agent.js CHANGED
@@ -1700,15 +1700,23 @@ export class Agent {
1700
1700
  const filterSet = new Set(options.toolFilter);
1701
1701
  tools = tools.filter((tool) => filterSet.has(tool.name));
1702
1702
  }
1703
- // Run beforeLLM hooks (can modify messages and tools)
1703
+ // Run beforeLLM hooks (can modify messages, tools, and system prompt)
1704
1704
  if (this.hooksManager) {
1705
1705
  const llmHookResult = await this.hooksManager.runBeforeLLM({
1706
1706
  ...hookContext,
1707
1707
  messages,
1708
1708
  tools,
1709
+ systemPrompt: systemContent,
1709
1710
  });
1710
1711
  messages = llmHookResult.messages;
1711
1712
  tools = llmHookResult.tools;
1713
+ // If a hook modified the system prompt, update messages[0]
1714
+ if (llmHookResult.systemPrompt !== systemContent) {
1715
+ systemContent = llmHookResult.systemPrompt;
1716
+ if (messages.length > 0 && messages[0].role === 'system') {
1717
+ messages[0] = { role: 'system', content: systemContent };
1718
+ }
1719
+ }
1712
1720
  }
1713
1721
  // Call LLM
1714
1722
  emit({ type: 'llm_start' });
@@ -1772,6 +1780,7 @@ export class Agent {
1772
1780
  ...hookContext,
1773
1781
  messages,
1774
1782
  tools,
1783
+ systemPrompt: systemContent,
1775
1784
  text,
1776
1785
  toolUses,
1777
1786
  usage: usage
@@ -18,7 +18,7 @@
18
18
  *
19
19
  * // Record usage after each LLM call
20
20
  * tracker.record({
21
- * model: 'claude-sonnet-4-20250514',
21
+ * model: 'claude-sonnet-4-6',
22
22
  * provider: 'anthropic',
23
23
  * tokens: { inputTokens: 1000, outputTokens: 500, totalTokens: 1500 },
24
24
  * });
@@ -18,7 +18,7 @@
18
18
  *
19
19
  * // Record usage after each LLM call
20
20
  * tracker.record({
21
- * model: 'claude-sonnet-4-20250514',
21
+ * model: 'claude-sonnet-4-6',
22
22
  * provider: 'anthropic',
23
23
  * tokens: { inputTokens: 1000, outputTokens: 500, totalTokens: 1500 },
24
24
  * });
@@ -102,6 +102,7 @@ export declare class HooksManager {
102
102
  runBeforeLLM(context: LLMHookContext): Promise<{
103
103
  messages: Message[];
104
104
  tools: ToolDefinition[];
105
+ systemPrompt: string;
105
106
  }>;
106
107
  /**
107
108
  * Run after:llm hooks
@@ -330,6 +330,7 @@ export class HooksManager {
330
330
  async runBeforeLLM(context) {
331
331
  let messages = context.messages;
332
332
  let tools = context.tools;
333
+ let systemPrompt = context.systemPrompt;
333
334
  for (const registered of this.beforeLLMHooks) {
334
335
  const start = Date.now();
335
336
  try {
@@ -339,7 +340,7 @@ export class HooksManager {
339
340
  hookId: registered.id,
340
341
  hookName: registered.name,
341
342
  });
342
- const result = await registered.hook({ ...context, messages, tools });
343
+ const result = await registered.hook({ ...context, messages, tools, systemPrompt });
343
344
  this.emitEvent({
344
345
  type: 'hook:completed',
345
346
  hookType: 'beforeLLM',
@@ -353,6 +354,8 @@ export class HooksManager {
353
354
  messages = hookResult.messages;
354
355
  if (hookResult.tools)
355
356
  tools = hookResult.tools;
357
+ if (hookResult.systemPrompt !== undefined)
358
+ systemPrompt = hookResult.systemPrompt;
356
359
  }
357
360
  }
358
361
  catch (error) {
@@ -365,7 +368,7 @@ export class HooksManager {
365
368
  });
366
369
  }
367
370
  }
368
- return { messages, tools };
371
+ return { messages, tools, systemPrompt };
369
372
  }
370
373
  /**
371
374
  * Run after:llm hooks
@@ -94,6 +94,11 @@ export interface LLMHookContext extends HookContext {
94
94
  * Tool definitions available to LLM
95
95
  */
96
96
  tools: ToolDefinition[];
97
+ /**
98
+ * Current system prompt (fully assembled, including anchors).
99
+ * Hooks can read this and return a modified version in BeforeLLMHookResult.
100
+ */
101
+ systemPrompt: string;
97
102
  }
98
103
  /**
99
104
  * Result from before:llm hook that modifies messages or tools
@@ -107,6 +112,11 @@ export interface BeforeLLMHookResult {
107
112
  * Modified tools (optional, original used if not provided)
108
113
  */
109
114
  tools?: ToolDefinition[];
115
+ /**
116
+ * Modified system prompt (optional, original used if not provided).
117
+ * When returned, messages[0] (system message) is updated automatically.
118
+ */
119
+ systemPrompt?: string;
110
120
  }
111
121
  /**
112
122
  * Hook called before LLM call.
@@ -21,7 +21,7 @@ export interface ClaudeProviderConfig {
21
21
  apiKey: string;
22
22
  /**
23
23
  * Default model to use
24
- * @default 'claude-sonnet-4-20250514'
24
+ * @default 'claude-sonnet-4-6'
25
25
  */
26
26
  model?: string;
27
27
  /**
@@ -16,7 +16,7 @@ import { ProviderError } from '../errors.js';
16
16
  /**
17
17
  * Default model for Claude API
18
18
  */
19
- const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
19
+ const DEFAULT_MODEL = 'claude-sonnet-4-6';
20
20
  /**
21
21
  * Default max tokens
22
22
  */
@@ -7,7 +7,7 @@
7
7
  * @example
8
8
  * ```typescript
9
9
  * const provider = createOpenRouterProvider({
10
- * model: 'anthropic/claude-3.5-sonnet',
10
+ * model: 'anthropic/claude-sonnet-4-6',
11
11
  * apiKey: process.env.OPENROUTER_API_KEY
12
12
  * });
13
13
  * ```
@@ -88,7 +88,7 @@ export declare class OpenRouterProvider extends OpenAICompatibleProvider {
88
88
  *
89
89
  * // With custom model and site attribution
90
90
  * const provider = createOpenRouterProvider({
91
- * model: 'anthropic/claude-3.5-sonnet',
91
+ * model: 'anthropic/claude-sonnet-4-6',
92
92
  * siteUrl: 'https://myapp.com',
93
93
  * siteName: 'My App'
94
94
  * });
@@ -7,7 +7,7 @@
7
7
  * @example
8
8
  * ```typescript
9
9
  * const provider = createOpenRouterProvider({
10
- * model: 'anthropic/claude-3.5-sonnet',
10
+ * model: 'anthropic/claude-sonnet-4-6',
11
11
  * apiKey: process.env.OPENROUTER_API_KEY
12
12
  * });
13
13
  * ```
@@ -128,7 +128,7 @@ export class OpenRouterProvider extends OpenAICompatibleProvider {
128
128
  *
129
129
  * // With custom model and site attribution
130
130
  * const provider = createOpenRouterProvider({
131
- * model: 'anthropic/claude-3.5-sonnet',
131
+ * model: 'anthropic/claude-sonnet-4-6',
132
132
  * siteUrl: 'https://myapp.com',
133
133
  * siteName: 'My App'
134
134
  * });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@compilr-dev/agents",
3
- "version": "0.3.23",
3
+ "version": "0.3.25",
4
4
  "description": "Lightweight multi-LLM agent library for building CLI AI assistants",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",