Add project-specific settings and SettingsManager factories

- SettingsManager now loads .pi/settings.json from cwd (project settings)
- Project settings merge with global settings (deep merge for objects)
- Setters only modify global settings, project settings are read-only
- Add static factories: SettingsManager.create(cwd?, agentDir?), SettingsManager.inMemory(settings?)
- Add applyOverrides() for programmatic overrides
- Replace 'settings' option with 'settingsManager' in CreateAgentSessionOptions
- Update examples to use new pattern

Incorporates PR #276 approach
This commit is contained in:
Mario Zechner 2025-12-22 12:23:02 +01:00
parent 05e1f31feb
commit 62c64a286b
8 changed files with 162 additions and 71 deletions

View file

@ -111,8 +111,8 @@ export interface CreateAgentSessionOptions {
/** Session manager. Default: SessionManager.create(cwd) */
sessionManager?: SessionManager;
/** Settings overrides (merged with agentDir/settings.json) */
settings?: Partial<Settings>;
/** Settings manager. Default: SettingsManager.create(cwd, agentDir) */
settingsManager?: SettingsManager;
}
/** Result from createAgentSession */
@ -338,10 +338,10 @@ export function buildSystemPrompt(options: BuildSystemPromptOptions = {}): strin
// Settings
/**
* Load settings from agentDir/settings.json.
* Load settings from agentDir/settings.json merged with cwd/.pi/settings.json.
*/
export function loadSettings(agentDir?: string): Settings {
const manager = new SettingsManager(agentDir ?? getDefaultAgentDir());
export function loadSettings(cwd?: string, agentDir?: string): Settings {
const manager = SettingsManager.create(cwd ?? process.cwd(), agentDir ?? getDefaultAgentDir());
return {
defaultProvider: manager.getDefaultProvider(),
defaultModel: manager.getDefaultModel(),
@ -449,8 +449,8 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
// Configure OAuth storage for this agentDir
configureOAuthStorage(agentDir);
const settingsManager = new SettingsManager(agentDir);
const sessionManager = options.sessionManager ?? SessionManager.create(cwd);
const settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);
const sessionManager = options.sessionManager ?? SessionManager.create(cwd, agentDir);
// Check if session has existing data to restore
const existingSession = sessionManager.loadSession();