@absolutejs/absolute 0.19.0-beta.637 → 0.19.0-beta.639

package/dist/ai/index.js

@@ -749,7 +749,7 @@ var formatLeadMediaCueSummary = (input) => {
   return parts.length > 0 ? parts.join(" \xB7 ") : "none";
 };
 var formatRAGTraceMetadataRow = (key, value) => ({
-  label: key === "sqliteQueryMode" ? "SQLite query mode" : key === "postgresQueryMode" ? "Postgres query mode" : key === "sqliteQueryPushdownMode" ? "SQLite pushdown mode" : key === "postgresQueryPushdownMode" ? "Postgres pushdown mode" : key === "sqliteQueryPushdownApplied" ? "SQLite pushdown applied" : key === "postgresQueryPushdownApplied" ? "Postgres pushdown applied" : key === "sqliteQueryPushdownClauseCount" ? "SQLite pushdown clauses" : key === "postgresQueryPushdownClauseCount" ? "Postgres pushdown clauses" : key === "sqliteQueryPushdownCoverageRatio" ? "SQLite pushdown coverage" : key === "postgresQueryPushdownCoverageRatio" ? "Postgres pushdown coverage" : key === "sqliteQueryTotalFilterClauseCount" ? "SQLite total filter clauses" : key === "postgresQueryTotalFilterClauseCount" ? "Postgres total filter clauses" : key === "sqliteQueryJsRemainderClauseCount" ? "SQLite JS remainder clauses" : key === "sqliteQueryMultiplierUsed" ? "SQLite query multiplier" : key === "sqliteQueryCandidateLimitUsed" ? "SQLite candidate limit" : key === "sqliteQueryMaxBackfillsUsed" ? "SQLite max backfills" : key === "sqliteQueryMinResultsUsed" ? "SQLite min results" : key === "sqliteQueryFillPolicyUsed" ? "SQLite fill policy" : key === "postgresQueryJsRemainderClauseCount" ? "Postgres JS remainder clauses" : key === "postgresQueryMultiplierUsed" ? "Postgres query multiplier" : key === "postgresQueryCandidateLimitUsed" ? "Postgres candidate limit" : key === "postgresQueryMaxBackfillsUsed" ? "Postgres max backfills" : key === "postgresQueryMinResultsUsed" ? "Postgres min results" : key === "postgresQueryFillPolicyUsed" ? "Postgres fill policy" : key === "sqliteQueryJsRemainderRatio" ? "SQLite JS remainder share" : key === "postgresQueryJsRemainderRatio" ? "Postgres JS remainder share" : key === "sqliteQueryFilteredCandidates" ? "SQLite filtered candidates" : key === "postgresQueryFilteredCandidates" ? "Postgres filtered candidates" : key === "sqliteQueryInitialSearchK" ? "SQLite initial searchK" : key === "postgresQueryInitialSearchK" ? "Postgres initial searchK" : key === "sqliteQueryFinalSearchK" ? "SQLite final searchK" : key === "postgresQueryFinalSearchK" ? "Postgres final searchK" : key === "sqliteQuerySearchExpansionRatio" ? "SQLite search expansion" : key === "postgresQuerySearchExpansionRatio" ? "Postgres search expansion" : key === "sqliteQueryBackfillCount" ? "SQLite backfill count" : key === "sqliteQueryBackfillLimitReached" ? "SQLite backfill limit reached" : key === "sqliteQueryMinResultsSatisfied" ? "SQLite min results satisfied" : key === "postgresQueryBackfillCount" ? "Postgres backfill count" : key === "postgresQueryBackfillLimitReached" ? "Postgres backfill limit reached" : key === "postgresQueryMinResultsSatisfied" ? "Postgres min results satisfied" : key === "sqliteQueryReturnedCount" ? "SQLite returned hits" : key === "postgresQueryReturnedCount" ? "Postgres returned hits" : key === "sqliteQueryCandidateYieldRatio" ? "SQLite candidate yield" : key === "postgresQueryCandidateYieldRatio" ? "Postgres candidate yield" : key === "sqliteQueryTopKFillRatio" ? "SQLite topK fill rate" : key === "postgresQueryTopKFillRatio" ? "Postgres topK fill rate" : key === "sqliteQueryUnderfilledTopK" ? "SQLite underfilled topK" : key === "postgresQueryUnderfilledTopK" ? "Postgres underfilled topK" : key === "sqliteQueryCandidateBudgetExhausted" ? "SQLite candidate budget exhausted" : key === "postgresQueryCandidateBudgetExhausted" ? "Postgres candidate budget exhausted" : key === "sqliteQueryCandidateCoverage" ? "SQLite candidate coverage" : key === "postgresQueryCandidateCoverage" ? "Postgres candidate coverage" : key === "leadSpeakerCue" ? "Lead speaker cue" : key === "leadSpeakerAttributionCue" ? "Lead speaker attribution" : key === "leadChannelAttributionCue" ? "Lead channel attribution" : key === "leadChannelCue" ? "Lead channel cue" : key === "leadContinuityCue" ? "Lead continuity cue" : key,
+  label: key === "sqliteQueryMode" ? "SQLite query mode" : key === "postgresQueryMode" ? "Postgres query mode" : key === "sqliteQueryPushdownMode" ? "SQLite pushdown mode" : key === "postgresQueryPushdownMode" ? "Postgres pushdown mode" : key === "sqliteQueryPushdownApplied" ? "SQLite pushdown applied" : key === "postgresQueryPushdownApplied" ? "Postgres pushdown applied" : key === "sqliteQueryPushdownClauseCount" ? "SQLite pushdown clauses" : key === "postgresQueryPushdownClauseCount" ? "Postgres pushdown clauses" : key === "sqliteQueryPushdownCoverageRatio" ? "SQLite pushdown coverage" : key === "postgresQueryPushdownCoverageRatio" ? "Postgres pushdown coverage" : key === "sqliteQueryTotalFilterClauseCount" ? "SQLite total filter clauses" : key === "postgresQueryTotalFilterClauseCount" ? "Postgres total filter clauses" : key === "sqliteQueryJsRemainderClauseCount" ? "SQLite JS remainder clauses" : key === "sqliteQueryMultiplierUsed" ? "SQLite query multiplier" : key === "sqliteQueryPlannerProfileUsed" ? "SQLite query profile" : key === "sqliteQueryCandidateLimitUsed" ? "SQLite candidate limit" : key === "sqliteQueryMaxBackfillsUsed" ? "SQLite max backfills" : key === "sqliteQueryMinResultsUsed" ? "SQLite min results" : key === "sqliteQueryFillPolicyUsed" ? "SQLite fill policy" : key === "postgresQueryJsRemainderClauseCount" ? "Postgres JS remainder clauses" : key === "postgresQueryMultiplierUsed" ? "Postgres query multiplier" : key === "postgresQueryPlannerProfileUsed" ? "Postgres query profile" : key === "postgresQueryCandidateLimitUsed" ? "Postgres candidate limit" : key === "postgresQueryMaxBackfillsUsed" ? "Postgres max backfills" : key === "postgresQueryMinResultsUsed" ? "Postgres min results" : key === "postgresQueryFillPolicyUsed" ? "Postgres fill policy" : key === "sqliteQueryJsRemainderRatio" ? "SQLite JS remainder share" : key === "postgresQueryJsRemainderRatio" ? "Postgres JS remainder share" : key === "sqliteQueryFilteredCandidates" ? "SQLite filtered candidates" : key === "postgresQueryFilteredCandidates" ? "Postgres filtered candidates" : key === "sqliteQueryInitialSearchK" ? "SQLite initial searchK" : key === "postgresQueryInitialSearchK" ? "Postgres initial searchK" : key === "sqliteQueryFinalSearchK" ? "SQLite final searchK" : key === "postgresQueryFinalSearchK" ? "Postgres final searchK" : key === "sqliteQuerySearchExpansionRatio" ? "SQLite search expansion" : key === "postgresQuerySearchExpansionRatio" ? "Postgres search expansion" : key === "sqliteQueryBackfillCount" ? "SQLite backfill count" : key === "sqliteQueryBackfillLimitReached" ? "SQLite backfill limit reached" : key === "sqliteQueryMinResultsSatisfied" ? "SQLite min results satisfied" : key === "postgresQueryBackfillCount" ? "Postgres backfill count" : key === "postgresQueryBackfillLimitReached" ? "Postgres backfill limit reached" : key === "postgresQueryMinResultsSatisfied" ? "Postgres min results satisfied" : key === "sqliteQueryReturnedCount" ? "SQLite returned hits" : key === "postgresQueryReturnedCount" ? "Postgres returned hits" : key === "sqliteQueryCandidateYieldRatio" ? "SQLite candidate yield" : key === "postgresQueryCandidateYieldRatio" ? "Postgres candidate yield" : key === "sqliteQueryTopKFillRatio" ? "SQLite topK fill rate" : key === "postgresQueryTopKFillRatio" ? "Postgres topK fill rate" : key === "sqliteQueryUnderfilledTopK" ? "SQLite underfilled topK" : key === "postgresQueryUnderfilledTopK" ? "Postgres underfilled topK" : key === "sqliteQueryCandidateBudgetExhausted" ? "SQLite candidate budget exhausted" : key === "postgresQueryCandidateBudgetExhausted" ? "Postgres candidate budget exhausted" : key === "sqliteQueryCandidateCoverage" ? "SQLite candidate coverage" : key === "postgresQueryCandidateCoverage" ? "Postgres candidate coverage" : key === "leadSpeakerCue" ? "Lead speaker cue" : key === "leadSpeakerAttributionCue" ? "Lead speaker attribution" : key === "leadChannelAttributionCue" ? "Lead channel attribution" : key === "leadChannelCue" ? "Lead channel cue" : key === "leadContinuityCue" ? "Lead continuity cue" : key,
   value: key === "sourceAwareChunkReason" ? formatSourceAwareChunkReason(value) ?? formatRAGTraceValue(value) : key === "leadSpeakerAttributionCue" ? formatLeadSpeakerAttributionCue(value) ?? formatRAGTraceValue(value) : key === "leadChannelAttributionCue" ? formatLeadChannelAttributionCue(value) ?? formatRAGTraceValue(value) : key === "leadContinuityCue" ? formatLeadContinuityCue(value) ?? formatRAGTraceValue(value) : formatRAGTraceValue(value)
 });
 var buildRAGRetrievalTracePresentation = (trace) => {
@@ -2521,6 +2521,7 @@ var formatSQLitePlannerCueSummary = (input) => {
     typeof input?.sqliteQueryPushdownClauseCount === "number" ? `clauses ${input.sqliteQueryPushdownClauseCount}` : undefined,
     typeof input?.sqliteQueryPushdownCoverageRatio === "number" ? `pushdown ${(input.sqliteQueryPushdownCoverageRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.sqliteQueryJsRemainderClauseCount === "number" ? `js remainder ${input.sqliteQueryJsRemainderClauseCount}` : undefined,
+    input?.sqliteQueryPlannerProfileUsed ? `profile ${input.sqliteQueryPlannerProfileUsed}` : undefined,
     typeof input?.sqliteQueryMultiplierUsed === "number" ? `x${input.sqliteQueryMultiplierUsed}` : undefined,
     typeof input?.sqliteQueryCandidateLimitUsed === "number" ? `cap ${input.sqliteQueryCandidateLimitUsed}` : undefined,
     typeof input?.sqliteQueryMaxBackfillsUsed === "number" ? `backfills ${input.sqliteQueryMaxBackfillsUsed}` : undefined,
@@ -2553,6 +2554,7 @@ var formatPostgresPlannerCueSummary = (input) => {
     typeof input?.postgresQueryPushdownClauseCount === "number" ? `clauses ${input.postgresQueryPushdownClauseCount}` : undefined,
     typeof input?.postgresQueryPushdownCoverageRatio === "number" ? `pushdown ${(input.postgresQueryPushdownCoverageRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.postgresQueryJsRemainderClauseCount === "number" ? `js remainder ${input.postgresQueryJsRemainderClauseCount}` : undefined,
+    input?.postgresQueryPlannerProfileUsed ? `profile ${input.postgresQueryPlannerProfileUsed}` : undefined,
     typeof input?.postgresQueryMultiplierUsed === "number" ? `x${input.postgresQueryMultiplierUsed}` : undefined,
     typeof input?.postgresQueryCandidateLimitUsed === "number" ? `cap ${input.postgresQueryCandidateLimitUsed}` : undefined,
     typeof input?.postgresQueryMaxBackfillsUsed === "number" ? `backfills ${input.postgresQueryMaxBackfillsUsed}` : undefined,
@@ -16662,6 +16664,37 @@ var prepareRAGDirectoryDocuments = async (input) => prepareRAGDocuments(await lo
 
 // src/ai/rag/collection.ts
 var DEFAULT_TOP_K2 = 6;
+var resolveNativeQueryProfile = (input) => {
+  if (!input.profile) {
+    return;
+  }
+  if (input.profile === "latency") {
+    return {
+      candidateLimit: Math.max(1, Math.min(input.candidateTopK, input.topK)),
+      fillPolicy: "satisfy_min_results",
+      maxBackfills: 0,
+      minResults: 1,
+      plannerProfile: input.profile,
+      queryMultiplier: 1
+    };
+  }
+  if (input.profile === "recall") {
+    return {
+      fillPolicy: "strict_topk",
+      maxBackfills: 4,
+      minResults: input.topK,
+      plannerProfile: input.profile,
+      queryMultiplier: 8
+    };
+  }
+  return {
+    fillPolicy: "satisfy_min_results",
+    maxBackfills: 1,
+    minResults: Math.max(1, Math.min(input.topK, Math.ceil(input.topK / 2))),
+    plannerProfile: input.profile,
+    queryMultiplier: 4
+  };
+};
 var VARIANT_RESULT_WEIGHT = 0.92;
 var normalizeTraceCueText = (value) => value.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim().replace(/\s+/g, " ");
 var queryIncludesTraceCue = (query, value) => {
@@ -16991,6 +17024,7 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
       sqliteQueryTotalFilterClauseCount: sqliteNativePlan.totalFilterClauseCount,
       sqliteQueryJsRemainderClauseCount: sqliteNativePlan.jsRemainderClauseCount,
       sqliteQueryMultiplierUsed: sqliteNativePlan.queryMultiplierUsed ?? null,
+      sqliteQueryPlannerProfileUsed: sqliteNativePlan.plannerProfileUsed ?? null,
       sqliteQueryCandidateLimitUsed: sqliteNativePlan.candidateLimitUsed ?? null,
       sqliteQueryMaxBackfillsUsed: sqliteNativePlan.maxBackfillsUsed ?? null,
       sqliteQueryMinResultsUsed: sqliteNativePlan.minResultsUsed ?? null,
@@ -17024,6 +17058,7 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
     postgresQueryTotalFilterClauseCount: postgresNativePlan.totalFilterClauseCount,
     postgresQueryJsRemainderClauseCount: postgresNativePlan.jsRemainderClauseCount,
     postgresQueryMultiplierUsed: postgresNativePlan.queryMultiplierUsed ?? null,
+    postgresQueryPlannerProfileUsed: postgresNativePlan.plannerProfileUsed ?? null,
     postgresQueryCandidateLimitUsed: postgresNativePlan.candidateLimitUsed ?? null,
     postgresQueryMaxBackfillsUsed: postgresNativePlan.maxBackfillsUsed ?? null,
     postgresQueryMinResultsUsed: postgresNativePlan.minResultsUsed ?? null,
@@ -17154,6 +17189,11 @@ var createRAGCollection = (options) => {
       });
     }
     const resultGroups = await Promise.all(searchQueries.map(async (query, queryIndex) => {
+      const nativeQueryProfile = resolveNativeQueryProfile({
+        candidateTopK,
+        profile: input.nativeQueryProfile,
+        topK
+      });
       const [vectorResults2, lexicalResults2] = await Promise.all([
         runVector ? embed({
           model,
@@ -17161,11 +17201,12 @@ var createRAGCollection = (options) => {
           text: query
         }, "query").then((nextQueryVector) => options.store.query({
           filter: input.filter,
-          candidateLimit: input.nativeCandidateLimit,
-          fillPolicy: input.nativeFillPolicy,
-          maxBackfills: input.nativeMaxBackfills,
-          minResults: input.nativeMinResults,
-          queryMultiplier: input.nativeQueryMultiplier,
+          candidateLimit: input.nativeCandidateLimit ?? nativeQueryProfile?.candidateLimit,
+          fillPolicy: input.nativeFillPolicy ?? nativeQueryProfile?.fillPolicy,
+          maxBackfills: input.nativeMaxBackfills ?? nativeQueryProfile?.maxBackfills,
+          minResults: input.nativeMinResults ?? nativeQueryProfile?.minResults,
+          plannerProfile: nativeQueryProfile?.plannerProfile,
+          queryMultiplier: input.nativeQueryMultiplier ?? nativeQueryProfile?.queryMultiplier,
           queryVector: nextQueryVector,
           topK: candidateTopK
         })) : Promise.resolve([]),
@@ -22155,6 +22196,7 @@ var ragChat = (config) => {
     }
     const input = {
       filter: getObjectProperty(body, "filter"),
+      nativeQueryProfile: body.nativeQueryProfile === "latency" || body.nativeQueryProfile === "balanced" || body.nativeQueryProfile === "recall" ? body.nativeQueryProfile : undefined,
       nativeCandidateLimit: typeof body.nativeCandidateLimit === "number" ? body.nativeCandidateLimit : undefined,
       nativeMaxBackfills: typeof body.nativeMaxBackfills === "number" ? body.nativeMaxBackfills : undefined,
       nativeMinResults: typeof body.nativeMinResults === "number" ? body.nativeMinResults : undefined,
@@ -26388,6 +26430,8 @@ var DEFAULT_DIRECTORY_EXTENSIONS2 = [
   ".yml",
   ".pdf"
 ];
+var DEFAULT_GITHUB_EXTENSION_FILTER = DEFAULT_DIRECTORY_EXTENSIONS2;
+var DEFAULT_GITHUB_MAX_DEPTH = 12;
 var isSyncExtractionFailure = (message) => message.startsWith("No RAG file extractor matched") || message.includes("could not extract readable text from this PDF") || message.includes("detected malformed JSONL") || message.includes("detected malformed CSV") || message.includes("detected malformed TSV") || message.includes("detected malformed XML") || message.includes("detected malformed YAML") || message.startsWith("RAG extractor ") || message.includes("extract failed");
 var inferSyncExtractionRemediation = (message) => {
   if (message.includes("could not extract readable text from this PDF")) {
@@ -27629,6 +27673,248 @@ var loadDiscoveredURLDocuments = async (input) => {
     }
   };
 };
+var normalizeGitHubPath = (path) => path?.trim().replace(/^[\\/]+/g, "").replace(/[\\]+/g, "/").replace(/\/+/g, "/").replace(/\/$/, "");
+var normalizeGitHubPathFilter = (path) => normalizeGitHubPath(path)?.toLowerCase();
+var matchesPathFilter = (path, pattern) => {
+  const normalizedPath = normalizeGitHubPath(path)?.toLowerCase();
+  const normalizedPattern = normalizeGitHubPathFilter(pattern);
+  if (!normalizedPath || !normalizedPattern) {
+    return false;
+  }
+  const isDirectory = normalizedPattern.endsWith("/");
+  const patternWithoutTrailingSlash = isDirectory ? normalizedPattern.replace(/\/$/, "") : normalizedPattern;
+  if (normalizedPath === patternWithoutTrailingSlash) {
+    return true;
+  }
+  if (isDirectory && normalizedPath.startsWith(`${patternWithoutTrailingSlash}/`)) {
+    return true;
+  }
+  return normalizedPath.includes(normalizedPattern);
+};
+var shouldIncludeGitHubPath = (path, input) => {
+  const normalizedPath = normalizeGitHubPath(path)?.toLowerCase();
+  if (!normalizedPath) {
+    return false;
+  }
+  const extension = normalizedPath.includes(".") ? normalizedPath.slice(normalizedPath.lastIndexOf(".")) : "";
+  if (!input.includeExtensions.has(extension)) {
+    return false;
+  }
+  if ((input.includePaths?.length ?? 0) > 0) {
+    const matchedInclude = input.includePaths?.some((pattern) => matchesPathFilter(normalizedPath, pattern));
+    if (!matchedInclude) {
+      return false;
+    }
+  }
+  if ((input.excludePaths?.length ?? 0) > 0) {
+    if ((input.excludePaths ?? []).some((pattern) => matchesPathFilter(normalizedPath, pattern))) {
+      return false;
+    }
+  }
+  return true;
+};
+var buildGitHubHeaders = (token) => {
+  if (!token) {
+    return;
+  }
+  return {
+    Authorization: `Bearer ${token}`,
+    Accept: "application/vnd.github+json",
+    "X-GitHub-Api-Version": "2022-11-28"
+  };
+};
+var buildGitHubContentsURL = (input) => {
+  const apiBase = input.apiBaseURL.replace(/\/$/, "");
+  const normalizedPath = normalizeGitHubPath(input.path);
+  const encodedPath = normalizedPath?.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/") ?? "";
+  const endpoint = `/repos/${encodeURIComponent(input.repo.owner)}/${encodeURIComponent(input.repo.repo)}/contents`;
+  const url = new URL(encodedPath ? `${endpoint}/${encodedPath}` : endpoint, `${apiBase}/`);
+  if (input.branch) {
+    url.searchParams.set("ref", input.branch);
+  }
+  url.searchParams.set("per_page", "100");
+  return url.toString();
+};
+var parseGitHubContents = async (response, path) => {
+  const body = await response.json();
+  if (Array.isArray(body)) {
+    return body;
+  }
+  if (body && typeof body === "object" && typeof body.type === "string") {
+    return [body];
+  }
+  throw new Error(`Unexpected GitHub contents response at ${path}`);
+};
+var buildGitHubRawURL = (input) => {
+  if (input.fallbackDownloadURL && typeof input.fallbackDownloadURL === "string") {
+    return input.fallbackDownloadURL;
+  }
+  const branch = input.branch ?? "main";
+  const encodedPath = normalizeGitHubPath(input.path)?.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/") ?? "";
+  return `https://raw.githubusercontent.com/${encodeURIComponent(input.repo.owner)}/${encodeURIComponent(input.repo.repo)}/${encodeURIComponent(branch)}/${encodedPath}`;
+};
+var loadDiscoveredGitHubRepositoryFiles = async (input) => {
+  const queue = [
+    { depth: 0, path: normalizeGitHubPath(input.repo.pathPrefix) }
+  ];
+  const seen = new Set;
+  const collected = [];
+  while (queue.length > 0) {
+    const current = queue.shift();
+    if (!current) {
+      continue;
+    }
+    const currentPath = normalizeGitHubPath(current.path) ?? "";
+    if (seen.has(currentPath)) {
+      continue;
+    }
+    seen.add(currentPath);
+    const requestURL = buildGitHubContentsURL({
+      apiBaseURL: input.apiBaseURL,
+      branch: input.branch ?? input.repo.branch,
+      path: currentPath,
+      repo: input.repo
+    });
+    const response = await fetch(requestURL, {
+      headers: input.requestHeaders
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to list GitHub repo contents at ${currentPath || `${input.repo.owner}/${input.repo.repo}`}: ${response.status} ${response.statusText}`);
+    }
+    const entries = await parseGitHubContents(response, requestURL);
+    for (const entry of entries) {
+      if (typeof entry.path !== "string" || typeof entry.type !== "string") {
+        continue;
+      }
+      if (entry.type === "file") {
+        if (!shouldIncludeGitHubPath(entry.path, {
+          excludePaths: input.repo.excludePaths,
+          includeExtensions: input.includeExtensions,
+          includePaths: input.repo.includePaths
+        })) {
+          continue;
+        }
+        const repoBranch = input.repo.branch ?? input.branch;
+        const fileURL = buildGitHubRawURL({
+          repo: input.repo,
+          branch: repoBranch,
+          fallbackDownloadURL: entry.download_url,
+          path: entry.path
+        });
+        const fileRepo = `${input.repo.owner}/${input.repo.repo}`;
+        collected.push({
+          repository: fileRepo,
+          repoBranch,
+          repoPath: currentPath,
+          metadata: {
+            ...input.defaults?.repoMetadata ?? {},
+            repo: fileRepo,
+            repoBranch,
+            repoName: input.repo.repo,
+            repoOwner: input.repo.owner,
+            repoPath: entry.path,
+            ...input.repo.metadata ?? {},
+            source: input.source
+          },
+          source: input.source,
+          path: entry.path,
+          title: `${input.repo.owner}/${input.repo.repo}:${entry.path}`,
+          url: fileURL
+        });
+        if (typeof input.maxFilesPerRepo === "number" && collected.length >= input.maxFilesPerRepo) {
+          return collected;
+        }
+        continue;
+      }
+      if (entry.type === "dir" && current.depth < input.maxDepth) {
+        queue.push({ depth: current.depth + 1, path: entry.path });
+      }
+    }
+  }
+  return collected;
+};
+var buildGitHubExtensionSet = (value) => {
+  const extensionValues = value === undefined || value.length === 0 ? DEFAULT_GITHUB_EXTENSION_FILTER : value;
+  const extensions = new Set;
+  for (const raw of extensionValues) {
+    const normalized = typeof raw === "string" && raw.trim().length > 0 ? raw.trim().startsWith(".") ? raw.trim().toLowerCase() : `.${raw.trim().toLowerCase()}` : undefined;
+    if (normalized) {
+      extensions.add(normalized);
+    }
+  }
+  if (extensions.size === 0) {
+    for (const extension of DEFAULT_GITHUB_EXTENSION_FILTER) {
+      extensions.add(extension);
+    }
+  }
+  return extensions;
+};
+var createRAGGitHubSyncSource = (options) => ({
+  description: options.description,
+  id: options.id,
+  kind: "url",
+  label: options.label,
+  metadata: options.metadata,
+  retryAttempts: options.retryAttempts,
+  retryDelayMs: options.retryDelayMs,
+  target: options.repos.length === 1 ? `${options.repos[0]?.owner ?? "unknown"}/${options.repos[0]?.repo ?? "repo"}` : `${options.repos.length} repos`,
+  sync: async ({ collection, deleteDocument, listDocuments }) => {
+    const requestHeaders = buildGitHubHeaders(options.token);
+    const extensionFilter = buildGitHubExtensionSet(options.includeExtensions);
+    const apiBaseURL = options.apiBaseUrl?.trim().replace(/\/$/, "") || "https://api.github.com";
+    const maxDepth = Math.max(0, Math.min(options.maxDepth ?? DEFAULT_GITHUB_MAX_DEPTH, 64));
+    const discoveredFiles = (await Promise.all(options.repos.map(async (repo) => {
+      return loadDiscoveredGitHubRepositoryFiles({
+        branch: repo.branch,
+        apiBaseURL,
+        includeExtensions: extensionFilter,
+        maxDepth,
+        maxFilesPerRepo: options.maxFilesPerRepo,
+        repo,
+        requestHeaders,
+        source: options.label,
+        defaults: {
+          repoMetadata: {
+            repoOwner: repo.owner,
+            repoName: repo.repo,
+            repoBranch: repo.branch,
+            repoPrefix: repo.pathPrefix ?? ""
+          }
+        }
+      });
+    }))).flat();
+    const result = await loadDiscoveredURLDocuments({
+      baseMetadata: options.baseMetadata,
+      chunkingRegistry: options.chunkingRegistry,
+      collection,
+      defaultChunking: options.defaultChunking,
+      deleteDocument,
+      extractorRegistry: options.extractorRegistry,
+      extractors: options.extractors,
+      listDocuments,
+      sourceId: options.id,
+      urlEntries: discoveredFiles.map((entry) => ({
+        metadata: {
+          ...entry.metadata,
+          repoPath: entry.path,
+          repoBranch: entry.repoBranch,
+          repo: entry.repository,
+          sourcePath: entry.path
+        },
+        title: entry.title,
+        url: entry.url
+      }))
+    });
+    return {
+      ...result,
+      metadata: {
+        ...result.metadata ?? {},
+        discoveredFileCount: discoveredFiles.length,
+        repoCount: options.repos.length
+      }
+    };
+  }
+});
 var createRAGFeedSyncSource = (options) => ({
   description: options.description,
   id: options.id,
@@ -29023,6 +29309,26 @@ var buildPostgresFilterPlan = (filter, startIndex = 0) => {
             const comparison = operator === "$gt" ? ">" : operator === "$gte" ? ">=" : operator === "$lt" ? "<" : "<=";
             return `((${actualSql}) ~ '^-?[0-9]+(\\.[0-9]+)?$' AND (${actualSql})::double precision ${comparison} ${bind(expected)})`;
           }
+          case "$contains":
+            if (isScalarField) {
+              return null;
+            }
+            if (toPostgresFilterBinding(expected) === undefined) {
+              return null;
+            }
+            return `(${metadataValueSql} IS NOT NULL AND ${metadataValueSql} ? ${bind(String(expected))})`;
+          case "$containsAny":
+          case "$containsAll": {
+            if (isScalarField || !Array.isArray(expected)) {
+              return null;
+            }
+            const values = expected.map((entry2) => toPostgresFilterBinding(entry2)).filter((entry2) => entry2 !== undefined);
+            if (values.length === 0 || values.length !== expected.length) {
+              return null;
+            }
+            const sqlArray = `ARRAY[${values.map((value2) => bind(String(value2))).join(", ")}]::text[]`;
+            return `(${metadataValueSql} IS NOT NULL AND ${metadataValueSql} ${operator === "$containsAny" ? "?|" : "?&"} ${sqlArray})`;
+          }
           default:
             return null;
         }
@@ -29063,7 +29369,7 @@ var buildPostgresPushdownFilter = (filter) => {
       }
       continue;
     }
-    if (Array.isArray(value) || isOperatorFilterRecord(value) && Object.keys(value).some((operator) => operator === "$contains" || operator === "$containsAny" || operator === "$containsAll")) {
+    if (Array.isArray(value) || isOperatorFilterRecord(value) && Object.keys(value).some((operator) => !(operator === "$exists" || operator === "$in" || operator === "$contains" || operator === "$containsAny" || operator === "$containsAll" || operator === "$ne" || operator === "$gt" || operator === "$gte" || operator === "$lt" || operator === "$lte"))) {
       continue;
     }
     const isScalarColumnKey = ["chunkId", "source", "title"].includes(key);
@@ -29216,6 +29522,7 @@ var updatePostgresLastQueryPlan = (input) => {
     maxBackfillsUsed: input.maxBackfillsUsed,
     minResultsUsed: input.minResultsUsed,
     fillPolicyUsed: input.fillPolicyUsed,
+    plannerProfileUsed: input.plannerProfileUsed,
     jsRemainderClauseCount: pushdown.jsRemainderClauseCount,
     queryMultiplierUsed: input.queryMultiplierUsed,
     jsRemainderRatio: pushdown.jsRemainderRatio,
@@ -29404,6 +29711,7 @@ var createPostgresRAGStore = (options = {}) => {
       maxBackfillsUsed: maxBackfills,
       minResultsUsed: minResults,
       fillPolicyUsed: fillTarget.fillPolicy,
+      plannerProfileUsed: input.plannerProfile,
       filter: input.filter,
       pushdownFilter,
       queryMultiplierUsed: queryMultiplier2,
@@ -30225,6 +30533,7 @@ var updateSQLiteLastQueryPlan = (input) => {
     initialSearchK: input.initialSearchK,
     searchExpansionRatio: typeof input.initialSearchK === "number" && typeof input.finalSearchK === "number" && input.initialSearchK > 0 ? input.finalSearchK / input.initialSearchK : undefined,
     jsRemainderClauseCount: pushdown.jsRemainderClauseCount,
+    plannerProfileUsed: input.plannerProfileUsed,
     candidateLimitUsed: input.candidateLimitUsed,
     maxBackfillsUsed: input.maxBackfillsUsed,
     minResultsUsed: input.minResultsUsed,
@@ -30376,6 +30685,7 @@ var createSQLiteRAGStore = (options = {}) => {
       initialSearchK: rawRows.length,
       nativeDiagnostics,
       pushdownFilter,
+      plannerProfileUsed: input.plannerProfile,
       queryMultiplierUsed: input.queryMultiplier,
       queryMode: "json_fallback",
       returnedCount: limited.length,
@@ -30482,6 +30792,7 @@ var createSQLiteRAGStore = (options = {}) => {
       initialSearchK: searchK,
       nativeDiagnostics,
       pushdownFilter,
+      plannerProfileUsed: input.plannerProfile,
       candidateLimitUsed: candidateLimit,
       maxBackfillsUsed: maxBackfills,
       minResultsUsed: minResults,
@@ -32572,6 +32883,7 @@ export {
   createRAGHTMXConfig,
   createRAGGraphEmailSyncClient,
   createRAGGmailEmailSyncClient,
+  createRAGGitHubSyncSource,
   createRAGFileSyncStateStore,
   createRAGFileSearchTraceStore,
   createRAGFileSearchTracePruneHistoryStore,
@@ -32657,5 +32969,5 @@ export {
   addRAGEvaluationSuiteCase
 };
 
-//# debugId=690A2FC8A2432BC964756E2164756E21
+//# debugId=7B7D71C6EA35C8D164756E2164756E21
 //# sourceMappingURL=index.js.map