@mragentix/cli 4.2.37

package/dist/core/auth-storage.d.ts

@@ -0,0 +1,35 @@
+import type { OAuthCredentials } from "./oauth/types.js";
+export declare class AuthStorage {
+    private data;
+    private filePath;
+    private loaded;
+    /** Per-provider lock to serialize concurrent refresh calls. */
+    private refreshLocks;
+    constructor(filePath?: string);
+    load(): Promise<void>;
+    private ensureLoaded;
+    getCredentials(provider: string): Promise<OAuthCredentials | undefined>;
+    setCredentials(provider: string, creds: OAuthCredentials): Promise<void>;
+    clearCredentials(provider: string): Promise<void>;
+    clearAll(): Promise<void>;
+    /**
+     * Returns valid credentials, auto-refreshing if expired.
+     * If `forceRefresh` is true, refreshes even if the token hasn't expired
+     * (useful when the provider rejects a token with 401 before its stored expiry).
+     * Throws if not logged in.
+     */
+    resolveCredentials(provider: string, opts?: {
+        forceRefresh?: boolean;
+    }): Promise<OAuthCredentials>;
+    /**
+     * Returns a valid access token, auto-refreshing if expired.
+     * Throws if not logged in.
+     */
+    resolveToken(provider: string): Promise<string>;
+    private save;
+}
+export declare class NotLoggedInError extends Error {
+    provider: string;
+    constructor(provider: string);
+}
+//# sourceMappingURL=auth-storage.d.ts.map

package/dist/core/auth-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-storage.d.ts","sourceRoot":"","sources":["../../src/core/auth-storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAOzD,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,+DAA+D;IAC/D,OAAO,CAAC,YAAY,CAAgD;gBAExD,QAAQ,CAAC,EAAE,MAAM;IAIvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAYb,YAAY;IAIpB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAKvE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;;;;OAKG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAChC,OAAO,CAAC,gBAAgB,CAAC;IAuD5B;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAKvC,IAAI;CAKnB;AAiBD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,EAAE,MAAM,CAAC;gBACL,QAAQ,EAAE,MAAM;CAK7B"}

package/dist/core/auth-storage.js

@@ -0,0 +1,144 @@
+import fs from "node:fs/promises";
+import crypto from "node:crypto";
+import { getAppPaths } from "../config.js";
+import { refreshAnthropicToken } from "./oauth/anthropic.js";
+import { refreshOpenAIToken } from "./oauth/openai.js";
+import { withFileLock } from "./file-lock.js";
+export class AuthStorage {
+    data = {};
+    filePath;
+    loaded = false;
+    /** Per-provider lock to serialize concurrent refresh calls. */
+    refreshLocks = new Map();
+    constructor(filePath) {
+        this.filePath = filePath ?? getAppPaths().authFile;
+    }
+    async load() {
+        await withFileLock(this.filePath, async () => {
+            try {
+                const content = await fs.readFile(this.filePath, "utf-8");
+                this.data = JSON.parse(content);
+            }
+            catch {
+                this.data = {};
+            }
+        });
+        this.loaded = true;
+    }
+    async ensureLoaded() {
+        if (!this.loaded)
+            await this.load();
+    }
+    async getCredentials(provider) {
+        await this.ensureLoaded();
+        return this.data[provider];
+    }
+    async setCredentials(provider, creds) {
+        await this.ensureLoaded();
+        this.data[provider] = creds;
+        await this.save();
+    }
+    async clearCredentials(provider) {
+        await this.ensureLoaded();
+        delete this.data[provider];
+        await this.save();
+    }
+    async clearAll() {
+        this.data = {};
+        await this.save();
+    }
+    /**
+     * Returns valid credentials, auto-refreshing if expired.
+     * If `forceRefresh` is true, refreshes even if the token hasn't expired
+     * (useful when the provider rejects a token with 401 before its stored expiry).
+     * Throws if not logged in.
+     */
+    async resolveCredentials(provider, opts) {
+        await this.ensureLoaded();
+        const creds = this.data[provider];
+        if (!creds) {
+            throw new NotLoggedInError(provider);
+        }
+        // GLM and Moonshot use static API keys — no refresh needed
+        if (provider === "glm" || provider === "moonshot") {
+            return creds;
+        }
+        // Return if not expired and not force-refreshing
+        if (!opts?.forceRefresh && Date.now() < creds.expiresAt) {
+            return creds;
+        }
+        // Serialize concurrent refresh calls per provider to avoid races
+        const existing = this.refreshLocks.get(provider);
+        if (existing)
+            return existing;
+        const refreshPromise = withFileLock(this.filePath, async () => {
+            // Re-read from disk in case another process refreshed while we waited for the lock
+            try {
+                const content = await fs.readFile(this.filePath, "utf-8");
+                const freshData = JSON.parse(content);
+                const freshCreds = freshData[provider];
+                if (freshCreds && !opts?.forceRefresh && Date.now() < freshCreds.expiresAt) {
+                    // Another process already refreshed — use their token
+                    this.data[provider] = freshCreds;
+                    return freshCreds;
+                }
+            }
+            catch {
+                // Fall through to refresh
+            }
+            const refreshFn = provider === "anthropic" ? refreshAnthropicToken : refreshOpenAIToken;
+            const refreshed = await refreshFn(creds.refreshToken);
+            if (!refreshed.accountId && creds.accountId) {
+                refreshed.accountId = creds.accountId;
+            }
+            this.data[provider] = refreshed;
+            // Write atomically (we already hold the file lock)
+            await atomicWriteFile(this.filePath, JSON.stringify(this.data, null, 2));
+            return refreshed;
+        });
+        this.refreshLocks.set(provider, refreshPromise);
+        try {
+            return await refreshPromise;
+        }
+        finally {
+            this.refreshLocks.delete(provider);
+        }
+    }
+    /**
+     * Returns a valid access token, auto-refreshing if expired.
+     * Throws if not logged in.
+     */
+    async resolveToken(provider) {
+        const creds = await this.resolveCredentials(provider);
+        return creds.accessToken;
+    }
+    async save() {
+        await withFileLock(this.filePath, async () => {
+            await atomicWriteFile(this.filePath, JSON.stringify(this.data, null, 2));
+        });
+    }
+}
+/**
+ * Atomic file write using temp file + rename pattern.
+ * Prevents partial/corrupt data if the process crashes mid-write.
+ */
+async function atomicWriteFile(filePath, content) {
+    const tmpPath = `${filePath}.${process.pid}.${Date.now()}.${crypto.randomUUID().slice(0, 8)}.tmp`;
+    try {
+        await fs.writeFile(tmpPath, content, { encoding: "utf-8", mode: 0o600 });
+        await fs.rename(tmpPath, filePath);
+    }
+    catch (err) {
+        await fs.unlink(tmpPath).catch(() => { });
+        throw err;
+    }
+}
+export class NotLoggedInError extends Error {
+    provider;
+    constructor(provider) {
+        super(`Not logged in to ${provider}. Run "mragentix login" to authenticate.`);
+        this.name = "NotLoggedInError";
+        this.provider = provider;
+    }
+}
+//# sourceMappingURL=auth-storage.js.map

package/dist/core/auth-storage.js.map

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

package/dist/core/auto-update.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Check for updates and silently auto-update if a newer version is available.
+ * Called at CLI startup. Non-blocking on failure — the CLI always proceeds.
+ *
+ * Returns a message to display if an update happened, or null.
+ */
+export declare function checkAndAutoUpdate(currentVersion: string): string | null;
+//# sourceMappingURL=auto-update.d.ts.map

package/dist/core/auto-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../../src/core/auto-update.ts"],"names":[],"mappings":"AAsIA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BxE"}

package/dist/core/auto-update.js

@@ -0,0 +1,152 @@
+import { execSync, spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+const PACKAGE_NAME = "@mragentix/cli";
+const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+const CHECK_INTERVAL_MS = 4 * 60 * 60 * 1000; // 4 hours
+const FETCH_TIMEOUT_MS = 3000;
+var PackageManager;
+(function (PackageManager) {
+    PackageManager["NPM"] = "npm";
+    PackageManager["PNPM"] = "pnpm";
+    PackageManager["YARN"] = "yarn";
+    PackageManager["UNKNOWN"] = "unknown";
+})(PackageManager || (PackageManager = {}));
+function getStateFilePath() {
+    return path.join(os.homedir(), ".mragentix", "update-state.json");
+}
+function readState() {
+    try {
+        const raw = fs.readFileSync(getStateFilePath(), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function writeState(state) {
+    try {
+        const dir = path.dirname(getStateFilePath());
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(getStateFilePath(), JSON.stringify(state));
+    }
+    catch {
+        // Non-fatal
+    }
+}
+function shouldCheck() {
+    const state = readState();
+    if (!state)
+        return true;
+    return Date.now() - state.lastCheckedAt > CHECK_INTERVAL_MS;
+}
+function compareVersions(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+function detectInstallInfo() {
+    const scriptPath = (process.argv[1] ?? "").replace(/\\/g, "/");
+    // npx — skip (ephemeral)
+    if (scriptPath.includes("/_npx/")) {
+        return { packageManager: PackageManager.UNKNOWN, updateCommand: null };
+    }
+    // pnpm global
+    if (scriptPath.includes("/.pnpm") || scriptPath.includes("/pnpm/global")) {
+        return {
+            packageManager: PackageManager.PNPM,
+            updateCommand: `pnpm add -g ${PACKAGE_NAME}@latest`,
+        };
+    }
+    // yarn global
+    if (scriptPath.includes("/.yarn/") || scriptPath.includes("/yarn/global")) {
+        return {
+            packageManager: PackageManager.YARN,
+            updateCommand: `yarn global add ${PACKAGE_NAME}@latest`,
+        };
+    }
+    // npm global (default)
+    return {
+        packageManager: PackageManager.NPM,
+        updateCommand: `npm install -g ${PACKAGE_NAME}@latest`,
+    };
+}
+function fetchLatestVersionSync() {
+    // Use a child process to fetch from npm registry with timeout
+    // We use node -e to avoid needing fetch in the parent process synchronously
+    try {
+        const script = `
+      const c = new AbortController();
+      const t = setTimeout(() => c.abort(), ${FETCH_TIMEOUT_MS});
+      fetch("${REGISTRY_URL}", { signal: c.signal })
+        .then(r => r.json())
+        .then(d => { clearTimeout(t); process.stdout.write(d.version || ""); })
+        .catch(() => { clearTimeout(t); process.exit(1); });
+    `;
+        const result = spawnSync(process.execPath, ["--input-type=module", "-e", script], {
+            encoding: "utf-8",
+            timeout: FETCH_TIMEOUT_MS + 1000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const version = result.stdout?.trim();
+        return version && /^\d+\.\d+\.\d+/.test(version) ? version : null;
+    }
+    catch {
+        return null;
+    }
+}
+function performUpdate(command) {
+    try {
+        execSync(command, {
+            stdio: "pipe",
+            timeout: 60_000,
+            env: { ...process.env, npm_config_loglevel: "silent" },
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check for updates and silently auto-update if a newer version is available.
+ * Called at CLI startup. Non-blocking on failure — the CLI always proceeds.
+ *
+ * Returns a message to display if an update happened, or null.
+ */
+export function checkAndAutoUpdate(currentVersion) {
+    try {
+        if (!shouldCheck())
+            return null;
+        const latestVersion = fetchLatestVersionSync();
+        // Always record that we checked
+        writeState({
+            lastCheckedAt: Date.now(),
+            lastSeenVersion: latestVersion ?? undefined,
+        });
+        if (!latestVersion)
+            return null;
+        if (compareVersions(latestVersion, currentVersion) <= 0)
+            return null;
+        const info = detectInstallInfo();
+        if (!info.updateCommand)
+            return null;
+        const success = performUpdate(info.updateCommand);
+        if (success) {
+            return `Updated ${PACKAGE_NAME} ${currentVersion} \u2192 ${latestVersion}`;
+        }
+        // Update failed — show manual instructions
+        return `Update available: ${currentVersion} \u2192 ${latestVersion}\nRun: ${info.updateCommand}`;
+    }
+    catch {
+        // Never block CLI startup
+        return null;
+    }
+}
+//# sourceMappingURL=auto-update.js.map

package/dist/core/auto-update.js.map

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

package/dist/core/compaction/compactor.d.ts

@@ -0,0 +1,69 @@
+import { type Message, type Provider, type ContentPart } from "@mragentix/ai";
+export interface CompactionResult {
+    originalCount: number;
+    newCount: number;
+    tokensBeforeEstimate: number;
+    tokensAfterEstimate: number;
+}
+/**
+ * Check if compaction should be triggered.
+ */
+export declare function shouldCompact(messages: Message[], contextWindow: number, threshold?: number): boolean;
+/**
+ * Find the index where recent messages should start, given a token budget.
+ * Walks backward from the end, accumulating token estimates, and returns the
+ * first index that fits within the budget. Never cuts at index 0 (system message).
+ * Avoids splitting tool_call / tool_result pairs.
+ */
+export declare function findRecentCutPoint(messages: Message[], tokenBudget: number): number;
+/**
+ * Prepare conversation messages for the summarizer by truncating large tool
+ * results and stripping thinking blocks. Returns lightweight copies suitable
+ * for a summary LLM call — the originals are not mutated.
+ */
+export declare function prepareMessagesForSummary(msgs: Message[]): Message[];
+/**
+ * Select messages that fit within a token budget for the summary LLM call.
+ * Walks forward from the start, accumulating messages until the budget is
+ * exceeded. Returns the selected subset.
+ */
+export declare function selectMessagesInBudget(msgs: Message[], tokenBudget: number): Message[];
+/**
+ * Build a fallback summary from file operations and message roles when the
+ * LLM summary call fails or returns empty.
+ */
+export declare function buildFallbackSummary(middleMessages: Message[], fileOps: {
+    read: Set<string>;
+    modified: Set<string>;
+}): string;
+/**
+ * Extract summary text from an LLM response.
+ */
+export declare function extractSummaryText(content: string | ContentPart[]): string;
+/**
+ * Compact a conversation by summarizing older messages via LLM.
+ *
+ * Follows the pattern used by Continue and Nao: sends the actual conversation
+ * messages to the summarizer (not a serialized string), bookended by a system
+ * prompt and a "summarize this" user prompt. This lets the LLM see the real
+ * message structure — roles, tool calls, tool results — and produce a much
+ * better summary.
+ *
+ * - Keeps the system message (index 0) intact.
+ * - Keeps the most recent ~20K tokens of conversation intact.
+ * - Summarizes everything in between using an appropriate model.
+ * - Tool results are truncated and thinking blocks stripped in the summary call.
+ * - Messages are token-budgeted to avoid overflowing the summarizer's context.
+ * - Retries on empty responses, falls back to extractive summary if all fail.
+ */
+export declare function compact(messages: Message[], options: {
+    provider: Provider;
+    model: string;
+    apiKey?: string;
+    contextWindow: number;
+    signal?: AbortSignal;
+}): Promise<{
+    messages: Message[];
+    result: CompactionResult;
+}>;
+//# sourceMappingURL=compactor.d.ts.map

package/dist/core/compaction/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/compactor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAC;AAsCvB,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,SAAM,GACd,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA2BnF;AA4CD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAkCpE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAYtF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,OAAO,EAAE,EACzB,OAAO,EAAE;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GACpD,MAAM,CAgCR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,MAAM,CAM1E;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE;IACP,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAkN5D"}