@compilr-dev/agents 0.3.23 → 0.3.24

package/dist/agent.js

@@ -1700,15 +1700,23 @@ export class Agent {
                     const filterSet = new Set(options.toolFilter);
                     tools = tools.filter((tool) => filterSet.has(tool.name));
                 }
-                // Run beforeLLM hooks (can modify messages and tools)
+                // Run beforeLLM hooks (can modify messages, tools, and system prompt)
                 if (this.hooksManager) {
                     const llmHookResult = await this.hooksManager.runBeforeLLM({
                         ...hookContext,
                         messages,
                         tools,
+                        systemPrompt: systemContent,
                     });
                     messages = llmHookResult.messages;
                     tools = llmHookResult.tools;
+                    // If a hook modified the system prompt, update messages[0]
+                    if (llmHookResult.systemPrompt !== systemContent) {
+                        systemContent = llmHookResult.systemPrompt;
+                        if (messages.length > 0 && messages[0].role === 'system') {
+                            messages[0] = { role: 'system', content: systemContent };
+                        }
+                    }
                 }
                 // Call LLM
                 emit({ type: 'llm_start' });
@@ -1772,6 +1780,7 @@ export class Agent {
                         ...hookContext,
                         messages,
                         tools,
+                        systemPrompt: systemContent,
                         text,
                         toolUses,
                         usage: usage

package/dist/hooks/manager.d.ts

@@ -102,6 +102,7 @@ export declare class HooksManager {
     runBeforeLLM(context: LLMHookContext): Promise<{
         messages: Message[];
         tools: ToolDefinition[];
+        systemPrompt: string;
     }>;
     /**
      * Run after:llm hooks

package/dist/hooks/manager.js

@@ -330,6 +330,7 @@ export class HooksManager {
     async runBeforeLLM(context) {
         let messages = context.messages;
         let tools = context.tools;
+        let systemPrompt = context.systemPrompt;
         for (const registered of this.beforeLLMHooks) {
             const start = Date.now();
             try {
@@ -339,7 +340,7 @@ export class HooksManager {
                     hookId: registered.id,
                     hookName: registered.name,
                 });
-                const result = await registered.hook({ ...context, messages, tools });
+                const result = await registered.hook({ ...context, messages, tools, systemPrompt });
                 this.emitEvent({
                     type: 'hook:completed',
                     hookType: 'beforeLLM',
@@ -353,6 +354,8 @@ export class HooksManager {
                         messages = hookResult.messages;
                     if (hookResult.tools)
                         tools = hookResult.tools;
+                    if (hookResult.systemPrompt !== undefined)
+                        systemPrompt = hookResult.systemPrompt;
                 }
             }
             catch (error) {
@@ -365,7 +368,7 @@ export class HooksManager {
                 });
             }
         }
-        return { messages, tools };
+        return { messages, tools, systemPrompt };
     }
     /**
      * Run after:llm hooks

package/dist/hooks/types.d.ts

@@ -94,6 +94,11 @@ export interface LLMHookContext extends HookContext {
      * Tool definitions available to LLM
      */
     tools: ToolDefinition[];
+    /**
+     * Current system prompt (fully assembled, including anchors).
+     * Hooks can read this and return a modified version in BeforeLLMHookResult.
+     */
+    systemPrompt: string;
 }
 /**
  * Result from before:llm hook that modifies messages or tools
@@ -107,6 +112,11 @@ export interface BeforeLLMHookResult {
      * Modified tools (optional, original used if not provided)
      */
     tools?: ToolDefinition[];
+    /**
+     * Modified system prompt (optional, original used if not provided).
+     * When returned, messages[0] (system message) is updated automatically.
+     */
+    systemPrompt?: string;
 }
 /**
  * Hook called before LLM call.

package/package.json

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