agentic-api 2.0.585 → 2.0.636

package/dist/src/agents/reducer.factory.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Factory to create a ReducerFn compatible with JobRunner using MapLLM
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMapLLMReducer = createMapLLMReducer;
+const reducer_core_1 = require("./reducer.core");
+const reducer_loaders_1 = require("./reducer.loaders");
+/**
+ * Default JSON schema for ReducedJobMemory
+ * Note: For strict mode, all properties must be in required array and
+ * all nested objects need additionalProperties: false
+ */
+const DEFAULT_MEMORY_SCHEMA = {
+    name: 'ReducedJobMemory',
+    schema: {
+        type: 'object',
+        properties: {
+            memory: {
+                type: 'string',
+                description: 'Short canonical memory summarizing progress and key facts'
+            },
+            index: {
+                type: 'object',
+                description: 'Stable references: artifact IDs, data tables, error traces',
+                properties: {
+                    artifacts: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of artifact references'
+                    },
+                    taskIds: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of completed task IDs'
+                    },
+                    errors: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of error messages'
+                    }
+                },
+                required: ['artifacts', 'taskIds', 'errors'],
+                additionalProperties: false
+            },
+            statusLine: {
+                type: 'string',
+                description: 'UI progress line'
+            }
+        },
+        required: ['memory', 'index', 'statusLine'],
+        additionalProperties: false
+    },
+    strict: true
+};
+/**
+ * Creates a ReducerFn compatible with JobRunner that uses MapLLM internally.
+ *
+ * This factory bridges JobRunner and MapLLM, allowing LLM-powered reduction
+ * with structured outputs while keeping both modules independent.
+ *
+ * @example
+ * ```typescript
+ * const reducer = createMapLLMReducer({
+ *   digestPrompt: "Analyze this task result and extract key facts...",
+ *   reducePrompt: "Merge with previous memory to produce updated canonical memory...",
+ *   model: 'LOW'
+ * });
+ *
+ * const runner = new JobRunner({
+ *   planner: myPlanner,
+ *   executor: myExecutor,
+ *   reducer: reducer  // ← ReducerFn compatible
+ * });
+ * ```
+ */
+function createMapLLMReducer(options) {
+    const { digestPrompt, reducePrompt, format = DEFAULT_MEMORY_SCHEMA, model = 'LOW', finalReduce = true, reduceThresholdBytes, verbose = false } = options;
+    return async (previous, task, result) => {
+        // Serialize context for reduction
+        const context = JSON.stringify({
+            previousMemory: previous,
+            task: {
+                id: task.id,
+                title: task.title,
+                type: task.type
+            },
+            result: {
+                taskId: result.taskId,
+                ok: result.ok,
+                summary: result.summary,
+                error: result.error,
+                artifacts: result.artifacts,
+                // Include data if small enough, otherwise just note its presence
+                data: result.data && JSON.stringify(result.data).length < 2000
+                    ? result.data
+                    : (result.data ? '[data truncated]' : undefined)
+            }
+        }, null, 2);
+        // Create loader with single-chunk strategy (the context is already compact)
+        const loader = new reducer_loaders_1.StringNativeLoader(context, { type: 'paragraphs', size: 10 });
+        // Create MapLLM with options
+        const mapllmOptions = {
+            finalReduce,
+            reduceThresholdBytes
+        };
+        const mapper = new reducer_core_1.MapLLM(loader, mapllmOptions);
+        // Config for MapLLM
+        const config = {
+            digestPrompt,
+            reducePrompt
+        };
+        // Callback: accumulate structured output
+        const callback = (res, current) => {
+            // If current is already an object (structured output), use it directly
+            if (typeof current === 'object' && current !== null) {
+                res.acc = current;
+            }
+            else if (typeof current === 'string') {
+                // Try to parse as JSON
+                try {
+                    res.acc = JSON.parse(current);
+                }
+                catch {
+                    // Fallback: wrap in memory field
+                    res.acc = {
+                        memory: current,
+                        index: res.acc?.index || {}
+                    };
+                }
+            }
+            return res;
+        };
+        // Init with previous memory or empty
+        const init = {
+            acc: previous || { memory: '', index: {} },
+            config,
+            format,
+            model,
+            verbose
+        };
+        // Execute MapLLM reduce
+        const out = await mapper.reduce(callback, init);
+        // Validate and return
+        const result_acc = out.acc;
+        // Ensure required fields exist
+        const reducedMemory = {
+            memory: typeof result_acc.memory === 'string' ? result_acc.memory : JSON.stringify(result_acc.memory || ''),
+            index: typeof result_acc.index === 'object' ? result_acc.index : {},
+            statusLine: result_acc.statusLine
+        };
+        return reducedMemory;
+    };
+}

package/dist/src/agents/reducer.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./reducer.core"), exports);
 __exportStar(require("./reducer.loaders"), exports);
 __exportStar(require("./reducer.types"), exports);
+__exportStar(require("./reducer.factory"), exports);

package/dist/src/execute/responses.js

@@ -329,14 +329,35 @@ async function executeAgentSet(agentSet, context, params) {
         throw new Error(`Agent ${currentAgent} has no instructions`);
     }
     let enrichedQuery = query;
+    //
+    // ✅ FIX: Always refresh system prompt with latest memories (MEM_ALWAYS, rules, etc.)
+    // Before: enrichWithMemory("system") was only called for NEW discussions
+    // After: enrichWithMemory("system") is called on EVERY request to keep memories up-to-date
+    //
+    // TODO [Best Practice]: OpenAI recommande d'injecter le contexte dynamique (mémoires, RAG)
+    // dans un message "user" avec tag <context> plutôt que dans le system message.
+    // Raisons:
+    // - Hiérarchie des rôles: system > developer > user (sécurité contre prompt injection)
+    // - Séparation instructions stables (developer) vs contexte dynamique (user)
+    // Refs:
+    // - https://cookbook.openai.com/examples/agents_sdk/context_personalization
+    // - https://cookbook.openai.com/articles/openai-harmony
+    // - https://community.openai.com/t/appropriate-role-for-context-message-in-query-in-rag/867231
+    //
+    const enrichedInstructions = await params.enrichWithMemory?.("system", currentAgentConfig, context);
     if (!discussion.messages.length) {
+        //
+        // New discussion: initialize usage and set system message
         discussion.usage = { prompt: 0, completion: 0, total: 0, cost: 0 };
-        const enrichedInstructions = await params.enrichWithMemory?.("system", currentAgentConfig, context);
-        const instructions = currentAgentConfig.instructions + '\n' + enrichedInstructions;
+        const instructions = currentAgentConfig.instructions + '\n' + (enrichedInstructions || '');
         stateGraph.set(discussionRootAgent, instructions);
     }
-    else {
-        enrichedQuery = (await params.enrichWithMemory?.("user", currentAgentConfig, context)) || query;
+    else if (enrichedInstructions) {
+        //
+        // Existing discussion: only update system message if enrichedInstructions exists
+        // stateGraph.set() preserves context-trail via updateSystemMessage()
+        const instructions = currentAgentConfig.instructions + '\n' + enrichedInstructions;
+        stateGraph.set(discussionRootAgent, instructions);
     }
     stateGraph.push(discussionRootAgent, { role: "user", content: enrichedQuery });
     const tools = currentAgentConfig.tools;

package/dist/src/index.d.ts

@@ -11,9 +11,12 @@ export type { LLMProvider, LLMConfig, ProviderConfig } from './llm';
 export { modelPricing, calculateCost, accumulateCost, LLM, LLMxai, LLMopenai } from './llm/pricing';
 export { modelConfig } from './execute/modelconfig';
 export * from './scrapper';
+export * from './prompts';
 export * from './agents/reducer';
+export * from './agents/prompts';
 export * from './agents/semantic';
 export * from './agents/system';
+export * from './agents/job.runner';
 export * from './rag';
 export * from './usecase';
 export * from './rules';

package/dist/src/index.js

@@ -47,10 +47,14 @@ var modelconfig_1 = require("./execute/modelconfig");
 Object.defineProperty(exports, "modelConfig", { enumerable: true, get: function () { return modelconfig_1.modelConfig; } });
 // Scrapper
 __exportStar(require("./scrapper"), exports);
+// Prompts
+__exportStar(require("./prompts"), exports);
 // Agents
 __exportStar(require("./agents/reducer"), exports);
+__exportStar(require("./agents/prompts"), exports);
 __exportStar(require("./agents/semantic"), exports);
 __exportStar(require("./agents/system"), exports);
+__exportStar(require("./agents/job.runner"), exports);
 // RAG Library
 __exportStar(require("./rag"), exports);
 // Usecase

package/dist/src/rag/rag.manager.d.ts

@@ -47,6 +47,9 @@ export declare class RAGManager {
     /**
      * Notifie les embeddings chargés de se mettre à jour
      *
+     * Cette méthode est publique pour permettre aux applications de notifier
+     * les utilisateurs actifs du RAG (tools, search) qu'il a été mis à jour.
+     *
      * @param name Nom du RAG à mettre à jour
      * @param opts Options de mise à jour (action: 'rename' pour renommer un document)
      *
@@ -59,18 +62,22 @@ export declare class RAGManager {
      *
      * @example
      * ```typescript
-     * // Après un build
-     * this.notifyUpdate('procedures-stable');
+     * // Après un build externe
+     * ragManager.notifyUpdate('procedures-stable');
      *
      * // Après un rename de document
-     * this.notifyUpdate('procedures-stable', {
+     * ragManager.notifyUpdate('procedures-stable', {
      *   action: 'rename',
      *   oldFile: 'old.md',
      *   newFile: 'new.md'
      * });
      * ```
      */
-    private notifyUpdate;
+    notifyUpdate(name: string, opts?: {
+        action?: 'rename';
+        oldFile?: string;
+        newFile?: string;
+    }): void;
     /**
      * Génère un nom d'archive avec timestamp YYYMMDD
      */

package/dist/src/rag/rag.manager.js

@@ -213,6 +213,9 @@ class RAGManager {
     /**
      * Notifie les embeddings chargés de se mettre à jour
      *
+     * Cette méthode est publique pour permettre aux applications de notifier
+     * les utilisateurs actifs du RAG (tools, search) qu'il a été mis à jour.
+     *
      * @param name Nom du RAG à mettre à jour
      * @param opts Options de mise à jour (action: 'rename' pour renommer un document)
      *
@@ -225,11 +228,11 @@ class RAGManager {
      *
      * @example
      * ```typescript
-     * // Après un build
-     * this.notifyUpdate('procedures-stable');
+     * // Après un build externe
+     * ragManager.notifyUpdate('procedures-stable');
      *
      * // Après un rename de document
-     * this.notifyUpdate('procedures-stable', {
+     * ragManager.notifyUpdate('procedures-stable', {
      *   action: 'rename',
      *   oldFile: 'old.md',
      *   newFile: 'new.md'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-api",
-  "version": "2.0.585",
+  "version": "2.0.636",
   "description": "API pour l'orchestration d'agents intelligents avec séquences et escalades automatiques",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",