@felan-ai/felan 0.15.0 → 0.15.2

package/dist/savings.d.ts

@@ -0,0 +1,87 @@
+import type { AgentRuntime, SavingsMeasurement, SavingsModelReference, SavingsReporter, SavingsReporterProvider } from '@felan-ai/agent-core';
+export type { SavingsCategory, SavingsMeasurement, SavingsModelReference, SavingsOutcome, SavingsReporter, SavingsReporterProvider, SavingsTokenUsage, } from '@felan-ai/agent-core';
+export interface SavingsPrice {
+    readonly model: SavingsModelReference;
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead: number;
+    readonly cacheWrite: number;
+    readonly tiers?: readonly SavingsPriceTier[];
+    readonly fingerprint: string;
+}
+export interface SavingsPriceTier {
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead: number;
+    readonly cacheWrite: number;
+    readonly inputTokensAbove: number;
+}
+export interface SavingsPriceSource {
+    resolveModel(model: SavingsModelReference): SavingsPrice | undefined | Promise<SavingsPrice | undefined>;
+}
+export interface SavingsServiceOptions {
+    readonly runtime: AgentRuntime;
+    readonly rootSessionId: string;
+    readonly projectKey: string;
+    readonly priceSource?: SavingsPriceSource;
+    readonly now?: () => Date;
+    readonly writerId?: string;
+}
+export type SavingsScope = 'session' | 'project' | 'all';
+export interface SavingsQuery {
+    readonly scope?: SavingsScope;
+    readonly sessionId?: string;
+    readonly projectKey?: string;
+    readonly producerId?: string;
+    readonly from?: Date;
+    readonly to?: Date;
+}
+export interface SavingsTokenTotals {
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead: number;
+    readonly cacheWrite: number;
+    readonly cacheWrite1h: number;
+}
+export interface SavingsOutcomeTotals {
+    readonly costUsd?: number;
+    readonly model?: SavingsModelReference;
+    readonly tokens?: SavingsTokenTotals;
+    readonly priceSource: 'producer-reported' | 'model-catalog' | 'unavailable';
+    readonly priceFingerprint?: string;
+}
+export interface SavingsBucket {
+    readonly day: string;
+    readonly sessionId: string;
+    readonly projectKey: string;
+    readonly producerId: string;
+    readonly category: SavingsMeasurement['category'];
+    readonly operation?: string;
+    readonly basis: SavingsMeasurement['basis'];
+    readonly tool?: string;
+    readonly techniques?: readonly string[];
+    readonly calls: number;
+    readonly baseline: SavingsOutcomeTotals;
+    readonly actual: SavingsOutcomeTotals;
+}
+export interface SavingsReport {
+    readonly scope: SavingsScope;
+    readonly bucketCount: number;
+    readonly calls: number;
+    readonly baselineCostUsd: number;
+    readonly actualCostUsd: number;
+    readonly savedCostUsd: number;
+    readonly hasUnpricedMeasurements: boolean;
+    readonly buckets: readonly SavingsBucket[];
+    readonly diagnostics: readonly string[];
+}
+export declare class SavingsService implements SavingsReporterProvider {
+    #private;
+    constructor(options: SavingsServiceOptions);
+    createReporter(producerId: string): SavingsReporter;
+    report(producerId: string, measurement: SavingsMeasurement): Promise<void>;
+    query(query?: SavingsQuery): Promise<SavingsReport>;
+}
+export declare function createModelPriceSource(resolveModel: (model: SavingsModelReference) => SavingsPrice | undefined): SavingsPriceSource;
+export declare function formatSavingsReport(report: SavingsReport, detailed?: boolean): string;
+//# sourceMappingURL=savings.d.ts.map

package/dist/savings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savings.d.ts","sourceRoot":"","sources":["../src/savings.ts"],"names":[],"mappings":"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"}

package/dist/savings.js

@@ -0,0 +1,347 @@
+import { randomUUID } from 'node:crypto';
+const ROOT = 'savings/v1';
+const WRITER_PATTERN = /^(?:savings\/v1\/)?writers\/([a-f0-9-]{36})\/(\d+)\.json$/u;
+const MAX_BUCKETS = 2_000;
+const MAX_SNAPSHOT_BYTES = 2 * 1024 * 1024;
+const MAX_GENERATIONS = 4;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+export class SavingsService {
+    #storage;
+    #options;
+    #writerId;
+    #buckets = new Map();
+    #sequence = 0;
+    #queue = Promise.resolve();
+    #persistenceErrors = 0;
+    constructor(options) {
+        this.#options = options;
+        this.#storage = options.runtime.storage('agent');
+        this.#writerId = options.writerId ?? randomUUID();
+        if (!/^[a-f0-9-]{36}$/u.test(this.#writerId))
+            throw new Error('writerId must be a UUID');
+    }
+    createReporter(producerId) {
+        if (!isProducerId(producerId))
+            throw new Error('producerId must be a bounded identifier');
+        return {
+            report: (measurement) => this.report(producerId, measurement),
+        };
+    }
+    async report(producerId, measurement) {
+        await this.#enqueue(async () => {
+            const bucket = await this.#normalize(producerId, measurement);
+            const key = bucketKey(bucket);
+            const previous = this.#buckets.get(key);
+            this.#buckets.set(key, previous ? mergeBuckets(previous, bucket) : bucket);
+            while (this.#buckets.size > MAX_BUCKETS)
+                this.#buckets.delete(this.#buckets.keys().next().value);
+            try {
+                await this.#persist();
+            }
+            catch {
+                this.#persistenceErrors += 1;
+            }
+        });
+    }
+    async query(query = {}) {
+        const snapshots = await readSnapshots(this.#storage);
+        const own = [...this.#buckets.values()];
+        const all = [
+            ...snapshots.filter(({ snapshot }) => snapshot.writerId !== this.#writerId).flatMap(({ snapshot }) => snapshot.buckets),
+            ...own,
+        ];
+        const selected = filterBuckets(all, query, this.#options.rootSessionId, this.#options.projectKey);
+        const deduped = dedupeSnapshots(selected);
+        const diagnostics = snapshots.flatMap(({ error }) => error === undefined ? [] : [error]);
+        if (this.#persistenceErrors > 0)
+            diagnostics.push(`${this.#persistenceErrors} savings writes failed`);
+        const baseline = sumCost(deduped, 'baseline');
+        const actual = sumCost(deduped, 'actual');
+        return {
+            scope: query.scope ?? (query.sessionId ? 'session' : query.projectKey ? 'project' : 'all'),
+            bucketCount: deduped.length,
+            calls: deduped.reduce((total, bucket) => total + bucket.calls, 0),
+            baselineCostUsd: baseline.value,
+            actualCostUsd: actual.value,
+            savedCostUsd: baseline.value - actual.value,
+            hasUnpricedMeasurements: baseline.unpriced || actual.unpriced,
+            buckets: deduped,
+            diagnostics,
+        };
+    }
+    async #normalize(producerId, measurement) {
+        validateMeasurement(producerId, measurement);
+        const baseline = await resolveOutcome(measurement.baseline, this.#options.priceSource);
+        const actual = await resolveOutcome(measurement.actual, this.#options.priceSource);
+        const now = (this.#options.now ?? (() => new Date()))();
+        return {
+            day: now.toISOString().slice(0, 10),
+            sessionId: this.#options.rootSessionId,
+            projectKey: this.#options.projectKey,
+            producerId,
+            category: measurement.category,
+            ...(measurement.operation === undefined ? {} : { operation: measurement.operation }),
+            basis: measurement.basis,
+            ...(measurement.dimensions?.tool === undefined ? {} : { tool: measurement.dimensions.tool }),
+            ...(measurement.dimensions?.techniques === undefined ? {} : { techniques: measurement.dimensions.techniques }),
+            calls: measurement.calls ?? 1,
+            baseline,
+            actual,
+        };
+    }
+    async #persist() {
+        const snapshot = {
+            version: 1,
+            writerId: this.#writerId,
+            sequence: ++this.#sequence,
+            updatedAt: new Date().toISOString(),
+            buckets: [...this.#buckets.values()],
+        };
+        const bytes = encoder.encode(JSON.stringify(snapshot));
+        if (bytes.byteLength > MAX_SNAPSHOT_BYTES)
+            throw new Error('Savings snapshot exceeds size limit');
+        const directory = `${ROOT}/writers/${this.#writerId}`;
+        await this.#storage.mkdir(directory, { recursive: true });
+        await this.#storage.writeFile(`${directory}/${snapshot.sequence}.json`, bytes);
+        const files = await this.#storage.listFiles(directory, { pattern: '*.json' });
+        for (const file of files.sort((a, b) => Number.parseInt(a) - Number.parseInt(b)).slice(0, -MAX_GENERATIONS)) {
+            await this.#storage.remove(`${directory}/${file}`);
+        }
+    }
+    #enqueue(operation) {
+        const previous = this.#queue;
+        const current = previous.then(operation);
+        this.#queue = current.then(() => { }, () => { });
+        return current;
+    }
+}
+export function createModelPriceSource(resolveModel) {
+    return { resolveModel };
+}
+export function formatSavingsReport(report, detailed = false) {
+    const lines = [
+        `Felan savings — ${report.scope}`,
+        `Estimated cost avoided: ${formatUsd(report.savedCostUsd)}`,
+        `Measured decisions: ${report.calls}`,
+    ];
+    if (report.hasUnpricedMeasurements)
+        lines.push('Some measurements have unavailable pricing and are excluded from the USD total.');
+    if (detailed && report.buckets.length > 0)
+        lines.push('', ...formatSavingsTable(report.buckets));
+    lines.push(...report.diagnostics.map((diagnostic) => `Warning: ${diagnostic}`));
+    return lines.join('\n');
+}
+function formatSavingsTable(buckets) {
+    const grouped = new Map();
+    for (const bucket of buckets) {
+        const key = JSON.stringify([bucket.category, bucket.producerId]);
+        const previous = grouped.get(key);
+        const savedCostUsd = cost(bucket.baseline) - cost(bucket.actual);
+        grouped.set(key, previous
+            ? { ...previous, calls: previous.calls + bucket.calls, savedCostUsd: previous.savedCostUsd + savedCostUsd }
+            : { category: bucket.category, producerId: bucket.producerId, calls: bucket.calls, savedCostUsd });
+    }
+    const categoryOrder = [
+        'output-optimization',
+        'model-routing',
+        'context-management',
+        'other',
+    ];
+    const rows = [...grouped.values()]
+        .sort((left, right) => categoryOrder.indexOf(left.category) - categoryOrder.indexOf(right.category)
+        || left.producerId.localeCompare(right.producerId))
+        .map((row) => [formatCategory(row.category), row.producerId, String(row.calls), formatUsd(row.savedCostUsd)]);
+    const headers = ['Category', 'Extension', 'Decisions', 'Savings'];
+    const widths = headers.map((header, index) => Math.max(header.length, ...rows.map((row) => row[index].length)));
+    const renderRow = (row) => row
+        .map((value, index) => index < 2 ? value.padEnd(widths[index]) : value.padStart(widths[index]))
+        .join('  ')
+        .trimEnd();
+    return [
+        renderRow(headers),
+        widths.map((width) => '-'.repeat(width)).join('  '),
+        ...rows.map(renderRow),
+    ];
+}
+function formatCategory(category) {
+    return category.split('-').map((word, index) => index === 0 ? `${word[0].toUpperCase()}${word.slice(1)}` : word).join(' ');
+}
+function validateMeasurement(producerId, measurement) {
+    if (!isProducerId(producerId) || !['output-optimization', 'model-routing', 'context-management', 'other'].includes(measurement.category))
+        throw new Error('Invalid savings category or producer');
+    if (measurement.operation !== undefined && !isSlug(measurement.operation, 64))
+        throw new Error('Invalid savings operation');
+    if (!measurement.basis || !['observed-comparison', 'estimated-baseline'].includes(measurement.basis.kind) || !isSlug(measurement.basis.method, 128))
+        throw new Error('Invalid savings basis');
+    if (measurement.calls !== undefined && (!Number.isSafeInteger(measurement.calls) || measurement.calls < 1 || measurement.calls > 10_000))
+        throw new Error('Invalid savings call count');
+    for (const outcome of [measurement.baseline, measurement.actual])
+        validateOutcome(outcome);
+    for (const value of [measurement.dimensions?.tool, ...(measurement.dimensions?.techniques ?? [])]) {
+        if (value !== undefined && !isSlug(value, 64))
+            throw new Error('Invalid savings dimension');
+    }
+    if ((measurement.dimensions?.techniques?.length ?? 0) > 16)
+        throw new Error('Too many savings techniques');
+}
+function validateOutcome(outcome) {
+    if (outcome.costUsd === undefined && outcome.tokens === undefined)
+        throw new Error('Savings outcome needs cost or tokens');
+    if (outcome.costUsd !== undefined && (!Number.isFinite(outcome.costUsd) || outcome.costUsd < 0))
+        throw new Error('Invalid savings cost');
+    if (outcome.model && (!isSlug(outcome.model.provider, 64) || !isSlug(outcome.model.id, 128)))
+        throw new Error('Invalid savings model');
+    if (outcome.tokens)
+        for (const value of Object.values(outcome.tokens))
+            if (value !== undefined && (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0))
+                throw new Error('Invalid savings tokens');
+}
+async function resolveOutcome(outcome, source) {
+    const tokens = outcome.tokens === undefined ? undefined : totals(outcome.tokens);
+    if (outcome.costUsd !== undefined)
+        return { costUsd: outcome.costUsd, ...(outcome.model ? { model: outcome.model } : {}), ...(tokens === undefined ? {} : { tokens }), priceSource: 'producer-reported' };
+    if (!source || !outcome.model || tokens === undefined)
+        return { ...(outcome.model ? { model: outcome.model } : {}), ...(tokens === undefined ? {} : { tokens }), priceSource: 'unavailable' };
+    const price = await source.resolveModel(outcome.model);
+    if (!price)
+        return { model: outcome.model, tokens, priceSource: 'unavailable' };
+    return { costUsd: calculateCost(price, tokens), model: outcome.model, tokens, priceSource: 'model-catalog', priceFingerprint: price.fingerprint };
+}
+function calculateCost(price, tokens) {
+    const inputTokens = tokens.input + tokens.cacheRead + tokens.cacheWrite;
+    let rates = price;
+    let threshold = -1;
+    for (const tier of price.tiers ?? [])
+        if (inputTokens > tier.inputTokensAbove && tier.inputTokensAbove > threshold) {
+            rates = tier;
+            threshold = tier.inputTokensAbove;
+        }
+    const shortWrite = tokens.cacheWrite - tokens.cacheWrite1h;
+    return rates.input * tokens.input / 1e6 + rates.output * tokens.output / 1e6 + rates.cacheRead * tokens.cacheRead / 1e6 + (rates.cacheWrite * shortWrite + rates.input * 2 * tokens.cacheWrite1h) / 1e6;
+}
+function totals(tokens) {
+    return { input: tokens.input, output: tokens.output, cacheRead: tokens.cacheRead ?? 0, cacheWrite: tokens.cacheWrite ?? 0, cacheWrite1h: tokens.cacheWrite1h ?? 0 };
+}
+function mergeBuckets(left, right) {
+    return { ...left, calls: left.calls + right.calls, baseline: mergeOutcome(left.baseline, right.baseline), actual: mergeOutcome(left.actual, right.actual) };
+}
+function mergeOutcome(left, right) {
+    const tokens = left.tokens && right.tokens ? Object.fromEntries(Object.keys(left.tokens).map((key) => [key, left.tokens[key] + right.tokens[key]])) : undefined;
+    return { ...(left.costUsd === undefined || right.costUsd === undefined ? {} : { costUsd: left.costUsd + right.costUsd }), ...(left.model ? { model: left.model } : {}), ...(tokens ? { tokens } : {}), priceSource: left.priceSource, ...(left.priceFingerprint ? { priceFingerprint: left.priceFingerprint } : {}) };
+}
+function bucketKey(bucket) {
+    return JSON.stringify([bucket.day, bucket.sessionId, bucket.projectKey, bucket.producerId, bucket.category, bucket.operation, bucket.basis, bucket.tool, bucket.techniques, bucket.baseline.model, bucket.baseline.priceSource, bucket.baseline.priceFingerprint, bucket.actual.model, bucket.actual.priceSource, bucket.actual.priceFingerprint]);
+}
+function filterBuckets(buckets, query, sessionId, projectKey) {
+    const scope = query.scope ?? (query.sessionId ? 'session' : query.projectKey ? 'project' : 'all');
+    return buckets.filter((bucket) => (scope !== 'session' || bucket.sessionId === (query.sessionId ?? sessionId)) && (scope !== 'project' || bucket.projectKey === (query.projectKey ?? projectKey)) && (query.producerId === undefined || bucket.producerId === query.producerId) && (query.from === undefined || bucket.day >= query.from.toISOString().slice(0, 10)) && (query.to === undefined || bucket.day <= query.to.toISOString().slice(0, 10)));
+}
+function dedupeSnapshots(buckets) {
+    const result = new Map();
+    for (const bucket of buckets)
+        result.set(bucketKey(bucket), result.has(bucketKey(bucket)) ? mergeBuckets(result.get(bucketKey(bucket)), bucket) : bucket);
+    return [...result.values()];
+}
+function sumCost(buckets, side) {
+    let value = 0;
+    let unpriced = false;
+    for (const bucket of buckets) {
+        const outcome = bucket[side];
+        if (outcome.costUsd === undefined)
+            unpriced = true;
+        else
+            value += outcome.costUsd;
+    }
+    return { value, unpriced };
+}
+function cost(outcome) { return outcome.costUsd ?? 0; }
+function formatUsd(value) { return `${value < 0 ? '-' : ''}$${Math.abs(value).toFixed(2)}`; }
+function isSlug(value, max) { return value.length > 0 && value.length <= max && /^[a-z0-9][a-z0-9._/-]*$/u.test(value); }
+function isProducerId(value) { return value.length > 0 && value.length <= 128 && /^[A-Za-z0-9@][A-Za-z0-9@._/-]*$/u.test(value); }
+async function readSnapshots(storage) {
+    let files;
+    try {
+        files = await storage.listFiles(ROOT, { recursive: true, pattern: '**/*.json', limit: 10_000 });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        return [{ snapshot: emptySnapshot(), error: `Unable to read savings storage: ${errorMessage(error)}` }];
+    }
+    const generations = new Map();
+    for (const path of files) {
+        const match = WRITER_PATTERN.exec(path.replaceAll('\\', '/'));
+        if (!match)
+            continue;
+        const entries = generations.get(match[1]) ?? [];
+        entries.push({ path, sequence: Number(match[2]) });
+        generations.set(match[1], entries);
+    }
+    const results = [];
+    for (const entries of generations.values()) {
+        entries.sort((a, b) => b.sequence - a.sequence);
+        let invalid = false;
+        for (const { path } of entries) {
+            try {
+                const storagePath = path.startsWith(`${ROOT}/`) ? path : `${ROOT}/${path}`;
+                const value = JSON.parse(decoder.decode(await storage.readFile(storagePath, { maxBytes: MAX_SNAPSHOT_BYTES })));
+                if (!isSnapshot(value))
+                    throw new Error('invalid snapshot');
+                results.push({ snapshot: value, ...(invalid ? { error: 'Latest savings snapshot was invalid; used a fallback generation' } : {}) });
+                break;
+            }
+            catch {
+                invalid = true;
+            }
+        }
+        if (invalid) {
+            const writerId = WRITER_PATTERN.exec(entries[0].path.replaceAll('\\', '/'))?.[1];
+            if (!results.some(({ snapshot }) => snapshot.writerId === writerId))
+                results.push({ snapshot: emptySnapshot(), error: 'All savings snapshot generations were invalid' });
+        }
+    }
+    return results;
+}
+function isSnapshot(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const snapshot = value;
+    return snapshot.version === 1
+        && typeof snapshot.writerId === 'string'
+        && /^[a-f0-9-]{36}$/u.test(snapshot.writerId)
+        && Number.isSafeInteger(snapshot.sequence)
+        && snapshot.sequence >= 1
+        && typeof snapshot.updatedAt === 'string'
+        && Array.isArray(snapshot.buckets)
+        && snapshot.buckets.length <= MAX_BUCKETS
+        && snapshot.buckets.every(isPersistedBucket);
+}
+function isPersistedBucket(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const bucket = value;
+    if (typeof bucket.day !== 'string' || typeof bucket.sessionId !== 'string' || typeof bucket.projectKey !== 'string')
+        return false;
+    try {
+        validateMeasurement(bucket.producerId, {
+            category: bucket.category,
+            ...(bucket.operation === undefined ? {} : { operation: bucket.operation }),
+            baseline: bucket.baseline,
+            actual: bucket.actual,
+            basis: bucket.basis,
+            calls: bucket.calls,
+            dimensions: {
+                ...(bucket.tool === undefined ? {} : { tool: bucket.tool }),
+                ...(bucket.techniques === undefined ? {} : { techniques: bucket.techniques }),
+            },
+        });
+    }
+    catch {
+        return false;
+    }
+    return isSlug(bucket.day, 10) && isSlug(bucket.sessionId, 128) && isSlug(bucket.projectKey, 128);
+}
+function emptySnapshot() { return { version: 1, writerId: randomUUID(), sequence: 0, updatedAt: new Date(0).toISOString(), buckets: [] }; }
+function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
+//# sourceMappingURL=savings.js.map

package/dist/savings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savings.js","sourceRoot":"","sources":["../src/savings.ts"],"names":[],"mappings":"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"}

package/dist/settings.d.ts

@@ -1,5 +1,4 @@
-import { SettingsManager } from '@felan-ai/agent-core';
-import type { ExtensionConfigOverride } from '@felan-ai/agent-core';
+import { SettingsManager, type ExtensionConfigDefinition, type ExtensionConfigOverride, type ExtensionConfigValue } from '@felan-ai/agent-core';
 import { type OutputStyle } from '@felan-ai/ext-output-style';
 import { type BuiltinExtensionName, type BuiltinExtensionSettings } from './extensions.js';
 import type { LocalSubagentSettings } from './subagents/host.js';
@@ -10,7 +9,12 @@ export interface FelanSettings {
     readonly felanTui?: FelanTuiSettings;
     readonly extensionConfig?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
 }
-export declare function getExtensionConfigOverrides(settings: FelanSettings): readonly ExtensionConfigOverride[];
+export interface ResolvedExtensionConfigSettings {
+    readonly overrides: readonly ExtensionConfigOverride[];
+    readonly configs: ReadonlyMap<string, Readonly<Record<string, ExtensionConfigValue>>>;
+    readonly warnings: readonly string[];
+}
+export declare function resolveExtensionConfigSettings(settings: FelanSettings, definitions: readonly ExtensionConfigDefinition[]): ResolvedExtensionConfigSettings;
 export declare function setExtensionConfigValue(agentDir: string, extensionId: string, field: string, value: unknown): Promise<void>;
 export interface FelanTuiSettings {
     readonly toolDisplay?: LocalToolDisplayMode;
@@ -19,7 +23,7 @@ export interface FelanTuiSettings {
 }
 export type LocalToolDisplayMode = 'grouped' | 'full';
 export type LocalDependencyOnboardingChoice = 'continue';
-export declare function getLocalOutputStyle(settingsManager: SettingsManager): OutputStyle;
+export declare function getLocalOutputStyle(settingsManager: SettingsManager, resolvedConfig?: Readonly<Record<string, ExtensionConfigValue>> | null): OutputStyle;
 export declare function createLocalSettingsManager(cwd: string, agentDir: string): SettingsManager;
 export declare function getFelanSettings(settingsManager: SettingsManager): FelanSettings;
 export declare function getLocalToolDisplayMode(settingsManager: SettingsManager): LocalToolDisplayMode;

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACxF;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,uBAAuB,EAAE,CAMvG;AAED,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC,CAAC;CAC3F;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,+BAA+B,GAAG,UAAU,CAAC;AAEzD,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,WAAW,CAOjF;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAmCzF;AAED,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,aAAa,CAEhF;AAED,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,eAAe,GAAG,oBAAoB,CAU9F;AAED,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CASzF;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,+BAA+B,CACnD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,+BAA+B,GAAG,SAAS,GAClD,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAEtG;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,MAAM,GACnB,+BAA+B,GAAG,SAAS,CAG7C"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/dist/settings.js

@@ -2,16 +2,51 @@ import { randomUUID } from 'node:crypto';
 import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { VERSION as PI_VERSION } from '@earendil-works/pi-coding-agent';
-import { SettingsManager } from '@felan-ai/agent-core';
+import { SettingsManager, resolveExtensionConfigs, validateExtensionConfigValue, } from '@felan-ai/agent-core';
 import { parseOutputStyle, } from '@felan-ai/ext-output-style';
 import { builtinExtensionPackages, } from './extensions.js';
 import { withLocalFileLock } from './lock.js';
-export function getExtensionConfigOverrides(settings) {
-    return Object.entries(settings.extensionConfig ?? {}).map(([extensionId, values]) => ({
-        extensionId,
-        values,
-        source: `settings.json.extensionConfig.${extensionId}`,
-    }));
+export function resolveExtensionConfigSettings(settings, definitions) {
+    const configuredExtensions = settings.extensionConfig;
+    if (configuredExtensions === undefined) {
+        return { overrides: [], configs: resolveExtensionConfigs(definitions), warnings: [] };
+    }
+    if (!isRecord(configuredExtensions)) {
+        return {
+            overrides: [],
+            configs: resolveExtensionConfigs(definitions),
+            warnings: ['settings.json.extensionConfig must be an object; using extension defaults.'],
+        };
+    }
+    const overrides = [];
+    const warnings = [];
+    for (const definition of definitions) {
+        const configured = configuredExtensions[definition.id];
+        if (configured === undefined)
+            continue;
+        const source = `settings.json.extensionConfig.${definition.id}`;
+        if (!isRecord(configured)) {
+            warnings.push(`${source} must be an object; using extension defaults.`);
+            continue;
+        }
+        const values = {};
+        for (const [field, value] of Object.entries(configured)) {
+            if (!Object.hasOwn(definition.fields, field)) {
+                warnings.push(`${source} contains unknown field: ${definition.id}.${field}; ignoring it.`);
+                continue;
+            }
+            try {
+                values[field] = validateExtensionConfigValue(definition, field, value, `${source}.${field}`);
+            }
+            catch (error) {
+                warnings.push(`${errorMessage(error)}; using the default value.`);
+            }
+        }
+        if (Object.keys(values).length > 0) {
+            overrides.push({ extensionId: definition.id, values, source });
+        }
+    }
+    return { overrides, configs: resolveExtensionConfigs(definitions, overrides), warnings };
 }
 export async function setExtensionConfigValue(agentDir, extensionId, field, value) {
     await updateGlobalFelanSettings(agentDir, (settings) => {
@@ -26,11 +61,17 @@ export async function setExtensionConfigValue(agentDir, extensionId, field, valu
         settings.extensionConfig = extensionConfig;
     });
 }
-export function getLocalOutputStyle(settingsManager) {
+export function getLocalOutputStyle(settingsManager, resolvedConfig) {
     const rawSettings = settingsManager.getGlobalSettings();
-    const extensionConfig = rawSettings.extensionConfig;
-    if (isRecord(extensionConfig) && isRecord(extensionConfig.outputStyle) && extensionConfig.outputStyle.style !== undefined) {
-        return parseOutputStyle(extensionConfig.outputStyle.style);
+    if (resolvedConfig !== undefined) {
+        if (resolvedConfig?.style !== undefined)
+            return parseOutputStyle(resolvedConfig.style);
+    }
+    else {
+        const extensionConfig = rawSettings.extensionConfig;
+        if (isRecord(extensionConfig) && isRecord(extensionConfig.outputStyle) && extensionConfig.outputStyle.style !== undefined) {
+            return parseOutputStyle(extensionConfig.outputStyle.style);
+        }
     }
     return parseOutputStyle(rawSettings.outputStyle);
 }
@@ -208,4 +249,7 @@ function isAlreadyExistsFile(error) {
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
 //# sourceMappingURL=settings.js.map