Release 0.10.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.9.0",
+	"version": "0.10.0",
 	"authors": [
 		{
 			"name": "Derek Hearst",
@@ -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.9.0/foundry-ai.zip",
+	"download": "https://github.com/derekhearst/FoundryAI/releases/download/0.10.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.9.0",
+	"version": "0.10.0",
 	"description": "FoundryAI - AI-powered DM assistant for Foundry VTT",
 	"type": "module",
 	"scripts": {

src/core/chat-session-manager.ts

@@ -1,13 +1,13 @@
 /* ==========================================================================
    Chat Session Manager
-   Persists raw chat conversations as JournalEntry documents in a dedicated
-   "FoundryAI Chat History" folder.
+   Persists raw chat conversations as JournalEntry documents in the
+   FoundryAI/Chat History subfolder (or FoundryAI/Actors for roleplay).
    ========================================================================== */
 
 import type { LLMMessage } from './openrouter-service'
+import { getSubfolderId } from './folder-manager'
 
 const MODULE_ID = 'foundry-ai'
-const CHAT_HISTORY_FOLDER_NAME = 'FoundryAI Chat History'
 
 export interface ChatSession {
 	id: string // JournalEntry document ID
@@ -17,6 +17,8 @@ export interface ChatSession {
 	updatedAt: number // Epoch ms
 	model: string // Model used for this session
 	tokenCount?: number // Approximate total tokens
+	actorId?: string // If this is an actor roleplay session
+	actorName?: string // Display name of the actor
 }
 
 export interface SessionSummary {
@@ -26,6 +28,8 @@ export interface SessionSummary {
 	updatedAt: number
 	messageCount: number
 	model: string
+	actorId?: string
+	actorName?: string
 }
 
 class ChatSessionManager {
@@ -40,22 +44,31 @@ class ChatSessionManager {
 			if (folder) return folder
 		}
 
-		// Find existing folder
+		// Use the FoundryAI/Chat History subfolder
+		const subfolderId = getSubfolderId('chatHistory')
+		if (subfolderId) {
+			const folder = game.folders?.get(subfolderId)
+			if (folder) return folder
+		}
+
+		// Find existing folder (legacy fallback)
 		if (this.folderCache) {
 			const cached = game.folders?.get(this.folderCache)
 			if (cached) return cached
 		}
 
-		const existing = game.folders?.find((f: Folder) => f.name === CHAT_HISTORY_FOLDER_NAME && f.type === 'JournalEntry')
+		const existing = game.folders?.find(
+			(f: Folder) => f.name === 'Chat History' && f.type === 'JournalEntry',
+		)
 
 		if (existing) {
 			this.folderCache = existing.id
 			return existing
 		}
 
-		// Create folder
+		// Create folder as last resort
 		const folder = await Folder.create({
-			name: CHAT_HISTORY_FOLDER_NAME,
+			name: 'Chat History',
 			type: 'JournalEntry',
 			color: '#5e4fa2',
 		})
@@ -64,30 +77,39 @@ class ChatSessionManager {
 		return folder
 	}
 
+	/** Get the Actors roleplay subfolder */
+	getActorRoleplayFolder(): any | null {
+		const folderId = getSubfolderId('actors')
+		if (folderId) return game.folders?.get(folderId) || null
+		return null
+	}
+
 	/** Create a new chat session */
-	async createSession(name?: string): Promise<ChatSession> {
-		const folder = await this.getChatHistoryFolder()
+	async createSession(name?: string, actorId?: string, actorName?: string): Promise<ChatSession> {
+		// Actor roleplay sessions go in the Actors folder
+		const folder = actorId ? (this.getActorRoleplayFolder() || await this.getChatHistoryFolder()) : await this.getChatHistoryFolder()
 		const now = Date.now()
-		const sessionName = name || `Chat ${new Date(now).toLocaleString()}`
+		const sessionName = name || (actorName ? `${actorName} — ${new Date(now).toLocaleString()}` : `Chat ${new Date(now).toLocaleString()}`)
 
 		const journal = await JournalEntry.create({
 			name: sessionName,
 			folder: folder.id,
 			pages: [
 				{
-					name: 'Chat Log',
+					name: actorName ? `${actorName} Roleplay` : 'Chat Log',
 					type: 'text',
 					text: { content: '', format: 1 },
 				},
 			],
 			flags: {
 				[MODULE_ID]: {
-					type: 'chat-session',
+					type: actorId ? 'actor-roleplay' : 'chat-session',
 					messages: [],
 					createdAt: now,
 					updatedAt: now,
 					model: '',
 					tokenCount: 0,
+					...(actorId ? { actorId, actorName } : {}),
 				},
 			},
 		})
@@ -99,6 +121,8 @@ class ChatSessionManager {
 			createdAt: now,
 			updatedAt: now,
 			model: '',
+			actorId,
+			actorName,
 		}
 	}
 
@@ -178,7 +202,7 @@ class ChatSessionManager {
 		if (!entry) return null
 
 		const flags = entry.flags?.[MODULE_ID] as Record<string, any>
-		if (!flags || flags.type !== 'chat-session') return null
+		if (!flags || (flags.type !== 'chat-session' && flags.type !== 'actor-roleplay')) return null
 
 		return {
 			id: entry.id,
@@ -188,6 +212,8 @@ class ChatSessionManager {
 			updatedAt: flags.updatedAt || 0,
 			model: flags.model || '',
 			tokenCount: flags.tokenCount,
+			actorId: flags.actorId,
+			actorName: flags.actorName,
 		}
 	}
 
@@ -199,7 +225,7 @@ class ChatSessionManager {
 
 		for (const entry of game.journal.values()) {
 			const flags = entry.flags?.[MODULE_ID] as Record<string, any>
-			if (!flags || flags.type !== 'chat-session') continue
+			if (!flags || (flags.type !== 'chat-session' && flags.type !== 'actor-roleplay')) continue
 
 			sessions.push({
 				id: entry.id,
@@ -208,6 +234,8 @@ class ChatSessionManager {
 				updatedAt: flags.updatedAt || 0,
 				messageCount: (flags.messages || []).length,
 				model: flags.model || '',
+				actorId: flags.actorId,
+				actorName: flags.actorName,
 			})
 		}
 

src/core/folder-manager.ts

@@ -0,0 +1,111 @@
+/* ==========================================================================
+   Folder Manager
+   Ensures a consistent "FoundryAI" top-level journal folder structure:
+     FoundryAI/
+       ├── Notes
+       ├── Chat History
+       ├── Sessions
+       └── Actors
+   Provides ID lookups so other managers can place journals in the right spot.
+   ========================================================================== */
+
+const ROOT_FOLDER_NAME = 'FoundryAI'
+const ROOT_FOLDER_COLOR = '#5e4fa2'
+
+/** Subfolder names under the FoundryAI root */
+export const SUBFOLDER_NAMES = {
+	notes: 'Notes',
+	chatHistory: 'Chat History',
+	sessions: 'Sessions',
+	actors: 'Actors',
+} as const
+
+export type SubfolderKey = keyof typeof SUBFOLDER_NAMES
+
+/** Cache of resolved folder IDs */
+const folderIdCache: Record<string, string | null> = {}
+
+/**
+ * Bootstrap the full FoundryAI folder tree.
+ * Safe to call multiple times — only creates missing folders.
+ * Returns the root folder.
+ */
+export async function ensureFoundryAIFolders(): Promise<any> {
+	const root = await getOrCreateFolder(ROOT_FOLDER_NAME, null, ROOT_FOLDER_COLOR)
+
+	// Create subfolders under root
+	for (const key of Object.keys(SUBFOLDER_NAMES) as SubfolderKey[]) {
+		const name = SUBFOLDER_NAMES[key]
+		await getOrCreateFolder(name, root.id)
+	}
+
+	// Invalidate cache — the IDs may have just been created
+	Object.keys(folderIdCache).forEach((k) => delete folderIdCache[k])
+
+	return root
+}
+
+/**
+ * Get the Folder document for a named subfolder under FoundryAI.
+ * Returns the Folder or null if it doesn't exist yet.
+ */
+export function getSubfolder(key: SubfolderKey): any | null {
+	const name = SUBFOLDER_NAMES[key]
+	const root = game.folders?.find((f: any) => f.type === 'JournalEntry' && f.name === ROOT_FOLDER_NAME && !f.folder)
+	if (!root) return null
+	return game.folders?.find((f: any) => f.type === 'JournalEntry' && f.name === name && f.folder?.id === root.id) || null
+}
+
+/**
+ * Get the subfolder ID. Returns null if not bootstrapped yet.
+ */
+export function getSubfolderId(key: SubfolderKey): string | null {
+	// Check cache first
+	const cacheKey = `subfolder-${key}`
+	if (folderIdCache[cacheKey]) {
+		// Verify it still exists
+		const folder = game.folders?.get(folderIdCache[cacheKey]!)
+		if (folder) return folderIdCache[cacheKey]!
+		delete folderIdCache[cacheKey]
+	}
+
+	const folder = getSubfolder(key)
+	if (folder) {
+		folderIdCache[cacheKey] = folder.id
+		return folder.id
+	}
+	return null
+}
+
+/**
+ * Get the root FoundryAI folder ID. Returns null if not bootstrapped yet.
+ */
+export function getRootFolderId(): string | null {
+	const root = game.folders?.find((f: any) => f.type === 'JournalEntry' && f.name === ROOT_FOLDER_NAME && !f.folder)
+	return root?.id || null
+}
+
+// ---- Helpers ----
+
+async function getOrCreateFolder(name: string, parentId: string | null, color?: string): Promise<any> {
+	// Find existing
+	const existing = game.folders?.find((f: any) => {
+		if (f.type !== 'JournalEntry' || f.name !== name) return false
+		if (parentId) return f.folder?.id === parentId
+		return !f.folder // top-level
+	})
+
+	if (existing) return existing
+
+	// Create
+	const data: Record<string, any> = {
+		name,
+		type: 'JournalEntry',
+		parent: parentId,
+	}
+	if (color) data.color = color
+
+	const folder = await Folder.create(data)
+	console.log(`FoundryAI | Created folder: ${name}${parentId ? ' (subfolder)' : ''}`)
+	return folder
+}

src/core/session-recap-manager.ts

@@ -7,9 +7,10 @@
 import { openRouterService, type LLMMessage } from './openrouter-service'
 import { chatSessionManager } from './chat-session-manager'
 import { collectionReader } from './collection-reader'
+import { getSubfolderId } from './folder-manager'
 
 const MODULE_ID = 'foundry-ai'
-const RECAP_FOLDER_NAME = 'Session Recaps'
+const RECAP_FOLDER_NAME = 'Sessions'
 
 export interface SessionRecap {
 	id: string // JournalEntry document ID
@@ -38,13 +39,20 @@ class SessionRecapManager {
 			if (folder) return folder
 		}
 
+		// Use the FoundryAI/Sessions subfolder
+		const subfolderId = getSubfolderId('sessions')
+		if (subfolderId) {
+			const folder = game.folders?.get(subfolderId)
+			if (folder) return folder
+		}
+
 		// Check cache
 		if (this.folderCache) {
 			const cached = game.folders?.get(this.folderCache)
 			if (cached) return cached
 		}
 
-		// Find existing
+		// Find existing (legacy fallback)
 		const existing = game.folders?.find((f: Folder) => f.name === RECAP_FOLDER_NAME && f.type === 'JournalEntry')
 
 		if (existing) {