@aj-archipelago/cortex 1.4.21 → 1.4.23

package/lib/util.js

@@ -294,6 +294,75 @@ function removeImageAndFileFromMessage(message) {
     return modifiedMessage;
 }
 
+/**
+ * Recursively sanitizes base64 data in objects/arrays to prevent logging large base64 strings
+ * Replaces base64 data with a placeholder string
+ */
+function sanitizeBase64(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    
+    // Handle strings - check for base64 data URLs or long base64 strings
+    if (typeof obj === 'string') {
+        // Check if it's a data URL with base64
+        if (obj.startsWith('data:') && obj.includes('base64,')) {
+            return '* base64 data truncated for log *';
+        }
+        // Check if it's a long base64 string (likely base64 if > 100 chars and matches base64 pattern)
+        if (obj.length > 100 && /^[A-Za-z0-9+/=]+$/.test(obj) && obj.length % 4 === 0) {
+            return '* base64 data truncated for log *';
+        }
+        return obj;
+    }
+    
+    // Handle arrays
+    if (Array.isArray(obj)) {
+        return obj.map(item => sanitizeBase64(item));
+    }
+    
+    // Handle objects
+    if (typeof obj === 'object') {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(obj)) {
+            // Special handling for known base64 fields
+            if (key === 'data' && typeof value === 'string' && value.length > 50) {
+                // Check if it looks like base64
+                if (/^[A-Za-z0-9+/=]+$/.test(value) && value.length % 4 === 0) {
+                    sanitized[key] = '* base64 data truncated for log *';
+                    continue;
+                }
+            }
+            // Handle image_url.url with base64
+            if (key === 'url' && typeof value === 'string' && value.startsWith('data:') && value.includes('base64,')) {
+                sanitized[key] = '* base64 data truncated for log *';
+                continue;
+            }
+            // Handle source.data (Claude format)
+            if (key === 'source' && typeof value === 'object' && value?.type === 'base64' && value?.data) {
+                sanitized[key] = {
+                    ...value,
+                    data: '* base64 data truncated for log *'
+                };
+                continue;
+            }
+            // Handle inlineData.data (Gemini format)
+            if (key === 'inlineData' && typeof value === 'object' && value?.data) {
+                sanitized[key] = {
+                    ...value,
+                    data: '* base64 data truncated for log *'
+                };
+                continue;
+            }
+            // Recursively sanitize nested objects
+            sanitized[key] = sanitizeBase64(value);
+        }
+        return sanitized;
+    }
+    
+    return obj;
+}
+
 export { 
     getUniqueId,
     getSearchResultId,
@@ -303,5 +372,6 @@ export {
     chatArgsHasType,
     convertSrtToText,
     alignSubtitles,
-    removeOldImageAndFileContent
+    removeOldImageAndFileContent,
+    sanitizeBase64
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aj-archipelago/cortex",
-  "version": "1.4.21",
+  "version": "1.4.23",
   "description": "Cortex is a GraphQL API for AI. It provides a simple, extensible interface for using AI services from OpenAI, Azure and others.",
   "private": false,
   "repository": {

package/pathways/image_flux.js

@@ -13,7 +13,13 @@ export default {
     output_format: "webp",
     output_quality: 80,
     steps: 4,
-    input_image: "", // URL to input image for models that support it
-    input_image_2: "", // URL to second input image for models that support it
+    input_image: "", // URL to a single input image (primary field for models that support image input)
+    input_image_1: "", // URL to the first input image when providing multiple input images
+    input_image_2: "", // URL to the second input image when providing multiple input images
+    input_image_3: "", // URL to the third input image when providing multiple input images
+    input_images: { type: "array", items: { type: "string" } }, // Array of input image URLs (alternative to input_image_*, max 8 for flux-2-pro)
+    // Flux 2 Pro specific parameters
+    resolution: "1 MP", // Options: "match_input_image", "0.5 MP", "1 MP", "2 MP", "4 MP" (flux-2-pro only)
+    seed: { type: "integer" }, // Optional seed for reproducible results
   },
 };

package/pathways/image_qwen.js

@@ -3,7 +3,7 @@ export default {
 
   enableDuplicateRequests: false,
   inputParameters: {
-    model: "replicate-qwen-image", // Options: "replicate-qwen-image" or "replicate-qwen-image-edit-plus"
+    model: "replicate-qwen-image", // Options: "replicate-qwen-image", "replicate-qwen-image-edit-plus", or "replicate-qwen-image-edit-2511"
     negativePrompt: "",
     width: 1024,
     height: 1024,

package/pathways/system/entity/files/sys_read_file_collection.js

@@ -3,39 +3,41 @@
 // File collections are stored in Redis hash maps (FileStoreMap:ctx:<contextId>
 // Returns file collection as JSON array string for backward compatibility with Labeeb
 
-import { loadFileCollection } from '../../../../lib/fileUtils.js';
+import { loadMergedFileCollection } from '../../../../lib/fileUtils.js';
 
 export default {
     inputParameters: {
-        contextId: ``,
-        contextKey: ``,
+        agentContext: [
+            { contextId: ``, contextKey: ``, default: true }
+        ],
         useCache: true
     },
     // No format field - returns String directly (like sys_read_memory)
     model: 'oai-gpt4o',
 
     resolver: async (_parent, args, _contextValue, _info) => {
-        const { contextId, contextKey = null, useCache = true } = args;
+        const { agentContext } = args;
         
-        // Validate that contextId is provided
-        if (!contextId) {
+        // Validate that agentContext is provided
+        if (!agentContext || !Array.isArray(agentContext) || agentContext.length === 0) {
             return JSON.stringify({ error: 'Context error' }, null, 2);
         }
         
         try {
-            // Load file collection from Redis hash maps
-            const collection = await loadFileCollection(contextId, contextKey, useCache);
+            // Load file collection from Redis hash maps (merged from all agentContext contexts)
+            const collection = await loadMergedFileCollection(agentContext);
             
             // Return as JSON array string for backward compatibility with Labeeb
             // Labeeb expects either: [] or { version: "...", files: [...] }
             // Since we removed versioning, we just return the array directly
-            // Ensure we always return a valid JSON array (empty if no files)
-            const result = Array.isArray(collection) ? collection : [];
+            // Strip internal _contextId before returning
+            const result = (Array.isArray(collection) ? collection : [])
+                .map(({ _contextId, ...file }) => file);
             return JSON.stringify(result);
         } catch (e) {
             // Log error for debugging
             const logger = (await import('../../../../lib/logger.js')).default;
-            logger.warn(`Error loading file collection for contextId ${contextId}: ${e.message}`);
+            logger.warn(`Error loading file collection: ${e.message}`);
             // Return empty array on error for backward compatibility
             return "[]";
         }

package/pathways/system/entity/files/sys_update_file_metadata.js

@@ -2,31 +2,40 @@
 // GraphQL pathway for updating file metadata (replaces sys_save_memory for renames and metadata updates)
 // Only updates Cortex-managed fields (displayFilename, tags, notes, etc.), not CFH fields (url, gcs, hash, filename)
 
-import { updateFileMetadata } from '../../../../lib/fileUtils.js';
+import { updateFileMetadata, getDefaultContext } from '../../../../lib/fileUtils.js';
 
 export default {
     inputParameters: {
-        contextId: ``,
+        agentContext: [{ contextId: ``, contextKey: ``, default: true }],
         hash: ``,
         displayFilename: { type: 'string' }, // Optional - no default
         tags: { type: 'array', items: { type: 'string' } }, // Optional - no default
         notes: { type: 'string' }, // Optional - no default
         mimeType: { type: 'string' }, // Optional - no default
         permanent: { type: 'boolean' }, // Optional - no default
-        inCollection: { type: 'array', items: { type: 'string' } }, // Optional - array of chat IDs, or can be boolean true/false (normalized to ['*'] or removed)
-        contextKey: `` // Optional - context key for encryption
+        inCollection: { type: 'array', items: { type: 'string' } } // Optional - array of chat IDs, or can be boolean true/false (normalized to ['*'] or removed)
     },
     model: 'oai-gpt4o',
     isMutation: true, // Declaratively mark this as a Mutation
 
     resolver: async (_parent, args, _contextValue, _info) => {
-        const { contextId, hash, displayFilename, tags, notes, mimeType, permanent, inCollection, contextKey } = args;
+        const { agentContext, hash, displayFilename, tags, notes, mimeType, permanent, inCollection } = args;
+        
+        const defaultCtx = getDefaultContext(agentContext);
+        if (!defaultCtx) {
+            return JSON.stringify({ 
+                success: false, 
+                error: 'agentContext with at least one default context is required' 
+            });
+        }
+        const contextId = defaultCtx.contextId;
+        const contextKey = defaultCtx.contextKey || null;
         
         // Validate required parameters
-        if (!contextId || !hash) {
+        if (!hash) {
             return JSON.stringify({ 
                 success: false, 
-                error: 'contextId and hash are required' 
+                error: 'hash is required' 
             });
         }
         

package/pathways/system/entity/sys_entity_agent.js

@@ -63,7 +63,9 @@ export default {
     inputParameters: {
         privateData: false,    
         chatHistory: [{role: '', content: []}],
-        contextId: ``,
+        agentContext: [
+            { contextId: ``, contextKey: ``, default: true }
+        ],
         chatId: ``,
         language: "English",
         aiName: "Jarvis",
@@ -76,8 +78,7 @@ export default {
         entityId: ``,
         researchMode: false,
         userInfo: '',
-        model: 'oai-gpt41',
-        contextKey: ``
+        model: 'oai-gpt41'
     },
     timeout: 600,
 
@@ -547,10 +548,11 @@ export default {
             args.chatHistory = args.chatHistory.slice(-20);
         }
 
-        // Sync files from chat history to collection and strip file content
-        // Files are accessible via tools (AnalyzeFile, ReadTextFile, etc.)
+        // Process files in chat history:
+        // - Files in collection (all agentContext contexts): stripped, accessible via tools
+        // - Files not in collection: left in message for model to see directly
         const { chatHistory: strippedHistory, availableFiles } = await syncAndStripFilesFromChatHistory(
-            args.chatHistory, args.contextId, args.contextKey
+            args.chatHistory, args.agentContext
         );
         args.chatHistory = strippedHistory;
 

package/pathways/system/entity/tools/sys_tool_codingagent.js

@@ -81,12 +81,12 @@ export default {
 
     executePathway: async ({args, resolver}) => {
         try {
-            const { codingTask, userMessage, inputFiles, codingTaskKeywords, contextId, contextKey } = args;
+            const { codingTask, userMessage, inputFiles, codingTaskKeywords } = args;
 
             let taskSuffix = "";
             if (inputFiles) {
-                if (!contextId) {
-                    throw new Error("contextId is required when using the 'inputFiles' parameter. Use ListFileCollection or SearchFileCollection to find available files.");
+                if (!args.agentContext || !Array.isArray(args.agentContext) || args.agentContext.length === 0) {
+                    throw new Error("agentContext is required when using the 'inputFiles' parameter. Use ListFileCollection or SearchFileCollection to find available files.");
                 }
                 
                 // Resolve file parameters to URLs
@@ -100,7 +100,7 @@ export default {
                 
                 for (const fileRef of fileReferences) {
                     // Try to resolve each file reference
-                    const resolvedUrl = await resolveFileParameter(fileRef, contextId, contextKey);
+                    const resolvedUrl = await resolveFileParameter(fileRef, args.agentContext);
                     if (resolvedUrl) {
                         resolvedUrls.push(resolvedUrl);
                     } else {

package/pathways/system/entity/tools/sys_tool_editfile.js

@@ -2,7 +2,7 @@
 // Entity tool that modifies existing files by replacing line ranges or exact string matches
 import logger from '../../../../lib/logger.js';
 import { axios } from '../../../../lib/requestExecutor.js';
-import { uploadFileToCloud, findFileInCollection, loadFileCollection, getMimeTypeFromFilename, deleteFileByHash, isTextMimeType, updateFileMetadata, writeFileDataToRedis, invalidateFileCollectionCache, getActualContentMimeType } from '../../../../lib/fileUtils.js';
+import { uploadFileToCloud, findFileInCollection, loadMergedFileCollection, getDefaultContext, getMimeTypeFromFilename, deleteFileByHash, isTextMimeType, updateFileMetadata, writeFileDataToRedis, invalidateFileCollectionCache, getActualContentMimeType } from '../../../../lib/fileUtils.js';
 
 // Maximum file size for editing (50MB) - prevents memory blowup on huge files
 const MAX_EDITABLE_FILE_SIZE = 50 * 1024 * 1024;
@@ -145,7 +145,19 @@ export default {
     ],
 
     executePathway: async ({args, runAllPrompts, resolver}) => {
-        const { file, startLine, endLine, content, oldString, newString, replaceAll = false, contextId, contextKey } = args;
+        const { file, startLine, endLine, content, oldString, newString, replaceAll = false, agentContext } = args;
+        
+        const defaultCtx = getDefaultContext(agentContext);
+        if (!defaultCtx) {
+            const errorResult = {
+                success: false,
+                error: "agentContext with at least one default context is required"
+            };
+            resolver.tool = JSON.stringify({ toolUsed: "EditFile" });
+            return JSON.stringify(errorResult);
+        }
+        const contextId = defaultCtx.contextId;
+        const contextKey = defaultCtx.contextKey || null;
         
         // Determine which tool was called based on parameters
         const isSearchReplace = oldString !== undefined && newString !== undefined;
@@ -162,14 +174,6 @@ export default {
             return JSON.stringify(errorResult);
         }
 
-        if (!contextId) {
-            const errorResult = {
-                success: false,
-                error: "contextId is required for file modification"
-            };
-            resolver.tool = JSON.stringify({ toolUsed: toolName });
-            return JSON.stringify(errorResult);
-        }
 
         // Validate that we have the right parameters for the tool being used
         if (!isSearchReplace && !isEditByLine) {
@@ -243,7 +247,7 @@ export default {
 
         try {
             // Resolve file ID first (needed for serialization)
-            const collection = await loadFileCollection(contextId, contextKey, false);
+            const collection = await loadMergedFileCollection(agentContext);
             const foundFile = findFileInCollection(file, collection);
             
             if (!foundFile) {
@@ -281,7 +285,7 @@ export default {
                     logger.info(`Using cached content for: ${currentFile.displayFilename || file}`);
                 } else {
                     // First edit in session: load collection and download file
-                    const currentCollection = await loadFileCollection(contextId, contextKey, false);
+                    const currentCollection = await loadMergedFileCollection(agentContext);
                     currentFile = findFileInCollection(file, currentCollection);
 
                     if (!currentFile) {
@@ -467,7 +471,7 @@ export default {
             if (editResult._isLastOperation) {
                 // Flush: upload the final content and update metadata
                 const { modifiedContent, currentFile, fileIdToUpdate: initialFileId, filename, mimeType, 
-                        modificationInfo, message, contextId: ctxId, contextKey: ctxKey, resolver: res,
+                        modificationInfo, message, resolver: res,
                         file: fileParam, isEditByLine: isByLine, isSearchReplace: isSR, replaceAll: repAll,
                         startLine: sLine, endLine: eLine } = editResult;
                 
@@ -482,7 +486,7 @@ export default {
                     mimeType,
                     filename,
                     res,
-                    ctxId
+                    contextId
                 );
 
                 if (!uploadResult || !uploadResult.url) {
@@ -490,7 +494,8 @@ export default {
                 }
 
                 // Update the file collection entry directly (atomic operation)
-                const latestCollection = await loadFileCollection(ctxId, ctxKey, false);
+                // Use default context from agentContext for consistency
+                const latestCollection = await loadMergedFileCollection(agentContext);
                 let fileToUpdate = latestCollection.find(f => f.id === fileIdToUpdate);
                 
                 // If not found by ID, try to find by the original file parameter
@@ -512,7 +517,7 @@ export default {
                     const { getRedisClient } = await import('../../../../lib/fileUtils.js');
                     const redisClient = await getRedisClient();
                     if (redisClient) {
-                        const contextMapKey = `FileStoreMap:ctx:${ctxId}`;
+                        const contextMapKey = `FileStoreMap:ctx:${contextId}`;
                         
                         const existingDataStr = await redisClient.hget(contextMapKey, uploadResult.hash);
                         let existingData = {};
@@ -541,21 +546,21 @@ export default {
                             permanent: fileToUpdate.permanent || false
                         };
                         
-                        await writeFileDataToRedis(redisClient, contextMapKey, uploadResult.hash, fileData, ctxKey);
+                        await writeFileDataToRedis(redisClient, contextMapKey, uploadResult.hash, fileData, contextKey);
                         
                         if (oldHashToDelete && oldHashToDelete !== uploadResult.hash) {
                             await redisClient.hdel(contextMapKey, oldHashToDelete);
                         }
                         
-                        invalidateFileCollectionCache(ctxId, ctxKey);
+                        invalidateFileCollectionCache(contextId, contextKey);
                     }
                 } else if (fileToUpdate.hash) {
-                    await updateFileMetadata(ctxId, fileToUpdate.hash, {
+                    await updateFileMetadata(contextId, fileToUpdate.hash, {
                         filename: filename,
                         lastAccessed: new Date().toISOString()
-                    }, ctxKey);
+                    }, contextKey);
                     
-                    invalidateFileCollectionCache(ctxId, ctxKey);
+                    invalidateFileCollectionCache(contextId, contextKey);
                 }
 
                 // Delete old file version (fire-and-forget)
@@ -563,7 +568,7 @@ export default {
                     (async () => {
                         try {
                             logger.info(`Deleting old file version with hash ${oldHashToDelete} (background task)`);
-                            await deleteFileByHash(oldHashToDelete, res, ctxId);
+                            await deleteFileByHash(oldHashToDelete, res, contextId);
                         } catch (cleanupError) {
                             logger.warn(`Failed to cleanup old file version: ${cleanupError.message}`);
                         }

package/pathways/system/entity/tools/sys_tool_file_collection.js

@@ -3,7 +3,7 @@
 // Uses Redis hash maps (FileStoreMap:ctx:<contextId>) for storage
 // Supports atomic rename/tag/notes updates via UpdateFileMetadata
 import logger from '../../../../lib/logger.js';
-import { addFileToCollection, loadFileCollection, findFileInCollection, deleteFileByHash, updateFileMetadata, invalidateFileCollectionCache } from '../../../../lib/fileUtils.js';
+import { addFileToCollection, loadFileCollection, loadMergedFileCollection, findFileInCollection, deleteFileByHash, updateFileMetadata, invalidateFileCollectionCache, getDefaultContext } from '../../../../lib/fileUtils.js';
 
 export default {
     prompt: [],
@@ -198,7 +198,12 @@ export default {
     ],
 
     executePathway: async ({args, runAllPrompts, resolver}) => {
-        const { contextId, contextKey } = args;
+        const defaultCtx = getDefaultContext(args.agentContext);
+        if (!defaultCtx) {
+            throw new Error("agentContext with at least one default context is required");
+        }
+        const contextId = defaultCtx.contextId;
+        const contextKey = defaultCtx.contextKey || null;
 
         // Determine which function was called based on which parameters are present
         // Order matters: check most specific operations first
@@ -359,12 +364,12 @@ export default {
                 const safeFilterTags = Array.isArray(filterTags) ? filterTags : [];
                 const queryLower = query.toLowerCase();
                 
-                // Update lastAccessed for matching files directly (atomic operations)
-                const allFiles = await loadFileCollection(contextId, contextKey, false);
+                // Load primary collection for lastAccessed updates (only update files in primary context)
+                const primaryFiles = await loadFileCollection(contextId, contextKey, false);
                 const now = new Date().toISOString();
                 
-                // Find matching files and update lastAccessed directly
-                for (const file of allFiles) {
+                // Find matching files in primary collection and update lastAccessed directly
+                for (const file of primaryFiles) {
                     if (!file.hash) continue;
                     
                     // Fallback to filename if displayFilename is not set (for files uploaded before displayFilename was added)
@@ -387,8 +392,8 @@ export default {
                     }
                 }
                 
-                // Reload collection to get results (after update)
-                const updatedFiles = await loadFileCollection(contextId, contextKey, false);
+                // Load merged collection for search results (includes all agentContext files)
+                const updatedFiles = await loadMergedFileCollection(args.agentContext);
                 
                 // Filter and sort results (for display only, not modifying)
                 let results = updatedFiles.filter(file => {
@@ -560,8 +565,8 @@ export default {
                 // List collection (read-only, no locking needed)
                 const { tags: filterTags = [], sortBy = 'date', limit = 50 } = args;
                 
-                // Use useCache: false to ensure we get the latest file data (important after edits)
-                const collection = await loadFileCollection(contextId, contextKey, false);
+                // Use merged collection to include files from all agentContext contexts
+                const collection = await loadMergedFileCollection(args.agentContext);
                 let results = collection;
 
                 // Filter by tags if provided

package/pathways/system/entity/tools/sys_tool_image.js

@@ -93,9 +93,9 @@ export default {
             let model = "replicate-seedream-4";
             let prompt = args.detailedInstructions || "";
 
-            // If we have input images, use the flux-kontext-max model
+            // If we have input images, use the qwen-image-edit-2511 model
             if (args.inputImages && Array.isArray(args.inputImages) && args.inputImages.length > 0) {
-                model = "replicate-qwen-image-edit-plus";
+                model = "replicate-qwen-image-edit-2511";
             }
 
             pathwayResolver.tool = JSON.stringify({ toolUsed: "image" });
@@ -113,7 +113,7 @@ export default {
                 
                 for (let i = 0; i < imagesToProcess.length; i++) {
                     const imageRef = imagesToProcess[i];
-                    const resolved = await resolveFileParameter(imageRef, args.contextId, args.contextKey);
+                    const resolved = await resolveFileParameter(imageRef, args.agentContext);
                     if (!resolved) {
                         throw new Error(`File not found: "${imageRef}". Use ListFileCollection or SearchFileCollection to find available files.`);
                     }
@@ -139,8 +139,8 @@ export default {
                 params.input_image_3 = resolvedInputImages[2];
             }
 
-            // Set default aspectRatio for qwen-image-edit-plus model
-            if (model === "replicate-qwen-image-edit-plus") {
+            // Set default aspectRatio for qwen-image-edit-2511 model
+            if (model === "replicate-qwen-image-edit-2511") {
                 params.aspectRatio = "match_input_image";
             }
             

package/pathways/system/entity/tools/sys_tool_image_gemini.js

@@ -109,7 +109,7 @@ export default {
                 
                 for (let i = 0; i < imagesToProcess.length; i++) {
                     const imageRef = imagesToProcess[i];
-                    const resolved = await resolveFileParameter(imageRef, args.contextId, args.contextKey, { preferGcs: true });
+                    const resolved = await resolveFileParameter(imageRef, args.agentContext, { preferGcs: true });
                     if (!resolved) {
                         throw new Error(`File not found: "${imageRef}". Use ListFileCollection or SearchFileCollection to find available files.`);
                     }

package/pathways/system/entity/tools/sys_tool_readfile.js

@@ -135,20 +135,20 @@ export default {
             const MAX_CHARS = 100000;
             const MAX_LINES = 1000;
             
-            let { cloudUrl, file, startChar, endChar, startLine, endLine, contextId, contextKey } = args;
+            let { cloudUrl, file, startChar, endChar, startLine, endLine } = args;
             
             // If file parameter is provided, resolve it to a URL using the common utility
             if (file) {
-                if (!contextId) {
+                if (!args.agentContext || !Array.isArray(args.agentContext) || args.agentContext.length === 0) {
                     const errorResult = {
                         success: false,
-                        error: "contextId is required when using the 'file' parameter. Use ListFileCollection or SearchFileCollection to find available files."
+                        error: "agentContext is required when using the 'file' parameter. Use ListFileCollection or SearchFileCollection to find available files."
                     };
                     resolver.tool = JSON.stringify({ toolUsed: "ReadFile" });
                     return JSON.stringify(errorResult);
                 }
                 // Use useCache: false to ensure we get the latest file data (important after edits)
-                const resolvedUrl = await resolveFileParameter(file, contextId, contextKey, { useCache: false });
+                const resolvedUrl = await resolveFileParameter(file, args.agentContext, { useCache: false });
                 if (!resolvedUrl) {
                     const errorResult = {
                         success: false,

package/pathways/system/entity/tools/sys_tool_slides_gemini.js

@@ -80,7 +80,7 @@ export default {
                 
                 for (let i = 0; i < imagesToProcess.length; i++) {
                     const imageRef = imagesToProcess[i];
-                    const resolved = await resolveFileParameter(imageRef, args.contextId, args.contextKey, { preferGcs: true });
+                    const resolved = await resolveFileParameter(imageRef, args.agentContext, { preferGcs: true });
                     if (!resolved) {
                         throw new Error(`File not found: "${imageRef}". Use ListFileCollection or SearchFileCollection to find available files.`);
                     }

package/pathways/system/entity/tools/sys_tool_video_veo.js

@@ -128,7 +128,7 @@ export default {
                     throw new Error("contextId is required when using the 'inputImage' parameter. Use ListFileCollection or SearchFileCollection to find available files.");
                 }
                 
-                const resolved = await resolveFileParameter(args.inputImage, args.contextId, args.contextKey, { preferGcs: true });
+                const resolved = await resolveFileParameter(args.inputImage, args.agentContext, { preferGcs: true });
                 if (!resolved) {
                     throw new Error(`File not found: "${args.inputImage}". Use ListFileCollection or SearchFileCollection to find available files.`);
                 }

package/pathways/system/entity/tools/sys_tool_view_image.js

@@ -1,7 +1,7 @@
 // sys_tool_view_image.js
 // Tool pathway that allows agents to view image files from the file collection
 import logger from '../../../../lib/logger.js';
-import { loadFileCollection, findFileInCollection, ensureShortLivedUrl } from '../../../../lib/fileUtils.js';
+import { loadMergedFileCollection, findFileInCollection, ensureShortLivedUrl, getDefaultContext } from '../../../../lib/fileUtils.js';
 import { config } from '../../../../config.js';
 
 export default {
@@ -34,15 +34,19 @@ export default {
     },
 
     executePathway: async ({args, runAllPrompts, resolver}) => {
-        const { files, contextId, contextKey } = args;
+        const { files } = args;
 
         if (!files || !Array.isArray(files) || files.length === 0) {
             throw new Error("Files parameter is required and must be a non-empty array");
         }
 
+        if (!args.agentContext || !Array.isArray(args.agentContext) || args.agentContext.length === 0) {
+            throw new Error("agentContext is required");
+        }
+
         try {
-            // Load the file collection
-            const collection = await loadFileCollection(contextId, contextKey, true);
+            // Load the file collection (merged from all agentContext contexts)
+            const collection = await loadMergedFileCollection(args.agentContext);
             
             const imageUrls = [];
             const errors = [];
@@ -70,7 +74,8 @@ export default {
 
                 // Resolve to short-lived URL if possible
                 const fileHandlerUrl = config.get('whisperMediaApiUrl');
-                const fileWithShortLivedUrl = await ensureShortLivedUrl(foundFile, fileHandlerUrl, contextId);
+                const defaultCtx = getDefaultContext(args.agentContext);
+                const fileWithShortLivedUrl = await ensureShortLivedUrl(foundFile, fileHandlerUrl, defaultCtx?.contextId || null);
 
                 // Add to imageUrls array
                 imageUrls.push({

package/pathways/system/workspaces/run_workspace_agent.js

@@ -6,8 +6,11 @@ export default {
 
     inputParameters: {
         model: "oai-gpt41",
-        aiStyle: "OpenAI",
         chatHistory: [{role: '', content: []}],
+        researchMode: false,
+        agentContext: [
+            { contextId: "", contextKey: "", default: true }
+        ]
     },
     timeout: 600,
 

package/pathways/video_seedance.js

@@ -11,6 +11,8 @@ export default {
     image: "",
     camera_fixed: false,
     seed: -1,
+    generate_audio: false,
+    last_frame_image: "",
   },
 
   timeout: 60 * 30, // 30 minutes