@gaunt-sloth/core 2.0.0-alpha.6 → 2.0.0-alpha.8

package/dist/history/historyStore.js

@@ -0,0 +1,315 @@
+/**
+ * @packageDocumentation
+ * GS2-7 (B20) — local, opt-in session history store.
+ *
+ * A **local SQLite** store that persists a compact record of each run BESIDE the existing
+ * per-run `.md` logs, so `gth history search` / `gth insights` can look back over past sessions.
+ * It is a **side-benefit, never a critical path**:
+ *
+ * - **Local only.** Nothing leaves the machine. The DB lives under the user's global `~/.gsloth`
+ *   dir (cross-project history), overridable via `history.dbPath`.
+ * - **Opt-in.** The recorder only writes when `history.enabled` is true (see
+ *   {@link recordSessionSafe}); default runs persist nothing and behave exactly as before.
+ * - **Fail-soft.** {@link openHistoryStore} returns `null` if the DB can't be opened, and every
+ *   {@link HistoryStore} method catches its own errors and returns a safe default. A malformed or
+ *   locked DB therefore can never abort or alter a run — it just means no history for that run.
+ *
+ * Uses the built-in `node:sqlite` (Node ≥ 24) — zero native dependency, no build step — and its
+ * bundled **FTS5** extension for full-text search (verified available at build time via an
+ * `fts5` virtual table). No fallback path is needed on this runtime.
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { getGlobalGslothDir, ensureGlobalGslothDir } from '#src/utils/globalConfigUtils.js';
+/** Filename of the global history DB inside `~/.gsloth`. */
+export const HISTORY_DB_FILENAME = 'history.db';
+/** Escape a value for use inside an FTS5 double-quoted string token. */
+function ftsQuote(term) {
+    return '"' + term.replace(/"/g, '""') + '"';
+}
+/**
+ * Turn arbitrary user text into a safe FTS5 MATCH expression: each whitespace-separated token is
+ * wrapped as a quoted string and AND-ed together. This avoids FTS5 syntax errors from stray
+ * operators (`AND`, `*`, `:`, parentheses, unbalanced quotes) in a user's query while still
+ * matching all of their words.
+ */
+export function toFtsMatchQuery(query) {
+    const tokens = query.trim().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return '';
+    return tokens.map(ftsQuote).join(' AND ');
+}
+/**
+ * A thin, fail-soft wrapper over a `node:sqlite` connection holding the session history.
+ *
+ * Obtain one via {@link openHistoryStore} (which returns `null` if the DB can't be opened). Every
+ * method is defensive: on any SQLite error it returns a safe empty/zero result rather than
+ * throwing, so callers on a run's hot path never have to guard.
+ */
+export class HistoryStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Open (and lazily initialise) the store at `dbPath`. Returns `null` on any failure — a missing
+     * file when `create` is false, an unopenable/locked/corrupt DB, or a schema-init error — so the
+     * caller can simply skip history without a try/catch.
+     */
+    static open(dbPath, options = {}) {
+        const create = options.create ?? false;
+        if (!create && dbPath !== ':memory:' && !existsSync(dbPath)) {
+            return null;
+        }
+        try {
+            const db = new DatabaseSync(dbPath);
+            const store = new HistoryStore(db);
+            store.initSchema();
+            return store;
+        }
+        catch {
+            return null;
+        }
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS sessions (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts TEXT NOT NULL,
+        project TEXT,
+        command TEXT,
+        model TEXT,
+        prompt TEXT,
+        response TEXT,
+        tokens_input INTEGER,
+        tokens_output INTEGER,
+        cost_usd REAL,
+        tools TEXT,
+        duration_ms INTEGER
+      );
+      CREATE VIRTUAL TABLE IF NOT EXISTS sessions_fts USING fts5(
+        prompt, response, command, project
+      );
+    `);
+    }
+    /**
+     * Persist one session and its full-text index entry. Returns the new row id, or `null` on any
+     * error (the run continues regardless). The two inserts run in a transaction so a failure can't
+     * leave the FTS index out of sync with the base table.
+     */
+    record(rec) {
+        try {
+            const ts = rec.ts ?? new Date().toISOString();
+            const tools = rec.tools && rec.tools.length > 0 ? JSON.stringify(rec.tools) : null;
+            this.db.exec('BEGIN');
+            try {
+                const insert = this.db.prepare(`INSERT INTO sessions
+             (ts, project, command, model, prompt, response,
+              tokens_input, tokens_output, cost_usd, tools, duration_ms)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+                const info = insert.run(ts, rec.project ?? null, rec.command ?? null, rec.model ?? null, rec.prompt ?? null, rec.response ?? null, rec.tokensInput ?? null, rec.tokensOutput ?? null, rec.costUsd ?? null, tools, rec.durationMs ?? null);
+                const id = Number(info.lastInsertRowid);
+                this.db
+                    .prepare(`INSERT INTO sessions_fts (rowid, prompt, response, command, project)
+             VALUES (?, ?, ?, ?, ?)`)
+                    .run(id, rec.prompt ?? '', rec.response ?? '', rec.command ?? '', rec.project ?? '');
+                this.db.exec('COMMIT');
+                return id;
+            }
+            catch (e) {
+                this.db.exec('ROLLBACK');
+                throw e;
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Full-text search over prompt/response/command/project, best match first (FTS5 `rank`). User
+     * text is sanitised via {@link toFtsMatchQuery}; an empty or all-punctuation query returns `[]`.
+     * Any SQLite error yields `[]` (fail-soft).
+     */
+    search(query, limit = 20) {
+        const match = toFtsMatchQuery(query);
+        if (!match)
+            return [];
+        try {
+            const rows = this.db
+                .prepare(`SELECT s.id AS id, s.ts AS ts, s.project AS project, s.command AS command,
+                  s.model AS model, s.prompt AS prompt, s.response AS response,
+                  s.tokens_input AS tokens_input, s.tokens_output AS tokens_output,
+                  s.cost_usd AS cost_usd, s.tools AS tools, s.duration_ms AS duration_ms,
+                  snippet(sessions_fts, 0, '[', ']', '…', 12) AS snippet
+             FROM sessions_fts f
+             JOIN sessions s ON s.id = f.rowid
+            WHERE sessions_fts MATCH ?
+            ORDER BY rank
+            LIMIT ?`)
+                .all(match, limit);
+            return rows.map((r) => ({
+                ...rowToRecord(r),
+                id: Number(r.id),
+                ts: String(r.ts),
+                snippet: String(r.snippet ?? ''),
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Most recent sessions, newest first. Fail-soft ([] on error). */
+    listRecent(limit = 20) {
+        try {
+            const rows = this.db
+                .prepare(`SELECT id, ts, project, command, model, prompt, response,
+                  tokens_input, tokens_output, cost_usd, tools, duration_ms
+             FROM sessions
+            ORDER BY id DESC
+            LIMIT ?`)
+                .all(limit);
+            return rows.map((r) => ({
+                ...rowToRecord(r),
+                id: Number(r.id),
+                ts: String(r.ts),
+                snippet: '',
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Aggregate token/cost totals, a top-tool tally, and a per-command breakdown over the whole
+     * store. Tool tallying reads each row's JSON `tools` array in JS (robust to nulls). Fail-soft:
+     * returns a zeroed summary on any error.
+     */
+    insights(topN = 10) {
+        const empty = {
+            sessionCount: 0,
+            totalTokensInput: 0,
+            totalTokensOutput: 0,
+            totalTokens: 0,
+            totalCostUsd: 0,
+            topTools: [],
+            perCommand: [],
+        };
+        try {
+            const agg = this.db
+                .prepare(`SELECT COUNT(*) AS n,
+                  COALESCE(SUM(tokens_input), 0) AS ti,
+                  COALESCE(SUM(tokens_output), 0) AS to_,
+                  COALESCE(SUM(cost_usd), 0) AS cost,
+                  MIN(ts) AS first_ts,
+                  MAX(ts) AS last_ts
+             FROM sessions`)
+                .get();
+            const perCommandRows = this.db
+                .prepare(`SELECT command, COUNT(*) AS n
+             FROM sessions
+            WHERE command IS NOT NULL AND command <> ''
+            GROUP BY command
+            ORDER BY n DESC, command ASC`)
+                .all();
+            const toolRows = this.db
+                .prepare(`SELECT tools FROM sessions WHERE tools IS NOT NULL AND tools <> ''`)
+                .all();
+            const toolCounts = new Map();
+            for (const row of toolRows) {
+                let names;
+                try {
+                    names = JSON.parse(String(row.tools));
+                }
+                catch {
+                    continue;
+                }
+                if (!Array.isArray(names))
+                    continue;
+                for (const name of names) {
+                    if (typeof name !== 'string' || name.length === 0)
+                        continue;
+                    toolCounts.set(name, (toolCounts.get(name) ?? 0) + 1);
+                }
+            }
+            const topTools = [...toolCounts.entries()]
+                .map(([tool, count]) => ({ tool, count }))
+                .sort((a, b) => b.count - a.count || a.tool.localeCompare(b.tool))
+                .slice(0, topN);
+            const ti = Number(agg.ti ?? 0);
+            const to = Number(agg.to_ ?? 0);
+            return {
+                sessionCount: Number(agg.n ?? 0),
+                totalTokensInput: ti,
+                totalTokensOutput: to,
+                totalTokens: ti + to,
+                totalCostUsd: Number(agg.cost ?? 0),
+                topTools,
+                perCommand: perCommandRows.map((r) => ({
+                    command: String(r.command),
+                    count: Number(r.n),
+                })),
+                firstTs: agg.first_ts ? String(agg.first_ts) : undefined,
+                lastTs: agg.last_ts ? String(agg.last_ts) : undefined,
+            };
+        }
+        catch {
+            return empty;
+        }
+    }
+    /** Close the underlying connection (fail-soft). */
+    close() {
+        try {
+            this.db.close();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/** Map a raw DB row (snake_case columns) to a {@link SessionRecord}. */
+function rowToRecord(r) {
+    let tools;
+    if (r.tools != null && r.tools !== '') {
+        try {
+            const parsed = JSON.parse(String(r.tools));
+            if (Array.isArray(parsed))
+                tools = parsed.filter((t) => typeof t === 'string');
+        }
+        catch {
+            /* ignore malformed tools JSON */
+        }
+    }
+    return {
+        ts: r.ts != null ? String(r.ts) : undefined,
+        project: r.project != null ? String(r.project) : undefined,
+        command: r.command != null ? String(r.command) : undefined,
+        model: r.model != null ? String(r.model) : undefined,
+        prompt: r.prompt != null ? String(r.prompt) : undefined,
+        response: r.response != null ? String(r.response) : undefined,
+        tokensInput: r.tokens_input != null ? Number(r.tokens_input) : undefined,
+        tokensOutput: r.tokens_output != null ? Number(r.tokens_output) : undefined,
+        costUsd: r.cost_usd != null ? Number(r.cost_usd) : undefined,
+        tools,
+        durationMs: r.duration_ms != null ? Number(r.duration_ms) : undefined,
+    };
+}
+/**
+ * Resolve the on-disk path of the history DB. Honors an explicit `dbPath` (from `history.dbPath`
+ * or a `--db` flag); otherwise the global `~/.gsloth/history.db`. When `dbPath` is omitted and
+ * `ensureDir` is true, the global dir is created so the recorder can write.
+ */
+export function resolveHistoryDbPath(dbPath, ensureDir = false) {
+    if (dbPath && dbPath.trim().length > 0)
+        return dbPath;
+    const dir = ensureDir ? ensureGlobalGslothDir() : getGlobalGslothDir();
+    return resolve(dir, HISTORY_DB_FILENAME);
+}
+/**
+ * Fail-soft open of the history store. Returns `null` (never throws) when the DB can't be opened
+ * or, for read-only callers (`create: false`, the default), when the file does not yet exist.
+ */
+export function openHistoryStore(dbPath, options = {}) {
+    return HistoryStore.open(dbPath, options);
+}
+//# sourceMappingURL=historyStore.js.map

package/dist/history/historyStore.js.map

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

package/dist/history/recordSession.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @packageDocumentation
+ * GS2-7 (B20) — the opt-in bridge from a finished run to the {@link HistoryStore}.
+ *
+ * {@link recordSessionSafe} is the ONE entry point the run path calls. It is a no-op unless
+ * `history.enabled` is true, and it swallows every error, so:
+ * - a **default run** (history absent/false) opens nothing, writes nothing, and behaves exactly
+ *   as before — the stateless identity is preserved; and
+ * - even with history **on**, a DB problem (locked/corrupt/read-only fs) can never abort or alter
+ *   the run: the worst case is that one session isn't recorded.
+ */
+import type { SessionRecord } from '#src/history/historyStore.js';
+/** The subset of the resolved config the recorder reads (structural, to avoid a hard type dep). */
+export interface HistoryConfigView {
+    history?: {
+        enabled?: boolean;
+        dbPath?: string;
+    };
+}
+/**
+ * Record one finished session IFF `history.enabled` is true. Returns the new row id, or `null`
+ * when history is disabled or anything went wrong (both are non-events for the caller).
+ *
+ * Deliberately fully guarded: opening the store, ensuring the global dir, and the insert all run
+ * behind a single try/catch, and the store itself is fail-soft. Callers put this in a `finally`
+ * (or after a run) without a try/catch of their own.
+ */
+export declare function recordSessionSafe(config: HistoryConfigView, record: SessionRecord): number | null;

package/dist/history/recordSession.js

@@ -0,0 +1,29 @@
+import { openHistoryStore, resolveHistoryDbPath } from '#src/history/historyStore.js';
+/**
+ * Record one finished session IFF `history.enabled` is true. Returns the new row id, or `null`
+ * when history is disabled or anything went wrong (both are non-events for the caller).
+ *
+ * Deliberately fully guarded: opening the store, ensuring the global dir, and the insert all run
+ * behind a single try/catch, and the store itself is fail-soft. Callers put this in a `finally`
+ * (or after a run) without a try/catch of their own.
+ */
+export function recordSessionSafe(config, record) {
+    try {
+        if (!config?.history?.enabled)
+            return null;
+        const dbPath = resolveHistoryDbPath(config.history.dbPath, /* ensureDir */ true);
+        const store = openHistoryStore(dbPath, { create: true });
+        if (!store)
+            return null;
+        try {
+            return store.record(record);
+        }
+        finally {
+            store.close();
+        }
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=recordSession.js.map

package/dist/history/recordSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordSession.js","sourceRoot":"","sources":["../../src/history/recordSession.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAOtF;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB,EAAE,MAAqB;IAChF,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -3,3 +3,6 @@ export * from '#src/core/types.js';
 export { gthLeanAgentFactory } from '#src/core/gthLeanAgentFactory.js';
 export * from '#src/config.js';
 export * from '#src/providers/modelDiscovery.js';
+export * from '#src/history/historyStore.js';
+export * from '#src/history/recordSession.js';
+export * from '#src/history/historyFormat.js';

package/dist/index.js

@@ -3,4 +3,7 @@ export * from '#src/core/types.js';
 export { gthLeanAgentFactory } from '#src/core/gthLeanAgentFactory.js';
 export * from '#src/config.js';
 export * from '#src/providers/modelDiscovery.js';
+export * from '#src/history/historyStore.js';
+export * from '#src/history/recordSession.js';
+export * from '#src/history/historyFormat.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -4,4 +4,4 @@ import type { BaseChatModel, BaseChatModelParams } from '@langchain/core/languag
  * Function to process JSON config and create Anthropic LLM instance
  */
 export declare function processJsonConfig(llmConfig: AnthropicInput & BaseChatModelParams): Promise<BaseChatModel>;
-export declare function init(configFileName: string, force?: boolean): void;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/anthropic.js

@@ -1,5 +1,6 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
 import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
 import { env } from '#src/utils/systemUtils.js';
 /**
  * Function to process JSON config and create Anthropic LLM instance
@@ -12,22 +13,16 @@ export async function processJsonConfig(llmConfig) {
     return new anthropic.ChatAnthropic({
         ...llmConfig,
         apiKey: anthropicApiKey,
-        model: llmConfig.model || 'claude-sonnet-4-6',
+        model: llmConfig.model || getCuratedFallbackModel('anthropic'),
     });
 }
-const jsonContent = `{
-  "llm": {
-    "type": "anthropic",
-    "model": "claude-sonnet-4-6"
-  }
-}`;
 // noinspection JSUnusedGlobalSymbols
-export function init(configFileName, force = false) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeConfigFileWithMessages(configFileName, jsonContent, force);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('anthropic', model), force);
     displayWarning(`You need to update your ${configFileName} to add your Anthropic API key, ` +
         'or define ANTHROPIC_API_KEY environment variable.');
 }

package/dist/providers/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD;;GAEG;AACH,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA+C;IAE/C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACvD,wEAAwE;IACxE,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAClE,OAAO,IAAI,SAAS,CAAC,aAAa,CAAC;QACjC,GAAG,SAAS;QACZ,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,mBAAmB;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK;IACxD,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IAChE,cAAc,CACZ,2BAA2B,cAAc,kCAAkC;QACzE,mDAAmD,CACtD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACnG,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD;;GAEG;AACH,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA+C;IAE/C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACvD,wEAAwE;IACxE,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAClE,OAAO,IAAI,SAAS,CAAC,aAAa,CAAC;QACjC,GAAG,SAAS;QACZ,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,WAAW,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/F,cAAc,CACZ,2BAA2B,cAAc,kCAAkC;QACzE,mDAAmD,CACtD,CAAC;AACJ,CAAC"}

package/dist/providers/deepseek.d.ts

@@ -1,4 +1,4 @@
 import type { BaseChatModel, BaseChatModelParams } from '@langchain/core/language_models/chat_models';
 import { ChatDeepSeekInput } from '@langchain/deepseek';
 export declare function processJsonConfig(llmConfig: ChatDeepSeekInput & BaseChatModelParams): Promise<BaseChatModel>;
-export declare function init(configFileName: string, force?: boolean): void;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/deepseek.js

@@ -1,6 +1,7 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
 import { env } from '#src/utils/systemUtils.js';
 import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
 // Function to process JSON config and create DeepSeek LLM instance
 export async function processJsonConfig(llmConfig) {
     const deepseek = await import('@langchain/deepseek');
@@ -9,21 +10,15 @@ export async function processJsonConfig(llmConfig) {
     return new deepseek.ChatDeepSeek({
         ...llmConfig,
         apiKey: deepseekApiKey,
-        model: llmConfig.model || 'deepseek-v4-pro',
+        model: llmConfig.model || getCuratedFallbackModel('deepseek'),
     });
 }
-const jsonContent = `{
-  "llm": {
-    "type": "deepseek",
-    "model": "deepseek-v4-pro"
-  }
-}`;
-export function init(configFileName, force = false) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeConfigFileWithMessages(configFileName, jsonContent, force);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('deepseek', model), force);
     displayWarning(`You need to update your ${configFileName} to add your DeepSeek API key, ` +
         'or define DEEPSEEK_API_KEY environment variable.');
 }

package/dist/providers/deepseek.js.map

@@ -1 +1 @@
-{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAkD;IAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACrD,yEAAyE;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC;IAChE,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC;QAC/B,GAAG,SAAS;QACZ,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,iBAAiB;KAC5C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK;IACxD,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IAChE,cAAc,CACZ,2BAA2B,cAAc,iCAAiC;QACxE,kDAAkD,CACrD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEnG,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAkD;IAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACrD,yEAAyE;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC;IAChE,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC;QAC/B,GAAG,SAAS;QACZ,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,UAAU,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9F,cAAc,CACZ,2BAA2B,cAAc,iCAAiC;QACxE,kDAAkD,CACrD,CAAC;AACJ,CAAC"}

package/dist/providers/google-genai.d.ts

@@ -4,4 +4,4 @@ export declare function processJsonConfig(llmConfig: ChatGoogleParams & {
     type?: string;
     apiKeyEnvironmentVariable?: string;
 }): Promise<BaseChatModel>;
-export declare function init(configFileName: string, force?: boolean): void;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/google-genai.js

@@ -1,6 +1,7 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
 import { env } from '#src/utils/systemUtils.js';
 import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
 // Function to process JSON config and create Google GenAI LLM instance
 export async function processJsonConfig(llmConfig) {
     const { ChatGoogle } = await import('@langchain/google/node');
@@ -9,25 +10,19 @@ export async function processJsonConfig(llmConfig) {
     const configFields = {
         ...llmConfig,
         apiKey: googleApiKey,
-        model: llmConfig.model || 'gemini-3.5-flash',
+        model: llmConfig.model || getCuratedFallbackModel('google-genai'),
         platformType: 'gai',
     };
     delete configFields.type;
     delete configFields.apiKeyEnvironmentVariable;
     return new ChatGoogle(configFields);
 }
-const jsonContent = `{
-  "llm": {
-    "type": "google-genai",
-    "model": "gemini-3.5-flash"
-  }
-}`;
-export function init(configFileName, force = false) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeConfigFileWithMessages(configFileName, jsonContent, force);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('google-genai', model), force);
     displayWarning(`You need to update your ${configFileName} to add your Google GenAI API key, ` +
         'or define GOOGLE_API_KEY environment variable.');
 }

package/dist/providers/google-genai.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-genai.js","sourceRoot":"","sources":["../../src/providers/google-genai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAmF;IAEnF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC9D,wEAAwE;IACxE,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC;IAC5D,MAAM,YAAY,GAAG;QACnB,GAAG,SAAS;QACZ,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,kBAAkB;QAC5C,YAAY,EAAE,KAAc;KAC7B,CAAC;IACF,OAAO,YAAY,CAAC,IAAI,CAAC;IACzB,OAAO,YAAY,CAAC,yBAAyB,CAAC;IAC9C,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK;IACxD,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IAChE,cAAc,CACZ,2BAA2B,cAAc,qCAAqC;QAC5E,gDAAgD,CACnD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"google-genai.js","sourceRoot":"","sources":["../../src/providers/google-genai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEnG,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAmF;IAEnF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC9D,wEAAwE;IACxE,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC;IAC5D,MAAM,YAAY,GAAG;QACnB,GAAG,SAAS;QACZ,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,cAAc,CAAC;QACjE,YAAY,EAAE,KAAc;KAC7B,CAAC;IACF,OAAO,YAAY,CAAC,IAAI,CAAC;IACzB,OAAO,YAAY,CAAC,yBAAyB,CAAC;IAC9C,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAClG,cAAc,CACZ,2BAA2B,cAAc,qCAAqC;QAC5E,gDAAgD,CACnD,CAAC;AACJ,CAAC"}

package/dist/providers/groq.d.ts

@@ -1,4 +1,4 @@
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { ChatGroqInput } from '@langchain/groq';
 export declare function processJsonConfig(llmConfig: ChatGroqInput): Promise<BaseChatModel>;
-export declare function init(configFileName: string, force?: boolean): void;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/groq.js

@@ -1,6 +1,7 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
 import { env } from '#src/utils/systemUtils.js';
 import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
 // Function to process JSON config and create Groq LLM instance
 export async function processJsonConfig(llmConfig) {
     const groq = await import('@langchain/groq');
@@ -9,21 +10,15 @@ export async function processJsonConfig(llmConfig) {
     return new groq.ChatGroq({
         ...llmConfig,
         apiKey: groqApiKey,
-        model: llmConfig.model || 'openai/gpt-oss-120b',
+        model: llmConfig.model || getCuratedFallbackModel('groq'),
     });
 }
-const jsonContent = `{
-  "llm": {
-    "type": "groq",
-    "model": "openai/gpt-oss-120b"
-  }
-}`;
-export function init(configFileName, force = false) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeConfigFileWithMessages(configFileName, jsonContent, force);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('groq', model), force);
     displayWarning(`You need to edit your ${configFileName} to configure model, ` +
         'or define GROQ_API_KEY environment variable.');
 }

package/dist/providers/groq.js.map

@@ -1 +1 @@
-{"version":3,"file":"groq.js","sourceRoot":"","sources":["../../src/providers/groq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAwB;IAC9D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7C,wEAAwE;IACxE,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC;IACxD,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QACvB,GAAG,SAAS;QACZ,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,qBAAqB;KAChD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK;IACxD,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IAChE,cAAc,CACZ,yBAAyB,cAAc,uBAAuB;QAC5D,8CAA8C,CACjD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"groq.js","sourceRoot":"","sources":["../../src/providers/groq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEnG,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAwB;IAC9D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7C,wEAAwE;IACxE,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC;IACxD,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QACvB,GAAG,SAAS;QACZ,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,MAAM,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1F,cAAc,CACZ,yBAAyB,cAAc,uBAAuB;QAC5D,8CAA8C,CACjD,CAAC;AACJ,CAAC"}