Fix JSONVault shared vault option

SDK : Add LLM prompting with attachment
SDK : Add Support for attachments processing with agent skills
Updated examples and documentation

Author: alaa-eddine

examples/01-agent-code-skill/01-prompting.ts

@@ -3,7 +3,7 @@ import { Agent, Scope } from '@smythos/sdk';
 async function main() {
     const agent = new Agent({
         id: 'crypto-market-assistant',
-        teamId: 'the-matrix',
+        
         name: 'CryptoMarket Assistant',
         behavior: 'You are a crypto price tracker. You are given a coin id and you need to get the price of the coin in USD',
         model: 'gpt-4o',
@@ -19,9 +19,28 @@ async function main() {
             return data.market_data;
         },
     });
+    const imgSkill = agent.addSkill({
+        name: 'ImageAnalyser',
+        description: 'Any attachment should be processed by this function',
+        process: async ({ image_url }) => {
+            console.log(image_url);
+            return 'Image analysed';
+        },
+    });
+    // imgSkill.in({
+    //     image_url : {
+    //         type:'Binary',
+    //         description:'The image url that we will analyze'
+    //     }
+    // })
+
+
+
+    const prompt = await agent.prompt('Analyze this image please ', {
+        files: ['https://www.robuxio.com/wp-content/uploads/2023/05/Trend.png'],
+    });
+    console.log(prompt);
 
-    const storage = agent.storage.LocalStorage({ scope: Scope.TEAM });
-    await storage.write('test0001.txt', 'Hello, world!');
 
     //this will prompt the agent and use the agent's LLM to determine which skill to use
     const promptResult = await agent.prompt('What are the current prices of Bitcoin and Ethereum ?');

examples/01-agent-code-skill/06-handle-attachment-with-agent-llm.ts

@@ -0,0 +1,26 @@
+import { Agent, Scope } from '@smythos/sdk';
+
+async function main() {
+    //in this example, the image is processed by the native agent LLM
+    
+
+    const agent = new Agent({
+        id: 'image-analyser',        
+        name: 'Image Analyser',
+        behavior: 'You are an image analyser. You are given an image and you need to analyse it',
+        model: 'gpt-4o',
+    });
+
+
+
+    const prompt = await agent.prompt('Describe this image please ', {
+        //you can pass your attachments in files array
+        //it supports local files, remote urls, smythfs:// urls, Buffers or Blobs
+        files: ['https://upload.wikimedia.org/wikipedia/commons/thumb/6/66/VanGogh-starry_night_ballance1.jpg/960px-VanGogh-starry_night_ballance1.jpg'],
+    });
+    console.log(prompt);
+
+
+}
+
+main();

examples/01-agent-code-skill/06-handle-attachment-with-agent-skill.ts

@@ -0,0 +1,45 @@
+import { Agent, Scope } from '@smythos/sdk';
+
+async function main() {
+    //in this example, we will skip the native LLM image processing, and we will let the agent delegate it to the appropriate skill
+
+    const agent = new Agent({
+        id: 'image-analyser',        
+        name: 'Image Analyser',
+        behavior: 'You are an image analyser. You are given an image and you need to analyse it',
+        model: 'gpt-4o',
+    });
+
+    //First we define the skill that will handle the image
+    const imgSkill = agent.addSkill({
+        name: 'ImageAnalyser',
+        description: 'Any attachment should be processed by this function',
+        process: async ({ image_url }) => {
+            //Here the image_url will be passed as smythfs:// url
+            //we can extract it using agent.storage functions 
+            
+            console.log(image_url);
+            return 'Image analysed';
+        },
+    });
+    //very important, we need to force the input type of image_url to Binary
+    //this will tell our agent to skip the native LLM image processing, and use the agent skill instead
+    imgSkill.in({
+        image_url : {
+            type:'Binary',
+            description:'The image url that we will analyze'
+        }
+    })
+
+
+    const prompt = await agent.prompt('Analyze this image please ', {
+        //you can pass your attachments in files array
+        //it supports local files, remote urls, smythfs:// urls, Buffers or Blobs
+        files: ['https://upload.wikimedia.org/wikipedia/commons/thumb/6/66/VanGogh-starry_night_ballance1.jpg/960px-VanGogh-starry_night_ballance1.jpg'],
+    });
+    console.log(prompt);
+
+
+}
+
+main();

examples/04-VectorDB-no-agent/05-ramvec-upsert-pdf copy.ts renamed to examples/04-VectorDB-no-agent/05-ramvec-upsert-pdf.ts

@@ -0,0 +1,33 @@
+# SmythOS SRE Examples
+
+This directory contains a collection of examples demonstrating how to use the SmythOS SRE (Smyth Runtime Environment) and its various features.
+
+Each example is a standalone script that can be run to see a specific part of the system in action.
+
+## Running Examples
+
+You can run any example using `npm`, `pnpm`, or `yarn`. Simply provide the path to the example file you want to run.
+
+### With NPM
+
+```bash
+npm start <path_to_example.ts>
+```
+
+### With PNPM
+
+```bash
+pnpm start <path_to_example.ts>
+```
+
+### With Yarn
+
+```bash
+yarn start <path_to_example.ts>
+```
+
+For instance, to run an example located at `01-agent-code-skill/01-prompting.ts`, you would execute:
+
+```bash
+npm start ./01-agent-code-skill/01-prompting.ts
+```

examples/README.md

@@ -1,13 +1,13 @@
 {
     "name": "@smythos/examples",
-    "version": "1.0.4",
+    "version": "1.0.5",
     "private": true,
     "description": "SmythOS SDK Examples",
     "type": "module",
     "author": "Alaa-eddine KADDOURI",
     "license": "MIT",
     "scripts": {
-        "try": "tsx"
+        "start": "tsx"
     },
     "dependencies": {
         "@smythos/sdk": "workspace:*",

examples/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sre",
-    "version": "0.0.10",
+    "version": "0.0.11",
     "description": "",
     "author": "Alaa-eddine KADDOURI",
     "license": "MIT",

package.json

@@ -195,5 +195,5 @@
       ]
     }
   },
-  "version": "0.2.11"
+  "version": "0.2.12"
 }

packages/cli/oclif.manifest.json

@@ -1,6 +1,6 @@
 {
     "name": "@smythos/cli",
-    "version": "0.2.11",
+    "version": "0.2.12",
     "description": "SmythOS SRE Command Line Interface",
     "keywords": [
         "smythos",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@smythos/sre",
-    "version": "1.5.12",
+    "version": "1.5.13",
     "description": "Smyth Runtime Environment",
     "author": "Alaa-eddine KADDOURI",
     "license": "MIT",