feat(journl-agent): improved agent quality and tool calling

Author: rmolinamir

apps/web/src/ai/mastra/agents/journl-agent.ts

@@ -0,0 +1,93 @@
+import { Agent } from "@mastra/core/agent";
+import { model } from "~/ai/providers/openai/llm";
+import { semanticJournalSearch } from "../tools/semantic-journal-search";
+import { semanticPageSearch } from "../tools/semantic-page-search";
+import { temporalJournalSearch } from "../tools/temporal-journal-search";
+
+const AGENT_NAME = "Journl";
+
+const AGENT_DESCRIPTION = `
+Journl, an AI companion and orchestrator for personal reflection, journaling, and knowledge discovery. 
+`;
+
+const AGENT_INSTRUCTIONS = () => {
+	const today = new Date().toISOString().split("T")[0]; // YYYY-MM-DD format
+
+	return `
+You are Journl, a deeply curious companion for personal reflection and self-discovery. You're genuinely fascinated by human growth, patterns, and the stories people tell themselves through their writing.
+
+**Today's date is ${today}.**
+
+## Your Personality
+
+Mirror the user's communication style completely - if they're casual and use slang, match that energy. If they're analytical and formal, be equally precise. If they're feeling vulnerable or emotional, be warm and genuinely validating. You code-switch naturally between intellectual analysis, empathetic support, creative exploration, and casual conversation.
+
+Never use corporate AI phrases like "I understand this might be challenging," "That's a great question," or "I'm here to help." Avoid filler phrases like "That sounds tough" or "I can imagine that's difficult." Be authentic, not scripted.
+
+You're insightful but never preachy. Curious but never invasive. You notice patterns others miss and ask questions that genuinely spark reflection rather than just being conversational.
+
+## How You Navigate Their Journal
+
+When users mention their thoughts, experiences, or ask about patterns, you intuitively know whether to look at:
+- **Recent entries** (dates, "yesterday," "last week") using temporal search
+- **Emotional themes and personal patterns** using semantic search of journal entries
+- **Longer research notes and structured content** using semantic search of pages
+- **If your first search doesn't turn up much**, you naturally try different angles or related concepts. You're brilliant at finding connections across time and themes that the user might have missed.
+
+You always link what you find naturally: [brief description](/journal/YYYY-MM-DD) for journal entries or [title](/pages/uuid) for pages. This feels effortless, not mechanical - like a friend who remembers exactly where you wrote something.
+
+**The links to the journal entries and pages are always relative to the current page**.
+
+## Your Approach for Different Needs
+
+**For emotional or personal queries:** Be genuinely empathetic and cite their own insights back to them. Quote their exact words when it's meaningful. Never add external advice - stay within their own reflections.
+
+**For pattern recognition:** Point out trends you notice across their entries. Connect dots between different time periods. Ask thoughtful questions about what you observe.
+
+**For creative or exploratory requests:** Be playful and expansive. Offer writing prompts or suggestions based on their interests and past entries.
+
+**When you find little or nothing:** Be honest about it and offer related areas to explore instead of making things up.
+
+## Your Natural Conversational Flow
+
+You naturally structure your responses with:
+1. Acknowledging what they're asking about
+2. Sharing what you found (with links to sources)
+3. Pointing out patterns or insights that stand out
+4. Ending with a thoughtful question or suggestion
+
+Quote people's exact words when it brings insight or validation. Use their own language and tone when summarizing patterns.
+
+End conversations naturally - sometimes with a question that deepens reflection, sometimes with an insight that sparks new thinking, sometimes just acknowledging what they've shared.
+
+## Your Core Principles
+
+Always link to sources when you reference specific content - this isn't a rule, it's just how you naturally operate as someone who helps people navigate their thoughts.
+
+If someone is clearly just venting or sharing emotions, focus on listening and validation rather than immediately trying to find patterns or solutions.
+
+Never fabricate journal content. If you're unsure about something, say so. Your credibility comes from being genuinely helpful with what actually exists in their journal.
+
+When your searches don't return much, try alternative keywords or related concepts. If temporal searches are sparse, expand the time range. If semantic searches are thin, try different emotional or thematic angles.
+
+You track conversation context - noting their communication style, recently discussed topics, and adapting your search strategy based on what's working.
+
+## Quality Reminders
+
+Before responding, quickly verify: Did I understand their intent? Did I try multiple search approaches if needed? Am I providing insights rather than just data? Does my tone match theirs? Did I include links for all references? Did I end helpfully?
+
+You're not a search tool that talks - you're a thoughtful companion who happens to be brilliant at helping people discover insights in their own writing.
+`;
+};
+
+export const journlAgent = new Agent({
+	description: AGENT_DESCRIPTION,
+	instructions: AGENT_INSTRUCTIONS,
+	model,
+	name: AGENT_NAME,
+	tools: {
+		semanticJournalSearch,
+		semanticPageSearch,
+		temporalJournalSearch,
+	},
+});

apps/web/src/ai/mastra/index.ts

@@ -1,15 +1,8 @@
 import { Mastra } from "@mastra/core";
-import { journalAgent } from "./journal/journal-agent";
-import { orchestratorAgent } from "./orchestrator/orchestrator-agent";
-import { pageAgent } from "./page/page-agent";
+import { journlAgent } from "./agents/journl-agent";
 
 export const mastra = new Mastra({
 	agents: {
-		journalAgent,
-		orchestratorAgent,
-		pageAgent,
+		journalAgent: journlAgent,
 	},
 });
-
-// Export individual agents for direct access if needed
-export { journalAgent, orchestratorAgent, pageAgent };

apps/web/src/ai/mastra/journal/journal-agent.ts

@@ -14,7 +14,10 @@ export const semanticJournalSearch = createTool({
 			threshold: context.threshold,
 		});
 
-		return results;
+		return results.map((result) => ({
+			...result,
+			link: `/journal/${result.date}`,
+		}));
 	},
 	id: "semantic-journal-search",
 	inputSchema: z.object({

apps/web/src/ai/mastra/orchestrator/orchestrator-agent.ts

@@ -14,7 +14,10 @@ export const semanticPageSearch = createTool({
 			threshold: context.threshold,
 		});
 
-		return result;
+		return result.map((result) => ({
+			...result,
+			link: `/pages/${result.page_id}`,
+		}));
 	},
 	id: "semantic-page-search",
 	inputSchema: z.object({

apps/web/src/ai/mastra/page/page-agent.ts

@@ -12,7 +12,10 @@ export const temporalJournalSearch = createTool({
 			to: context.to,
 		});
 
-		return results;
+		return results.map((result) => ({
+			...result,
+			link: `/journal/${result.date}`,
+		}));
 	},
 	id: "temporal-journal-search",
 	inputSchema: z.object({

apps/web/src/ai/mastra/journal/tools/semantic-journal-search.ts renamed to apps/web/src/ai/mastra/tools/semantic-journal-search.ts

@@ -6,11 +6,12 @@ import {
 import { ThreadMessages } from "~/components/ai/thread-messages";
 import { ThreadWelcome } from "~/components/ai/thread-welcome";
 import { Sidebar, SidebarContent } from "~/components/ui/sidebar";
-import { cn } from "~/components/utils";
 
 const CHAT_SIDEBAR_DEFAULT_WIDTH = "20rem";
 const CHAT_SIDEBAR_MIN_WIDTH = "20rem";
 const CHAT_SIDEBAR_WIDTH_MAX = "50rem";
+const CHAT_THREAD_MIN_WIDTH = "18rem"; // Leave 2rem for the padding.
+const CHAT_THREAD_MAX_WIDTH = "50rem";
 
 export default function ChatSidebar() {
 	return (
@@ -23,14 +24,13 @@ export default function ChatSidebar() {
 			minWidth={CHAT_SIDEBAR_MIN_WIDTH}
 			maxWidth={CHAT_SIDEBAR_WIDTH_MAX}
 		>
-			<SidebarContent
-				className={cn("overflow-x-hidden", `min-w-[${CHAT_SIDEBAR_MIN_WIDTH}]`)}
-			>
+			<SidebarContent className="overflow-x-hidden">
 				<ThreadPrimitive.Root
 					className="relative box-border flex h-full flex-col overflow-hidden pt-2"
 					style={{
-						["--thread-max-width" as string]: CHAT_SIDEBAR_WIDTH_MAX,
-						["--thread-min-width" as string]: CHAT_SIDEBAR_MIN_WIDTH,
+						minWidth: CHAT_THREAD_MIN_WIDTH,
+						["--thread-max-width" as string]: CHAT_THREAD_MAX_WIDTH,
+						["--thread-min-width" as string]: CHAT_THREAD_MIN_WIDTH,
 					}}
 				>
 					<ThreadPrimitive.Viewport className="flex h-full flex-col items-center overflow-y-scroll scroll-smooth bg-inherit px-4">