@snoglobe/helios 0.3.6 → 0.4.1

package/dist/metrics/store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.d.ts","sourceRoot":"","sources":["../../src/metrics/store.test.ts"],"names":[],"mappings":""}

package/dist/metrics/store.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { createTestDb } from "../__tests__/db-helper.js";
+const mockDb = { current: createTestDb() };
+vi.mock("../store/database.js", () => {
+    const getDb = () => mockDb.current;
+    class StmtCache {
+        cache = new Map();
+        stmt(sql) {
+            let s = this.cache.get(sql);
+            if (!s) {
+                s = getDb().prepare(sql);
+                this.cache.set(sql, s);
+            }
+            return s;
+        }
+    }
+    return { getDb, StmtCache, getHeliosDir: () => "/tmp/helios-test" };
+});
+const { MetricStore } = await import("./store.js");
+describe("MetricStore", () => {
+    beforeEach(() => {
+        mockDb.current = createTestDb();
+    });
+    it("inserts and retrieves a metric", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", {
+            metricName: "loss",
+            value: 0.5,
+            timestamp: 1000,
+        });
+        const latest = store.getLatest("task1", "loss");
+        expect(latest).not.toBeNull();
+        expect(latest.value).toBe(0.5);
+    });
+    it("returns null for missing metric", () => {
+        const store = new MetricStore("agent1");
+        expect(store.getLatest("task1", "nonexistent")).toBeNull();
+    });
+    it("getLatest returns most recent value", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 1.0, timestamp: 1000 });
+        store.insert("task1", "local", { metricName: "loss", value: 0.5, timestamp: 2000 });
+        store.insert("task1", "local", { metricName: "loss", value: 0.3, timestamp: 3000 });
+        const latest = store.getLatest("task1", "loss");
+        expect(latest.value).toBe(0.3);
+    });
+    it("getSeries returns points in chronological order", () => {
+        const store = new MetricStore("agent1");
+        for (let i = 0; i < 5; i++) {
+            store.insert("task1", "local", { metricName: "loss", value: 5 - i, timestamp: 1000 + i * 100 });
+        }
+        const series = store.getSeries("task1", "loss");
+        expect(series).toHaveLength(5);
+        expect(series[0].value).toBe(5); // earliest
+        expect(series[4].value).toBe(1); // latest
+    });
+    it("getSeries respects limit", () => {
+        const store = new MetricStore("agent1");
+        for (let i = 0; i < 10; i++) {
+            store.insert("task1", "local", { metricName: "loss", value: i, timestamp: 1000 + i });
+        }
+        const series = store.getSeries("task1", "loss", 3);
+        expect(series).toHaveLength(3);
+        // Should be the most recent 3, in ASC order
+        expect(series[0].value).toBe(7);
+        expect(series[2].value).toBe(9);
+    });
+    it("insertBatch inserts all points atomically", () => {
+        const store = new MetricStore("agent1");
+        const points = Array.from({ length: 100 }, (_, i) => ({
+            metricName: "loss",
+            value: Math.random(),
+            timestamp: 1000 + i,
+        }));
+        store.insertBatch("task1", "local", points);
+        const series = store.getSeries("task1", "loss", 200);
+        expect(series).toHaveLength(100);
+    });
+    it("getMetricNames lists distinct names", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 1, timestamp: 1000 });
+        store.insert("task1", "local", { metricName: "acc", value: 0.9, timestamp: 1000 });
+        store.insert("task1", "local", { metricName: "loss", value: 0.5, timestamp: 2000 });
+        const names = store.getMetricNames("task1");
+        expect(names.sort()).toEqual(["acc", "loss"]);
+    });
+    it("getLatestAll returns latest value per metric", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 1.0, timestamp: 1000 });
+        store.insert("task1", "local", { metricName: "loss", value: 0.5, timestamp: 2000 });
+        store.insert("task1", "local", { metricName: "acc", value: 0.95, timestamp: 2000 });
+        const all = store.getLatestAll("task1");
+        expect(all.loss).toBe(0.5);
+        expect(all.acc).toBe(0.95);
+    });
+    it("isolates by agentId", () => {
+        const store1 = new MetricStore("agent1");
+        const store2 = new MetricStore("agent2");
+        store1.insert("task1", "local", { metricName: "loss", value: 1, timestamp: 1000 });
+        expect(store2.getLatest("task1", "loss")).toBeNull();
+    });
+    it("clearTask removes task metrics", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 1, timestamp: 1000 });
+        store.insert("task2", "local", { metricName: "loss", value: 2, timestamp: 1000 });
+        store.clearTask("task1");
+        expect(store.getLatest("task1", "loss")).toBeNull();
+        expect(store.getLatest("task2", "loss")).not.toBeNull();
+    });
+    it("clear removes all agent metrics", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 1, timestamp: 1000 });
+        store.insert("task2", "local", { metricName: "acc", value: 0.9, timestamp: 1000 });
+        const removed = store.clear();
+        expect(removed).toBe(2);
+        expect(store.getMetricNames("task1")).toEqual([]);
+    });
+    it("getAllSeries groups by metric name", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 1, timestamp: 1000 });
+        store.insert("task1", "local", { metricName: "loss", value: 0.5, timestamp: 2000 });
+        store.insert("task1", "local", { metricName: "acc", value: 0.9, timestamp: 1000 });
+        const all = store.getAllSeries(50);
+        expect(all.get("loss")).toEqual([1, 0.5]);
+        expect(all.get("acc")).toEqual([0.9]);
+    });
+    it("getTaskSummary returns min/max/latest/count", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 3, timestamp: 1000 });
+        store.insert("task1", "local", { metricName: "loss", value: 1, timestamp: 2000 });
+        store.insert("task1", "local", { metricName: "loss", value: 2, timestamp: 3000 });
+        const summary = store.getTaskSummary("task1");
+        expect(summary.loss).toMatchObject({
+            latest: 2,
+            min: 1,
+            max: 3,
+            count: 3,
+        });
+    });
+    it("getLatestPerMetric aggregates across tasks", () => {
+        const store = new MetricStore("agent1");
+        store.insert("task1", "local", { metricName: "loss", value: 0.5, timestamp: 1000 });
+        store.insert("task2", "local", { metricName: "loss", value: 0.3, timestamp: 2000 });
+        const latest = store.getLatestPerMetric();
+        expect(latest.loss).toBe(0.3);
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/dist/metrics/store.test.js.map

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

package/dist/paths.js

@@ -1,6 +1,6 @@
 import { join } from "node:path";
 import { homedir } from "node:os";
-import { mkdirSync, appendFileSync } from "node:fs";
+import { mkdirSync, openSync, writeSync } from "node:fs";
 /** Root config/data directory. Override with HELIOS_HOME env var. */
 export const HELIOS_DIR = process.env.HELIOS_HOME ?? join(homedir(), ".helios");
 /** Get the agent ID from environment. */
@@ -13,19 +13,19 @@ export const WEB_SEARCH_TOOL = "web_search";
 export function isDebug() {
     return process.env.HELIOS_DEBUG === "1";
 }
-let debugLogPath = null;
+let debugLogFd = null;
 /** Log a debug message to ~/.helios/debug.log (only when debug mode is enabled). */
 export function debugLog(label, ...args) {
     if (!isDebug())
         return;
     try {
-        if (!debugLogPath) {
+        if (debugLogFd === null) {
             mkdirSync(HELIOS_DIR, { recursive: true });
-            debugLogPath = join(HELIOS_DIR, "debug.log");
+            debugLogFd = openSync(join(HELIOS_DIR, "debug.log"), "a");
         }
         const timestamp = new Date().toISOString().slice(11, 23);
         const line = `[${timestamp}] [${label}] ${args.map(a => typeof a === "string" ? a : JSON.stringify(a)).join(" ")}\n`;
-        appendFileSync(debugLogPath, line);
+        writeSync(debugLogFd, line);
     }
     catch {
         // Don't let debug logging crash the app

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEpD,qEAAqE;AACrE,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAEhF,yCAAyC;AACzC,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,UAAU,OAAO;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,CAAC;AAC1C,CAAC;AAED,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,oFAAoF;AACpF,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,GAAG,IAAe;IACxD,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO;IACvB,IAAI,CAAC;QACH,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,SAAS,MAAM,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QACrH,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;AACH,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,qEAAqE;AACrE,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAEhF,yCAAyC;AACzC,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,UAAU,OAAO;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,CAAC;AAC1C,CAAC;AAED,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,oFAAoF;AACpF,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,GAAG,IAAe;IACxD,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO;IACvB,IAAI,CAAC;QACH,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,SAAS,MAAM,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QACrH,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;AACH,CAAC"}

package/dist/providers/auth/auth-manager.d.ts

@@ -2,6 +2,7 @@ import { TokenStore } from "./token-store.js";
 import type { AuthCredentials } from "../types.js";
 export declare class AuthManager {
     readonly tokenStore: TokenStore;
+    private refreshPromises;
     private refreshHandlers;
     constructor();
     /**

package/dist/providers/auth/auth-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../../src/providers/auth/auth-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,aAAa,CAAC;AAE/D,qBAAa,WAAW;IACtB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,OAAO,CAAC,eAAe,CAOnB;;IAMJ;;;OAGG;IACH,sBAAsB,CACpB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7B,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,GACD,IAAI;IAID,cAAc,CAClB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAC5B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgB5B,SAAS,CACb,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAQV,cAAc,CAClB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAUhB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO;YASzC,OAAO;CA0BtB"}
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../../src/providers/auth/auth-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,aAAa,CAAC;AAE/D,qBAAa,WAAW;IACtB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,eAAe,CAOnB;;IAMJ;;;OAGG;IACH,sBAAsB,CACpB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7B,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,GACD,IAAI;IAID,cAAc,CAClB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAC5B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAyB5B,SAAS,CACb,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAQV,cAAc,CAClB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAUhB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO;YASzC,OAAO;CA0BtB"}

package/dist/providers/auth/auth-manager.js

@@ -1,6 +1,7 @@
 import { TokenStore } from "./token-store.js";
 export class AuthManager {
     tokenStore;
+    refreshPromises = new Map();
     refreshHandlers = new Map();
     constructor() {
         this.tokenStore = new TokenStore();
@@ -20,7 +21,13 @@ export class AuthManager {
         if (creds.method === "oauth" &&
             this.tokenStore.needsRefresh(provider) &&
             creds.refreshToken) {
-            return this.refresh(provider, creds);
+            // Deduplicate concurrent refresh attempts per provider
+            if (!this.refreshPromises.has(provider)) {
+                this.refreshPromises.set(provider, this.refresh(provider, creds).finally(() => {
+                    this.refreshPromises.delete(provider);
+                }));
+            }
+            return this.refreshPromises.get(provider);
         }
         return creds;
     }

package/dist/providers/auth/auth-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth-manager.js","sourceRoot":"","sources":["../../../src/providers/auth/auth-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,OAAO,WAAW;IACb,UAAU,CAAa;IACxB,eAAe,GAAG,IAAI,GAAG,EAO9B,CAAC;IAEJ;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,sBAAsB,CACpB,QAA6B,EAC7B,OAIE;QAEF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,QAA6B;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,wCAAwC;QACxC,IACE,KAAK,CAAC,MAAM,KAAK,OAAO;YACxB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC;YACtC,KAAK,CAAC,YAAY,EAClB,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAS,CACb,QAA6B,EAC7B,MAAc;QAEd,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE;YAC5B,MAAM,EAAE,SAAS;YACjB,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,QAA6B,EAC7B,WAAmB,EACnB,YAAoB,EACpB,SAAiB;QAEjB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE;YAC5B,MAAM,EAAE,OAAO;YACf,QAAQ;YACR,WAAW;YACX,YAAY;YACZ,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,QAA6B;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QACtD,sDAAsD;QACtD,2CAA2C;QAC3C,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,QAA6B,EAC7B,KAAsB;QAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACpC,+DAA+D;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACjD,MAAM,OAAO,GAAoB;gBAC/B,MAAM,EAAE,OAAO;gBACf,QAAQ;gBACR,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACvC,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"auth-manager.js","sourceRoot":"","sources":["../../../src/providers/auth/auth-manager.ts"],"names":[],"mappings":"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"}

package/dist/providers/auth/auth-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth-manager.test.d.ts.map

package/dist/providers/auth/auth-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.test.d.ts","sourceRoot":"","sources":["../../../src/providers/auth/auth-manager.test.ts"],"names":[],"mappings":""}

package/dist/providers/auth/auth-manager.test.js

@@ -0,0 +1,364 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// ---------------------------------------------------------------------------
+// Mock TokenStore — avoid filesystem access
+// ---------------------------------------------------------------------------
+function createMockTokenStore() {
+    const store = new Map();
+    return {
+        get: vi.fn((provider) => store.get(provider) ?? null),
+        set: vi.fn((provider, creds) => store.set(provider, creds)),
+        clear: vi.fn((provider) => store.delete(provider)),
+        isExpired: vi.fn().mockReturnValue(false),
+        needsRefresh: vi.fn().mockReturnValue(false),
+        _store: store, // escape hatch for assertions
+    };
+}
+let latestMockTokenStore;
+vi.mock("./token-store.js", () => ({
+    TokenStore: class {
+        constructor() {
+            latestMockTokenStore = createMockTokenStore();
+            Object.assign(this, latestMockTokenStore);
+        }
+    },
+}));
+const { AuthManager } = await import("./auth-manager.js");
+describe("AuthManager", () => {
+    let manager;
+    let tokenStore;
+    beforeEach(() => {
+        manager = new AuthManager();
+        tokenStore = latestMockTokenStore;
+    });
+    // -----------------------------------------------------------------------
+    // getCredentials
+    // -----------------------------------------------------------------------
+    describe("getCredentials", () => {
+        it("returns null when no creds stored", async () => {
+            const creds = await manager.getCredentials("claude");
+            expect(creds).toBeNull();
+        });
+        it("returns stored API key", async () => {
+            const apiCreds = {
+                method: "api_key",
+                provider: "claude",
+                apiKey: "sk-ant-test123",
+            };
+            tokenStore.set("claude", apiCreds);
+            const creds = await manager.getCredentials("claude");
+            expect(creds).toEqual(apiCreds);
+        });
+        it("returns stored OAuth tokens", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "openai",
+                accessToken: "access-123",
+                refreshToken: "refresh-456",
+                expiresAt: Date.now() + 3600_000,
+            };
+            tokenStore.set("openai", oauthCreds);
+            const creds = await manager.getCredentials("openai");
+            expect(creds).toEqual(oauthCreds);
+        });
+        it("auto-refreshes when needsRefresh returns true", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "old-access",
+                refreshToken: "refresh-abc",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("claude", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            const refreshedTokens = {
+                accessToken: "new-access",
+                refreshToken: "new-refresh",
+                expiresAt: Date.now() + 3600_000,
+            };
+            manager.registerRefreshHandler("claude", vi.fn().mockResolvedValue(refreshedTokens));
+            const creds = await manager.getCredentials("claude");
+            expect(creds.accessToken).toBe("new-access");
+            expect(creds.refreshToken).toBe("new-refresh");
+        });
+        it("deduplicates concurrent refresh calls", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "old",
+                refreshToken: "refresh-tok",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("claude", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            let resolveRefresh;
+            const handler = vi.fn(() => new Promise((resolve) => {
+                resolveRefresh = resolve;
+            }));
+            manager.registerRefreshHandler("claude", handler);
+            // Fire two concurrent getCredentials calls
+            const p1 = manager.getCredentials("claude");
+            const p2 = manager.getCredentials("claude");
+            resolveRefresh({
+                accessToken: "refreshed",
+                refreshToken: "new-rt",
+                expiresAt: Date.now() + 3600_000,
+            });
+            const [c1, c2] = await Promise.all([p1, p2]);
+            // Handler should only be called once
+            expect(handler).toHaveBeenCalledTimes(1);
+            expect(c1.accessToken).toBe("refreshed");
+            expect(c2.accessToken).toBe("refreshed");
+        });
+        it("deduplication clears after completion", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "old",
+                refreshToken: "rt",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("claude", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            const handler = vi.fn().mockResolvedValue({
+                accessToken: "new1",
+                refreshToken: "rt1",
+                expiresAt: Date.now() + 3600_000,
+            });
+            manager.registerRefreshHandler("claude", handler);
+            await manager.getCredentials("claude");
+            expect(handler).toHaveBeenCalledTimes(1);
+            // Second call after first completes should trigger refresh again
+            handler.mockResolvedValue({
+                accessToken: "new2",
+                refreshToken: "rt2",
+                expiresAt: Date.now() + 3600_000,
+            });
+            await manager.getCredentials("claude");
+            expect(handler).toHaveBeenCalledTimes(2);
+        });
+        it("returns stale creds if no refresh handler registered", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "stale",
+                refreshToken: "rt",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("claude", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            // No handler registered
+            const creds = await manager.getCredentials("claude");
+            expect(creds.accessToken).toBe("stale");
+        });
+        it("returns stale creds if refresh fails", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "stale-token",
+                refreshToken: "rt",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("claude", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            manager.registerRefreshHandler("claude", vi.fn().mockRejectedValue(new Error("refresh failed")));
+            const creds = await manager.getCredentials("claude");
+            expect(creds.accessToken).toBe("stale-token");
+        });
+    });
+    // -----------------------------------------------------------------------
+    // setApiKey
+    // -----------------------------------------------------------------------
+    describe("setApiKey", () => {
+        it("stores API key credentials", async () => {
+            await manager.setApiKey("claude", "sk-ant-key-123");
+            expect(tokenStore.set).toHaveBeenCalledWith("claude", {
+                method: "api_key",
+                provider: "claude",
+                apiKey: "sk-ant-key-123",
+            });
+        });
+        it("stores for openai provider", async () => {
+            await manager.setApiKey("openai", "sk-openai-key");
+            expect(tokenStore.set).toHaveBeenCalledWith("openai", {
+                method: "api_key",
+                provider: "openai",
+                apiKey: "sk-openai-key",
+            });
+        });
+    });
+    // -----------------------------------------------------------------------
+    // setOAuthTokens
+    // -----------------------------------------------------------------------
+    describe("setOAuthTokens", () => {
+        it("stores OAuth credentials", async () => {
+            const expiresAt = Date.now() + 3600_000;
+            await manager.setOAuthTokens("claude", "access-tok", "refresh-tok", expiresAt);
+            expect(tokenStore.set).toHaveBeenCalledWith("claude", {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "access-tok",
+                refreshToken: "refresh-tok",
+                expiresAt,
+            });
+        });
+    });
+    // -----------------------------------------------------------------------
+    // isAuthenticated
+    // -----------------------------------------------------------------------
+    describe("isAuthenticated", () => {
+        it("returns false when no creds", () => {
+            expect(manager.isAuthenticated("claude")).toBe(false);
+        });
+        it("returns true with API key", () => {
+            tokenStore.set("claude", {
+                method: "api_key",
+                provider: "claude",
+                apiKey: "sk-ant-test",
+            });
+            expect(manager.isAuthenticated("claude")).toBe(true);
+        });
+        it("returns true with access token", () => {
+            tokenStore.set("openai", {
+                method: "oauth",
+                provider: "openai",
+                accessToken: "access-tok",
+                refreshToken: "rt",
+                expiresAt: Date.now() + 3600_000,
+            });
+            expect(manager.isAuthenticated("openai")).toBe(true);
+        });
+        it("returns true with only refresh token (can try refresh)", () => {
+            tokenStore.set("claude", {
+                method: "oauth",
+                provider: "claude",
+                refreshToken: "refresh-only",
+                expiresAt: Date.now() - 1000,
+            });
+            expect(manager.isAuthenticated("claude")).toBe(true);
+        });
+        it("returns false for API key with empty string", () => {
+            tokenStore.set("claude", {
+                method: "api_key",
+                provider: "claude",
+                apiKey: "",
+            });
+            expect(manager.isAuthenticated("claude")).toBe(false);
+        });
+    });
+    // -----------------------------------------------------------------------
+    // registerRefreshHandler + refresh
+    // -----------------------------------------------------------------------
+    describe("registerRefreshHandler / refresh", () => {
+        it("stores handler", () => {
+            const handler = vi.fn();
+            manager.registerRefreshHandler("claude", handler);
+            // No direct getter, but we can trigger it via getCredentials
+            // Just verify no error occurs
+            expect(() => manager.registerRefreshHandler("openai", vi.fn())).not.toThrow();
+        });
+        it("calls registered handler on refresh", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "old",
+                refreshToken: "rt-123",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("claude", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            const handler = vi.fn().mockResolvedValue({
+                accessToken: "new-at",
+                refreshToken: "new-rt",
+                expiresAt: Date.now() + 3600_000,
+            });
+            manager.registerRefreshHandler("claude", handler);
+            await manager.getCredentials("claude");
+            expect(handler).toHaveBeenCalledWith("rt-123");
+        });
+        it("updates token store on successful refresh", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "openai",
+                accessToken: "old",
+                refreshToken: "rt-abc",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("openai", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            const newExpires = Date.now() + 7200_000;
+            manager.registerRefreshHandler("openai", vi.fn().mockResolvedValue({
+                accessToken: "fresh-at",
+                refreshToken: "fresh-rt",
+                expiresAt: newExpires,
+            }));
+            await manager.getCredentials("openai");
+            // tokenStore.set should have been called with the new creds
+            expect(tokenStore.set).toHaveBeenCalledWith("openai", {
+                method: "oauth",
+                provider: "openai",
+                accessToken: "fresh-at",
+                refreshToken: "fresh-rt",
+                expiresAt: newExpires,
+            });
+        });
+        it("returns stale creds on refresh failure", async () => {
+            const oauthCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "will-be-stale",
+                refreshToken: "rt",
+                expiresAt: Date.now() - 1000,
+            };
+            tokenStore.set("claude", oauthCreds);
+            tokenStore.needsRefresh.mockReturnValue(true);
+            manager.registerRefreshHandler("claude", vi.fn().mockRejectedValue(new Error("network error")));
+            const creds = await manager.getCredentials("claude");
+            expect(creds.accessToken).toBe("will-be-stale");
+        });
+    });
+    // -----------------------------------------------------------------------
+    // Multiple providers isolated
+    // -----------------------------------------------------------------------
+    describe("multiple providers", () => {
+        it("claude and openai credentials are isolated", async () => {
+            await manager.setApiKey("claude", "sk-claude");
+            await manager.setOAuthTokens("openai", "at-openai", "rt-openai", Date.now() + 3600_000);
+            const claudeCreds = await manager.getCredentials("claude");
+            const openaiCreds = await manager.getCredentials("openai");
+            expect(claudeCreds.apiKey).toBe("sk-claude");
+            expect(claudeCreds.method).toBe("api_key");
+            expect(openaiCreds.accessToken).toBe("at-openai");
+            expect(openaiCreds.method).toBe("oauth");
+        });
+        it("refreshing one provider does not affect the other", async () => {
+            const claudeCreds = {
+                method: "oauth",
+                provider: "claude",
+                accessToken: "claude-old",
+                refreshToken: "claude-rt",
+                expiresAt: Date.now() - 1000,
+            };
+            const openaiCreds = {
+                method: "oauth",
+                provider: "openai",
+                accessToken: "openai-stable",
+                refreshToken: "openai-rt",
+                expiresAt: Date.now() + 3600_000,
+            };
+            tokenStore.set("claude", claudeCreds);
+            tokenStore.set("openai", openaiCreds);
+            // Only claude needs refresh
+            tokenStore.needsRefresh.mockImplementation((provider) => provider === "claude");
+            manager.registerRefreshHandler("claude", vi.fn().mockResolvedValue({
+                accessToken: "claude-new",
+                refreshToken: "claude-rt-new",
+                expiresAt: Date.now() + 3600_000,
+            }));
+            const c = await manager.getCredentials("claude");
+            const o = await manager.getCredentials("openai");
+            expect(c.accessToken).toBe("claude-new");
+            expect(o.accessToken).toBe("openai-stable");
+        });
+    });
+});
+//# sourceMappingURL=auth-manager.test.js.map