Release 0.6.0

Author: derekhearst

module.json

@@ -2,7 +2,7 @@
 	"id": "foundry-ai",
 	"title": "FoundryAI",
 	"description": "AI-powered DM assistant with chat interface, RAG over journals/actors, session recaps, quest tracking, and more.",
-	"version": "0.5.2",
+	"version": "0.6.0",
 	"authors": [
 		{
 			"name": "Derek",
@@ -30,7 +30,7 @@
 	"socket": true,
 	"url": "https://github.com/derekhearst/FoundryAI",
 	"manifest": "https://github.com/derekhearst/FoundryAI/releases/latest/download/module.json",
-	"download": "https://github.com/derekhearst/FoundryAI/releases/download/0.5.2/foundry-ai.zip",
+	"download": "https://github.com/derekhearst/FoundryAI/releases/download/0.6.0/foundry-ai.zip",
 	"license": "MIT",
 	"readme": "https://github.com/derekhearst/FoundryAI/blob/main/README.md"
 }

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "foundry-ai",
-	"version": "0.5.2",
+	"version": "0.6.0",
 	"description": "FoundryAI - AI-powered DM assistant for Foundry VTT",
 	"type": "module",
 	"scripts": {

src/core/system-prompt.ts

@@ -78,6 +78,26 @@ function getWorldContext(): string | null {
 		/* ignore */
 	}
 
+	// Available journals inventory
+	try {
+		const journalIndex = getJournalInventory()
+		if (journalIndex) {
+			parts.push(journalIndex)
+		}
+	} catch {
+		/* ignore */
+	}
+
+	// Available actors inventory
+	try {
+		const actorIndex = getActorInventory()
+		if (actorIndex) {
+			parts.push(actorIndex)
+		}
+	} catch {
+		/* ignore */
+	}
+
 	if (parts.length === 0) return null
 
 	return `# Campaign Context\n\n${parts.join('\n\n')}`
@@ -108,6 +128,72 @@ function getPlayerCharacters(): string[] {
 	return pcs
 }
 
+/**
+ * Build a compact inventory of all journal entries grouped by folder.
+ * This lets the LLM know what's available so it can fetch relevant docs.
+ */
+function getJournalInventory(): string | null {
+	if (!game.journal || game.journal.size === 0) return null
+
+	// Group journals by folder
+	const byFolder = new Map<string, Array<{ id: string; name: string; pages: number }>>()
+
+	for (const entry of game.journal.values()) {
+		const folderName = entry.folder?.name || 'Uncategorized'
+		if (!byFolder.has(folderName)) byFolder.set(folderName, [])
+		byFolder.get(folderName)!.push({
+			id: entry.id,
+			name: entry.name,
+			pages: entry.pages?.size || 0,
+		})
+	}
+
+	const lines: string[] = ['## Available Journals']
+	lines.push('Use search_journals or get_journal (with the ID) to read any of these:\n')
+
+	for (const [folder, entries] of byFolder) {
+		lines.push(`### 📁 ${folder}`)
+		for (const e of entries) {
+			lines.push(`- ${e.name} (id: ${e.id}, ${e.pages} page${e.pages !== 1 ? 's' : ''})`)
+		}
+		lines.push('')
+	}
+
+	return lines.join('\n')
+}
+
+/**
+ * Build a compact inventory of all actors grouped by folder.
+ */
+function getActorInventory(): string | null {
+	if (!game.actors || game.actors.size === 0) return null
+
+	const byFolder = new Map<string, Array<{ id: string; name: string; type: string }>>()
+
+	for (const actor of game.actors.values()) {
+		const folderName = actor.folder?.name || 'Uncategorized'
+		if (!byFolder.has(folderName)) byFolder.set(folderName, [])
+		byFolder.get(folderName)!.push({
+			id: actor.id,
+			name: actor.name,
+			type: actor.type,
+		})
+	}
+
+	const lines: string[] = ['## Available Actors']
+	lines.push('Use search_actors or get_actor (with the ID) to look up any of these:\n')
+
+	for (const [folder, actors] of byFolder) {
+		lines.push(`### 📁 ${folder}`)
+		for (const a of actors) {
+			lines.push(`- ${a.name} (id: ${a.id}, type: ${a.type})`)
+		}
+		lines.push('')
+	}
+
+	return lines.join('\n')
+}
+
 // ---- Prompt Templates ----
 
 const BASE_PROMPT = `You are **FoundryAI**, an expert AI Dungeon Master assistant integrated directly into Foundry Virtual Tabletop. You help the DM run their game by providing guidance, generating content, and managing game information.
@@ -156,6 +242,10 @@ You have access to tools that let you interact with the Foundry VTT world. **You
 4. **Chain tool calls when needed.** For example: search_journals → get_journal → search_actors → get_actor. Use as many calls as necessary to gather complete information.
 5. **Use create_journal** when the DM asks you to write up quests, session notes, recaps, or summaries.
 6. **Use get_scene_info** when asked about the current scene, map, or tokens.
+7. **Journal folder routing — ALWAYS follow these rules when creating journals:**
+   - **Session recaps** → folder_name: "Sessions"
+   - **Notes, stored data, quest logs, reminders, or any other created content** → folder_name: "Notes"
+   - NEVER create journals in the root. Always specify the appropriate folder_name.
 
 ### When tools are NOT needed
 - General D&D rules questions (use training knowledge)

src/core/tool-system.ts

@@ -92,7 +92,7 @@ export const TOOL_DEFINITIONS: ToolDefinition[] = [
 		function: {
 			name: 'create_journal',
 			description:
-				'Create a new journal entry in a specified folder. Use this for quest tracking, session recaps, notes, etc.',
+				'Create a new journal entry in a specified folder. Session recaps MUST go in the "Sessions" folder. Notes and stored data MUST go in the "Notes" folder.',
 			parameters: {
 				type: 'object',
 				properties: {
@@ -104,9 +104,14 @@ export const TOOL_DEFINITIONS: ToolDefinition[] = [
 						type: 'string',
 						description: 'The HTML content of the journal entry. Use proper HTML formatting.',
 					},
+					folder_name: {
+						type: 'string',
+						description:
+							'The name of the journal folder to create in (e.g. "Sessions", "Notes"). The folder will be created if it does not exist.',
+					},
 					folder_id: {
 						type: 'string',
-						description: 'The folder ID to create the journal in. If omitted, creates in the root.',
+						description: 'The folder ID to create the journal in. Prefer folder_name instead.',
 					},
 				},
 				required: ['name', 'content'],
@@ -229,7 +234,7 @@ export async function executeTool(toolCall: ToolCall): Promise<string> {
 				return handleGetActor(args.actor_id)
 
 			case 'create_journal':
-				return await handleCreateJournal(args.name, args.content, args.folder_id)
+				return await handleCreateJournal(args.name, args.content, args.folder_name, args.folder_id)
 
 			case 'update_journal':
 				return await handleUpdateJournal(args.journal_id, args.content, args.page_name)
@@ -323,7 +328,31 @@ function handleGetActor(actorId: string): string {
 	})
 }
 
-async function handleCreateJournal(name: string, content: string, folderId?: string): Promise<string> {
+async function handleCreateJournal(
+	name: string,
+	content: string,
+	folderName?: string,
+	folderId?: string,
+): Promise<string> {
+	// Resolve folder: prefer folderName, fall back to folderId
+	let resolvedFolderId = folderId || null
+
+	if (folderName && !resolvedFolderId) {
+		// Find existing folder by name
+		let folder = game.folders?.find((f: any) => f.type === 'JournalEntry' && f.name === folderName)
+
+		// Create folder if it doesn't exist
+		if (!folder) {
+			folder = await Folder.create({
+				name: folderName,
+				type: 'JournalEntry',
+				parent: null,
+			} as any)
+		}
+
+		resolvedFolderId = folder?.id || null
+	}
+
 	const journalData: any = {
 		name,
 		pages: [
@@ -335,16 +364,17 @@ async function handleCreateJournal(name: string, content: string, folderId?: str
 		],
 	}
 
-	if (folderId) {
-		journalData.folder = folderId
+	if (resolvedFolderId) {
+		journalData.folder = resolvedFolderId
 	}
 
 	const journal = await JournalEntry.create(journalData)
 	return JSON.stringify({
 		success: true,
 		id: journal.id,
 		name: journal.name,
-		message: `Created journal entry "${name}"`,
+		folder: folderName || 'Root',
+		message: `Created journal entry "${name}" in folder "${folderName || 'Root'}"`,
 	})
 }
 

src/module.ts

@@ -88,21 +88,51 @@ Hooks.once('ready', async () => {
 	Hooks.on(`${MODULE_ID}.settingsChanged`, (key: string) => {
 		if (key === 'apiKey') {
 			const newKey = getSetting('apiKey')
-			if (newKey) openRouterService.configure({
-				apiKey: newKey,
-				defaultModel: getSetting('chatModel'),
-				embeddingModel: getSetting('embeddingModel'),
-			})
+			if (newKey)
+				openRouterService.configure({
+					apiKey: newKey,
+					defaultModel: getSetting('chatModel'),
+					embeddingModel: getSetting('embeddingModel'),
+				})
 		}
 	})
 
+	// Ensure standard journal folders exist
+	await ensureJournalFolders()
+
 	// Create/update the hotbar macro for easy access
 	await ensureChatMacro()
 
 	// Notification
 	ui.notifications.info('FoundryAI is ready! Use the hotbar macro or scene controls brain icon to chat.')
 })
 
+// ---- Journal Folder Setup ----
+
+/**
+ * Ensure the standard FoundryAI journal folders exist: "Sessions" and "Notes".
+ * Creates them if missing so the LLM always has valid targets.
+ */
+async function ensureJournalFolders() {
+	try {
+		const REQUIRED_FOLDERS = ['Sessions', 'Notes']
+
+		for (const folderName of REQUIRED_FOLDERS) {
+			const exists = game.folders?.find((f: any) => f.type === 'JournalEntry' && f.name === folderName)
+			if (!exists) {
+				await Folder.create({
+					name: folderName,
+					type: 'JournalEntry',
+					parent: null,
+				} as any)
+				console.log(`FoundryAI | Created journal folder: ${folderName}`)
+			}
+		}
+	} catch (err) {
+		console.error('FoundryAI | Failed to create journal folders:', err)
+	}
+}
+
 // ---- Macro Creation ----
 
 /**