perplexity-user-mcp 0.8.42 → 0.8.47

package/dist/cli.mjs

@@ -1,3 +1,12 @@
+#!/usr/bin/env node
+import {
+  isMainModule
+} from "./chunk-GPUGKWXH.mjs";
+import {
+  probeKeychainState
+} from "./chunk-C5I7KXHK.mjs";
+import "./chunk-MTDFKNXX.mjs";
+import "./chunk-E3GRJXXJ.mjs";
 import "./chunk-4UEJOM6W.mjs";
 
 // src/cli.js
@@ -99,23 +108,7 @@ function normalizeExportFormat(value) {
   return null;
 }
 async function probeVaultState({ profile } = {}) {
-  let keychainAvailable = false;
-  let keychainHasKey = false;
-  try {
-    const mod = await import("keytar");
-    const keytar = mod.default ?? mod;
-    if (keytar && typeof keytar.getPassword === "function") {
-      keychainAvailable = true;
-      try {
-        const hex = await keytar.getPassword("perplexity-user-mcp", "vault-master-key");
-        keychainHasKey = !!hex;
-      } catch {
-        keychainHasKey = false;
-      }
-    }
-  } catch {
-    keychainAvailable = false;
-  }
+  const { available: keychainAvailable, hasKey: keychainHasKey } = await probeKeychainState();
   const envPassphraseSet = !!process.env.PERPLEXITY_VAULT_PASSPHRASE;
   const hasTty = process.stdin?.isTTY === true && process.env.PERPLEXITY_MCP_STDIO !== "1";
   let vaultExists = false;
@@ -776,7 +769,7 @@ Config written to ${config.configPath}`;
     return { code: browserResult.code, stdout: (flags.json ? browserResult.last : `login finished (${browserResult.code})`) + "\n", stderr: "" };
   }
   if (command === "install-speed-boost") {
-    const { installImpit, getImpitStatus } = await import("./native-deps-IE4B55EL.mjs");
+    const { installImpit, getImpitStatus } = await import("./native-deps-FCSYDL4W.mjs");
     const before = getImpitStatus();
     if (before.installed && !flags.force) {
       const msg2 = flags.json ? JSON.stringify({ ok: true, alreadyInstalled: true, version: before.version, runtimeDir: before.runtimeDir }) : `Speed Boost (impit ${before.version ?? "?"}) already installed at ${before.runtimeDir}.
@@ -797,7 +790,7 @@ All impit-eligible tools (sync, hydrate, retrieve, export, models, login) will u
     return { code: 0, stdout: out + "\n", stderr: "" };
   }
   if (command === "uninstall-speed-boost") {
-    const { uninstallImpit, getImpitStatus } = await import("./native-deps-IE4B55EL.mjs");
+    const { uninstallImpit, getImpitStatus } = await import("./native-deps-FCSYDL4W.mjs");
     const before = getImpitStatus();
     const log = (line) => process.stderr.write(`[speed-boost] ${line}
 `);
@@ -811,7 +804,7 @@ All impit-eligible tools (sync, hydrate, retrieve, export, models, login) will u
     return { code: 0, stdout: out + "\n", stderr: "" };
   }
   if (command === "speed-boost-status") {
-    const { getImpitStatus } = await import("./native-deps-IE4B55EL.mjs");
+    const { getImpitStatus } = await import("./native-deps-FCSYDL4W.mjs");
     const status = getImpitStatus();
     if (flags.json) {
       return { code: 0, stdout: JSON.stringify(status) + "\n", stderr: "" };
@@ -1084,7 +1077,7 @@ Notes:
 Environment:
   PERPLEXITY_NO_DAEMON=1        'daemon attach' runs in-process stdio (bypass daemon)
 `;
-if (import.meta.url === pathToFileURL(process.argv[1]).href) {
+if (isMainModule(import.meta.url)) {
   const parsed = parseArgs(process.argv.slice(2));
   routeCommand(parsed).then((res) => {
     if (res.stdout) process.stdout.write(res.stdout);

package/dist/client.d.ts

@@ -1,12 +1,9 @@
-import { AccountInfo, SearchResult } from './config.js';
-import 'patchright';
-
 /**
  * Perplexity Web API client — uses Playwright persistent browser context.
  * Login (headed) and MCP server (headless) share the same browser profile directory,
  * so Cloudflare cf_clearance and all state persist between runs.
  */
-
+import { type SearchResult, type AccountInfo } from "./config.js";
 /**
  * Read the on-disk AccountInfo cache for the active profile without
  * touching the browser or the network. Returns null when the cache file
@@ -15,8 +12,20 @@ import 'patchright';
  * runs — the cache is written by every successful refresh tier
  * (refresh.ts) and by login-runner.js after a fresh login.
  */
-declare function readCachedAccountInfoFromDisk(): AccountInfo | null;
-interface ListAskThreadsItem {
+export declare function readCachedAccountInfoFromDisk(): AccountInfo | null;
+/**
+ * Build launch options for Playwright persistent context.
+ *
+ * Uses the first available system browser (Chrome > Edge > Chromium > Brave)
+ * for best Cloudflare fingerprinting, falling back to patchright's bundled
+ * Chromium. The resolved `channel` is passed through so Patchright can apply
+ * channel-specific stealth tweaks (important for msedge on Windows).
+ *
+ * @internal Exported only so unit tests can assert the headed/headless arg
+ * branches; not part of the supported `perplexity-user-mcp/client` API.
+ */
+export declare function buildLaunchOptions(headless: boolean): Record<string, any>;
+export interface ListAskThreadsItem {
     backendUuid: string;
     contextUuid: string;
     slug: string;
@@ -33,11 +42,11 @@ interface ListAskThreadsItem {
     threadStatus: string;
     readWriteToken: string | null;
 }
-interface ListAskThreadsResult {
+export interface ListAskThreadsResult {
     items: ListAskThreadsItem[];
     total: number;
 }
-interface ListAskThreadsOpts {
+export interface ListAskThreadsOpts {
     limit?: number;
     offset?: number;
     searchTerm?: string;
@@ -50,11 +59,11 @@ interface ListAskThreadsOpts {
  * doesn't yield a parseable 200. Lets callers (cloud-sync, the class method)
  * fall back to the browser path on any miss.
  */
-declare function listCloudThreadsViaImpit(opts?: ListAskThreadsOpts): Promise<ListAskThreadsResult | null>;
-interface GetCloudThreadOpts {
+export declare function listCloudThreadsViaImpit(opts?: ListAskThreadsOpts): Promise<ListAskThreadsResult | null>;
+export interface GetCloudThreadOpts {
     limit?: number;
 }
-interface CloudThreadEntry {
+export interface CloudThreadEntry {
     backendUuid: string;
     queryStr: string;
     answer: string;
@@ -72,7 +81,7 @@ interface CloudThreadEntry {
     createdAt: string;
     status: string;
 }
-interface GetCloudThreadResult {
+export interface GetCloudThreadResult {
     entries: CloudThreadEntry[];
     thread: {
         slug: string;
@@ -88,8 +97,8 @@ interface GetCloudThreadResult {
  * miss (returns null) — the caller will hit the browser path which will
  * surface the 404 as a hard error.
  */
-declare function getCloudThreadViaImpit(slug: string, opts?: GetCloudThreadOpts): Promise<GetCloudThreadResult | null>;
-interface BuildSearchRequestOpts {
+export declare function getCloudThreadViaImpit(slug: string, opts?: GetCloudThreadOpts): Promise<GetCloudThreadResult | null>;
+export interface BuildSearchRequestOpts {
     query: string;
     modelPreference: string;
     mode: string;
@@ -100,15 +109,15 @@ interface BuildSearchRequestOpts {
         readWriteToken?: string | null;
     };
 }
-declare function isExperimentalImpitSearchEnabled(): boolean;
+export declare function isExperimentalImpitSearchEnabled(): boolean;
 /**
  * Browser-free search via impit. Returns null on any failure (impit not
  * installed, no session cookie, non-200, parse error) so callers can fall
  * back to the browser path. Same SSE response format as the in-page fetch
  * — parsed by `PerplexityClient.parseSSEText`.
  */
-declare function searchPerplexityViaImpit(opts: BuildSearchRequestOpts): Promise<SearchResult | null>;
-interface RetrieveThreadViaImpitOpts {
+export declare function searchPerplexityViaImpit(opts: BuildSearchRequestOpts): Promise<SearchResult | null>;
+export interface RetrieveThreadViaImpitOpts {
     threadSlug: string;
     backendUuid: string | null;
     readWriteToken: string | null;
@@ -126,13 +135,13 @@ interface RetrieveThreadViaImpitOpts {
  * attached files we return null so the caller forces a browser session
  * which can drive `downloadASIFiles` via the page's APIRequestContext.
  */
-declare function retrieveThreadViaImpit(opts: RetrieveThreadViaImpitOpts): Promise<SearchResult | null>;
-interface ExportThreadViaImpitOpts {
+export declare function retrieveThreadViaImpit(opts: RetrieveThreadViaImpitOpts): Promise<SearchResult | null>;
+export interface ExportThreadViaImpitOpts {
     threadSlug?: string | null;
     entryUuid?: string | null;
     format: "pdf" | "markdown" | "docx";
 }
-interface ExportThreadResult {
+export interface ExportThreadResult {
     buffer: Buffer;
     filename: string;
     contentType: string;
@@ -144,8 +153,8 @@ interface ExportThreadResult {
  * page-context export. Markdown export is intentionally not supported here
  * — the caller assembles markdown locally from the saved history entry.
  */
-declare function exportThreadViaImpit(opts: ExportThreadViaImpitOpts): Promise<ExportThreadResult | null>;
-declare class PerplexityClient {
+export declare function exportThreadViaImpit(opts: ExportThreadViaImpitOpts): Promise<ExportThreadResult | null>;
+export declare class PerplexityClient {
     private browser;
     private context;
     private page;
@@ -350,6 +359,12 @@ declare class PerplexityClient {
      */
     getCloudThread(slug: string, opts?: GetCloudThreadOpts): Promise<GetCloudThreadResult>;
     shutdown(): Promise<void>;
+    private daemonTier;
+    /**
+     * Write daemon-status.json so the extension UI can show live auth state
+     * instead of relying on the stale models-cache.json snapshot.
+     * @param startedAt - Date.now() captured at the start of init/reinit
+     * @param error - error message if init threw, null on success or shutdown
+     */
+    private writeDaemonStatus;
 }
-
-export { type BuildSearchRequestOpts, type CloudThreadEntry, type ExportThreadResult, type ExportThreadViaImpitOpts, type GetCloudThreadOpts, type GetCloudThreadResult, type ListAskThreadsItem, type ListAskThreadsOpts, type ListAskThreadsResult, PerplexityClient, type RetrieveThreadViaImpitOpts, exportThreadViaImpit, getCloudThreadViaImpit, isExperimentalImpitSearchEnabled, listCloudThreadsViaImpit, readCachedAccountInfoFromDisk, retrieveThreadViaImpit, searchPerplexityViaImpit };

package/dist/client.mjs

@@ -1,5 +1,6 @@
 import {
   PerplexityClient,
+  buildLaunchOptions,
   exportThreadViaImpit,
   getCloudThreadViaImpit,
   isExperimentalImpitSearchEnabled,
@@ -7,16 +8,18 @@ import {
   readCachedAccountInfoFromDisk,
   retrieveThreadViaImpit,
   searchPerplexityViaImpit
-} from "./chunk-C3HPFFTD.mjs";
-import "./chunk-DQQISMYN.mjs";
-import "./chunk-D254EFYB.mjs";
-import "./chunk-U7QPUNRH.mjs";
-import "./chunk-S677V2JU.mjs";
+} from "./chunk-GBHPJ7I7.mjs";
+import "./chunk-KVV3JBSN.mjs";
+import "./chunk-V4LHDNWJ.mjs";
+import "./chunk-GBI2U336.mjs";
+import "./chunk-DXR6EEZH.mjs";
+import "./chunk-C5I7KXHK.mjs";
 import "./chunk-MTDFKNXX.mjs";
-import "./chunk-HJIXH6CL.mjs";
+import "./chunk-E3GRJXXJ.mjs";
 import "./chunk-4UEJOM6W.mjs";
 export {
   PerplexityClient,
+  buildLaunchOptions,
   exportThreadViaImpit,
   getCloudThreadViaImpit,
   isExperimentalImpitSearchEnabled,

package/dist/cloud-sync.d.ts

@@ -1,42 +1,65 @@
-import { PerplexityClient } from './client.js';
-import './config.js';
-import 'patchright';
-
-interface CloudSyncProgressEvent {
-  phase: "starting" | "syncing" | "done" | "cancelled" | "error";
-  fetched?: number;
-  total?: number;
-  inserted?: number;
-  updated?: number;
-  skipped?: number;
-  error?: string;
-}
-
-interface CloudSyncOptions {
-  client?: PerplexityClient;
-  getClient?: () => Promise<PerplexityClient>;
-  onProgress?: (evt: CloudSyncProgressEvent) => void;
-  pageSize?: number;
-  signal?: AbortSignal;
-}
-
-interface CloudSyncResult {
-  fetched: number;
-  total: number;
-  inserted: number;
-  updated: number;
-  skipped: number;
-  cancelled: boolean;
-}
-
-declare function syncCloudHistory(opts?: CloudSyncOptions): Promise<CloudSyncResult>;
-
-declare function hydrateCloudHistoryEntry(
-  historyId: string,
-  opts?: {
-    client?: PerplexityClient;
-    getClient?: () => Promise<PerplexityClient>;
-  },
-): Promise<{ action: "skipped-local" | "skipped-hydrated" | "hydrated"; id?: string }>;
-
-export { type CloudSyncOptions, type CloudSyncProgressEvent, type CloudSyncResult, hydrateCloudHistoryEntry, syncCloudHistory };
+/**
+ * Sync the user's Perplexity library (all ask threads) into local history.
+ * Merges by backend_uuid. Never touches local MCP-originated entries or the
+ * bodies of already-hydrated cloud entries.
+ *
+ * Per-page strategy: try impit first (no browser); on miss, lazily acquire
+ * the client (init() or caller-provided getClient) and use the browser path
+ * for the remainder of the sync. The first impit miss in a run sticks —
+ * we don't ping-pong between paths.
+ *
+ * @param {object} opts
+ * @param {PerplexityClient} [opts.client] Pre-initialized client. If supplied, the impit fast path is skipped (the caller has already paid for init).
+ * @param {() => Promise<PerplexityClient>} [opts.getClient] Lazy getter. Called only when the impit path misses, so the browser is never spawned in the all-impit happy path.
+ * @param {(evt: { phase: string; fetched?: number; total?: number; inserted?: number; updated?: number; skipped?: number; error?: string }) => void} [opts.onProgress]
+ * @param {number} [opts.pageSize=1000]
+ * @param {AbortSignal} [opts.signal]
+ */
+export function syncCloudHistory(opts?: {
+    client?: PerplexityClient | undefined;
+    getClient?: (() => Promise<PerplexityClient>) | undefined;
+    onProgress?: ((evt: {
+        phase: string;
+        fetched?: number;
+        total?: number;
+        inserted?: number;
+        updated?: number;
+        skipped?: number;
+        error?: string;
+    }) => void) | undefined;
+    pageSize?: number | undefined;
+    signal?: AbortSignal | undefined;
+}): Promise<{
+    cancelled: boolean;
+    fetched: number;
+    total: number;
+    inserted: number;
+    updated: number;
+    skipped: number;
+}>;
+/**
+ * Lazy-hydrate a single cloud entry — fetch full thread content and
+ * replace the stub body. No-op if the entry is already hydrated or
+ * isn't a cloud entry.
+ *
+ * Tries the impit fast path first (no browser launch). If that misses,
+ * lazy-acquires the daemon's client (or constructs one) and falls back
+ * to the browser path. The first impit miss in a hydrate run sticks for
+ * any subsequent steps in this same call (there's only one fetch, so
+ * this is a no-op in practice but keeps the semantics consistent with
+ * syncCloudHistory).
+ *
+ * @param {string} historyId
+ * @param {object} [opts]
+ * @param {PerplexityClient} [opts.client] Pre-init'd client. Skips impit fast path (caller already paid for init).
+ * @param {() => Promise<PerplexityClient>} [opts.getClient] Lazy getter. Only called if impit misses.
+ * @returns {Promise<{ action: "skipped-local" | "skipped-hydrated" | "hydrated"; id?: string }>}
+ */
+export function hydrateCloudHistoryEntry(historyId: string, opts?: {
+    client?: PerplexityClient | undefined;
+    getClient?: (() => Promise<PerplexityClient>) | undefined;
+}): Promise<{
+    action: "skipped-local" | "skipped-hydrated" | "hydrated";
+    id?: string;
+}>;
+import { PerplexityClient } from "./client.js";

package/dist/cloud-sync.mjs

@@ -1,15 +1,16 @@
 import {
   hydrateCloudHistoryEntry,
   syncCloudHistory
-} from "./chunk-2FPGJKCA.mjs";
-import "./chunk-C3HPFFTD.mjs";
-import "./chunk-DQQISMYN.mjs";
-import "./chunk-B65IJQZJ.mjs";
-import "./chunk-D254EFYB.mjs";
-import "./chunk-U7QPUNRH.mjs";
-import "./chunk-S677V2JU.mjs";
+} from "./chunk-YD25G5AD.mjs";
+import "./chunk-GBHPJ7I7.mjs";
+import "./chunk-KVV3JBSN.mjs";
+import "./chunk-V4LHDNWJ.mjs";
+import "./chunk-6E6XTHTG.mjs";
+import "./chunk-GBI2U336.mjs";
+import "./chunk-DXR6EEZH.mjs";
+import "./chunk-C5I7KXHK.mjs";
 import "./chunk-MTDFKNXX.mjs";
-import "./chunk-HJIXH6CL.mjs";
+import "./chunk-E3GRJXXJ.mjs";
 import "./chunk-4UEJOM6W.mjs";
 export {
   hydrateCloudHistoryEntry,

package/dist/config.d.ts

@@ -1,30 +1,28 @@
-import * as patchright from 'patchright';
-
-declare const PERPLEXITY_URL = "https://www.perplexity.ai";
-declare const AUTH_SESSION_ENDPOINT = "https://www.perplexity.ai/api/auth/session";
-declare const QUERY_ENDPOINT = "https://www.perplexity.ai/rest/sse/perplexity_ask";
-declare const MODELS_CONFIG_ENDPOINT = "https://www.perplexity.ai/rest/models/config?config_schema=v1&version=2.18&source=default";
-declare const ASI_ACCESS_ENDPOINT = "https://www.perplexity.ai/rest/billing/asi-access-decision?version=2.18&source=default";
-declare const RATE_LIMIT_ENDPOINT = "https://www.perplexity.ai/rest/rate-limit/status?version=2.18&source=default";
-declare const EXPERIMENTS_ENDPOINT = "https://www.perplexity.ai/rest/experiments/attributes?version=2.18&source=default";
-declare const USER_INFO_ENDPOINT = "https://www.perplexity.ai/rest/user/info?version=2.18&source=default";
-declare const THREAD_ENDPOINT: (slug: string) => string;
-declare const CONFIG_DIR: string;
+export declare const PERPLEXITY_URL = "https://www.perplexity.ai";
+export declare const AUTH_SESSION_ENDPOINT = "https://www.perplexity.ai/api/auth/session";
+export declare const QUERY_ENDPOINT = "https://www.perplexity.ai/rest/sse/perplexity_ask";
+export declare const MODELS_CONFIG_ENDPOINT = "https://www.perplexity.ai/rest/models/config?config_schema=v1&version=2.18&source=default";
+export declare const ASI_ACCESS_ENDPOINT = "https://www.perplexity.ai/rest/billing/asi-access-decision?version=2.18&source=default";
+export declare const RATE_LIMIT_ENDPOINT = "https://www.perplexity.ai/rest/rate-limit/status?version=2.18&source=default";
+export declare const EXPERIMENTS_ENDPOINT = "https://www.perplexity.ai/rest/experiments/attributes?version=2.18&source=default";
+export declare const USER_INFO_ENDPOINT = "https://www.perplexity.ai/rest/user/info?version=2.18&source=default";
+export declare const THREAD_ENDPOINT: (slug: string) => string;
+export declare const CONFIG_DIR: string;
 /**
  * Cookies file path for the active profile (legacy fallback only — real
  * storage is the encrypted vault now). Profile-aware, evaluated at call time.
  */
-declare function getCookiesFile(): string;
+export declare function getCookiesFile(): string;
 /**
  * Browser persistent-context directory for the active profile.
  * Profile-aware, evaluated at call time.
  */
-declare function getBrowserDataDir(): string;
-declare const COOKIES_FILE: string;
-declare const STORAGE_STATE_FILE: string;
-declare const BROWSER_DATA_DIR: string;
-type BrowserChannel = "chrome" | "msedge" | "chromium" | "bundled";
-interface BrowserInfo {
+export declare function getBrowserDataDir(): string;
+export declare const COOKIES_FILE: string;
+export declare const STORAGE_STATE_FILE: string;
+export declare const BROWSER_DATA_DIR: string;
+export type BrowserChannel = "chrome" | "msedge" | "chromium" | "bundled";
+export interface BrowserInfo {
     /** Absolute path to a browser executable. */
     path: string;
     /** Channel passed to Patchright's launch APIs. */
@@ -40,7 +38,7 @@ interface BrowserInfo {
  *   PERPLEXITY_BROWSER_CHANNEL — chrome | msedge | chromium (defaults to "chrome")
  *   PERPLEXITY_CHROME_PATH     — legacy alias for PERPLEXITY_BROWSER_PATH
  */
-declare function findBrowser(): BrowserInfo | null;
+export declare function findBrowser(): BrowserInfo | null;
 /**
  * Pick a usable BrowserContext from a Patchright Browser. Kept as a small
  * helper for any future CDP-connect path (e.g. attaching to a remote Chrome
@@ -48,12 +46,12 @@ declare function findBrowser(): BrowserInfo | null;
  * is empty until we call `newContext`, which then runs unchanged with the
  * caller's options (viewport, userAgent, etc).
  */
-declare function getOrCreateContext(browser: patchright.Browser, options?: Parameters<patchright.Browser["newContext"]>[0]): Promise<patchright.BrowserContext>;
+export declare function getOrCreateContext(browser: import("patchright").Browser, options?: Parameters<import("patchright").Browser["newContext"]>[0]): Promise<import("patchright").BrowserContext>;
 /**
  * Find the real Chrome executable on the system.
  * Returns the path or null if not found.
  */
-declare function findChromeExecutable(): string | null;
+export declare function findChromeExecutable(): string | null;
 /**
  * Resolve a browser executable the client can launch.
  *
@@ -66,20 +64,20 @@ declare function findChromeExecutable(): string | null;
  * The returned `channel` field is additive and safe to ignore by legacy
  * callers that only destructure `{ path }`.
  */
-declare function resolveBrowserExecutable(): Promise<{
+export declare function resolveBrowserExecutable(): Promise<{
     path: string;
     channel: BrowserChannel;
     source: "system-chrome" | "system-edge" | "system-chromium" | "system-brave" | "bundled-chromium";
 }>;
-declare const DEFAULT_HEADERS: Record<string, string>;
-declare const SUPPORTED_BLOCK_USE_CASES: string[];
-interface ModelInfo {
+export declare const DEFAULT_HEADERS: Record<string, string>;
+export declare const SUPPORTED_BLOCK_USE_CASES: string[];
+export interface ModelInfo {
     description: string;
     mode: string;
     provider: string | null;
     label?: string;
 }
-interface ModelConfigEntry {
+export interface ModelConfigEntry {
     label: string;
     description: string;
     subheading: string | null;
@@ -91,18 +89,18 @@ interface ModelConfigEntry {
     audience?: string | null;
     is_default?: boolean;
 }
-interface ModelsConfigResponse {
+export interface ModelsConfigResponse {
     models: Record<string, ModelInfo>;
     config: ModelConfigEntry[];
     default_models: Record<string, string>;
     agentic_research_compare_models?: string[];
 }
-interface ASIAccessResponse {
+export interface ASIAccessResponse {
     can_use_computer: boolean;
     can_access_org_credits_page: boolean;
     can_enable_topup: boolean;
 }
-interface RateLimitResponse {
+export interface RateLimitResponse {
     modes: Record<string, {
         available: boolean;
         remaining_detail: {
@@ -118,13 +116,13 @@ interface RateLimitResponse {
         };
     }>;
 }
-interface UserInfoResponse {
+export interface UserInfoResponse {
     has_non_public_email?: boolean;
     is_enterprise?: boolean;
     is_gov?: boolean;
     is_student?: boolean;
 }
-interface AccountInfo {
+export interface AccountInfo {
     isPro: boolean;
     isMax: boolean;
     isEnterprise: boolean;
@@ -132,7 +130,7 @@ interface AccountInfo {
     modelsConfig: ModelsConfigResponse | null;
     rateLimits: RateLimitResponse | null;
 }
-interface ASIFile {
+export interface ASIFile {
     filename: string;
     assetType: string;
     url: string;
@@ -140,7 +138,7 @@ interface ASIFile {
     size?: number;
     mediaType?: string;
 }
-interface SearchResult {
+export interface SearchResult {
     answer: string;
     reasoning?: string;
     sources: Array<{
@@ -166,7 +164,7 @@ interface SearchResult {
 /**
  * Build cookie string from env vars or saved cookies file for Playwright context.
  */
-interface PlaywrightCookie {
+export interface PlaywrightCookie {
     name: string;
     value: string;
     domain: string;
@@ -175,12 +173,10 @@ interface PlaywrightCookie {
     httpOnly?: boolean;
     sameSite?: "Strict" | "Lax" | "None";
 }
-declare function getSavedCookies(): Promise<PlaywrightCookie[]>;
+export declare function getSavedCookies(): Promise<PlaywrightCookie[]>;
 /**
  * Check whether the active profile has stored login cookies in its vault.
  * Extension has its own filesystem-based `hasStoredLogin` in session.ts that
  * inspects COOKIES_FILE / BROWSER_DATA_DIR — this one is vault-aware.
  */
-declare function hasStoredLogin(): Promise<boolean>;
-
-export { type ASIAccessResponse, type ASIFile, ASI_ACCESS_ENDPOINT, AUTH_SESSION_ENDPOINT, type AccountInfo, BROWSER_DATA_DIR, type BrowserChannel, type BrowserInfo, CONFIG_DIR, COOKIES_FILE, DEFAULT_HEADERS, EXPERIMENTS_ENDPOINT, MODELS_CONFIG_ENDPOINT, type ModelConfigEntry, type ModelInfo, type ModelsConfigResponse, PERPLEXITY_URL, type PlaywrightCookie, QUERY_ENDPOINT, RATE_LIMIT_ENDPOINT, type RateLimitResponse, STORAGE_STATE_FILE, SUPPORTED_BLOCK_USE_CASES, type SearchResult, THREAD_ENDPOINT, USER_INFO_ENDPOINT, type UserInfoResponse, findBrowser, findChromeExecutable, getBrowserDataDir, getCookiesFile, getOrCreateContext, getSavedCookies, hasStoredLogin, resolveBrowserExecutable };
+export declare function hasStoredLogin(): Promise<boolean>;

package/dist/config.mjs

@@ -22,10 +22,10 @@ import {
   getSavedCookies,
   hasStoredLogin,
   resolveBrowserExecutable
-} from "./chunk-U7QPUNRH.mjs";
-import "./chunk-S677V2JU.mjs";
+} from "./chunk-DXR6EEZH.mjs";
+import "./chunk-C5I7KXHK.mjs";
 import "./chunk-MTDFKNXX.mjs";
-import "./chunk-HJIXH6CL.mjs";
+import "./chunk-E3GRJXXJ.mjs";
 import "./chunk-4UEJOM6W.mjs";
 export {
   ASI_ACCESS_ENDPOINT,

package/dist/cookie-jar.d.ts

@@ -0,0 +1,77 @@
+export class CookieJar {
+    /**
+     * @param {PlaywrightCookie[]} [initialCookies]
+     */
+    constructor(initialCookies?: PlaywrightCookie[]);
+    /** @type {Map<string, ReturnType<typeof entryFromPlaywright>>} */
+    _store: Map<string, ReturnType<typeof entryFromPlaywright>>;
+    /**
+     * Apply one or more Set-Cookie headers from a response. Accepts either a
+     * single string or an array (e.g. `res.headers.getSetCookie?.()` /
+     * `res.headers.raw()['set-cookie']`).
+     *
+     * @param {string|string[]|null|undefined} header
+     * @param {string} requestUrl
+     */
+    consumeSetCookieHeader(header: string | string[] | null | undefined, requestUrl: string): void;
+    /**
+     * Build a `Cookie:` header value for `requestUrl`. Returns "" if no cookies
+     * apply (so the caller can do `if (h) headers.cookie = h`).
+     *
+     * @param {string} requestUrl
+     * @returns {string}
+     */
+    buildCookieHeader(requestUrl: string): string;
+    /**
+     * Snapshot of every cookie in the jar (including expired ones — callers that
+     * persist to disk want the full set so a refresh can simply overwrite).
+     *
+     * @returns {PlaywrightCookie[]}
+     */
+    toPlaywrightShape(): PlaywrightCookie[];
+    /**
+     * Explicit setter, mostly for tests and for the rare case where the caller
+     * already has a fully-formed cookie record (e.g. seeding cf_clearance from
+     * the vault). `attributes` may include any of the PlaywrightCookie fields
+     * except name/value.
+     *
+     * @param {string} name
+     * @param {string} value
+     * @param {Partial<PlaywrightCookie> & { hostOnly?: boolean }} [attributes]
+     */
+    set(name: string, value: string, attributes?: Partial<PlaywrightCookie> & {
+        hostOnly?: boolean;
+    }): void;
+}
+export type PlaywrightCookie = {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    /**
+     * Unix epoch seconds; -1 for session cookies (Patchright convention).
+     */
+    expires?: number | undefined;
+    secure?: boolean | undefined;
+    httpOnly?: boolean | undefined;
+    sameSite?: "Strict" | "Lax" | "None" | undefined;
+};
+/**
+ * Coerce a PlaywrightCookie back into the internal entry shape. Used by
+ * the constructor and `set()`. We always produce hostOnly=false when domain
+ * starts with `.` in the source array (Patchright emits leading-dot domains
+ * for domain cookies); strip the dot here so the rest of the matching logic
+ * runs on a normalised form.
+ */
+declare function entryFromPlaywright(c: any): {
+    name: string;
+    value: string;
+    domain: any;
+    path: any;
+    expires: any;
+    secure: boolean;
+    httpOnly: boolean;
+    sameSite: any;
+    hostOnly: boolean;
+};
+export {};