@agentforge-io/core 2.0.5 → 2.0.6

package/dist/services/agent-runner.service.d.ts

@@ -17,6 +17,27 @@ export declare class AgentRunnerService {
     });
     run(agent: AgentDefinition, messages: AnthropicMessage[], context: ToolExecutionContext, overrides?: AgentOverrides): Promise<AgentResponse>;
     stream(agent: AgentDefinition, messages: AnthropicMessage[], context: ToolExecutionContext, overrides?: AgentOverrides): AsyncGenerator<StreamChunk>;
+    /**
+     * Compose the system prompt for a single Anthropic call:
+     *
+     *   [tool-awareness preamble]   ← only when `tools` is non-empty
+     *   ──────────────────────────
+     *   agent.systemPrompt          ← what the operator wrote
+     *   ──────────────────────────
+     *   overrides.systemPromptSuffix ← optional per-call addendum
+     *
+     * The preamble exists because operator prompts in the wild often pin
+     * the model to a narrow persona ("respond in three sentences", "stick
+     * to product Q&A") which suppresses tool use even when tools are
+     * attached and clearly relevant. The preamble doesn't override the
+     * operator — it's a short, generic reminder that listed tools are
+     * available and should be consulted when the user's question depends
+     * on real-world / current / authoritative information.
+     *
+     * It's only added when tools are present, so prompt-only agents stay
+     * exactly as the operator wrote them.
+     */
+    private buildSystemPrompt;
     /**
      * Merge `agent.tools[]` (resolved via the global registry) with any
      * per-call extras (e.g. the user's connector tools).

package/dist/services/agent-runner.service.js

@@ -30,10 +30,8 @@ class AgentRunnerService {
         const model = overrides?.model ?? agent.model ?? this.anthropicConfig.defaultModel ?? 'claude-opus-4-6';
         const maxTokens = overrides?.maxTokens ?? agent.maxTokens ?? this.anthropicConfig.defaultMaxTokens ?? 4096;
         const temperature = overrides?.temperature ?? agent.temperature ?? 1;
-        const systemPrompt = overrides?.systemPromptSuffix
-            ? `${agent.systemPrompt}\n\n${overrides.systemPromptSuffix}`
-            : agent.systemPrompt;
         const { tools, extras } = this.buildToolList(agent, overrides);
+        const systemPrompt = this.buildSystemPrompt(agent, tools, overrides);
         const toolCalls = [];
         let currentMessages = [...messages];
         let totalUsage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
@@ -117,10 +115,8 @@ class AgentRunnerService {
         const model = overrides?.model ?? agent.model ?? this.anthropicConfig.defaultModel ?? 'claude-opus-4-6';
         const maxTokens = overrides?.maxTokens ?? agent.maxTokens ?? this.anthropicConfig.defaultMaxTokens ?? 4096;
         const temperature = overrides?.temperature ?? agent.temperature ?? 1;
-        const systemPrompt = overrides?.systemPromptSuffix
-            ? `${agent.systemPrompt}\n\n${overrides.systemPromptSuffix}`
-            : agent.systemPrompt;
         const { tools, extras } = this.buildToolList(agent, overrides);
+        const systemPrompt = this.buildSystemPrompt(agent, tools, overrides);
         let currentMessages = [...messages];
         let totalUsage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
         while (true) {
@@ -184,6 +180,44 @@ class AgentRunnerService {
         yield { type: 'usage', usage: totalUsage };
         yield { type: 'done', messageId };
     }
+    /**
+     * Compose the system prompt for a single Anthropic call:
+     *
+     *   [tool-awareness preamble]   ← only when `tools` is non-empty
+     *   ──────────────────────────
+     *   agent.systemPrompt          ← what the operator wrote
+     *   ──────────────────────────
+     *   overrides.systemPromptSuffix ← optional per-call addendum
+     *
+     * The preamble exists because operator prompts in the wild often pin
+     * the model to a narrow persona ("respond in three sentences", "stick
+     * to product Q&A") which suppresses tool use even when tools are
+     * attached and clearly relevant. The preamble doesn't override the
+     * operator — it's a short, generic reminder that listed tools are
+     * available and should be consulted when the user's question depends
+     * on real-world / current / authoritative information.
+     *
+     * It's only added when tools are present, so prompt-only agents stay
+     * exactly as the operator wrote them.
+     */
+    buildSystemPrompt(agent, tools, overrides) {
+        const parts = [];
+        if (tools && tools.length > 0) {
+            const names = tools.map((t) => `\`${t.name}\``).join(', ');
+            parts.push('You have the following tools available: ' +
+                names +
+                '. Use them whenever the user’s request depends on information ' +
+                'you can’t reliably produce from memory (current data, time, ' +
+                'account-specific facts, external APIs). Do not refuse to use a ' +
+                'tool because of style or persona instructions further below — ' +
+                'those control your voice, not your capabilities. When a tool is ' +
+                'clearly relevant, call it before composing the final answer.');
+        }
+        parts.push(agent.systemPrompt);
+        if (overrides?.systemPromptSuffix)
+            parts.push(overrides.systemPromptSuffix);
+        return parts.join('\n\n');
+    }
     /**
      * Merge `agent.tools[]` (resolved via the global registry) with any
      * per-call extras (e.g. the user's connector tools).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/core",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Framework-free AI runtime SDK. Owns: agent loop (Anthropic), conversations, tools, streaming, agent-job queue, SdkHooks. Identity, billing, infra (email/uploads/secrets) live in the host's modules — not here.",
   "license": "MIT",
   "main": "dist/index.js",