illuma-agents 1.0.12 → 1.0.14

package/src/messages/cache.ts

@@ -7,14 +7,10 @@ type MessageWithContent = {
   content?: string | MessageContentComplex[];
 };
 
-/** Always-on logger for cache operations */
-const logCache = (message: string) => {
-  console.log(`[Cache] ${message}`);
-};
-
 /** Debug logger for cache operations - set ILLUMA_DEBUG_CACHE=true to enable */
 const debugCache = (message: string, data?: unknown) => {
   if (process.env.ILLUMA_DEBUG_CACHE === 'true') {
+    // eslint-disable-next-line no-console
     console.log(`[Cache] ${message}`, data !== undefined ? JSON.stringify(data, null, 2) : '');
   }
 };
@@ -266,12 +262,12 @@ export function addBedrockCacheControl<
   }
 
   // Log message summary
-  logCache(`📨 Messages | total=${updatedMessages.length} | ${Object.entries(messageTypes).map(([k,v]) => `${k}:${v}`).join(' ')} | skippedReasoning=${skippedWithReasoning}`);
+  debugCache(`📨 Messages | total=${updatedMessages.length} | ${Object.entries(messageTypes).map(([k,v]) => `${k}:${v}`).join(' ')} | skippedReasoning=${skippedWithReasoning}`);
 
   // If no suitable assistant message found, skip conversation caching
   // (System and Tools caching are still handled separately)
   if (lastAssistantIndex === -1) {
-    logCache('📨 Messages | No suitable assistant message for cachePoint (first turn or all have reasoning)');
+    debugCache('📨 Messages | No suitable assistant message for cachePoint (first turn or all have reasoning)');
     return updatedMessages;
   }
 
@@ -284,7 +280,7 @@ export function addBedrockCacheControl<
       { type: ContentTypes.TEXT, text: content },
       { cachePoint: { type: 'default' } },
     ] as MessageContentComplex[];
-    logCache(`📍 Message cachePoint at index ${lastAssistantIndex} (string, ${content.length} chars)`);
+    debugCache(`📍 Message cachePoint at index ${lastAssistantIndex} (string, ${content.length} chars)`);
     debugCache('addBedrockCacheControl: Added cachePoint to assistant message (string content)', {
       index: lastAssistantIndex,
       contentLength: content.length,
@@ -293,7 +289,7 @@ export function addBedrockCacheControl<
     // Double-check: If this message has reasoning blocks, skip adding cache point entirely
     // This handles edge cases where the initial skip check might have missed it
     if (hasReasoningBlock(assistantMessage)) {
-      logCache(`⚠️ Message cachePoint SKIPPED at index ${lastAssistantIndex} (has reasoning blocks)`);
+      debugCache(`⚠️ Message cachePoint SKIPPED at index ${lastAssistantIndex} (has reasoning blocks)`);
       debugCache('addBedrockCacheControl: Skipping - assistant message has reasoning blocks (safety check)', {
         index: lastAssistantIndex,
       });
@@ -312,7 +308,7 @@ export function addBedrockCacheControl<
             cachePoint: { type: 'default' },
           } as MessageContentComplex);
           inserted = true;
-          logCache(`📍 Message cachePoint at index ${lastAssistantIndex} (array, block ${j}, ${text.length} chars)`);
+          debugCache(`📍 Message cachePoint at index ${lastAssistantIndex} (array, block ${j}, ${text.length} chars)`);
           debugCache('addBedrockCacheControl: Added cachePoint after text block in assistant message', {
             index: lastAssistantIndex,
             textBlockIndex: j,
@@ -326,7 +322,7 @@ export function addBedrockCacheControl<
     // If no text block found, don't append cache point as the message structure is unexpected
     if (!inserted) {
       const contentTypes = assistantMessage.content.map((b) => (b as { type?: string }).type);
-      logCache(`⚠️ Message cachePoint SKIPPED at index ${lastAssistantIndex} (no text block, types: ${contentTypes.join(',')})`);
+      debugCache(`⚠️ Message cachePoint SKIPPED at index ${lastAssistantIndex} (no text block, types: ${contentTypes.join(',')})`);
       debugCache('addBedrockCacheControl: No suitable text block found, skipping cache point', {
         index: lastAssistantIndex,
         contentTypes,

package/src/tools/CodeExecutor.ts

@@ -85,16 +85,25 @@ function createCodeExecutionTool(
   }
 
   const description = `
-Runs code and returns stdout/stderr output from a stateless execution environment, similar to running scripts in a command-line interface. Each execution is isolated and independent.
+⛔ STOP! Before using this tool, ask: "Does user need a DOWNLOADABLE FILE?"
+- If NO (dashboard, chart, visualization, UI) → DO NOT USE THIS TOOL. Use :::artifact instead.
+- If YES (.pptx, .docx, .pdf, .xlsx) → Use this tool.
 
-⚠️ DO NOT USE FOR: Creating dashboards, UI components, React components, HTML pages, charts, or visualizations. These should be created as artifacts directly in your response using :::artifact syntax.
+Runs code in a stateless execution environment. Each execution is isolated.
 
-✅ USE FOR: Data processing, calculations, file generation (CSV, Excel, PowerPoint, PDF), matplotlib plots, running algorithms, or computational tasks.
+🚫 NEVER USE FOR:
+- Dashboards, charts, visualizations → Use :::artifact with React/Chart.js
+- "Mock data" or "sample data" for display → Hardcode data in artifact
+- UI components, HTML pages, React apps → Use :::artifact
 
-Usage:
-- No network access available.
-- Generated files are automatically delivered; **DO NOT** provide download links.
-- NEVER use this tool to execute malicious code.
+✅ ONLY USE FOR:
+- File generation: PowerPoint (.pptx), Word (.docx), PDF (.pdf), Excel (.xlsx)
+- Processing uploaded files (CSV, Excel analysis)
+- Heavy computation requiring Python
+
+Rules:
+- No network access available
+- Generated files auto-delivered (no download links needed)
 `.trim();
 
   return tool<typeof CodeExecutionToolSchema>(