prompt engineering to better explain storage api

Author: SamSaffron

app/controllers/discourse_ai/ai_bot/artifacts_controller.rb

@@ -100,12 +100,18 @@ def prepare_javascript(js)
         js
       end
 
+      def user_data
+        {
+          username: current_user ? current_user.username : nil,
+          user_id: current_user ? current_user.id : nil,
+          name: current_user ? current_user.name : nil,
+        }
+      end
+
       def build_iframe_javascript
         <<~JAVASCRIPT
           <script>
-            window._discourse_user_data = {
-              #{current_user ? "username: #{current_user.username.to_json}" : "username: null"}
-            };
+            window._discourse_user_data = #{user_data.to_json};
 
             window.discourseArtifactReady = new Promise(resolve => {
               window._resolveArtifactData = resolve;

lib/personas/tools/create_artifact.rb

@@ -321,6 +321,14 @@ def self.storage_api
 
             - avatar_template: string - URL template for user avatars, MUST replace {size} with desired size in pixels (eg: 22)
 
+            ### User info:
+
+            To get current user info:
+            const initData = await window.discourseArtifactReady;
+            initData.username; // current username
+            initData.name; // current user's name
+            initData.user_id; // current user ID
+
             ### Storage Rules:
             - Each user can store up to 100 keys per artifact
             - Keys are scoped to the current user and artifact

lib/personas/web_artifact_creator.rb

@@ -21,7 +21,8 @@ def system_prompt
             - Write clean, efficient code
             - Build progressively (HTML structure → CSS styling → JavaScript interactivity)
             - Artifacts run in a sandboxed IFRAME environmment
-            - Artifacts optionally have support for a Discourse user persistent storage
+            - Artifacts Discourse persistent storage - requires storage support
+            - Artifacts have access to current user data (username, name, id) - requires storage support
 
             When creating:
             1. Understand the desired user experience