ashtar 1.0.10

package/dist/shared/index.cjs

@@ -0,0 +1,553 @@
+"use strict";
+function loadDotenvCJS() {
+  try {
+    const fs = require("fs");
+    const path = require("path");
+    const seeds = [];
+    if (typeof __dirname !== "undefined") {
+      seeds.push(__dirname);
+    }
+    seeds.push(process.cwd());
+    const candidates = new Set();
+    for (const seed of seeds) {
+      candidates.add(path.resolve(seed, ".env"));
+      candidates.add(path.resolve(seed, "..", ".env"));
+      candidates.add(path.resolve(seed, "..", "..", ".env"));
+      candidates.add(path.resolve(seed, "..", "..", "..", ".env"));
+    }
+    for (const cand of candidates) {
+      if (fs.existsSync(cand)) {
+        const dotenv = require("dotenv");
+        dotenv.config({ path: cand });
+        break;
+      }
+    }
+  } catch (err) {}
+}
+loadDotenvCJS();
+
+function isGeminiKey(key) {
+  if (!key) return false;
+  return key.startsWith("AIzaSy") || key.startsWith("AAQ.");
+}
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// shared/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_MODEL: () => DEFAULT_MODEL,
+  askGroq: () => askGroq,
+  askWithAutoRotate: () => askWithAutoRotate,
+  decryptPoolKey: () => decryptPoolKey,
+  decryptValue: () => decryptValue,
+  encryptPoolKey: () => encryptPoolKey,
+  encryptValue: () => encryptValue,
+  loadPool: () => loadPool,
+  loadUserConfig: () => loadUserConfig,
+  maskKey: () => maskKey,
+  patchUserConfig: () => patchUserConfig,
+  resolveCurrentKey: () => resolveCurrentKey,
+  rotateKey: () => rotateKey,
+  saveUserConfig: () => saveUserConfig
+});
+module.exports = __toCommonJS(index_exports);
+
+// shared/crypto.ts
+var import_node_crypto = require("crypto");
+var ALGO = "aes-256-gcm";
+function machineScopedSecret() {
+  const basis = `${process.platform}|${process.arch}|${process.env.USERNAME ?? process.env.USER ?? "user"}`;
+  return (0, import_node_crypto.createHash)("sha256").update(basis).digest();
+}
+function poolSecret() {
+  const parts = [112, 97, 103, 101, 97, 105, 45, 112, 111, 111, 108, 45, 118, 50];
+  return (0, import_node_crypto.createHash)("sha256").update(Buffer.from(parts)).digest();
+}
+function encryptValue(raw) {
+  const iv = (0, import_node_crypto.randomBytes)(12);
+  const key = machineScopedSecret();
+  const cipher = (0, import_node_crypto.createCipheriv)(ALGO, key, iv);
+  const encrypted = Buffer.concat([cipher.update(raw, "utf8"), cipher.final()]);
+  const tag = cipher.getAuthTag();
+  return Buffer.concat([iv, tag, encrypted]).toString("base64");
+}
+function decryptValue(payload) {
+  const data = Buffer.from(payload, "base64");
+  const iv = data.subarray(0, 12);
+  const tag = data.subarray(12, 28);
+  const encrypted = data.subarray(28);
+  const key = machineScopedSecret();
+  const decipher = (0, import_node_crypto.createDecipheriv)(ALGO, key, iv);
+  decipher.setAuthTag(tag);
+  const result = Buffer.concat([decipher.update(encrypted), decipher.final()]);
+  return result.toString("utf8");
+}
+function encryptPoolKey(raw) {
+  const iv = (0, import_node_crypto.randomBytes)(12);
+  const key = poolSecret();
+  const cipher = (0, import_node_crypto.createCipheriv)(ALGO, key, iv);
+  const encrypted = Buffer.concat([cipher.update(raw, "utf8"), cipher.final()]);
+  const tag = cipher.getAuthTag();
+  return Buffer.concat([iv, tag, encrypted]).toString("base64");
+}
+function decryptPoolKey(payload) {
+  const data = Buffer.from(payload, "base64");
+  const iv = data.subarray(0, 12);
+  const tag = data.subarray(12, 28);
+  const encrypted = data.subarray(28);
+  const key = poolSecret();
+  const decipher = (0, import_node_crypto.createDecipheriv)(ALGO, key, iv);
+  decipher.setAuthTag(tag);
+  const result = Buffer.concat([decipher.update(encrypted), decipher.final()]);
+  return result.toString("utf8");
+}
+
+// shared/storage.ts
+var import_conf = __toESM(require("conf"), 1);
+var conf;
+function getConf() {
+  if (!conf) {
+    conf = new import_conf.default({
+      projectName: "Idlidosa",
+      defaults: {
+        config: {
+          model: "llama-3.3-70b-versatile",
+          autoSummarizeOnLoad: false,
+          theme: "dark",
+          stealth: true
+        }
+      }
+    });
+  }
+  return conf;
+}
+function saveUserConfig(config) {
+  const toSave = { ...config };
+  if (toSave.apiKey) {
+    toSave.apiKey = encryptValue(toSave.apiKey);
+  }
+  getConf().set("config", toSave);
+}
+function loadUserConfig() {
+  const config = getConf().get("config");
+  if (config?.apiKey) {
+    try {
+      return { ...config, apiKey: decryptValue(config.apiKey) };
+    } catch {
+      return { ...config, apiKey: void 0 };
+    }
+  }
+  return config;
+}
+function patchUserConfig(patch) {
+  const current = loadUserConfig();
+  const merged = { ...current, ...patch };
+  saveUserConfig(merged);
+  return merged;
+}
+
+// shared/groq.ts
+var import_groq_sdk = __toESM(require("groq-sdk"), 1);
+
+// shared/keyPool.ts
+var import_node_crypto2 = require("crypto");
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var import_node_machine_id = __toESM(require("node-machine-id"), 1);
+var machineIdSync = import_node_machine_id.default.machineIdSync ?? import_node_machine_id.default.default?.machineIdSync ?? (() => {
+  throw new Error("node-machine-id is unavailable");
+});
+var cachedPool = null;
+function findKeysFile() {
+  const seeds = [];
+  if (typeof __dirname !== "undefined") {
+    seeds.push(__dirname);
+  }
+  seeds.push(process.cwd());
+  const candidates = /* @__PURE__ */ new Set();
+  for (const seed of seeds) {
+    candidates.add((0, import_node_path.resolve)(seed, "shared", "keys.json"));
+    candidates.add((0, import_node_path.resolve)(seed, "..", "shared", "keys.json"));
+    candidates.add((0, import_node_path.resolve)(seed, "..", "..", "shared", "keys.json"));
+    candidates.add((0, import_node_path.resolve)(seed, "..", "..", "..", "shared", "keys.json"));
+    candidates.add((0, import_node_path.resolve)(seed, "keys.json"));
+  }
+  for (const candidate of candidates) {
+    if ((0, import_node_fs.existsSync)(candidate)) return candidate;
+  }
+  return null;
+}
+function loadPool() {
+  if (cachedPool) return cachedPool;
+  const path = findKeysFile();
+  if (!path) {
+    cachedPool = [];
+    return cachedPool;
+  }
+  try {
+    const raw = (0, import_node_fs.readFileSync)(path, "utf8");
+    const parsed = JSON.parse(raw);
+    const isEncrypted = parsed.v === 2;
+    cachedPool = (parsed.keys ?? []).filter((k) => typeof k === "string" && k.length > 0).map((k) => {
+      if (isEncrypted) {
+        try {
+          return decryptPoolKey(k);
+        } catch {
+          return "";
+        }
+      }
+      return k;
+    }).filter((k) => k.length > 0 && !k.startsWith("REPLACE_WITH_"));
+  } catch {
+    cachedPool = [];
+  }
+  return cachedPool;
+}
+function machineSlot(poolSize) {
+  if (poolSize <= 0) return 0;
+  let id = "fallback";
+  try {
+    id = machineIdSync(true);
+  } catch {
+    id = `${process.platform}|${process.arch}|${process.env.USER ?? process.env.USERNAME ?? "user"}`;
+  }
+  const digest = (0, import_node_crypto2.createHash)("sha256").update(id).digest();
+  return digest.readUInt32BE(0) % poolSize;
+}
+function resolveCurrentKey() {
+  const envKey = process.env.GEMINI_API_KEY || process.env.GROQ_API_KEY || process.env.API_KEY;
+  if (envKey && envKey.trim().length > 0) {
+    return {
+      apiKey: envKey.trim(),
+      source: "env-variable",
+      poolSize: 0
+    };
+  }
+  const config = loadUserConfig();
+  const pool = loadPool();
+  if (config.apiKey && config.apiKey.trim().length > 0) {
+    return {
+      apiKey: config.apiKey,
+      source: "user-override",
+      poolSize: pool.length
+    };
+  }
+  if (pool.length === 0) return null;
+  let slot = config.keyPoolSlot;
+  if (typeof slot !== "number" || slot < 0 || slot >= pool.length) {
+    slot = machineSlot(pool.length);
+    patchUserConfig({ keyPoolSlot: slot });
+  }
+  return { apiKey: pool[slot], source: "pool", slot, poolSize: pool.length };
+}
+function rotateKey() {
+  const pool = loadPool();
+  if (pool.length === 0) return null;
+  const config = loadUserConfig();
+  const current = typeof config.keyPoolSlot === "number" ? config.keyPoolSlot : machineSlot(pool.length);
+  const next = (current + 1) % pool.length;
+  patchUserConfig({ keyPoolSlot: next });
+  return { apiKey: pool[next], source: "pool", slot: next, poolSize: pool.length };
+}
+function maskKey(key) {
+  if (!key) return "(none)";
+  if (key.length <= 8) return "********";
+  return `${key.slice(0, 4)}\u2026${key.slice(-4)}`;
+}
+
+// shared/groq.ts
+process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+var DEFAULT_MODEL = "llama-3.3-70b-versatile";
+var ANSWER_MODEL = "llama-3.3-70b-versatile";
+var CODING_MODEL = "deepseek-r1-distill-llama-70b";
+var VISION_PROMPT = [
+  "You are an OCR and screen reader. Extract EVERYTHING visible in this screenshot.",
+  "IMPORTANT RULES:",
+  "- Extract ALL text, questions, code, options, tables, constraints, and input/output examples.",
+  "- Return the EXACT text as it appears. Do not summarize. Do not skip any part.",
+  "- Include question numbers, option letters (A, B, C, D), code snippets, EVERYTHING.",
+  "- If there is code, reproduce it EXACTLY including variable names, operators (*, +, -, /, %, etc.), and formatting.",
+  "- If you see a coding problem, extract the full problem statement, constraints, examples, and any starter code.",
+  "- NEVER say 'no question found' or 'question not provided'. There IS content on screen \u2014 extract it.",
+  "- If the text is partially visible or blurry, do your best to read it. Guess if needed.",
+  "- Output raw extracted text only. No commentary."
+].join("\n");
+var ANSWER_PROMPT = [
+  "You are an expert exam solver. You must provide the CORRECT answer.",
+  "",
+  "OUTPUT FORMAT: Plain text only. No markdown formatting whatsoever.",
+  "- Do NOT wrap text in ** or * for emphasis",
+  "- Do NOT use # for headings or ``` for code blocks",
+  "- Do NOT use bullet markers (-, *, +) for lists",
+  "- You MUST keep the * symbol when it appears in code as multiplication, pointer, or any operator",
+  "- Write code directly without any code fence markers",
+  "",
+  "ANSWERING RULES:",
+  "- For MCQ: State the correct option letter and the answer text. Be precise.",
+  "- For coding problems: Write the COMPLETE working solution. Include ALL operators (*, /, %, +, -, etc.) exactly as needed. Test edge cases mentally.",
+  "- For short answer: Give the precise answer only.",
+  "- For math: Show the final answer with key steps. Use * for multiplication.",
+  "- For fill-in-the-blank: Give the exact word or phrase.",
+  "- Do NOT say 'Here is', 'Sure', 'Let me explain', or any filler.",
+  "- If the question involves code, write COMPLETE runnable code with correct syntax.",
+  "- VERIFY your answer is correct before responding. Accuracy is critical.",
+  "- If you see a question, ALWAYS provide an answer. Never say 'question not provided'."
+].join("\n");
+var CODING_PROMPT = [
+  "You are an expert competitive programmer. You solve LeetCode, HackerRank, and CodeForces problems.",
+  "",
+  "CRITICAL RULES:",
+  "1. Write the OPTIMAL solution with the best possible time and space complexity.",
+  "2. DO NOT write brute force. Use the most efficient algorithm (sliding window, two pointers, hash maps, DP, binary search, etc.).",
+  "3. Your code MUST compile and run without errors.",
+  "4. Your code MUST pass ALL test cases including edge cases.",
+  "5. Your code MUST NOT get TLE (Time Limit Exceeded). Optimize for speed.",
+  "",
+  "CODE COMPLETENESS (VERY IMPORTANT):",
+  "- Include ALL closing brackets } and closing braces",
+  "- In C++: ALWAYS end class with }; (semicolon after closing brace)",
+  "- In Java: ALWAYS close all brackets }",
+  "- In Python: ensure proper indentation",
+  "- Include ALL necessary imports/headers",
+  "- The code must be copy-paste ready \u2014 compilable as-is",
+  "",
+  "OUTPUT FORMAT:",
+  "- Output PLAIN TEXT only. No markdown. No ``` code fences.",
+  "- Keep ALL operators: * (multiply/pointer/dereference), /, %, +, -, &, |, ^, ~, <<, >>",
+  "- Write ONLY the solution code. No explanation unless very brief.",
+  "- If the problem asks for a class Solution, write the complete class with method.",
+  "",
+  "VERIFY BEFORE RESPONDING:",
+  "- Mentally trace through the examples given in the problem",
+  "- Check edge cases: empty input, single element, large input, duplicates",
+  "- Ensure time complexity is optimal (usually O(n) or O(n log n), NOT O(n\xB2) or O(n\xB3))",
+  "- Ensure the code handles all constraints mentioned in the problem"
+].join("\n");
+function sleep(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+function isRotatableError(msg) {
+  return /429|rate.?limit|too many requests|quota|resource.?exhausted|organization.?restricted|invalid.?api.?key|authentication|unauthorized|forbidden|deactivated|suspended|revoked|disabled|401|403/i.test(msg);
+}
+var keyCooldowns = /* @__PURE__ */ new Map();
+function markCooling(slot) {
+  keyCooldowns.set(slot, Date.now() + 6e4);
+}
+function isCooling(slot) {
+  const until = keyCooldowns.get(slot);
+  if (!until) return false;
+  if (Date.now() >= until) {
+    keyCooldowns.delete(slot);
+    return false;
+  }
+  return true;
+}
+function isCodingProblem(text) {
+  const lower = text.toLowerCase();
+  return /leetcode|hackerrank|codeforces|codechef|geeksforgeeks|atcoder/i.test(lower) || /class\s+solution/i.test(lower) || /\bfunction\s+\w+\s*\(/i.test(lower) || /\b(input|output)\s*:/i.test(lower) && /\b(example|constraint|return)\b/i.test(lower) || /\btime\s*complexity\b/i.test(lower) || /\bgiven\s+(an?\s+)?array\b/i.test(lower) || /\b(vector|listnode|treenode|linked\s*list)\b/i.test(lower) || /\breturn\s+(the|an?)\s+/i.test(lower) && /\bexample\b/i.test(lower);
+}
+function stripThinkingBlocks(text) {
+  return text.replace(/<think>[\s\S]*?<\/think>/g, "").trim();
+}
+async function callGroq(apiKey, model, systemPrompt, userContent, temperature = 0.2) {
+  const isGem = isGeminiKey(apiKey);
+  const baseURL = isGem ? (process.env.GEMINI_BASE_URL || "https://generativelanguage.googleapis.com/v1beta") : void 0;
+
+  let finalContent = userContent;
+  let finalModel = model;
+  if (Array.isArray(userContent)) {
+    const hasImage = userContent.some(item => item && item.type === "image_url");
+    if (hasImage) {
+      if (isGem) {
+        finalModel = process.env.GEMINI_MODEL || "gemini-2.0-flash";
+      } else {
+        finalModel = "llama-3.3-70b-versatile";
+        finalContent = userContent
+          .filter(item => item && item.type === "text")
+          .map(item => item.text)
+          .join("\n\n");
+      }
+    } else {
+      finalContent = userContent.map(item => typeof item === "string" ? item : (item?.text || "")).join("\n\n");
+    }
+  }
+
+  const client = new import_groq_sdk.default({
+    apiKey,
+    baseURL,
+    timeout: 9e4,
+    maxRetries: 0
+  });
+  const response = await client.chat.completions.create({
+    model: finalModel,
+    messages: [
+      { role: "system", content: systemPrompt },
+      { role: "user", content: finalContent }
+    ],
+    temperature,
+    max_tokens: 8192
+  });
+  return response.choices?.[0]?.message?.content ?? "";
+}
+async function askGroq(apiKey, payload, model = DEFAULT_MODEL) {
+  const isGem = isGeminiKey(apiKey);
+  const gemModel = process.env.GEMINI_MODEL || "gemini-2.5-flash";
+  if (isGem) {
+    model = gemModel;
+  }
+  let extractedText = "";
+  let rawImageB64 = "";
+  const imagesToOcr = [];
+  if (payload.screenshotPages && payload.screenshotPages.length > 0) {
+    for (const page of payload.screenshotPages) {
+      const b64 = page.replace(/^data:image\/\w+;base64,/, "");
+      imagesToOcr.push(b64);
+    }
+  } else if (payload.screenshotBase64) {
+    const b64 = payload.screenshotBase64.replace(/^data:image\/\w+;base64,/, "");
+    imagesToOcr.push(b64);
+  }
+  if (imagesToOcr.length > 0) {
+    rawImageB64 = imagesToOcr[0];
+    try {
+      const visionContent = [
+        {
+          type: "text",
+          text: imagesToOcr.length > 1 ? VISION_PROMPT + "\n\nIMPORTANT: Multiple screenshots are provided showing different parts of the same page (scrolled). Extract text from ALL images and combine into one complete output." : VISION_PROMPT
+        }
+      ];
+      for (const b64 of imagesToOcr) {
+        visionContent.push({
+          type: "image_url",
+          image_url: { url: `data:image/png;base64,${b64}` }
+        });
+      }
+      extractedText = await callGroq(apiKey, model, "You are an OCR assistant. Extract all text from the image(s) accurately.", visionContent);
+    } catch {
+      extractedText = "";
+    }
+  }
+  const contextParts = [];
+  if (payload.title) contextParts.push(`Window: ${payload.title}`);
+  if (payload.visibleText && payload.visibleText.length > 30) {
+    contextParts.push(`App context:
+${payload.visibleText.slice(0, 6e3)}`);
+  }
+  if (extractedText && extractedText.length > 10) {
+    contextParts.push(`Screen content:
+${extractedText}`);
+  }
+  if (payload.question) {
+    contextParts.push(`User question: ${payload.question}`);
+  } else {
+    contextParts.push("Solve the problem shown above. Give the correct answer.");
+  }
+  const fullContext = contextParts.join("\n\n");
+  const coding = isCodingProblem(fullContext + " " + (payload.title ?? ""));
+  const chosenModel = isGem ? gemModel : (coding ? CODING_MODEL : ANSWER_MODEL);
+  const chosenPrompt = coding ? CODING_PROMPT : ANSWER_PROMPT;
+  const temp = coding ? 0 : 0.1;
+  let answerText;
+  async function tryAnswer(mdl, prompt, content, t) {
+    return callGroq(apiKey, mdl, prompt, content, t);
+  }
+  if (extractedText && extractedText.length > 10) {
+    const answerContent = [{ type: "text", text: fullContext }];
+    try {
+      answerText = await tryAnswer(chosenModel, chosenPrompt, answerContent, temp);
+    } catch {
+      answerText = await tryAnswer(ANSWER_MODEL, chosenPrompt, answerContent, temp);
+    }
+  } else if (rawImageB64) {
+    const answerContent = [
+      { type: "text", text: fullContext + "\n\nThe screenshot is attached. Read it and solve the problem." },
+      { type: "image_url", image_url: { url: `data:image/png;base64,${rawImageB64}` } }
+    ];
+    answerText = await callGroq(apiKey, model, chosenPrompt, answerContent, temp);
+  } else {
+    const answerContent = [{ type: "text", text: fullContext }];
+    try {
+      answerText = await tryAnswer(chosenModel, chosenPrompt, answerContent, temp);
+    } catch {
+      answerText = await tryAnswer(ANSWER_MODEL, chosenPrompt, answerContent, temp);
+    }
+  }
+  answerText = stripThinkingBlocks(answerText);
+  return {
+    text: answerText || "No response generated.",
+    model: chosenModel
+  };
+}
+async function askWithAutoRotate(payload, model = DEFAULT_MODEL) {
+  const pool = loadPool();
+  const totalKeys = Math.max(pool.length, 1);
+  let lastError;
+  for (let attempt = 0; attempt < totalKeys; attempt++) {
+    const resolved2 = resolveCurrentKey();
+    if (!resolved2) throw new Error("No API keys available.");
+    if (resolved2.slot !== void 0 && isCooling(resolved2.slot)) {
+      rotateKey();
+      continue;
+    }
+    try {
+      return await askGroq(resolved2.apiKey, payload, model);
+    } catch (err) {
+      lastError = err;
+      const msg = err instanceof Error ? err.message : String(err);
+      if (!isRotatableError(msg)) throw err;
+      if (resolved2.slot !== void 0) markCooling(resolved2.slot);
+      rotateKey();
+      await sleep(500);
+    }
+  }
+  const resolved = resolveCurrentKey();
+  if (resolved) {
+    keyCooldowns.clear();
+    return await askGroq(resolved.apiKey, payload, model);
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_MODEL,
+  askGroq,
+  askWithAutoRotate,
+  decryptPoolKey,
+  decryptValue,
+  encryptPoolKey,
+  encryptValue,
+  loadPool,
+  loadUserConfig,
+  maskKey,
+  patchUserConfig,
+  resolveCurrentKey,
+  rotateKey,
+  saveUserConfig
+});

package/dist/shared/index.d.cts

@@ -0,0 +1,47 @@
+interface PageContextPayload {
+    url: string;
+    title: string;
+    visibleText: string;
+    screenshotBase64?: string;
+    /** Multiple screenshots from scroll-capture (base64 PNG each) */
+    screenshotPages?: string[];
+    question?: string;
+}
+interface AiResult {
+    text: string;
+    model: string;
+}
+interface UserConfig {
+    apiKey?: string;
+    model: string;
+    autoSummarizeOnLoad: boolean;
+    theme: "dark" | "light";
+    stealth?: boolean;
+    keyPoolSlot?: number;
+}
+
+declare function encryptValue(raw: string): string;
+declare function decryptValue(payload: string): string;
+declare function encryptPoolKey(raw: string): string;
+declare function decryptPoolKey(payload: string): string;
+
+declare function saveUserConfig(config: UserConfig): void;
+declare function loadUserConfig(): UserConfig;
+declare function patchUserConfig(patch: Partial<UserConfig>): UserConfig;
+
+declare const DEFAULT_MODEL = "meta-llama/llama-4-scout-17b-16e-instruct";
+declare function askGroq(apiKey: string, payload: PageContextPayload, model?: string): Promise<AiResult>;
+declare function askWithAutoRotate(payload: PageContextPayload, model?: string): Promise<AiResult>;
+
+declare function loadPool(): string[];
+interface ResolvedKey {
+    apiKey: string;
+    source: "user-override" | "pool";
+    slot?: number;
+    poolSize: number;
+}
+declare function resolveCurrentKey(): ResolvedKey | null;
+declare function rotateKey(): ResolvedKey | null;
+declare function maskKey(key: string): string;
+
+export { type AiResult, DEFAULT_MODEL, type PageContextPayload, type ResolvedKey, type UserConfig, askGroq, askWithAutoRotate, decryptPoolKey, decryptValue, encryptPoolKey, encryptValue, loadPool, loadUserConfig, maskKey, patchUserConfig, resolveCurrentKey, rotateKey, saveUserConfig };

package/dist/shared/index.d.ts

@@ -0,0 +1,47 @@
+interface PageContextPayload {
+    url: string;
+    title: string;
+    visibleText: string;
+    screenshotBase64?: string;
+    /** Multiple screenshots from scroll-capture (base64 PNG each) */
+    screenshotPages?: string[];
+    question?: string;
+}
+interface AiResult {
+    text: string;
+    model: string;
+}
+interface UserConfig {
+    apiKey?: string;
+    model: string;
+    autoSummarizeOnLoad: boolean;
+    theme: "dark" | "light";
+    stealth?: boolean;
+    keyPoolSlot?: number;
+}
+
+declare function encryptValue(raw: string): string;
+declare function decryptValue(payload: string): string;
+declare function encryptPoolKey(raw: string): string;
+declare function decryptPoolKey(payload: string): string;
+
+declare function saveUserConfig(config: UserConfig): void;
+declare function loadUserConfig(): UserConfig;
+declare function patchUserConfig(patch: Partial<UserConfig>): UserConfig;
+
+declare const DEFAULT_MODEL = "meta-llama/llama-4-scout-17b-16e-instruct";
+declare function askGroq(apiKey: string, payload: PageContextPayload, model?: string): Promise<AiResult>;
+declare function askWithAutoRotate(payload: PageContextPayload, model?: string): Promise<AiResult>;
+
+declare function loadPool(): string[];
+interface ResolvedKey {
+    apiKey: string;
+    source: "user-override" | "pool";
+    slot?: number;
+    poolSize: number;
+}
+declare function resolveCurrentKey(): ResolvedKey | null;
+declare function rotateKey(): ResolvedKey | null;
+declare function maskKey(key: string): string;
+
+export { type AiResult, DEFAULT_MODEL, type PageContextPayload, type ResolvedKey, type UserConfig, askGroq, askWithAutoRotate, decryptPoolKey, decryptValue, encryptPoolKey, encryptValue, loadPool, loadUserConfig, maskKey, patchUserConfig, resolveCurrentKey, rotateKey, saveUserConfig };