@dreb/coding-agent 2.15.2 → 2.17.0

package/dist/core/performance-tracker.d.ts

@@ -0,0 +1,54 @@
+export interface PerformanceEntry {
+    timestamp: string;
+    sessionId: string;
+    provider: string;
+    modelId: string;
+    outputTokens: number;
+    durationMs: number;
+    tps: number;
+}
+export interface RollingAverage {
+    median: number;
+    mean: number;
+    count: number;
+}
+export type PerformanceDeltaDirection = "above" | "below" | "stable";
+export interface PerformanceDelta {
+    baselineMedian: number;
+    recentMedian: number;
+    percentDelta: number;
+    direction: PerformanceDeltaDirection;
+    baselineCount: number;
+    recentCount: number;
+}
+export declare class PerformanceTracker {
+    private static readonly PRUNE_INTERVAL_MS;
+    private static readonly LOCK_TIMEOUT_MS;
+    private static readonly PRUNE_LOCK_TIMEOUT_MS;
+    private static readonly STALE_LOCK_MS;
+    private logPath;
+    private lockPath;
+    private entries;
+    private pruneTimer;
+    private disposed;
+    constructor(logPath?: string);
+    record(entry: PerformanceEntry): void;
+    getRollingAverage(provider: string, modelId: string, count?: number): RollingAverage;
+    getPerformanceDelta(provider: string, modelId: string, recentCount?: number, baselineCount?: number, stablePercent?: number): PerformanceDelta;
+    getAllRollingAverages(windowMs?: number): Array<{
+        provider: string;
+        modelId: string;
+        median: number;
+        mean: number;
+        count: number;
+    }>;
+    prune(ageMs?: number): void;
+    dispose(): void;
+    private ensureDir;
+    private schedulePrune;
+    private readEntries;
+    private withLogLock;
+    private acquireLock;
+    private removeStaleLock;
+}
+//# sourceMappingURL=performance-tracker.d.ts.map

package/dist/core/performance-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-tracker.d.ts","sourceRoot":"","sources":["../../src/core/performance-tracker.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,yBAAyB,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAuB;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAQ;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAEtD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,OAAO,CAAC,EAAE,MAAM,EAU3B;IAED,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAepC;IAED,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,cAAc,CAgBhF;IAED,mBAAmB,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,SAAK,EAChB,aAAa,SAAS,EACtB,aAAa,SAAI,GACf,gBAAgB,CAiClB;IAED,qBAAqB,CACpB,QAAQ,SAAsB,GAC5B,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAyB3F;IAED,KAAK,CAAC,KAAK,SAA2B,GAAG,IAAI,CAsC5C;IAED,OAAO,IAAI,IAAI,CAMd;IAED,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,eAAe;CAUvB","sourcesContent":["import {\n\tappendFileSync,\n\tcloseSync,\n\tmkdirSync,\n\topenSync,\n\treadFileSync,\n\trenameSync,\n\trmSync,\n\tstatSync,\n\twriteFileSync,\n} from \"fs\";\nimport { dirname, join } from \"path\";\nimport { getPerformanceLogPath } from \"../config.js\";\n\nexport interface PerformanceEntry {\n\ttimestamp: string;\n\tsessionId: string;\n\tprovider: string;\n\tmodelId: string;\n\toutputTokens: number;\n\tdurationMs: number;\n\ttps: number;\n}\n\nexport interface RollingAverage {\n\tmedian: number;\n\tmean: number;\n\tcount: number;\n}\n\nexport type PerformanceDeltaDirection = \"above\" | \"below\" | \"stable\";\n\nexport interface PerformanceDelta {\n\tbaselineMedian: number;\n\trecentMedian: number;\n\tpercentDelta: number;\n\tdirection: PerformanceDeltaDirection;\n\tbaselineCount: number;\n\trecentCount: number;\n}\n\nexport class PerformanceTracker {\n\tprivate static readonly PRUNE_INTERVAL_MS = 24 * 60 * 60 * 1000;\n\tprivate static readonly LOCK_TIMEOUT_MS = 1000;\n\tprivate static readonly PRUNE_LOCK_TIMEOUT_MS = 5000;\n\tprivate static readonly STALE_LOCK_MS = 5 * 60 * 1000;\n\n\tprivate logPath: string;\n\tprivate lockPath: string;\n\tprivate entries: PerformanceEntry[];\n\tprivate pruneTimer: ReturnType<typeof setInterval> | null = null;\n\tprivate disposed = false;\n\n\tconstructor(logPath?: string) {\n\t\tthis.logPath = logPath ?? getPerformanceLogPath();\n\t\tthis.lockPath = `${this.logPath}.lock`;\n\t\ttry {\n\t\t\tthis.entries = this.readEntries();\n\t\t} catch {\n\t\t\tthis.entries = [];\n\t\t}\n\t\tthis.ensureDir();\n\t\tthis.schedulePrune();\n\t}\n\n\trecord(entry: PerformanceEntry): void {\n\t\tif (this.disposed) return;\n\t\ttry {\n\t\t\tconst wrote = this.withLogLock(() => {\n\t\t\t\tappendFileSync(this.logPath, `${JSON.stringify(entry)}\\n`, \"utf8\");\n\t\t\t\treturn true;\n\t\t\t});\n\t\t\tif (!wrote) {\n\t\t\t\tconsole.warn(\"[PerformanceTracker] Failed to write performance entry: could not acquire log lock\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.entries.push(entry);\n\t\t} catch (error) {\n\t\t\tconsole.warn(`[PerformanceTracker] Failed to write performance entry: ${error}`);\n\t\t}\n\t}\n\n\tgetRollingAverage(provider: string, modelId: string, count = 100): RollingAverage {\n\t\tconst values = this.entries\n\t\t\t.filter((e) => e.provider === provider && e.modelId === modelId)\n\t\t\t.sort((a, b) => entryTime(b) - entryTime(a))\n\t\t\t.slice(0, count)\n\t\t\t.map((e) => e.tps);\n\n\t\tif (values.length === 0) {\n\t\t\treturn { median: 0, mean: 0, count: 0 };\n\t\t}\n\n\t\treturn {\n\t\t\tmedian: computeMedian(values),\n\t\t\tmean: computeMean(values),\n\t\t\tcount: values.length,\n\t\t};\n\t}\n\n\tgetPerformanceDelta(\n\t\tprovider: string,\n\t\tmodelId: string,\n\t\trecentCount = 10,\n\t\tbaselineCount = 10_000,\n\t\tstablePercent = 1,\n\t): PerformanceDelta {\n\t\tconst modelEntries = this.entries\n\t\t\t.filter((e) => e.provider === provider && e.modelId === modelId)\n\t\t\t.sort((a, b) => entryTime(b) - entryTime(a));\n\n\t\tconst baselineSlice = baselineCount > 0 ? baselineCount : modelEntries.length;\n\t\tconst baselineValues = modelEntries.slice(0, baselineSlice).map((e) => e.tps);\n\t\tconst recentValues = modelEntries.slice(0, recentCount).map((e) => e.tps);\n\n\t\tconst baselineMedian = computeMedian(baselineValues);\n\t\tconst recentMedian = computeMedian(recentValues);\n\t\tif (baselineValues.length < 3 || recentValues.length < 3 || baselineMedian <= 0) {\n\t\t\treturn {\n\t\t\t\tbaselineMedian,\n\t\t\t\trecentMedian,\n\t\t\t\tpercentDelta: 0,\n\t\t\t\tdirection: \"stable\",\n\t\t\t\tbaselineCount: baselineValues.length,\n\t\t\t\trecentCount: recentValues.length,\n\t\t\t};\n\t\t}\n\n\t\tconst percentDelta = ((recentMedian - baselineMedian) / baselineMedian) * 100;\n\t\tconst direction = Math.abs(percentDelta) < stablePercent ? \"stable\" : percentDelta > 0 ? \"above\" : \"below\";\n\n\t\treturn {\n\t\t\tbaselineMedian,\n\t\t\trecentMedian,\n\t\t\tpercentDelta,\n\t\t\tdirection,\n\t\t\tbaselineCount: baselineValues.length,\n\t\t\trecentCount: recentValues.length,\n\t\t};\n\t}\n\n\tgetAllRollingAverages(\n\t\twindowMs = 24 * 60 * 60 * 1000,\n\t): Array<{ provider: string; modelId: string; median: number; mean: number; count: number }> {\n\t\tconst cutoff = Date.now() - windowMs;\n\t\tconst filtered = this.entries.filter((e) => entryTime(e) >= cutoff);\n\n\t\tconst groups = new Map<string, number[]>();\n\t\tfor (const entry of filtered) {\n\t\t\tconst key = `${entry.provider}\\0${entry.modelId}`;\n\t\t\tconst arr = groups.get(key) ?? [];\n\t\t\tarr.push(entry.tps);\n\t\t\tgroups.set(key, arr);\n\t\t}\n\n\t\tconst results: Array<{ provider: string; modelId: string; median: number; mean: number; count: number }> = [];\n\t\tfor (const [key, values] of groups) {\n\t\t\tconst [provider, modelId] = key.split(\"\\0\");\n\t\t\tresults.push({\n\t\t\t\tprovider,\n\t\t\t\tmodelId,\n\t\t\t\tmedian: computeMedian(values),\n\t\t\t\tmean: computeMean(values),\n\t\t\t\tcount: values.length,\n\t\t\t});\n\t\t}\n\n\t\treturn results;\n\t}\n\n\tprune(ageMs = 30 * 24 * 60 * 60 * 1000): void {\n\t\tif (this.disposed) return;\n\t\tlet tempPath: string | undefined;\n\t\ttry {\n\t\t\tconst pruned = this.withLogLock(() => {\n\t\t\t\tconst cutoff = Date.now() - ageMs;\n\t\t\t\tconst sourceEntries = this.readEntries();\n\t\t\t\tconst kept: PerformanceEntry[] = [];\n\t\t\t\tconst lines: string[] = [];\n\n\t\t\t\tfor (const entry of sourceEntries) {\n\t\t\t\t\tif (entryTime(entry) >= cutoff) {\n\t\t\t\t\t\tkept.push(entry);\n\t\t\t\t\t\tlines.push(JSON.stringify(entry));\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\ttempPath = join(dirname(this.logPath), `.performance-prune-${process.pid}-${Date.now()}.jsonl`);\n\t\t\t\twriteFileSync(tempPath, lines.length > 0 ? `${lines.join(\"\\n\")}\\n` : \"\", \"utf8\");\n\t\t\t\trenameSync(tempPath, this.logPath);\n\t\t\t\ttempPath = undefined;\n\t\t\t\tthis.entries = kept;\n\t\t\t\treturn true;\n\t\t\t}, PerformanceTracker.PRUNE_LOCK_TIMEOUT_MS);\n\t\t\tif (!pruned) {\n\t\t\t\tconsole.warn(\"[PerformanceTracker] Failed to prune performance log: could not acquire log lock\");\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.warn(`[PerformanceTracker] Failed to prune performance log: ${error}`);\n\t\t} finally {\n\t\t\tif (tempPath) {\n\t\t\t\ttry {\n\t\t\t\t\trmSync(tempPath, { force: true });\n\t\t\t\t} catch {\n\t\t\t\t\t// Best-effort cleanup only\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tif (this.pruneTimer) {\n\t\t\tclearInterval(this.pruneTimer);\n\t\t\tthis.pruneTimer = null;\n\t\t}\n\t}\n\n\tprivate ensureDir(): void {\n\t\ttry {\n\t\t\tmkdirSync(dirname(this.logPath), { recursive: true });\n\t\t} catch (error) {\n\t\t\tif (isFileExistsError(error)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.warn(`[PerformanceTracker] Failed to create log directory: ${error}`);\n\t\t}\n\t}\n\n\tprivate schedulePrune(): void {\n\t\tif (this.disposed) return;\n\t\tthis.pruneTimer = setInterval(() => {\n\t\t\tthis.prune();\n\t\t}, PerformanceTracker.PRUNE_INTERVAL_MS);\n\t\tthis.pruneTimer?.unref?.();\n\t}\n\n\tprivate readEntries(): PerformanceEntry[] {\n\t\ttry {\n\t\t\tconst content = readFileSync(this.logPath, \"utf8\");\n\t\t\tconst entries: PerformanceEntry[] = [];\n\t\t\tfor (const line of content.split(\"\\n\")) {\n\t\t\t\tif (!line.trim()) continue;\n\t\t\t\ttry {\n\t\t\t\t\tconst parsed = JSON.parse(line) as unknown;\n\t\t\t\t\tif (!isValidPerformanceEntry(parsed)) {\n\t\t\t\t\t\tconsole.warn(`[PerformanceTracker] Skipping invalid performance entry line: ${line}`);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst time = entryTime(parsed);\n\t\t\t\t\tif (!Number.isFinite(time)) {\n\t\t\t\t\t\tconsole.warn(`[PerformanceTracker] Skipping entry with invalid timestamp: ${line}`);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tentries.push(parsed);\n\t\t\t\t} catch {\n\t\t\t\t\t// Skip malformed lines\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn entries;\n\t\t} catch (error) {\n\t\t\tif (isENOENT(error)) {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprivate withLogLock<T>(operation: () => T, timeoutMs = PerformanceTracker.LOCK_TIMEOUT_MS): T | undefined {\n\t\tconst fd = this.acquireLock(timeoutMs);\n\t\tif (fd === undefined) return undefined;\n\t\ttry {\n\t\t\treturn operation();\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tcloseSync(fd);\n\t\t\t} finally {\n\t\t\t\trmSync(this.lockPath, { force: true });\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate acquireLock(timeoutMs: number): number | undefined {\n\t\tconst start = performance.now();\n\t\twhile (performance.now() - start <= timeoutMs) {\n\t\t\ttry {\n\t\t\t\treturn openSync(this.lockPath, \"wx\");\n\t\t\t} catch (error) {\n\t\t\t\tif (!isFileExistsError(error)) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tthis.removeStaleLock();\n\t\t\t\tsleepSync(10);\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate removeStaleLock(): void {\n\t\ttry {\n\t\t\tconst lockAgeMs = Date.now() - statSync(this.lockPath).mtimeMs;\n\t\t\tif (lockAgeMs > PerformanceTracker.STALE_LOCK_MS) {\n\t\t\t\trmSync(this.lockPath, { force: true });\n\t\t\t}\n\t\t} catch {\n\t\t\t// Lock disappeared between open attempts\n\t\t}\n\t}\n}\n\nfunction entryTime(entry: PerformanceEntry): number {\n\tconst time = new Date(entry.timestamp).getTime();\n\treturn Number.isFinite(time) ? time : NaN;\n}\n\nfunction computeMedian(values: number[]): number {\n\tif (values.length === 0) return 0;\n\tconst sorted = [...values].sort((a, b) => a - b);\n\tconst mid = Math.floor(sorted.length / 2);\n\tif (sorted.length % 2 === 1) {\n\t\treturn sorted[mid];\n\t}\n\treturn (sorted[mid - 1] + sorted[mid]) / 2;\n}\n\nfunction computeMean(values: number[]): number {\n\tif (values.length === 0) return 0;\n\treturn values.reduce((a, b) => a + b, 0) / values.length;\n}\n\nfunction isFileExistsError(error: unknown): boolean {\n\treturn typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"EEXIST\";\n}\n\nfunction isENOENT(error: unknown): boolean {\n\treturn typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"ENOENT\";\n}\n\nfunction isValidPerformanceEntry(entry: unknown): entry is PerformanceEntry {\n\tif (typeof entry !== \"object\" || entry === null) return false;\n\tconst e = entry as Record<string, unknown>;\n\treturn (\n\t\ttypeof e.timestamp === \"string\" &&\n\t\ttypeof e.provider === \"string\" &&\n\t\ttypeof e.modelId === \"string\" &&\n\t\ttypeof e.outputTokens === \"number\" &&\n\t\tNumber.isFinite(e.outputTokens) &&\n\t\ttypeof e.durationMs === \"number\" &&\n\t\tNumber.isFinite(e.durationMs) &&\n\t\ttypeof e.tps === \"number\" &&\n\t\tNumber.isFinite(e.tps)\n\t);\n}\n\nfunction sleepSync(ms: number): void {\n\tAtomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);\n}\n"]}

package/dist/core/performance-tracker.js

@@ -0,0 +1,298 @@
+import { appendFileSync, closeSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "fs";
+import { dirname, join } from "path";
+import { getPerformanceLogPath } from "../config.js";
+export class PerformanceTracker {
+    static PRUNE_INTERVAL_MS = 24 * 60 * 60 * 1000;
+    static LOCK_TIMEOUT_MS = 1000;
+    static PRUNE_LOCK_TIMEOUT_MS = 5000;
+    static STALE_LOCK_MS = 5 * 60 * 1000;
+    logPath;
+    lockPath;
+    entries;
+    pruneTimer = null;
+    disposed = false;
+    constructor(logPath) {
+        this.logPath = logPath ?? getPerformanceLogPath();
+        this.lockPath = `${this.logPath}.lock`;
+        try {
+            this.entries = this.readEntries();
+        }
+        catch {
+            this.entries = [];
+        }
+        this.ensureDir();
+        this.schedulePrune();
+    }
+    record(entry) {
+        if (this.disposed)
+            return;
+        try {
+            const wrote = this.withLogLock(() => {
+                appendFileSync(this.logPath, `${JSON.stringify(entry)}\n`, "utf8");
+                return true;
+            });
+            if (!wrote) {
+                console.warn("[PerformanceTracker] Failed to write performance entry: could not acquire log lock");
+                return;
+            }
+            this.entries.push(entry);
+        }
+        catch (error) {
+            console.warn(`[PerformanceTracker] Failed to write performance entry: ${error}`);
+        }
+    }
+    getRollingAverage(provider, modelId, count = 100) {
+        const values = this.entries
+            .filter((e) => e.provider === provider && e.modelId === modelId)
+            .sort((a, b) => entryTime(b) - entryTime(a))
+            .slice(0, count)
+            .map((e) => e.tps);
+        if (values.length === 0) {
+            return { median: 0, mean: 0, count: 0 };
+        }
+        return {
+            median: computeMedian(values),
+            mean: computeMean(values),
+            count: values.length,
+        };
+    }
+    getPerformanceDelta(provider, modelId, recentCount = 10, baselineCount = 10_000, stablePercent = 1) {
+        const modelEntries = this.entries
+            .filter((e) => e.provider === provider && e.modelId === modelId)
+            .sort((a, b) => entryTime(b) - entryTime(a));
+        const baselineSlice = baselineCount > 0 ? baselineCount : modelEntries.length;
+        const baselineValues = modelEntries.slice(0, baselineSlice).map((e) => e.tps);
+        const recentValues = modelEntries.slice(0, recentCount).map((e) => e.tps);
+        const baselineMedian = computeMedian(baselineValues);
+        const recentMedian = computeMedian(recentValues);
+        if (baselineValues.length < 3 || recentValues.length < 3 || baselineMedian <= 0) {
+            return {
+                baselineMedian,
+                recentMedian,
+                percentDelta: 0,
+                direction: "stable",
+                baselineCount: baselineValues.length,
+                recentCount: recentValues.length,
+            };
+        }
+        const percentDelta = ((recentMedian - baselineMedian) / baselineMedian) * 100;
+        const direction = Math.abs(percentDelta) < stablePercent ? "stable" : percentDelta > 0 ? "above" : "below";
+        return {
+            baselineMedian,
+            recentMedian,
+            percentDelta,
+            direction,
+            baselineCount: baselineValues.length,
+            recentCount: recentValues.length,
+        };
+    }
+    getAllRollingAverages(windowMs = 24 * 60 * 60 * 1000) {
+        const cutoff = Date.now() - windowMs;
+        const filtered = this.entries.filter((e) => entryTime(e) >= cutoff);
+        const groups = new Map();
+        for (const entry of filtered) {
+            const key = `${entry.provider}\0${entry.modelId}`;
+            const arr = groups.get(key) ?? [];
+            arr.push(entry.tps);
+            groups.set(key, arr);
+        }
+        const results = [];
+        for (const [key, values] of groups) {
+            const [provider, modelId] = key.split("\0");
+            results.push({
+                provider,
+                modelId,
+                median: computeMedian(values),
+                mean: computeMean(values),
+                count: values.length,
+            });
+        }
+        return results;
+    }
+    prune(ageMs = 30 * 24 * 60 * 60 * 1000) {
+        if (this.disposed)
+            return;
+        let tempPath;
+        try {
+            const pruned = this.withLogLock(() => {
+                const cutoff = Date.now() - ageMs;
+                const sourceEntries = this.readEntries();
+                const kept = [];
+                const lines = [];
+                for (const entry of sourceEntries) {
+                    if (entryTime(entry) >= cutoff) {
+                        kept.push(entry);
+                        lines.push(JSON.stringify(entry));
+                    }
+                }
+                tempPath = join(dirname(this.logPath), `.performance-prune-${process.pid}-${Date.now()}.jsonl`);
+                writeFileSync(tempPath, lines.length > 0 ? `${lines.join("\n")}\n` : "", "utf8");
+                renameSync(tempPath, this.logPath);
+                tempPath = undefined;
+                this.entries = kept;
+                return true;
+            }, PerformanceTracker.PRUNE_LOCK_TIMEOUT_MS);
+            if (!pruned) {
+                console.warn("[PerformanceTracker] Failed to prune performance log: could not acquire log lock");
+            }
+        }
+        catch (error) {
+            console.warn(`[PerformanceTracker] Failed to prune performance log: ${error}`);
+        }
+        finally {
+            if (tempPath) {
+                try {
+                    rmSync(tempPath, { force: true });
+                }
+                catch {
+                    // Best-effort cleanup only
+                }
+            }
+        }
+    }
+    dispose() {
+        this.disposed = true;
+        if (this.pruneTimer) {
+            clearInterval(this.pruneTimer);
+            this.pruneTimer = null;
+        }
+    }
+    ensureDir() {
+        try {
+            mkdirSync(dirname(this.logPath), { recursive: true });
+        }
+        catch (error) {
+            if (isFileExistsError(error)) {
+                return;
+            }
+            console.warn(`[PerformanceTracker] Failed to create log directory: ${error}`);
+        }
+    }
+    schedulePrune() {
+        if (this.disposed)
+            return;
+        this.pruneTimer = setInterval(() => {
+            this.prune();
+        }, PerformanceTracker.PRUNE_INTERVAL_MS);
+        this.pruneTimer?.unref?.();
+    }
+    readEntries() {
+        try {
+            const content = readFileSync(this.logPath, "utf8");
+            const entries = [];
+            for (const line of content.split("\n")) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const parsed = JSON.parse(line);
+                    if (!isValidPerformanceEntry(parsed)) {
+                        console.warn(`[PerformanceTracker] Skipping invalid performance entry line: ${line}`);
+                        continue;
+                    }
+                    const time = entryTime(parsed);
+                    if (!Number.isFinite(time)) {
+                        console.warn(`[PerformanceTracker] Skipping entry with invalid timestamp: ${line}`);
+                        continue;
+                    }
+                    entries.push(parsed);
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+            return entries;
+        }
+        catch (error) {
+            if (isENOENT(error)) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    withLogLock(operation, timeoutMs = PerformanceTracker.LOCK_TIMEOUT_MS) {
+        const fd = this.acquireLock(timeoutMs);
+        if (fd === undefined)
+            return undefined;
+        try {
+            return operation();
+        }
+        finally {
+            try {
+                closeSync(fd);
+            }
+            finally {
+                rmSync(this.lockPath, { force: true });
+            }
+        }
+    }
+    acquireLock(timeoutMs) {
+        const start = performance.now();
+        while (performance.now() - start <= timeoutMs) {
+            try {
+                return openSync(this.lockPath, "wx");
+            }
+            catch (error) {
+                if (!isFileExistsError(error)) {
+                    throw error;
+                }
+                this.removeStaleLock();
+                sleepSync(10);
+            }
+        }
+        return undefined;
+    }
+    removeStaleLock() {
+        try {
+            const lockAgeMs = Date.now() - statSync(this.lockPath).mtimeMs;
+            if (lockAgeMs > PerformanceTracker.STALE_LOCK_MS) {
+                rmSync(this.lockPath, { force: true });
+            }
+        }
+        catch {
+            // Lock disappeared between open attempts
+        }
+    }
+}
+function entryTime(entry) {
+    const time = new Date(entry.timestamp).getTime();
+    return Number.isFinite(time) ? time : NaN;
+}
+function computeMedian(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1) {
+        return sorted[mid];
+    }
+    return (sorted[mid - 1] + sorted[mid]) / 2;
+}
+function computeMean(values) {
+    if (values.length === 0)
+        return 0;
+    return values.reduce((a, b) => a + b, 0) / values.length;
+}
+function isFileExistsError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
+}
+function isENOENT(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function isValidPerformanceEntry(entry) {
+    if (typeof entry !== "object" || entry === null)
+        return false;
+    const e = entry;
+    return (typeof e.timestamp === "string" &&
+        typeof e.provider === "string" &&
+        typeof e.modelId === "string" &&
+        typeof e.outputTokens === "number" &&
+        Number.isFinite(e.outputTokens) &&
+        typeof e.durationMs === "number" &&
+        Number.isFinite(e.durationMs) &&
+        typeof e.tps === "number" &&
+        Number.isFinite(e.tps));
+}
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+//# sourceMappingURL=performance-tracker.js.map

package/dist/core/performance-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-tracker.js","sourceRoot":"","sources":["../../src/core/performance-tracker.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tappendFileSync,\n\tcloseSync,\n\tmkdirSync,\n\topenSync,\n\treadFileSync,\n\trenameSync,\n\trmSync,\n\tstatSync,\n\twriteFileSync,\n} from \"fs\";\nimport { dirname, join } from \"path\";\nimport { getPerformanceLogPath } from \"../config.js\";\n\nexport interface PerformanceEntry {\n\ttimestamp: string;\n\tsessionId: string;\n\tprovider: string;\n\tmodelId: string;\n\toutputTokens: number;\n\tdurationMs: number;\n\ttps: number;\n}\n\nexport interface RollingAverage {\n\tmedian: number;\n\tmean: number;\n\tcount: number;\n}\n\nexport type PerformanceDeltaDirection = \"above\" | \"below\" | \"stable\";\n\nexport interface PerformanceDelta {\n\tbaselineMedian: number;\n\trecentMedian: number;\n\tpercentDelta: number;\n\tdirection: PerformanceDeltaDirection;\n\tbaselineCount: number;\n\trecentCount: number;\n}\n\nexport class PerformanceTracker {\n\tprivate static readonly PRUNE_INTERVAL_MS = 24 * 60 * 60 * 1000;\n\tprivate static readonly LOCK_TIMEOUT_MS = 1000;\n\tprivate static readonly PRUNE_LOCK_TIMEOUT_MS = 5000;\n\tprivate static readonly STALE_LOCK_MS = 5 * 60 * 1000;\n\n\tprivate logPath: string;\n\tprivate lockPath: string;\n\tprivate entries: PerformanceEntry[];\n\tprivate pruneTimer: ReturnType<typeof setInterval> | null = null;\n\tprivate disposed = false;\n\n\tconstructor(logPath?: string) {\n\t\tthis.logPath = logPath ?? getPerformanceLogPath();\n\t\tthis.lockPath = `${this.logPath}.lock`;\n\t\ttry {\n\t\t\tthis.entries = this.readEntries();\n\t\t} catch {\n\t\t\tthis.entries = [];\n\t\t}\n\t\tthis.ensureDir();\n\t\tthis.schedulePrune();\n\t}\n\n\trecord(entry: PerformanceEntry): void {\n\t\tif (this.disposed) return;\n\t\ttry {\n\t\t\tconst wrote = this.withLogLock(() => {\n\t\t\t\tappendFileSync(this.logPath, `${JSON.stringify(entry)}\\n`, \"utf8\");\n\t\t\t\treturn true;\n\t\t\t});\n\t\t\tif (!wrote) {\n\t\t\t\tconsole.warn(\"[PerformanceTracker] Failed to write performance entry: could not acquire log lock\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.entries.push(entry);\n\t\t} catch (error) {\n\t\t\tconsole.warn(`[PerformanceTracker] Failed to write performance entry: ${error}`);\n\t\t}\n\t}\n\n\tgetRollingAverage(provider: string, modelId: string, count = 100): RollingAverage {\n\t\tconst values = this.entries\n\t\t\t.filter((e) => e.provider === provider && e.modelId === modelId)\n\t\t\t.sort((a, b) => entryTime(b) - entryTime(a))\n\t\t\t.slice(0, count)\n\t\t\t.map((e) => e.tps);\n\n\t\tif (values.length === 0) {\n\t\t\treturn { median: 0, mean: 0, count: 0 };\n\t\t}\n\n\t\treturn {\n\t\t\tmedian: computeMedian(values),\n\t\t\tmean: computeMean(values),\n\t\t\tcount: values.length,\n\t\t};\n\t}\n\n\tgetPerformanceDelta(\n\t\tprovider: string,\n\t\tmodelId: string,\n\t\trecentCount = 10,\n\t\tbaselineCount = 10_000,\n\t\tstablePercent = 1,\n\t): PerformanceDelta {\n\t\tconst modelEntries = this.entries\n\t\t\t.filter((e) => e.provider === provider && e.modelId === modelId)\n\t\t\t.sort((a, b) => entryTime(b) - entryTime(a));\n\n\t\tconst baselineSlice = baselineCount > 0 ? baselineCount : modelEntries.length;\n\t\tconst baselineValues = modelEntries.slice(0, baselineSlice).map((e) => e.tps);\n\t\tconst recentValues = modelEntries.slice(0, recentCount).map((e) => e.tps);\n\n\t\tconst baselineMedian = computeMedian(baselineValues);\n\t\tconst recentMedian = computeMedian(recentValues);\n\t\tif (baselineValues.length < 3 || recentValues.length < 3 || baselineMedian <= 0) {\n\t\t\treturn {\n\t\t\t\tbaselineMedian,\n\t\t\t\trecentMedian,\n\t\t\t\tpercentDelta: 0,\n\t\t\t\tdirection: \"stable\",\n\t\t\t\tbaselineCount: baselineValues.length,\n\t\t\t\trecentCount: recentValues.length,\n\t\t\t};\n\t\t}\n\n\t\tconst percentDelta = ((recentMedian - baselineMedian) / baselineMedian) * 100;\n\t\tconst direction = Math.abs(percentDelta) < stablePercent ? \"stable\" : percentDelta > 0 ? \"above\" : \"below\";\n\n\t\treturn {\n\t\t\tbaselineMedian,\n\t\t\trecentMedian,\n\t\t\tpercentDelta,\n\t\t\tdirection,\n\t\t\tbaselineCount: baselineValues.length,\n\t\t\trecentCount: recentValues.length,\n\t\t};\n\t}\n\n\tgetAllRollingAverages(\n\t\twindowMs = 24 * 60 * 60 * 1000,\n\t): Array<{ provider: string; modelId: string; median: number; mean: number; count: number }> {\n\t\tconst cutoff = Date.now() - windowMs;\n\t\tconst filtered = this.entries.filter((e) => entryTime(e) >= cutoff);\n\n\t\tconst groups = new Map<string, number[]>();\n\t\tfor (const entry of filtered) {\n\t\t\tconst key = `${entry.provider}\\0${entry.modelId}`;\n\t\t\tconst arr = groups.get(key) ?? [];\n\t\t\tarr.push(entry.tps);\n\t\t\tgroups.set(key, arr);\n\t\t}\n\n\t\tconst results: Array<{ provider: string; modelId: string; median: number; mean: number; count: number }> = [];\n\t\tfor (const [key, values] of groups) {\n\t\t\tconst [provider, modelId] = key.split(\"\\0\");\n\t\t\tresults.push({\n\t\t\t\tprovider,\n\t\t\t\tmodelId,\n\t\t\t\tmedian: computeMedian(values),\n\t\t\t\tmean: computeMean(values),\n\t\t\t\tcount: values.length,\n\t\t\t});\n\t\t}\n\n\t\treturn results;\n\t}\n\n\tprune(ageMs = 30 * 24 * 60 * 60 * 1000): void {\n\t\tif (this.disposed) return;\n\t\tlet tempPath: string | undefined;\n\t\ttry {\n\t\t\tconst pruned = this.withLogLock(() => {\n\t\t\t\tconst cutoff = Date.now() - ageMs;\n\t\t\t\tconst sourceEntries = this.readEntries();\n\t\t\t\tconst kept: PerformanceEntry[] = [];\n\t\t\t\tconst lines: string[] = [];\n\n\t\t\t\tfor (const entry of sourceEntries) {\n\t\t\t\t\tif (entryTime(entry) >= cutoff) {\n\t\t\t\t\t\tkept.push(entry);\n\t\t\t\t\t\tlines.push(JSON.stringify(entry));\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\ttempPath = join(dirname(this.logPath), `.performance-prune-${process.pid}-${Date.now()}.jsonl`);\n\t\t\t\twriteFileSync(tempPath, lines.length > 0 ? `${lines.join(\"\\n\")}\\n` : \"\", \"utf8\");\n\t\t\t\trenameSync(tempPath, this.logPath);\n\t\t\t\ttempPath = undefined;\n\t\t\t\tthis.entries = kept;\n\t\t\t\treturn true;\n\t\t\t}, PerformanceTracker.PRUNE_LOCK_TIMEOUT_MS);\n\t\t\tif (!pruned) {\n\t\t\t\tconsole.warn(\"[PerformanceTracker] Failed to prune performance log: could not acquire log lock\");\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.warn(`[PerformanceTracker] Failed to prune performance log: ${error}`);\n\t\t} finally {\n\t\t\tif (tempPath) {\n\t\t\t\ttry {\n\t\t\t\t\trmSync(tempPath, { force: true });\n\t\t\t\t} catch {\n\t\t\t\t\t// Best-effort cleanup only\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tif (this.pruneTimer) {\n\t\t\tclearInterval(this.pruneTimer);\n\t\t\tthis.pruneTimer = null;\n\t\t}\n\t}\n\n\tprivate ensureDir(): void {\n\t\ttry {\n\t\t\tmkdirSync(dirname(this.logPath), { recursive: true });\n\t\t} catch (error) {\n\t\t\tif (isFileExistsError(error)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.warn(`[PerformanceTracker] Failed to create log directory: ${error}`);\n\t\t}\n\t}\n\n\tprivate schedulePrune(): void {\n\t\tif (this.disposed) return;\n\t\tthis.pruneTimer = setInterval(() => {\n\t\t\tthis.prune();\n\t\t}, PerformanceTracker.PRUNE_INTERVAL_MS);\n\t\tthis.pruneTimer?.unref?.();\n\t}\n\n\tprivate readEntries(): PerformanceEntry[] {\n\t\ttry {\n\t\t\tconst content = readFileSync(this.logPath, \"utf8\");\n\t\t\tconst entries: PerformanceEntry[] = [];\n\t\t\tfor (const line of content.split(\"\\n\")) {\n\t\t\t\tif (!line.trim()) continue;\n\t\t\t\ttry {\n\t\t\t\t\tconst parsed = JSON.parse(line) as unknown;\n\t\t\t\t\tif (!isValidPerformanceEntry(parsed)) {\n\t\t\t\t\t\tconsole.warn(`[PerformanceTracker] Skipping invalid performance entry line: ${line}`);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst time = entryTime(parsed);\n\t\t\t\t\tif (!Number.isFinite(time)) {\n\t\t\t\t\t\tconsole.warn(`[PerformanceTracker] Skipping entry with invalid timestamp: ${line}`);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tentries.push(parsed);\n\t\t\t\t} catch {\n\t\t\t\t\t// Skip malformed lines\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn entries;\n\t\t} catch (error) {\n\t\t\tif (isENOENT(error)) {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprivate withLogLock<T>(operation: () => T, timeoutMs = PerformanceTracker.LOCK_TIMEOUT_MS): T | undefined {\n\t\tconst fd = this.acquireLock(timeoutMs);\n\t\tif (fd === undefined) return undefined;\n\t\ttry {\n\t\t\treturn operation();\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tcloseSync(fd);\n\t\t\t} finally {\n\t\t\t\trmSync(this.lockPath, { force: true });\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate acquireLock(timeoutMs: number): number | undefined {\n\t\tconst start = performance.now();\n\t\twhile (performance.now() - start <= timeoutMs) {\n\t\t\ttry {\n\t\t\t\treturn openSync(this.lockPath, \"wx\");\n\t\t\t} catch (error) {\n\t\t\t\tif (!isFileExistsError(error)) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tthis.removeStaleLock();\n\t\t\t\tsleepSync(10);\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate removeStaleLock(): void {\n\t\ttry {\n\t\t\tconst lockAgeMs = Date.now() - statSync(this.lockPath).mtimeMs;\n\t\t\tif (lockAgeMs > PerformanceTracker.STALE_LOCK_MS) {\n\t\t\t\trmSync(this.lockPath, { force: true });\n\t\t\t}\n\t\t} catch {\n\t\t\t// Lock disappeared between open attempts\n\t\t}\n\t}\n}\n\nfunction entryTime(entry: PerformanceEntry): number {\n\tconst time = new Date(entry.timestamp).getTime();\n\treturn Number.isFinite(time) ? time : NaN;\n}\n\nfunction computeMedian(values: number[]): number {\n\tif (values.length === 0) return 0;\n\tconst sorted = [...values].sort((a, b) => a - b);\n\tconst mid = Math.floor(sorted.length / 2);\n\tif (sorted.length % 2 === 1) {\n\t\treturn sorted[mid];\n\t}\n\treturn (sorted[mid - 1] + sorted[mid]) / 2;\n}\n\nfunction computeMean(values: number[]): number {\n\tif (values.length === 0) return 0;\n\treturn values.reduce((a, b) => a + b, 0) / values.length;\n}\n\nfunction isFileExistsError(error: unknown): boolean {\n\treturn typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"EEXIST\";\n}\n\nfunction isENOENT(error: unknown): boolean {\n\treturn typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"ENOENT\";\n}\n\nfunction isValidPerformanceEntry(entry: unknown): entry is PerformanceEntry {\n\tif (typeof entry !== \"object\" || entry === null) return false;\n\tconst e = entry as Record<string, unknown>;\n\treturn (\n\t\ttypeof e.timestamp === \"string\" &&\n\t\ttypeof e.provider === \"string\" &&\n\t\ttypeof e.modelId === \"string\" &&\n\t\ttypeof e.outputTokens === \"number\" &&\n\t\tNumber.isFinite(e.outputTokens) &&\n\t\ttypeof e.durationMs === \"number\" &&\n\t\tNumber.isFinite(e.durationMs) &&\n\t\ttypeof e.tps === \"number\" &&\n\t\tNumber.isFinite(e.tps)\n\t);\n}\n\nfunction sleepSync(ms: number): void {\n\tAtomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);\n}\n"]}

package/dist/core/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { Agent, type AgentMessage, type ThinkingLevel } from \"@dreb/agent-core\";\nimport type { Message, Model } from \"@dreb/ai\";\nimport { getAgentDir, getDocsPath } from \"../config.js\";\nimport { AgentSession } from \"./agent-session.js\";\nimport { AuthStorage } from \"./auth-storage.js\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.js\";\nimport type { ExtensionRunner, LoadExtensionsResult, ToolDefinition } from \"./extensions/index.js\";\nimport { convertToLlm } from \"./messages.js\";\nimport { ModelRegistry } from \"./model-registry.js\";\nimport { findInitialModel } from \"./model-resolver.js\";\nimport { configValueWarnings } from \"./resolve-config-value.js\";\nimport type { ResourceLoader } from \"./resource-loader.js\";\nimport { DefaultResourceLoader } from \"./resource-loader.js\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.js\";\nimport { SettingsManager } from \"./settings-manager.js\";\nimport { time } from \"./timings.js\";\nimport {\n\tallTools,\n\tbashTool,\n\tcodingTools,\n\tcreateBashTool,\n\tcreateCodingTools,\n\tcreateEditTool,\n\tcreateFindTool,\n\tcreateGrepTool,\n\tcreateLsTool,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateSubagentTool,\n\tcreateWriteTool,\n\teditTool,\n\tfindTool,\n\tgetBackgroundAgents,\n\tgetRunningBackgroundAgents,\n\tgrepTool,\n\tlsTool,\n\tpruneBackgroundAgents,\n\treadOnlyTools,\n\treadTool,\n\tsubagentTool,\n\ttype Tool,\n\ttype ToolName,\n\twithFileMutationQueue,\n\twriteTool,\n} from \"./tools/index.js\";\n\nexport interface CreateAgentSessionOptions {\n\t/** Working directory for project-local discovery. Default: process.cwd() */\n\tcwd?: string;\n\t/** Global config directory. Default: ~/.dreb/agent */\n\tagentDir?: string;\n\n\t/** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */\n\tauthStorage?: AuthStorage;\n\t/** Model registry. Default: new ModelRegistry(authStorage, agentDir/models.json) */\n\tmodelRegistry?: ModelRegistry;\n\n\t/** Model to use. Default: from settings, else first available */\n\tmodel?: Model<any>;\n\t/** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Models available for cycling (Ctrl+P in interactive mode) */\n\tscopedModels?: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\n\t/** Built-in tools to use. Default: all standard tools [read, bash, edit, write, grep, find, ls, web_search, web_fetch, subagent]. `skill`, `tasks_update`, and `search` are always active regardless of this setting. */\n\ttools?: Tool[];\n\t/** Custom tools to register (in addition to built-in tools). */\n\tcustomTools?: ToolDefinition[];\n\n\t/** Resource loader. When omitted, DefaultResourceLoader is used. */\n\tresourceLoader?: ResourceLoader;\n\n\t/** Session manager. Default: SessionManager.create(cwd) */\n\tsessionManager?: SessionManager;\n\n\t/** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n\tsettingsManager?: SettingsManager;\n\t/** UI type for system prompt context (e.g. \"tui\", \"telegram\", \"rpc\") */\n\tuiType?: string;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n\t/** The created session */\n\tsession: AgentSession;\n\t/** Extensions result (for UI context setup in interactive mode) */\n\textensionsResult: LoadExtensionsResult;\n\t/** Warning if session was restored with a different model than saved */\n\tmodelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport type {\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionContext,\n\tExtensionFactory,\n\tSlashCommandInfo,\n\tSlashCommandSource,\n\tToolDefinition,\n} from \"./extensions/index.js\";\nexport type { PromptTemplate } from \"./prompt-templates.js\";\nexport type { Skill } from \"./skills.js\";\nexport type { Tool } from \"./tools/index.js\";\n\nexport {\n\t// Pre-built tools (use process.cwd())\n\treadTool,\n\tbashTool,\n\teditTool,\n\twriteTool,\n\tgrepTool,\n\tfindTool,\n\tlsTool,\n\tsubagentTool,\n\tcodingTools,\n\treadOnlyTools,\n\tallTools as allBuiltInTools,\n\twithFileMutationQueue,\n\t// Tool factories (for custom cwd)\n\tcreateCodingTools,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateBashTool,\n\tcreateEditTool,\n\tcreateWriteTool,\n\tcreateGrepTool,\n\tcreateFindTool,\n\tcreateLsTool,\n\tcreateSubagentTool,\n\t// Background agent registry\n\tgetBackgroundAgents,\n\tgetRunningBackgroundAgents,\n\tpruneBackgroundAgents,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n\treturn getAgentDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@dreb/ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [readTool, bashTool],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(options: CreateAgentSessionOptions = {}): Promise<CreateAgentSessionResult> {\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst agentDir = options.agentDir ?? getDefaultAgentDir();\n\tlet resourceLoader = options.resourceLoader;\n\n\t// Use provided or create AuthStorage and ModelRegistry\n\tconst authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n\tconst modelsPath = options.agentDir ? join(agentDir, \"models.json\") : undefined;\n\tconst authStorage = options.authStorage ?? AuthStorage.create(authPath);\n\tconst modelRegistry = options.modelRegistry ?? new ModelRegistry(authStorage, modelsPath);\n\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tconst sessionManager = options.sessionManager ?? SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir));\n\n\tif (!resourceLoader) {\n\t\tresourceLoader = new DefaultResourceLoader({ cwd, agentDir, settingsManager });\n\t\tawait resourceLoader.reload();\n\t\ttime(\"resourceLoader.reload\");\n\t}\n\n\t// Check if session has existing data to restore\n\tconst existingSession = sessionManager.buildSessionContext();\n\tconst hasExistingSession = existingSession.messages.length > 0;\n\tconst hasThinkingEntry = sessionManager.getBranch().some((entry) => entry.type === \"thinking_level_change\");\n\n\tlet model = options.model;\n\tlet modelFallbackMessage: string | undefined;\n\n\t// If session has data, try to restore model from it\n\tif (!model && hasExistingSession && existingSession.model) {\n\t\tconst restoredModel = modelRegistry.find(existingSession.model.provider, existingSession.model.modelId);\n\t\tconst hasApiKey = restoredModel ? !!(await modelRegistry.getApiKey(restoredModel)) : false;\n\t\tif (restoredModel && hasApiKey) {\n\t\t\tmodel = restoredModel;\n\t\t}\n\t\tif (!model) {\n\t\t\tconst reason = !restoredModel ? \"not found in registry\" : \"no API key available\";\n\t\t\tmodelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId} (${reason})`;\n\t\t\tconsole.warn(`[model-restore] ${modelFallbackMessage}`);\n\t\t}\n\t}\n\n\t// If still no model, use findInitialModel (checks settings default, then provider defaults)\n\tif (!model) {\n\t\tconst result = await findInitialModel({\n\t\t\tscopedModels: [],\n\t\t\tisContinuing: hasExistingSession,\n\t\t\tdefaultProvider: settingsManager.getDefaultProvider(),\n\t\t\tdefaultModelId: settingsManager.getDefaultModel(),\n\t\t\tdefaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n\t\t\tmodelRegistry,\n\t\t});\n\t\tmodel = result.model;\n\t\tif (!model) {\n\t\t\tmodelFallbackMessage = `No models available. Use /login or set an API key environment variable. See ${join(getDocsPath(), \"providers.md\")}. Then use /model to select a model.`;\n\t\t} else if (modelFallbackMessage) {\n\t\t\tmodelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n\t\t}\n\t}\n\n\tlet thinkingLevel = options.thinkingLevel;\n\n\t// If session has data, restore thinking level from it\n\tif (thinkingLevel === undefined && hasExistingSession) {\n\t\tthinkingLevel = hasThinkingEntry\n\t\t\t? (existingSession.thinkingLevel as ThinkingLevel)\n\t\t\t: (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n\t}\n\n\t// Fall back to settings default\n\tif (thinkingLevel === undefined) {\n\t\tthinkingLevel = settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n\t}\n\n\t// Clamp to model capabilities\n\tif (!model || !model.reasoning) {\n\t\tthinkingLevel = \"off\";\n\t}\n\n\t// Tools that are always active when available (created by factory, not in allTools singleton)\n\tconst alwaysActiveBuiltins = [\"skill\", \"tasks_update\", \"search\"];\n\tconst defaultActiveToolNames: ToolName[] = [\n\t\t\"read\",\n\t\t\"bash\",\n\t\t\"edit\",\n\t\t\"write\",\n\t\t\"grep\",\n\t\t\"find\",\n\t\t\"ls\",\n\t\t\"web_search\",\n\t\t\"web_fetch\",\n\t\t\"subagent\",\n\t];\n\tconst initialActiveToolNames: string[] = options.tools\n\t\t? [...options.tools.map((t) => t.name).filter((n): n is ToolName => n in allTools), ...alwaysActiveBuiltins]\n\t\t: [...defaultActiveToolNames, ...alwaysActiveBuiltins];\n\n\tlet agent: Agent;\n\n\t// Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n\tconst convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n\t\tconst converted = convertToLlm(messages);\n\t\t// Check setting dynamically so mid-session changes take effect\n\t\tif (!settingsManager.getBlockImages()) {\n\t\t\treturn converted;\n\t\t}\n\t\t// Filter out ImageContent from all messages, replacing with text placeholder\n\t\treturn converted.map((msg) => {\n\t\t\tif (msg.role === \"user\" || msg.role === \"toolResult\") {\n\t\t\t\tconst content = msg.content;\n\t\t\t\tif (Array.isArray(content)) {\n\t\t\t\t\tconst hasImages = content.some((c) => c.type === \"image\");\n\t\t\t\t\tif (hasImages) {\n\t\t\t\t\t\tconst filteredContent = content\n\t\t\t\t\t\t\t.map((c) =>\n\t\t\t\t\t\t\t\tc.type === \"image\" ? { type: \"text\" as const, text: \"Image reading is disabled.\" } : c,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.filter(\n\t\t\t\t\t\t\t\t(c, i, arr) =>\n\t\t\t\t\t\t\t\t\t// Dedupe consecutive \"Image reading is disabled.\" texts\n\t\t\t\t\t\t\t\t\t!(\n\t\t\t\t\t\t\t\t\t\tc.type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\tc.text === \"Image reading is disabled.\" &&\n\t\t\t\t\t\t\t\t\t\ti > 0 &&\n\t\t\t\t\t\t\t\t\t\tarr[i - 1].type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t(arr[i - 1] as { type: \"text\"; text: string }).text === \"Image reading is disabled.\"\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\treturn { ...msg, content: filteredContent };\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn msg;\n\t\t});\n\t};\n\n\tconst extensionRunnerRef: { current?: ExtensionRunner } = {};\n\tconst sessionRef: { current?: AgentSession } = {};\n\n\tagent = new Agent({\n\t\tinitialState: {\n\t\t\tsystemPrompt: \"\",\n\t\t\tmodel,\n\t\t\tthinkingLevel,\n\t\t\ttools: [],\n\t\t},\n\t\tconvertToLlm: convertToLlmWithBlockImages,\n\t\tonPayload: async (payload, _model) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner?.hasHandlers(\"before_provider_request\")) {\n\t\t\t\treturn payload;\n\t\t\t}\n\t\t\treturn runner.emitBeforeProviderRequest(payload);\n\t\t},\n\t\tsessionId: sessionManager.getSessionId(),\n\t\ttransformContext: async (messages) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner) return messages;\n\t\t\treturn runner.emitContext(messages);\n\t\t},\n\t\tsteeringMode: settingsManager.getSteeringMode(),\n\t\tfollowUpMode: settingsManager.getFollowUpMode(),\n\t\ttransport: settingsManager.getTransport(),\n\t\tthinkingBudgets: settingsManager.getThinkingBudgets(),\n\t\tmaxRetryDelayMs: settingsManager.getRetrySettings().maxDelayMs,\n\t\tonWarning: (code: string, message: string) => {\n\t\t\t// Wire provider-level warnings to the session for user/agent visibility\n\t\t\tconst informational =\n\t\t\t\tcode === \"sse_parse_error\" || code === \"ws_parse_error\" || code === \"json_parse_total_failure\";\n\t\t\tsessionRef.current?.warnInSession(message, { informational });\n\t\t},\n\t\tgetApiKey: async (provider) => {\n\t\t\t// Use the provider argument from the in-flight request;\n\t\t\t// agent.state.model may already be switched mid-turn.\n\t\t\tconst resolvedProvider = provider || agent.state.model?.provider;\n\t\t\tif (!resolvedProvider) {\n\t\t\t\tthrow new Error(\"No model selected\");\n\t\t\t}\n\t\t\tconst key = await modelRegistry.getApiKeyForProvider(resolvedProvider);\n\t\t\t// Surface any config value resolution warnings (e.g. failed !command API keys)\n\t\t\tif (configValueWarnings.length > 0) {\n\t\t\t\tconst warnings = configValueWarnings.splice(0);\n\t\t\t\tfor (const w of warnings) {\n\t\t\t\t\tsessionRef.current?.warnInSession(w);\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (!key) {\n\t\t\t\tconst model = agent.state.model;\n\t\t\t\tconst isOAuth = model && modelRegistry.isUsingOAuth(model);\n\t\t\t\tif (isOAuth) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Authentication failed for \"${resolvedProvider}\". ` +\n\t\t\t\t\t\t\t`Credentials may have expired or network is unavailable. ` +\n\t\t\t\t\t\t\t`Run '/login ${resolvedProvider}' to re-authenticate.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`No API key found for \"${resolvedProvider}\". ` +\n\t\t\t\t\t\t`Set an API key environment variable or run '/login ${resolvedProvider}'.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn key;\n\t\t},\n\t});\n\n\t// Restore messages if session has existing data\n\tif (hasExistingSession) {\n\t\tagent.replaceMessages(existingSession.messages);\n\t\tif (!hasThinkingEntry) {\n\t\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t}\n\t} else {\n\t\t// Save initial model and thinking level for new sessions so they can be restored on resume\n\t\tif (model) {\n\t\t\tsessionManager.appendModelChange(model.provider, model.id);\n\t\t}\n\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t}\n\n\tconst session = new AgentSession({\n\t\tagent,\n\t\tsessionManager,\n\t\tsettingsManager,\n\t\tcwd,\n\t\tscopedModels: options.scopedModels,\n\t\tresourceLoader,\n\t\tcustomTools: options.customTools,\n\t\tmodelRegistry,\n\t\tinitialActiveToolNames,\n\t\textensionRunnerRef,\n\t\tuiType: options.uiType,\n\t});\n\tsessionRef.current = session;\n\tconst extensionsResult = resourceLoader.getExtensions();\n\n\t// Surface any resource diagnostics from initial load\n\tsession.warnResourceDiagnostics(resourceLoader);\n\n\treturn {\n\t\tsession,\n\t\textensionsResult,\n\t\tmodelFallbackMessage,\n\t};\n}\n"]}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { Agent, type AgentMessage, type ThinkingLevel } from \"@dreb/agent-core\";\nimport type { Message, Model } from \"@dreb/ai\";\nimport { getAgentDir, getDocsPath } from \"../config.js\";\nimport { AgentSession } from \"./agent-session.js\";\nimport { AuthStorage } from \"./auth-storage.js\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.js\";\nimport type { ExtensionRunner, LoadExtensionsResult, ToolDefinition } from \"./extensions/index.js\";\nimport { convertToLlm } from \"./messages.js\";\nimport { ModelRegistry } from \"./model-registry.js\";\nimport { findInitialModel } from \"./model-resolver.js\";\nimport { configValueWarnings } from \"./resolve-config-value.js\";\nimport type { ResourceLoader } from \"./resource-loader.js\";\nimport { DefaultResourceLoader } from \"./resource-loader.js\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.js\";\nimport { SettingsManager } from \"./settings-manager.js\";\nimport { time } from \"./timings.js\";\nimport {\n\tallTools,\n\tbashTool,\n\tcodingTools,\n\tcreateBashTool,\n\tcreateCodingTools,\n\tcreateEditTool,\n\tcreateFindTool,\n\tcreateGrepTool,\n\tcreateLsTool,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateSubagentTool,\n\tcreateWriteTool,\n\teditTool,\n\tfindTool,\n\tgetBackgroundAgents,\n\tgetRunningBackgroundAgents,\n\tgrepTool,\n\tlsTool,\n\tpruneBackgroundAgents,\n\treadOnlyTools,\n\treadTool,\n\tsubagentTool,\n\ttype Tool,\n\ttype ToolName,\n\twithFileMutationQueue,\n\twriteTool,\n} from \"./tools/index.js\";\n\nexport interface CreateAgentSessionOptions {\n\t/** Working directory for project-local discovery. Default: process.cwd() */\n\tcwd?: string;\n\t/** Global config directory. Default: ~/.dreb/agent */\n\tagentDir?: string;\n\n\t/** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */\n\tauthStorage?: AuthStorage;\n\t/** Model registry. Default: new ModelRegistry(authStorage, agentDir/models.json) */\n\tmodelRegistry?: ModelRegistry;\n\n\t/** Model to use. Default: from settings, else first available */\n\tmodel?: Model<any>;\n\t/** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Models available for cycling (Ctrl+P in interactive mode) */\n\tscopedModels?: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\n\t/** Built-in tools to use. Default: all standard tools [read, bash, edit, write, grep, find, ls, web_search, web_fetch, subagent]. `skill`, `tasks_update`, and `search` are always active regardless of this setting. */\n\ttools?: Tool[];\n\t/** Custom tools to register (in addition to built-in tools). */\n\tcustomTools?: ToolDefinition[];\n\n\t/** Resource loader. When omitted, DefaultResourceLoader is used. */\n\tresourceLoader?: ResourceLoader;\n\n\t/** Session manager. Default: SessionManager.create(cwd) */\n\tsessionManager?: SessionManager;\n\n\t/** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n\tsettingsManager?: SettingsManager;\n\t/** UI type for system prompt context (e.g. \"tui\", \"telegram\", \"rpc\") */\n\tuiType?: string;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n\t/** The created session */\n\tsession: AgentSession;\n\t/** Extensions result (for UI context setup in interactive mode) */\n\textensionsResult: LoadExtensionsResult;\n\t/** Warning if session was restored with a different model than saved */\n\tmodelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport type {\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionContext,\n\tExtensionFactory,\n\tSlashCommandInfo,\n\tSlashCommandSource,\n\tToolDefinition,\n} from \"./extensions/index.js\";\nexport type { PromptTemplate } from \"./prompt-templates.js\";\nexport type { Skill } from \"./skills.js\";\nexport type { Tool } from \"./tools/index.js\";\n\nexport {\n\t// Pre-built tools (use process.cwd())\n\treadTool,\n\tbashTool,\n\teditTool,\n\twriteTool,\n\tgrepTool,\n\tfindTool,\n\tlsTool,\n\tsubagentTool,\n\tcodingTools,\n\treadOnlyTools,\n\tallTools as allBuiltInTools,\n\twithFileMutationQueue,\n\t// Tool factories (for custom cwd)\n\tcreateCodingTools,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateBashTool,\n\tcreateEditTool,\n\tcreateWriteTool,\n\tcreateGrepTool,\n\tcreateFindTool,\n\tcreateLsTool,\n\tcreateSubagentTool,\n\t// Background agent registry\n\tgetBackgroundAgents,\n\tgetRunningBackgroundAgents,\n\tpruneBackgroundAgents,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n\treturn getAgentDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@dreb/ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [readTool, bashTool],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(options: CreateAgentSessionOptions = {}): Promise<CreateAgentSessionResult> {\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst agentDir = options.agentDir ?? getDefaultAgentDir();\n\tlet resourceLoader = options.resourceLoader;\n\n\t// Use provided or create AuthStorage and ModelRegistry\n\tconst authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n\tconst modelsPath = options.agentDir ? join(agentDir, \"models.json\") : undefined;\n\tconst authStorage = options.authStorage ?? AuthStorage.create(authPath);\n\tconst modelRegistry = options.modelRegistry ?? new ModelRegistry(authStorage, modelsPath);\n\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tconst sessionManager = options.sessionManager ?? SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir));\n\n\tif (!resourceLoader) {\n\t\tresourceLoader = new DefaultResourceLoader({ cwd, agentDir, settingsManager });\n\t\tawait resourceLoader.reload();\n\t\ttime(\"resourceLoader.reload\");\n\t}\n\n\t// Check if session has existing data to restore\n\tconst existingSession = sessionManager.buildSessionContext();\n\tconst hasExistingSession = existingSession.messages.length > 0;\n\tconst hasThinkingEntry = sessionManager.getBranch().some((entry) => entry.type === \"thinking_level_change\");\n\n\tlet model = options.model;\n\tlet modelFallbackMessage: string | undefined;\n\n\t// If session has data, try to restore model from it\n\tif (!model && hasExistingSession && existingSession.model) {\n\t\tconst restoredModel = modelRegistry.find(existingSession.model.provider, existingSession.model.modelId);\n\t\tconst hasApiKey = restoredModel ? !!(await modelRegistry.getApiKey(restoredModel)) : false;\n\t\tif (restoredModel && hasApiKey) {\n\t\t\tmodel = restoredModel;\n\t\t}\n\t\tif (!model) {\n\t\t\tconst reason = !restoredModel ? \"not found in registry\" : \"no API key available\";\n\t\t\tmodelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId} (${reason})`;\n\t\t\tconsole.warn(`[model-restore] ${modelFallbackMessage}`);\n\t\t}\n\t}\n\n\t// If still no model, use findInitialModel (checks settings default, then provider defaults)\n\tif (!model) {\n\t\tconst result = await findInitialModel({\n\t\t\tscopedModels: [],\n\t\t\tisContinuing: hasExistingSession,\n\t\t\tdefaultProvider: settingsManager.getDefaultProvider(),\n\t\t\tdefaultModelId: settingsManager.getDefaultModel(),\n\t\t\tdefaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n\t\t\tmodelRegistry,\n\t\t});\n\t\tmodel = result.model;\n\t\tif (!model) {\n\t\t\tmodelFallbackMessage = `No models available. Use /login or set an API key environment variable. See ${join(getDocsPath(), \"providers.md\")}. Then use /model to select a model.`;\n\t\t} else if (modelFallbackMessage) {\n\t\t\tmodelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n\t\t}\n\t}\n\n\tlet thinkingLevel = options.thinkingLevel;\n\n\t// If session has data, restore thinking level from it\n\tif (thinkingLevel === undefined && hasExistingSession) {\n\t\tthinkingLevel = hasThinkingEntry\n\t\t\t? (existingSession.thinkingLevel as ThinkingLevel)\n\t\t\t: (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n\t}\n\n\t// Fall back to settings default\n\tif (thinkingLevel === undefined) {\n\t\tthinkingLevel = settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n\t}\n\n\t// Clamp to model capabilities\n\tif (!model || !model.reasoning) {\n\t\tthinkingLevel = \"off\";\n\t}\n\n\t// Tools that are always active when available (created by factory, not in allTools singleton)\n\tconst alwaysActiveBuiltins = [\"skill\", \"tasks_update\", \"search\", \"suggest_next\"];\n\tconst defaultActiveToolNames: ToolName[] = [\n\t\t\"read\",\n\t\t\"bash\",\n\t\t\"edit\",\n\t\t\"write\",\n\t\t\"grep\",\n\t\t\"find\",\n\t\t\"ls\",\n\t\t\"web_search\",\n\t\t\"web_fetch\",\n\t\t\"subagent\",\n\t];\n\tconst initialActiveToolNames: string[] = options.tools\n\t\t? [...options.tools.map((t) => t.name).filter((n): n is ToolName => n in allTools), ...alwaysActiveBuiltins]\n\t\t: [...defaultActiveToolNames, ...alwaysActiveBuiltins];\n\n\tlet agent: Agent;\n\n\t// Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n\tconst convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n\t\tconst converted = convertToLlm(messages);\n\t\t// Check setting dynamically so mid-session changes take effect\n\t\tif (!settingsManager.getBlockImages()) {\n\t\t\treturn converted;\n\t\t}\n\t\t// Filter out ImageContent from all messages, replacing with text placeholder\n\t\treturn converted.map((msg) => {\n\t\t\tif (msg.role === \"user\" || msg.role === \"toolResult\") {\n\t\t\t\tconst content = msg.content;\n\t\t\t\tif (Array.isArray(content)) {\n\t\t\t\t\tconst hasImages = content.some((c) => c.type === \"image\");\n\t\t\t\t\tif (hasImages) {\n\t\t\t\t\t\tconst filteredContent = content\n\t\t\t\t\t\t\t.map((c) =>\n\t\t\t\t\t\t\t\tc.type === \"image\" ? { type: \"text\" as const, text: \"Image reading is disabled.\" } : c,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.filter(\n\t\t\t\t\t\t\t\t(c, i, arr) =>\n\t\t\t\t\t\t\t\t\t// Dedupe consecutive \"Image reading is disabled.\" texts\n\t\t\t\t\t\t\t\t\t!(\n\t\t\t\t\t\t\t\t\t\tc.type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\tc.text === \"Image reading is disabled.\" &&\n\t\t\t\t\t\t\t\t\t\ti > 0 &&\n\t\t\t\t\t\t\t\t\t\tarr[i - 1].type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t(arr[i - 1] as { type: \"text\"; text: string }).text === \"Image reading is disabled.\"\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\treturn { ...msg, content: filteredContent };\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn msg;\n\t\t});\n\t};\n\n\tconst extensionRunnerRef: { current?: ExtensionRunner } = {};\n\tconst sessionRef: { current?: AgentSession } = {};\n\n\tagent = new Agent({\n\t\tinitialState: {\n\t\t\tsystemPrompt: \"\",\n\t\t\tmodel,\n\t\t\tthinkingLevel,\n\t\t\ttools: [],\n\t\t},\n\t\tconvertToLlm: convertToLlmWithBlockImages,\n\t\tonPayload: async (payload, _model) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner?.hasHandlers(\"before_provider_request\")) {\n\t\t\t\treturn payload;\n\t\t\t}\n\t\t\treturn runner.emitBeforeProviderRequest(payload);\n\t\t},\n\t\tsessionId: sessionManager.getSessionId(),\n\t\ttransformContext: async (messages) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner) return messages;\n\t\t\treturn runner.emitContext(messages);\n\t\t},\n\t\tsteeringMode: settingsManager.getSteeringMode(),\n\t\tfollowUpMode: settingsManager.getFollowUpMode(),\n\t\ttransport: settingsManager.getTransport(),\n\t\tthinkingBudgets: settingsManager.getThinkingBudgets(),\n\t\tmaxRetryDelayMs: settingsManager.getRetrySettings().maxDelayMs,\n\t\tonWarning: (code: string, message: string) => {\n\t\t\t// Wire provider-level warnings to the session for user/agent visibility\n\t\t\tconst informational =\n\t\t\t\tcode === \"sse_parse_error\" || code === \"ws_parse_error\" || code === \"json_parse_total_failure\";\n\t\t\tsessionRef.current?.warnInSession(message, { informational });\n\t\t},\n\t\tgetApiKey: async (provider) => {\n\t\t\t// Use the provider argument from the in-flight request;\n\t\t\t// agent.state.model may already be switched mid-turn.\n\t\t\tconst resolvedProvider = provider || agent.state.model?.provider;\n\t\t\tif (!resolvedProvider) {\n\t\t\t\tthrow new Error(\"No model selected\");\n\t\t\t}\n\t\t\tconst key = await modelRegistry.getApiKeyForProvider(resolvedProvider);\n\t\t\t// Surface any config value resolution warnings (e.g. failed !command API keys)\n\t\t\tif (configValueWarnings.length > 0) {\n\t\t\t\tconst warnings = configValueWarnings.splice(0);\n\t\t\t\tfor (const w of warnings) {\n\t\t\t\t\tsessionRef.current?.warnInSession(w);\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (!key) {\n\t\t\t\tconst model = agent.state.model;\n\t\t\t\tconst isOAuth = model && modelRegistry.isUsingOAuth(model);\n\t\t\t\tif (isOAuth) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Authentication failed for \"${resolvedProvider}\". ` +\n\t\t\t\t\t\t\t`Credentials may have expired or network is unavailable. ` +\n\t\t\t\t\t\t\t`Run '/login ${resolvedProvider}' to re-authenticate.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`No API key found for \"${resolvedProvider}\". ` +\n\t\t\t\t\t\t`Set an API key environment variable or run '/login ${resolvedProvider}'.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn key;\n\t\t},\n\t});\n\n\t// Restore messages if session has existing data\n\tif (hasExistingSession) {\n\t\tagent.replaceMessages(existingSession.messages);\n\t\tif (!hasThinkingEntry) {\n\t\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t}\n\t} else {\n\t\t// Save initial model and thinking level for new sessions so they can be restored on resume\n\t\tif (model) {\n\t\t\tsessionManager.appendModelChange(model.provider, model.id);\n\t\t}\n\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t}\n\n\tconst session = new AgentSession({\n\t\tagent,\n\t\tsessionManager,\n\t\tsettingsManager,\n\t\tcwd,\n\t\tscopedModels: options.scopedModels,\n\t\tresourceLoader,\n\t\tcustomTools: options.customTools,\n\t\tmodelRegistry,\n\t\tinitialActiveToolNames,\n\t\textensionRunnerRef,\n\t\tuiType: options.uiType,\n\t});\n\tsessionRef.current = session;\n\tconst extensionsResult = resourceLoader.getExtensions();\n\n\t// Surface any resource diagnostics from initial load\n\tsession.warnResourceDiagnostics(resourceLoader);\n\n\treturn {\n\t\tsession,\n\t\textensionsResult,\n\t\tmodelFallbackMessage,\n\t};\n}\n"]}

package/dist/core/sdk.js

@@ -128,7 +128,7 @@ export async function createAgentSession(options = {}) {
         thinkingLevel = "off";
     }
     // Tools that are always active when available (created by factory, not in allTools singleton)
-    const alwaysActiveBuiltins = ["skill", "tasks_update", "search"];
+    const alwaysActiveBuiltins = ["skill", "tasks_update", "search", "suggest_next"];
     const defaultActiveToolNames = [
         "read",
         "bash",