@ashx-j/lunr 0.2.21 → 0.2.22

package/dist/node-runtime/service-ISSP6VHE.js

@@ -0,0 +1,36 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  atomicJson,
+  claimGateway,
+  configureStartup,
+  gatewayIsRunning,
+  gatewayLogPath,
+  loadServiceSettings,
+  processExists,
+  readGatewayLog,
+  readGatewayStatus,
+  serviceDirectory,
+  serviceStatusText,
+  startGatewayService,
+  startupSpec,
+  stopGatewayService
+} from "./chunk-UWPJL22I.js";
+import "./chunk-FQMM2EZ2.js";
+import "./chunk-Q4Q6D4IY.js";
+import "./chunk-BRJX2PRC.js";
+export {
+  atomicJson,
+  claimGateway,
+  configureStartup,
+  gatewayIsRunning,
+  gatewayLogPath,
+  loadServiceSettings,
+  processExists,
+  readGatewayLog,
+  readGatewayStatus,
+  serviceDirectory,
+  serviceStatusText,
+  startGatewayService,
+  startupSpec,
+  stopGatewayService
+};

package/dist/node-runtime/session-handoff-HC7R5E24.js

@@ -0,0 +1,33 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  HANDOFF_DURATION_MS,
+  SessionTransferError,
+  cancelSessionHandoff,
+  latestTuiSession,
+  listHandoffCandidates,
+  listRegisteredSessionPaths,
+  listRegisteredSessions,
+  markSessionHandoff,
+  recordTuiActivity,
+  registerTransferHandler,
+  requestSessionTransfer
+} from "./chunk-AZJHNQKQ.js";
+import "./chunk-XLTL257W.js";
+import "./chunk-FVDOXRUD.js";
+import "./chunk-UAEOTO52.js";
+import "./chunk-FQMM2EZ2.js";
+import "./chunk-Q4Q6D4IY.js";
+import "./chunk-BRJX2PRC.js";
+export {
+  HANDOFF_DURATION_MS,
+  SessionTransferError,
+  cancelSessionHandoff,
+  latestTuiSession,
+  listHandoffCandidates,
+  listRegisteredSessionPaths,
+  listRegisteredSessions,
+  markSessionHandoff,
+  recordTuiActivity,
+  registerTransferHandler,
+  requestSessionTransfer
+};

package/dist/node-runtime/{session-manager-E7AREDTV.js → session-manager-CFN4UFM2.js}

@@ -12,8 +12,9 @@ import {
   migrateSessionEntries,
   parseSessionEntries,
   sessionEntryToContextMessages
-} from "./chunk-GKLEQ3I4.js";
+} from "./chunk-XLTL257W.js";
 import "./chunk-FVDOXRUD.js";
+import "./chunk-UAEOTO52.js";
 import "./chunk-FQMM2EZ2.js";
 import "./chunk-Q4Q6D4IY.js";
 import "./chunk-BRJX2PRC.js";

package/dist/node-runtime/{session-selector-FJ7M2AIX.js → session-selector-LHRMJOKT.js}

@@ -1,11 +1,12 @@
 import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
 import {
   SessionSelectorComponent
-} from "./chunk-JZQ7F36T.js";
+} from "./chunk-ORH324EP.js";
+import "./chunk-UAEOTO52.js";
 import "./chunk-5EFIU3OM.js";
-import "./chunk-BOHIDQT4.js";
-import "./chunk-DDWHZ633.js";
-import "./chunk-RNBHABBA.js";
+import "./chunk-6B2POMK7.js";
+import "./chunk-GNN7H3B7.js";
+import "./chunk-7QWNYZDI.js";
 import "./chunk-FQMM2EZ2.js";
 import "./chunk-Q4Q6D4IY.js";
 import "./chunk-BRJX2PRC.js";

package/dist/node-runtime/{settings-manager-CUGAZWAB.js → settings-manager-UUZ6NUXI.js}

@@ -6,9 +6,14 @@ import {
   SKILL_TAG_CHARACTERS,
   SettingsManager,
   parseSkillTagCharacter
-} from "./chunk-WLLDXJRT.js";
+} from "./chunk-WADV2VDS.js";
+import "./chunk-UP2XBVH5.js";
+import "./chunk-VWCE2HSZ.js";
 import "./chunk-LISUTZS3.js";
-import "./chunk-AY6CAJSL.js";
+import "./chunk-URD2SLIT.js";
+import "./chunk-UJOCPOMX.js";
+import "./chunk-IMLCWLPI.js";
+import "./chunk-R3K2F5GI.js";
 import "./chunk-FQMM2EZ2.js";
 import "./chunk-Q4Q6D4IY.js";
 import "./chunk-BRJX2PRC.js";

package/dist/node-runtime/setup-JBKOLJ6F.js

@@ -0,0 +1,18 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import "./chunk-BRJX2PRC.js";
+
+// packages/coding-agent/dist/core/browser/setup.js
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+async function installBrowser(explicit = !0) {
+  let script = fileURLToPath(new URL("../../../scripts/install-browser.mjs", new URL("../core/browser/setup.js", import.meta.url).href));
+  await new Promise((resolve, reject) => {
+    let child = spawn(process.execPath, [script, ...explicit ? ["--explicit"] : []], { stdio: "inherit", windowsHide: !0 });
+    child.once("error", reject), child.once("exit", (code) => {
+      code === 0 ? resolve() : reject(new Error(`Chromium setup failed (${code}). Retry lunr browser install when online.`));
+    });
+  });
+}
+export {
+  installBrowser
+};

package/dist/node-runtime/setup-NRXVZBLJ.js

@@ -0,0 +1,155 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  readSecret
+} from "./chunk-H4K3JDRB.js";
+import {
+  createPairingStore
+} from "./chunk-RMQZU2YU.js";
+import {
+  configureStartup,
+  loadServiceSettings,
+  startGatewayService
+} from "./chunk-UWPJL22I.js";
+import {
+  loadInstallFeatures,
+  saveInstallFeatures
+} from "./chunk-VWCE2HSZ.js";
+import {
+  loadGatewayConfig,
+  saveGatewayConfig
+} from "./chunk-R3K2F5GI.js";
+import "./chunk-FQMM2EZ2.js";
+import "./chunk-Q4Q6D4IY.js";
+import "./chunk-BRJX2PRC.js";
+
+// packages/coding-agent/dist/gateway/setup.js
+import { existsSync, realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+async function validateBotToken(platform, token) {
+  let url = platform === "telegram" ? `https://api.telegram.org/bot${token}/getMe` : "https://discord.com/api/v10/users/@me", response;
+  try {
+    response = await fetch(url, {
+      headers: platform === "discord" ? { Authorization: `Bot ${token}` } : {},
+      signal: AbortSignal.timeout(15e3)
+    });
+  } catch {
+    throw new Error(`${platform}: could not reach the bot API. Check your connection and try again.`);
+  }
+  if (!response.ok)
+    throw new Error(`${platform}: token check failed with HTTP ${response.status}. Check the token and bot permissions.`);
+  let value = await response.json();
+  if (!value || typeof value != "object")
+    throw new Error(`${platform}: unexpected bot API response.`);
+  let user = platform === "telegram" && "result" in value ? value.result : value;
+  if (!user || typeof user != "object" || !("id" in user))
+    throw new Error(`${platform}: bot identity was missing.`);
+  return "username" in user && typeof user.username == "string" ? user.username : String(user.id);
+}
+async function setupGateway() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY)
+    throw new Error("Run lunr gateway setup in a terminal. Bot tokens are entered privately, not as command arguments.");
+  let rl = createInterface({ input: process.stdin, output: process.stdout }), ask = async (question, fallback = "") => (await rl.question(`${question}${fallback ? ` [${fallback}]` : ""}: `)).trim() || fallback, cfg = loadGatewayConfig();
+  try {
+    console.log(`Set up lunR on your phone
+Your computer must stay awake and connected to the internet. Press Ctrl+C to cancel.
+`);
+    let choice = (await ask("Connect telegram, discord, or both", cfg.discord.enabled ? cfg.telegram.enabled ? "both" : "discord" : "telegram")).toLowerCase();
+    if (!["telegram", "discord", "both"].includes(choice))
+      throw new Error("Choose telegram, discord, or both.");
+    for (let platform of ["telegram", "discord"]) {
+      if (choice !== platform && choice !== "both")
+        continue;
+      console.log(platform === "telegram" ? `
+Telegram
+1. Open https://t.me/BotFather and send /newbot.
+2. Follow its prompts and copy the bot token.
+3. Open your new bot and send /whoami. After startup it will show your user ID and pairing code.
+Guide: https://core.telegram.org/bots/tutorial` : `
+Discord
+1. Open https://discord.com/developers/applications and create an application.
+2. Open Bot, create or reset its token, and enable Message Content Intent for ordinary chat.
+3. Under Installation, add bot and applications.commands scopes. Grant View Channels, Send Messages, Read Message History, Attach Files, and thread permissions if needed.
+4. Use the install link to add your bot. In Discord, enable Developer Mode and copy your user ID.
+Guide: https://docs.discord.com/developers/quick-start/getting-started`);
+      let token = cfg[platform].token;
+      if (!token || await ask("Replace the saved token? yes/no", "no") === "yes") {
+        rl.close();
+        try {
+          token = (await readSecret(`${platform} bot token`))?.trim();
+        } finally {
+          rl = createInterface({ input: process.stdin, output: process.stdout });
+        }
+      }
+      if (!token)
+        throw new Error("No token entered. Existing configuration was not changed.");
+      console.log(`Connected bot: ${await validateBotToken(platform, token)}`), cfg[platform].token = token, cfg[platform].enabled = !0, cfg.owners ??= { telegram: [], discord: [] };
+      let owner = await ask(`Your ${platform} user ID, or leave empty to pair after startup`, cfg.owners[platform][0] ?? "");
+      if (owner && !/^\d+$/.test(owner))
+        throw new Error("User IDs contain digits only.");
+      owner && (cfg.owners[platform] = [.../* @__PURE__ */ new Set([...cfg.owners[platform], owner])], cfg[platform].allowedUsers = [.../* @__PURE__ */ new Set([...cfg[platform].allowedUsers, owner])]);
+    }
+    let root = await ask("Project folder you want to browse from your phone", cfg.projectRoots?.[0] ?? process.cwd()), path = resolve(root);
+    if (!existsSync(path) || !statSync(path).isDirectory())
+      throw new Error("That project folder does not exist.");
+    cfg.projectRoots = [.../* @__PURE__ */ new Set([...cfg.projectRoots ?? [], realpathSync(path)])];
+    let startup = await ask("Automatic startup: off, login, or boot", "off");
+    if (!["off", "login", "boot"].includes(startup))
+      throw new Error("Choose off, login, or boot.");
+    startup === "boot" && console.log("Boot startup may require administrator permission or OS-managed account credentials. lunR does not save your account password.");
+    let [{ ModelRuntime }, { SettingsManager }] = await Promise.all([
+      import("./model-runtime-PLQKAG4B.js"),
+      import("./settings-manager-UUZ6NUXI.js")
+    ]), models = await (await ModelRuntime.create({ allowModelNetwork: !1 })).getAvailable();
+    if (!models.length)
+      throw new Error("No saved model credentials found. Open lunr locally and use /login, then rerun gateway setup. Nothing saved.");
+    let settings = SettingsManager.create(process.cwd()), providers = [...new Set(models.map((model2) => model2.provider))];
+    console.log(`Saved providers: ${providers.join(", ")}`);
+    let provider = await ask("Model provider", settings.getDefaultProvider() ?? providers[0]), choices = models.filter((model2) => model2.provider === provider);
+    if (!choices.length)
+      throw new Error("Choose one of the saved providers. Nothing saved.");
+    console.log(choices.map((model2, index) => `${index + 1}. ${model2.id}`).join(`
+`));
+    let selected = await ask("Model number or ID", choices.find((model2) => model2.id === settings.getDefaultModel())?.id ?? choices[0].id), model = choices.find((model2) => model2.id === selected) ?? choices[Number(selected) - 1];
+    if (!model)
+      throw new Error("Choose a model from the list. Nothing saved.");
+    if (await ask("Save these settings? yes/no", "yes") !== "yes") {
+      console.log("Cancelled. Nothing saved.");
+      return;
+    }
+    saveGatewayConfig(cfg), settings.setDefaultModelAndProvider(model.provider, model.id);
+    let features = loadInstallFeatures();
+    features.features["chat-platforms"] = {
+      enabled: !0,
+      options: {
+        ...features.features["chat-platforms"]?.options,
+        autostart: loadServiceSettings().startup !== "off"
+      }
+    }, saveInstallFeatures(features);
+    try {
+      await configureStartup(startup);
+    } finally {
+      features.features["chat-platforms"].options.autostart = loadServiceSettings().startup !== "off", saveInstallFeatures(features);
+    }
+    await ask("Start the gateway now? yes/no", "yes") === "yes" && console.log(await startGatewayService()), console.log(`
+Send /whoami to your bot. To approve your own pairing code with access to projects and TUI sessions, run:
+lunr gateway pair approve <telegram|discord> <code> --owner
+Then use /project, /sessions, or /continue on your phone.`);
+  } finally {
+    rl.close();
+  }
+}
+function approveGatewayOwner(platform, code) {
+  if (platform !== "telegram" && platform !== "discord")
+    throw new Error("Choose telegram or discord.");
+  let user = createPairingStore().approve(platform, code);
+  if (!user)
+    throw new Error("Pairing code is invalid or expired.");
+  let cfg = loadGatewayConfig();
+  return cfg.owners ??= { telegram: [], discord: [] }, cfg.owners[platform] = [.../* @__PURE__ */ new Set([...cfg.owners[platform], user])], cfg[platform].allowedUsers = [.../* @__PURE__ */ new Set([...cfg[platform].allowedUsers, user])], saveGatewayConfig(cfg), `Approved ${platform} owner ${user}. Owner access includes local projects and TUI session history.`;
+}
+export {
+  approveGatewayOwner,
+  setupGateway,
+  validateBotToken
+};

package/dist/node-runtime/{subagent-executor-MH4A7CCF.js → subagent-executor-MLUMBWCP.js}

@@ -3,7 +3,6 @@ import {
   ASYNC_DIR,
   CHAIN_RUNS_DIR,
   DEFAULT_ARTIFACT_CONFIG,
-  DEFAULT_CONTROL_CONFIG,
   DEFAULT_FORK_PREAMBLE,
   DEFAULT_GLOBAL_CONCURRENCY_LIMIT,
   DEFAULT_MAX_OUTPUT,
@@ -34,7 +33,6 @@ import {
   attachRootChildrenToSteps,
   buildChainInstructions,
   buildChainSummary,
-  buildControlEvent,
   buildModelCandidates,
   buildPiArgs,
   buildRevivedAsyncTask,
@@ -46,7 +44,6 @@ import {
   checkSubagentDepth,
   childRowLabel,
   childWatchdogIsActive,
-  claimControlNotification,
   cleanupTempDir,
   clearPendingForegroundControlNotices,
   compactForegroundDetails,
@@ -59,7 +56,6 @@ import {
   deliverStopRequest,
   deliverSubagentIntercomMessageEvent,
   deliverSubagentResultIntercomEvent,
-  deriveActivityState,
   detectSubagentError,
   diagnoseIntercomBridge,
   discoverAvailableSkills,
@@ -79,8 +75,6 @@ import {
   formatAsyncRunOutputPath,
   formatAsyncRunProgressLabel,
   formatAsyncRunTranscript,
-  formatControlIntercomMessage,
-  formatControlNoticeMessage,
   formatModelAttemptNote,
   formatModelSelection,
   formatNestedRunStatusLines,
@@ -130,7 +124,6 @@ import {
   resolveChildExcludeTools,
   resolveChildMaxSubagentDepth,
   resolveChildWatchdogConfig,
-  resolveControlConfig,
   resolveCurrentMaxSubagentDepth,
   resolveCurrentSessionId,
   resolveEffectiveAcceptance,
@@ -158,7 +151,6 @@ import {
   resolveWatchdogModelInput,
   restorePersistedAcceptance,
   shouldAbortForTurnBudget,
-  shouldNotifyControlEvent,
   splitKnownThinkingSuffix,
   splitThinkingSuffix,
   stripAcceptanceReport,
@@ -187,26 +179,38 @@ import {
   writeNestedControlRequest,
   writeNestedEvent,
   writePrivateAtomicJson
-} from "./chunk-SY2TFMLO.js";
+} from "./chunk-QDGKKKUM.js";
+import {
+  DEFAULT_CONTROL_CONFIG,
+  buildControlEvent,
+  claimControlNotification,
+  deriveActivityState,
+  formatControlIntercomMessage,
+  formatControlNoticeMessage,
+  resolveControlConfig,
+  shouldNotifyControlEvent
+} from "./chunk-OAR4TYZE.js";
 import {
   PLAN_MODE_WRITE_SPAWN_ERROR,
   resolveChildPermissions,
   snapshotParentPermissionMode
-} from "./chunk-25I2BHAA.js";
-import "./chunk-WKDK4C5P.js";
+} from "./chunk-CSUZVNYE.js";
+import "./chunk-VSSXXL36.js";
 import "./chunk-53YJI7JU.js";
-import "./chunk-KBKMCJDU.js";
+import "./chunk-5ZQXRPMC.js";
+import "./chunk-AD6VXAO7.js";
+import "./chunk-5D7LC2ZQ.js";
+import "./chunk-M3LZLQW2.js";
+import "./chunk-KKUTQQV7.js";
 import "./chunk-CSFI6YXL.js";
 import {
   SessionManager
-} from "./chunk-GKLEQ3I4.js";
+} from "./chunk-XLTL257W.js";
 import "./chunk-FVDOXRUD.js";
-import "./chunk-AD6VXAO7.js";
-import "./chunk-6N22HULO.js";
-import "./chunk-M3LZLQW2.js";
+import "./chunk-UAEOTO52.js";
 import "./chunk-RQ2Q5IYR.js";
-import "./chunk-DDWHZ633.js";
-import "./chunk-RNBHABBA.js";
+import "./chunk-GNN7H3B7.js";
+import "./chunk-7QWNYZDI.js";
 import "./chunk-FQMM2EZ2.js";
 import "./chunk-Q4Q6D4IY.js";
 import "./chunk-BRJX2PRC.js";

package/dist/node-runtime/theme-U7IGOA7O.js

@@ -0,0 +1,68 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  DEFAULT_THEME_GLYPHS,
+  Theme,
+  detectTerminalBackgroundFromEnv,
+  detectTerminalBackgroundTheme,
+  detectTerminalThemeForAuto,
+  getAvailableThemes,
+  getAvailableThemesWithPaths,
+  getDefaultTheme,
+  getEditorTheme,
+  getLanguageFromPath,
+  getMarkdownTheme,
+  getResolvedThemeColors,
+  getSelectListTheme,
+  getSettingsListTheme,
+  getThemeByName,
+  getThemeExportColors,
+  getThemeForRgbColor,
+  getThemeName,
+  highlightCode,
+  initTheme,
+  isLightTheme,
+  loadThemeFromPath,
+  onThemeChange,
+  parseAutoThemeSetting,
+  resolveThemeSetting,
+  setRegisteredThemes,
+  setTheme,
+  setThemeInstance,
+  stopThemeWatcher,
+  theme
+} from "./chunk-7QWNYZDI.js";
+import "./chunk-FQMM2EZ2.js";
+import "./chunk-Q4Q6D4IY.js";
+import "./chunk-BRJX2PRC.js";
+export {
+  DEFAULT_THEME_GLYPHS,
+  Theme,
+  detectTerminalBackgroundFromEnv,
+  detectTerminalBackgroundTheme,
+  detectTerminalThemeForAuto,
+  getAvailableThemes,
+  getAvailableThemesWithPaths,
+  getDefaultTheme,
+  getEditorTheme,
+  getLanguageFromPath,
+  getMarkdownTheme,
+  getResolvedThemeColors,
+  getSelectListTheme,
+  getSettingsListTheme,
+  getThemeByName,
+  getThemeExportColors,
+  getThemeForRgbColor,
+  getThemeName,
+  highlightCode,
+  initTheme,
+  isLightTheme,
+  loadThemeFromPath,
+  onThemeChange,
+  parseAutoThemeSetting,
+  resolveThemeSetting,
+  setRegisteredThemes,
+  setTheme,
+  setThemeInstance,
+  stopThemeWatcher,
+  theme
+};

package/dist/node-runtime/trust-manager-MMISNCYO.js

@@ -0,0 +1,17 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  ProjectTrustStore,
+  getProjectTrustOptions,
+  getProjectTrustParentPath,
+  hasTrustRequiringProjectResources
+} from "./chunk-HTFRRDSF.js";
+import "./chunk-URD2SLIT.js";
+import "./chunk-FQMM2EZ2.js";
+import "./chunk-Q4Q6D4IY.js";
+import "./chunk-BRJX2PRC.js";
+export {
+  ProjectTrustStore,
+  getProjectTrustOptions,
+  getProjectTrustParentPath,
+  hasTrustRequiringProjectResources
+};

package/dist/node-runtime/{update-cli-XTZMZGOL.js → update-cli-4TP25CNW.js}

@@ -6,9 +6,14 @@ import {
 import "./chunk-DVGWF6A2.js";
 import {
   SettingsManager
-} from "./chunk-WLLDXJRT.js";
+} from "./chunk-WADV2VDS.js";
+import "./chunk-UP2XBVH5.js";
+import "./chunk-VWCE2HSZ.js";
 import "./chunk-LISUTZS3.js";
-import "./chunk-AY6CAJSL.js";
+import "./chunk-URD2SLIT.js";
+import "./chunk-UJOCPOMX.js";
+import "./chunk-IMLCWLPI.js";
+import "./chunk-R3K2F5GI.js";
 import {
   APP_NAME,
   NPM_CLI_PACKAGE,

package/dist/node-runtime/usage-service-LFB2SWYV.js

@@ -0,0 +1,37 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  PLAN_USAGE_CACHE_TTL_MS,
+  USAGE_SERVICE_BRIDGE_SYMBOL,
+  clearPlanUsageCache,
+  footerPlanLabel,
+  getAllPlanUsageResults,
+  getPlanUsage,
+  getPlanUsageResult,
+  getUsageServiceBridge,
+  hasPlanUsageAdapter,
+  isFiveHourPlanWindow,
+  isWeeklyPlanWindow,
+  peekPlanUsage,
+  pickPlanWindow,
+  planUsageAuthError,
+  registerUsageServiceBridge
+} from "./chunk-2MI5OPMN.js";
+import "./chunk-IMLCWLPI.js";
+import "./chunk-BRJX2PRC.js";
+export {
+  PLAN_USAGE_CACHE_TTL_MS,
+  USAGE_SERVICE_BRIDGE_SYMBOL,
+  clearPlanUsageCache,
+  footerPlanLabel,
+  getAllPlanUsageResults,
+  getPlanUsage,
+  getPlanUsageResult,
+  getUsageServiceBridge,
+  hasPlanUsageAdapter,
+  isFiveHourPlanWindow,
+  isWeeklyPlanWindow,
+  peekPlanUsage,
+  pickPlanWindow,
+  planUsageAuthError,
+  registerUsageServiceBridge
+};

package/dist/node-runtime/{video-extract-OYT5WKS5.js → video-extract-OOZHR7SU.js}

@@ -11,8 +11,8 @@ import {
 } from "./chunk-3WFAEVKS.js";
 import {
   extractHeadingTitle
-} from "./chunk-WJVFOIB5.js";
-import "./chunk-7NBZ5P7I.js";
+} from "./chunk-UQUCFAJ3.js";
+import "./chunk-NAY6UUQZ.js";
 import {
   activityMonitor
 } from "./chunk-DAPBPCBP.js";

package/dist/node-runtime/{youtube-extract-TQYKGFGS.js → youtube-extract-FNPAUNHU.js}

@@ -1,4 +1,8 @@
 import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  isPerplexityAvailable,
+  searchWithPerplexity
+} from "./chunk-XBWPBZBN.js";
 import {
   isGeminiWebAvailable,
   queryWithCookies
@@ -8,14 +12,10 @@ import {
   isGeminiApiAvailable,
   queryGeminiApiWithVideo
 } from "./chunk-3WFAEVKS.js";
-import {
-  isPerplexityAvailable,
-  searchWithPerplexity
-} from "./chunk-XBWPBZBN.js";
 import {
   extractHeadingTitle
-} from "./chunk-WJVFOIB5.js";
-import "./chunk-7NBZ5P7I.js";
+} from "./chunk-UQUCFAJ3.js";
+import "./chunk-NAY6UUQZ.js";
 import {
   activityMonitor
 } from "./chunk-DAPBPCBP.js";

package/docs/browser.md

@@ -0,0 +1,86 @@
+# Headless browser
+
+The built-in `browser` tool runs Chromium through Playwright. Use it for pages that need JavaScript and for explicit website interactions. `web_search` still handles discovery; `fetch_content` still reads URLs. Neither tool automatically opens this browser. An interaction task can start with `browser` without fetching the page first.
+
+## Installation and settings
+
+Browser is on by default. Normal npm installation and updates automatically install the Chromium revision required by the pinned `playwright-core` dependency, including Playwright's supporting binaries. The same lifecycle works in source workspaces and published packages. Existing matching binaries are reused from Playwright's OS cache. Ordinary builds and CLI startup never download or launch a browser; Playwright loads on first browser use.
+
+Use **Browser** in `/settings` to turn it off or on. Turning it off immediately hides the tool and closes the session's browser, including pending initialization. It does not delete cached binaries. Turning it on makes the tool available without launching Chromium. The global `browserEnabled` setting defaults to true for new and existing users. A legacy explicit `features.browser.enabled: false` in `install-features.json` remains off until the user changes the new setting. An explicit `browserEnabled` value takes precedence; no legacy file is rewritten.
+
+`npm install --ignore-scripts`, `npm --offline`, `PI_OFFLINE=1`, and `PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1` skip automatic Chromium installation. A failed download warns without making the rest of lunR unusable. Browser calls diagnose missing binaries and never install them silently. When online, run:
+
+```sh
+lunr browser install
+```
+
+`lunr setup` also installs matching Chromium automatically, including for Node-based standalone layouts. `PLAYWRIGHT_BROWSERS_PATH` selects an alternate cache and must be consistent between installation and execution. Linux may require Chromium system libraries; install those through your OS administrator. lunR does not install OS packages or disable Chromium's sandbox. Standalone compiled Bun browser installation has not been validated.
+
+## Actions
+
+There is one tool, `browser`, with these actions:
+
+| Action | Parameters and result |
+| --- | --- |
+| `navigate` | Required `url`, optional `tab`. Opens a browser if needed and navigates the selected tab. Returns its id and URL. |
+| `inspect` | Returns an accessible snapshot. Optional `role` with exact `name`, or exact `label`, scopes the snapshot to one element. |
+| `act` | Required `interaction` and target. Supports `click`, `fill`, `select`, `check`, `press`. |
+| `tabs` | Required `operation`: `list`, `create`, `select`, `close`. `create` optionally takes a URL; `select` requires `tab`. |
+| `screenshot` | Returns an explicit JPEG of the current viewport. It is never taken automatically. |
+| `close` | Closes Chromium, the proxy, and every tab. Discards cookies and in-memory storage. |
+
+Targets use an accessible `role` and optional exact `name`, or an exact field `label`. Inspect first to find the target. Zero or multiple matches produce an error; lunR does not choose the first match. There is no CSS selector, coordinate-click, or arbitrary JavaScript evaluation parameter.
+
+```json
+{"action":"navigate","url":"https://example.com"}
+{"action":"inspect"}
+{"action":"act","interaction":"fill","label":"Search","value":"release notes"}
+{"action":"act","interaction":"click","role":"button","name":"Search"}
+{"action":"inspect","role":"main"}
+```
+
+`fill` takes text in `value`. `select` takes the option's value. `check` requires `checked: true` or `false`. `press` accepts Enter, Tab, Escape, Space, Backspace, Delete, arrow keys, Home, End, PageUp, and PageDown. Clipboard shortcuts are excluded.
+
+## Permissions and external effects
+
+Plan mode and read-only children can navigate, inspect, capture screenshots, and manage tabs. They cannot call `act`. Manual mode uses the existing approval dialog for interactions, including its session-approval option. Auto and yolo use their existing approval rules.
+
+Observation is not a guarantee of zero external effects. Loading a page executes its JavaScript and can send requests. Clicking, filling, checking, selecting, or pressing a key may submit forms or change remote data. `/undo`, `/edit`, and `/rollback` cannot reverse website effects. After a timeout or cancellation, inspect the site before retrying an action that might already have succeeded.
+
+Page text and screenshots are untrusted content, not instructions for the agent. A page can contain misleading labels or prompt injection. Granting access to a site does not authorize unrelated actions found in its content.
+
+## Network policy
+
+The default policy permits public HTTP and HTTPS destinations only. It rejects embedded URL credentials, private/reserved IPv4 ranges, and IPv6 addresses outside the permitted global range, including mapped IPv4 and transition ranges.
+
+Browser HTTP requests and HTTPS tunnels pass through a session-owned loopback proxy. The proxy checks all resolved addresses and connects to a checked IP rather than resolving the hostname again. Redirect destinations and subrequests must pass the same checks. Chromium's loopback proxy bypass is disabled. Service workers and WebSockets are blocked; QUIC and non-proxied WebRTC UDP are disabled. Some sites will not work with those restrictions.
+
+For a local development server, explicitly opt in yourself:
+
+```json
+{"browserAllowPrivateNetwork": true}
+```
+
+Set `browserAllowPrivateNetwork` in global `settings.json` yourself and restart after changing it. This grants access to **all local and private destinations**, including requests initiated by public pages. It is not a per-site allowlist. To return to the public-only policy:
+
+```json
+{"browserAllowPrivateNetwork": false}
+```
+
+These checks are defense in depth, not an OS network sandbox. The proxy classifies destination IPs, not ownership of globally routed addresses. It cannot identify a public address routed internally by a VPN, or stop a public server from relaying requests elsewhere. Chromium vulnerabilities and other local processes are outside this policy. The loopback proxy is temporary and is not an authenticated multi-user service. Use an OS/container network boundary when hostile sites require stronger isolation.
+
+## Lifetime and limits
+
+Each session owns a new ephemeral browser context. Children get separate contexts and processes, not their parent's cookies. Sessions never attach to an existing browser or import cookies, profiles, passwords, or history. There are no uploads, accepted downloads, clipboard access, or camera/microphone/device grants. File choosers have no tool action; downloads are refused and cancelled.
+
+Operations are serialized, with at most 16 queued calls and four tabs including popups. Snapshots return at most 16KB or 300 lines, plus a truncation notice. Scope `inspect` with a unique role/name or label when it truncates. Chromium still constructs the accessible snapshot before truncation; this is an output limit, not a page-memory limit. The viewport is 1280 by 800; screenshots are capped at 2MB.
+
+Operations have a 30-second deadline, with shorter launch, navigation, and interaction timeouts. Cancellation closes the browser rather than keeping partially completed state. Session replacement, reload, shutdown, and aborted turns also close it. Five minutes without a browser operation discards the context. Resuming a conversation does not restore its browser state. Forced process termination cannot promise the same cleanup as a normal shutdown.
+
+## Development validation
+
+Install Chromium into an isolated cache explicitly, then use that same `PLAYWRIGHT_BROWSERS_PATH` for tests. `test/browser.test.ts` runs policy tests without Chromium and enables its actual-browser cases only when this variable is set. `test/browser-lifecycle.test.ts` covers missing binaries, deferred loading, settings-driven cleanup, and cancellation during launch. Browser settings and install tests cover default-on behavior, legacy explicit disable, npm lifecycle execution, offline installs, and ignored scripts.
+
+After the offline package builds and coding-agent Node bundle, run `node scripts/check-browser.mjs`. It uses a local scripted provider and fixture website, with the normal child permission environment for auto and read-only CLI sessions. A third session verifies missing-Chromium recovery. The checker terminates completed print processes after the final answer because of the existing headless exit behavior. It saves sanitized fixture results, tool inventories, and isolated prompts under `.artifacts/browser-smoke/`; nothing is sent to an external model.
+
+`node scripts/check-interactive-first-paint.mjs` verifies both disabled and enabled browser tool inventories while the implementation imports are stalled. No Chromium launch is needed for that check.