feat: improved semantic structure of chat prompt

Author: jahilldev

api/src/chat/chat.prompts.ts

@@ -18,11 +18,21 @@ export function buildChatPrompt(p: {
     .join('\n\n');
 
   return [
-    `You are Hermes, a capable autonomous assistant in an interactive chat. Help with research, questions, analysis, and general engineering work.`,
-    workspaceNote,
-    `Use your full toolset — web access, file reading, and shell — as needed to answer well. This is a conversation, not a delivery job: there is no plan to follow and no PR to open.`,
-    `--- CONVERSATION SO FAR ---\n${transcript}\n--- END CONVERSATION ---`,
-    `Respond to the latest user message above. Output only your reply in GitHub-flavored Markdown — no preamble, no sign-off.`,
+    `# Role
+
+You are Hermes, a capable autonomous assistant in an interactive chat. Help with research, questions, analysis, and general engineering work.
+
+${workspaceNote}
+
+Use your full toolset — web access, file reading, and shell — as needed to answer well. This is a conversation, not a delivery job: there is no plan to follow and no PR to open.`,
+    `# Context
+
+--- CONVERSATION SO FAR ---
+${transcript}
+--- END CONVERSATION ---`,
+    `# Responding
+
+Respond to the latest user message above. Output only your reply in GitHub-flavored Markdown — no preamble, no sign-off.`,
   ].join('\n\n');
 }
 
@@ -32,8 +42,16 @@ export function buildChatPrompt(p: {
  */
 export function buildTitlePrompt(firstMessage: string): string {
   return [
-    `Generate a short, descriptive title for a chat conversation that opens with the message below.`,
-    `Rules:\n- Output ONLY the title — no quotes, no markdown, no trailing punctuation, no preamble.\n- 4 to 8 words, Title Case.\n- Do NOT use any tools; just reply with the title.`,
-    `--- FIRST MESSAGE ---\n${firstMessage}\n--- END ---`,
+    `# Task
+
+Generate a short, descriptive title for a chat conversation that opens with the message below.`,
+    `--- FIRST MESSAGE ---
+${firstMessage}
+--- END FIRST MESSAGE ---`,
+    `# Rules
+
+- Output ONLY the title — no quotes, no markdown, no trailing punctuation, no preamble.
+- 4 to 8 words, Title Case.
+- Do NOT use any tools; just reply with the title.`,
   ].join('\n\n');
 }

app/src/components/RunOutput/EventCard.tsx

@@ -215,7 +215,7 @@ function ToolCard({ event, isSubagent }: { event: LangfuseEvent; isSubagent?: bo
   return (
     <div class="rounded-xl border border-amber-900/40 overflow-hidden text-xs shadow-sm">
       {/* Header */}
-      <div class="flex items-center gap-2 px-3 py-2.5 bg-amber-950/25 text-amber-200">
+      <div class="flex items-center gap-2 px-3 py-2.5 bg-amber-950/25 text-amber-300">
         <IconWrench />
         <span class="font-semibold font-mono tracking-wide">TOOL</span>
         <span class="text-zinc-300 font-mono font-medium">{displayName}</span>