@athenaintel/react 0.22.4 → 0.23.0

package/dist/search/useAthenaRepoSearch.cjs

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactQuery = require("@tanstack/react-query");
+const react = require("react");
+const mint = require("../collab/mint.cjs");
+const errors = require("../diagnostics/errors.cjs");
+const AthenaContext = require("../provider/AthenaContext.cjs");
+const statewireAuthHeaders = require("../runtime/statewire-auth-headers.cjs");
+const credentialShape = require("../threads/credential-shape.cjs");
+const ATHENA_REPO_SEARCH_PATH = "/api/search/repositories";
+function repoSearchRequestBody(params) {
+  var _a, _b, _c;
+  const body = { query: params.query.trim() };
+  if (params.limit !== void 0) body.limit = params.limit;
+  if (params.mode !== void 0) body.mode = params.mode;
+  if ((_a = params.repositoryAssetIds) == null ? void 0 : _a.length) body.repository_asset_ids = params.repositoryAssetIds;
+  if ((_b = params.paths) == null ? void 0 : _b.length) body.paths = params.paths;
+  if ((_c = params.languages) == null ? void 0 : _c.length) body.languages = params.languages;
+  return body;
+}
+function isAbortError(error) {
+  return (error instanceof DOMException || error instanceof Error) && error.name === "AbortError";
+}
+async function fetchRepoSearch(backendUrl, auth, params, opts = {}) {
+  const url = `${mint.getAthenaApiBaseUrl(backendUrl)}${ATHENA_REPO_SEARCH_PATH}`;
+  const body = JSON.stringify(repoSearchRequestBody(params));
+  const post = async (staleAuth) => {
+    const headers = await statewireAuthHeaders.resolveStatewireAuthHeaders(auth, { staleAuth });
+    try {
+      return await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...headers },
+        body,
+        signal: opts.signal ?? null
+      });
+    } catch (error) {
+      if (isAbortError(error)) throw error;
+      throw new errors.AthenaSdkError({
+        code: "repo_search_failed",
+        message: "Repository search could not reach the Agora API.",
+        cause: error,
+        hint: "Check the network and that backendUrl points at the Agora API base."
+      });
+    }
+  };
+  let res = await post(false);
+  if (res.status === 401 && auth.getToken) res = await post(true);
+  if (!res.ok) {
+    const refused = res.status === 401 || res.status === 403;
+    throw new errors.AthenaSdkError({
+      code: refused ? "auth_rejected" : "repo_search_failed",
+      message: `Repository search failed: ${res.status}`,
+      status: res.status,
+      detail: await res.json().catch(() => void 0),
+      hint: refused ? "Repository search is limited to Athena platform staff on the managed cloud; check the credential." : res.status === 404 ? "Repository search is not offered on this deployment (managed cloud only)." : "Check backendUrl points at the Agora API base and that Clio is available."
+    });
+  }
+  return await res.json();
+}
+function useAthenaRepoSearch({
+  enabled = true,
+  ...params
+}) {
+  const config = AthenaContext.useAthenaConfig();
+  const { backendUrl, apiKey, getToken } = config;
+  const credentialsRef = react.useRef(credentialShape.credentialShape({ apiKey, token: config.token, getToken }));
+  const generationRef = react.useRef(0);
+  const currentCredentials = credentialShape.credentialShape({ apiKey, token: config.token, getToken });
+  if (!credentialShape.sameCredentialShape(credentialsRef.current, currentCredentials)) {
+    credentialsRef.current = currentCredentials;
+    generationRef.current += 1;
+  }
+  const body = repoSearchRequestBody(params);
+  const contextClient = react.useContext(reactQuery.QueryClientContext);
+  const [fallbackClient] = react.useState(() => contextClient ? void 0 : new reactQuery.QueryClient());
+  return reactQuery.useQuery(
+    {
+      queryKey: ["athena-sdk", "repo-search", backendUrl, generationRef.current, body],
+      // `config.token` is read at fetch time: the provider serves the latest
+      // token through a getter, so rotations reach the request.
+      queryFn: ({ signal }) => fetchRepoSearch(backendUrl, { apiKey, token: config.token, getToken }, params, { signal }),
+      enabled: enabled && body.query.length > 0 && backendUrl.length > 0,
+      staleTime: 3e4,
+      placeholderData: reactQuery.keepPreviousData,
+      refetchOnWindowFocus: false
+    },
+    contextClient ?? fallbackClient
+  );
+}
+exports.ATHENA_REPO_SEARCH_PATH = ATHENA_REPO_SEARCH_PATH;
+exports.fetchRepoSearch = fetchRepoSearch;
+exports.repoSearchRequestBody = repoSearchRequestBody;
+exports.useAthenaRepoSearch = useAthenaRepoSearch;
+//# sourceMappingURL=useAthenaRepoSearch.cjs.map

package/dist/search/useAthenaRepoSearch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAthenaRepoSearch.cjs","sources":["../../src/search/useAthenaRepoSearch.ts"],"sourcesContent":["/**\n * Code search over the workspace's indexed repositories —\n * `POST /api/search/repositories` (agora `web/api/search/repositories.py`),\n * the HTTP face of Clio's repository source for a Devin-style \"Ask\" surface\n * that searches the monorepo without an agent turn. Athena platform staff\n * only (the account-level `is_admin`, not a workspace role) on the managed\n * cloud today: a non-staff caller reads `403`, a private deployment `404`.\n */\nimport {\n  keepPreviousData,\n  QueryClient,\n  QueryClientContext,\n  useQuery,\n  type UseQueryResult,\n} from '@tanstack/react-query';\nimport { useContext, useRef, useState } from 'react';\nimport { getAthenaApiBaseUrl } from '../collab/mint';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  resolveStatewireAuthHeaders,\n  type StatewireAuthSource,\n} from '../runtime/statewire-auth-headers';\nimport { credentialShape, sameCredentialShape } from '../threads/credential-shape';\n\nexport type AthenaRepoSearchMode = 'hybrid' | 'lexical';\n\n/** One file range of one indexed repository, as the route serves it. */\nexport interface AthenaRepoSearchHit {\n  /** The GitHub catalog asset the repository is connected through. */\n  catalogAssetId: string;\n  /** `owner/repo`; `null` when the catalog names no repository. */\n  repoFullName: string | null;\n  /** Repo-relative, `/`-separated. */\n  path: string;\n  /** 1-based, inclusive. */\n  startLine: number;\n  endLine: number;\n  /** The enclosing declaration (`Class.method`) when the chunk's header named one. */\n  symbol: string | null;\n  /** Clio's language name for the file (`python`, `typescript`, …). */\n  language: string | null;\n  /** `code` (an AST chunk) or `window` (a Markdown heading window). */\n  unitType: string;\n  score: number;\n  /** The indexed commit the hit was read at. */\n  commitSha: string | null;\n  /** `{origin}/{owner}/{repo}/blob/{sha}/{path}#L{a}-L{b}`, GHES-aware. */\n  githubUrl: string | null;\n  /** The chunk's lines, header line removed, line breaks preserved. */\n  snippet: string;\n  /** `asset_<catalog>?anchor=file_line_range&…` — what `read_asset` and a citation take. */\n  readAssetReference: string;\n}\n\nexport interface AthenaRepoSearchResponse {\n  /** Best first, at most `limit`. */\n  hits: AthenaRepoSearchHit[];\n  tookMs: number;\n  mode: AthenaRepoSearchMode;\n}\n\nexport interface AthenaRepoSearchParams {\n  query: string;\n  /** 1–25; the route's default is 10. */\n  limit?: number;\n  /** `hybrid` (default) or `lexical`. */\n  mode?: AthenaRepoSearchMode;\n  /** Search these GitHub catalog assets only; empty means every indexed repository. */\n  repositoryAssetIds?: string[];\n  /** gitignore-style globs a hit's path must match (`agora/**\\/*.py`, `docs/`). */\n  paths?: string[];\n  /** Clio language names a hit's file must be indexed as. */\n  languages?: string[];\n}\n\nexport interface UseAthenaRepoSearchOptions extends AthenaRepoSearchParams {\n  /** `false` holds the query idle (a blank `query` does too). Default `true`. */\n  enabled?: boolean;\n}\n\n/** The route's JSON body — snake_case, unset filters omitted. */\nexport interface AthenaRepoSearchRequestBody {\n  query: string;\n  limit?: number;\n  mode?: AthenaRepoSearchMode;\n  repository_asset_ids?: string[];\n  paths?: string[];\n  languages?: string[];\n}\n\nexport const ATHENA_REPO_SEARCH_PATH = '/api/search/repositories';\n\nexport function repoSearchRequestBody(params: AthenaRepoSearchParams): AthenaRepoSearchRequestBody {\n  const body: AthenaRepoSearchRequestBody = { query: params.query.trim() };\n  if (params.limit !== undefined) body.limit = params.limit;\n  if (params.mode !== undefined) body.mode = params.mode;\n  if (params.repositoryAssetIds?.length) body.repository_asset_ids = params.repositoryAssetIds;\n  if (params.paths?.length) body.paths = params.paths;\n  if (params.languages?.length) body.languages = params.languages;\n  return body;\n}\n\n/** A `fetch` the caller cancelled (unmount, a newer query): lifecycle, not failure. */\nfunction isAbortError(error: unknown): boolean {\n  return (error instanceof DOMException || error instanceof Error) && error.name === 'AbortError';\n}\n\n/**\n * One search request. The credential rides `Authorization: Bearer` (a token,\n * resolved live through `getToken` when the host provided one) or\n * `X-API-KEY`; with neither, a same-origin host's session cookie rides\n * automatically, as the SDK's other REST helpers allow. A `401` gets one\n * forced re-mint through `getToken` (`force: true`, the statewire\n * transport's `staleAuth` contract) — a getter that caches until forced would\n * otherwise resend the same expired token on every retry. Every failure is an\n * `AthenaSdkError`, transport rejections included; only an abort keeps its\n * own identity.\n */\nexport async function fetchRepoSearch(\n  backendUrl: string,\n  auth: StatewireAuthSource,\n  params: AthenaRepoSearchParams,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AthenaRepoSearchResponse> {\n  const url = `${getAthenaApiBaseUrl(backendUrl)}${ATHENA_REPO_SEARCH_PATH}`;\n  const body = JSON.stringify(repoSearchRequestBody(params));\n  const post = async (staleAuth: boolean): Promise<Response> => {\n    const headers = await resolveStatewireAuthHeaders(auth, { staleAuth });\n    try {\n      return await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', ...headers },\n        body,\n        signal: opts.signal ?? null,\n      });\n    } catch (error) {\n      if (isAbortError(error)) throw error;\n      throw new AthenaSdkError({\n        code: 'repo_search_failed',\n        message: 'Repository search could not reach the Agora API.',\n        cause: error,\n        hint: 'Check the network and that backendUrl points at the Agora API base.',\n      });\n    }\n  };\n  let res = await post(false);\n  if (res.status === 401 && auth.getToken) res = await post(true);\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'repo_search_failed',\n      message: `Repository search failed: ${res.status}`,\n      status: res.status,\n      detail: await res.json().catch(() => undefined),\n      hint: refused\n        ? 'Repository search is limited to Athena platform staff on the managed cloud; check the credential.'\n        : res.status === 404\n          ? 'Repository search is not offered on this deployment (managed cloud only).'\n          : 'Check backendUrl points at the Agora API base and that Clio is available.',\n    });\n  }\n  return (await res.json()) as AthenaRepoSearchResponse;\n}\n\n/**\n * Search the indexed repositories through TanStack Query with the provider's\n * `backendUrl` and credentials. Keyed by the non-secret request and a\n * credential generation (a counter that advances when the host's credentials\n * change), never by the credential itself. Uses the host's `QueryClient` when\n * one is in context (`enableThreadList` mounts the SDK's own) and a\n * hook-scoped client otherwise, so it works under any `<AthenaProvider>`.\n */\nexport function useAthenaRepoSearch({\n  enabled = true,\n  ...params\n}: UseAthenaRepoSearchOptions): UseQueryResult<AthenaRepoSearchResponse, Error> {\n  const config = useAthenaConfig();\n  const { backendUrl, apiKey, getToken } = config;\n  const credentialsRef = useRef(credentialShape({ apiKey, token: config.token, getToken }));\n  const generationRef = useRef(0);\n  const currentCredentials = credentialShape({ apiKey, token: config.token, getToken });\n  if (!sameCredentialShape(credentialsRef.current, currentCredentials)) {\n    credentialsRef.current = currentCredentials;\n    generationRef.current += 1;\n  }\n  const body = repoSearchRequestBody(params);\n  const contextClient = useContext(QueryClientContext);\n  const [fallbackClient] = useState(() => (contextClient ? undefined : new QueryClient()));\n  return useQuery(\n    {\n      queryKey: ['athena-sdk', 'repo-search', backendUrl, generationRef.current, body],\n      // `config.token` is read at fetch time: the provider serves the latest\n      // token through a getter, so rotations reach the request.\n      queryFn: ({ signal }) =>\n        fetchRepoSearch(backendUrl, { apiKey, token: config.token, getToken }, params, { signal }),\n      enabled: enabled && body.query.length > 0 && backendUrl.length > 0,\n      staleTime: 30_000,\n      placeholderData: keepPreviousData,\n      refetchOnWindowFocus: false,\n    },\n    contextClient ?? fallbackClient,\n  );\n}\n"],"names":["getAthenaApiBaseUrl","resolveStatewireAuthHeaders","AthenaSdkError","useAthenaConfig","useRef","credentialShape","sameCredentialShape","useContext","QueryClientContext","useState","QueryClient","useQuery","keepPreviousData"],"mappings":"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"}

package/dist/search/useAthenaRepoSearch.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Code search over the workspace's indexed repositories —
+ * `POST /api/search/repositories` (agora `web/api/search/repositories.py`),
+ * the HTTP face of Clio's repository source for a Devin-style "Ask" surface
+ * that searches the monorepo without an agent turn. Athena platform staff
+ * only (the account-level `is_admin`, not a workspace role) on the managed
+ * cloud today: a non-staff caller reads `403`, a private deployment `404`.
+ */
+import { type UseQueryResult } from '@tanstack/react-query';
+import { type StatewireAuthSource } from '../runtime/statewire-auth-headers';
+export type AthenaRepoSearchMode = 'hybrid' | 'lexical';
+/** One file range of one indexed repository, as the route serves it. */
+export interface AthenaRepoSearchHit {
+    /** The GitHub catalog asset the repository is connected through. */
+    catalogAssetId: string;
+    /** `owner/repo`; `null` when the catalog names no repository. */
+    repoFullName: string | null;
+    /** Repo-relative, `/`-separated. */
+    path: string;
+    /** 1-based, inclusive. */
+    startLine: number;
+    endLine: number;
+    /** The enclosing declaration (`Class.method`) when the chunk's header named one. */
+    symbol: string | null;
+    /** Clio's language name for the file (`python`, `typescript`, …). */
+    language: string | null;
+    /** `code` (an AST chunk) or `window` (a Markdown heading window). */
+    unitType: string;
+    score: number;
+    /** The indexed commit the hit was read at. */
+    commitSha: string | null;
+    /** `{origin}/{owner}/{repo}/blob/{sha}/{path}#L{a}-L{b}`, GHES-aware. */
+    githubUrl: string | null;
+    /** The chunk's lines, header line removed, line breaks preserved. */
+    snippet: string;
+    /** `asset_<catalog>?anchor=file_line_range&…` — what `read_asset` and a citation take. */
+    readAssetReference: string;
+}
+export interface AthenaRepoSearchResponse {
+    /** Best first, at most `limit`. */
+    hits: AthenaRepoSearchHit[];
+    tookMs: number;
+    mode: AthenaRepoSearchMode;
+}
+export interface AthenaRepoSearchParams {
+    query: string;
+    /** 1–25; the route's default is 10. */
+    limit?: number;
+    /** `hybrid` (default) or `lexical`. */
+    mode?: AthenaRepoSearchMode;
+    /** Search these GitHub catalog assets only; empty means every indexed repository. */
+    repositoryAssetIds?: string[];
+    /** gitignore-style globs a hit's path must match (`agora/**\/*.py`, `docs/`). */
+    paths?: string[];
+    /** Clio language names a hit's file must be indexed as. */
+    languages?: string[];
+}
+export interface UseAthenaRepoSearchOptions extends AthenaRepoSearchParams {
+    /** `false` holds the query idle (a blank `query` does too). Default `true`. */
+    enabled?: boolean;
+}
+/** The route's JSON body — snake_case, unset filters omitted. */
+export interface AthenaRepoSearchRequestBody {
+    query: string;
+    limit?: number;
+    mode?: AthenaRepoSearchMode;
+    repository_asset_ids?: string[];
+    paths?: string[];
+    languages?: string[];
+}
+export declare const ATHENA_REPO_SEARCH_PATH = "/api/search/repositories";
+export declare function repoSearchRequestBody(params: AthenaRepoSearchParams): AthenaRepoSearchRequestBody;
+/**
+ * One search request. The credential rides `Authorization: Bearer` (a token,
+ * resolved live through `getToken` when the host provided one) or
+ * `X-API-KEY`; with neither, a same-origin host's session cookie rides
+ * automatically, as the SDK's other REST helpers allow. A `401` gets one
+ * forced re-mint through `getToken` (`force: true`, the statewire
+ * transport's `staleAuth` contract) — a getter that caches until forced would
+ * otherwise resend the same expired token on every retry. Every failure is an
+ * `AthenaSdkError`, transport rejections included; only an abort keeps its
+ * own identity.
+ */
+export declare function fetchRepoSearch(backendUrl: string, auth: StatewireAuthSource, params: AthenaRepoSearchParams, opts?: {
+    signal?: AbortSignal;
+}): Promise<AthenaRepoSearchResponse>;
+/**
+ * Search the indexed repositories through TanStack Query with the provider's
+ * `backendUrl` and credentials. Keyed by the non-secret request and a
+ * credential generation (a counter that advances when the host's credentials
+ * change), never by the credential itself. Uses the host's `QueryClient` when
+ * one is in context (`enableThreadList` mounts the SDK's own) and a
+ * hook-scoped client otherwise, so it works under any `<AthenaProvider>`.
+ */
+export declare function useAthenaRepoSearch({ enabled, ...params }: UseAthenaRepoSearchOptions): UseQueryResult<AthenaRepoSearchResponse, Error>;

package/dist/search/useAthenaRepoSearch.js

@@ -0,0 +1,94 @@
+import { QueryClientContext, QueryClient, useQuery, keepPreviousData } from "@tanstack/react-query";
+import { useRef, useContext, useState } from "react";
+import { getAthenaApiBaseUrl } from "../collab/mint.js";
+import { AthenaSdkError } from "../diagnostics/errors.js";
+import { useAthenaConfig } from "../provider/AthenaContext.js";
+import { resolveStatewireAuthHeaders } from "../runtime/statewire-auth-headers.js";
+import { credentialShape, sameCredentialShape } from "../threads/credential-shape.js";
+const ATHENA_REPO_SEARCH_PATH = "/api/search/repositories";
+function repoSearchRequestBody(params) {
+  var _a, _b, _c;
+  const body = { query: params.query.trim() };
+  if (params.limit !== void 0) body.limit = params.limit;
+  if (params.mode !== void 0) body.mode = params.mode;
+  if ((_a = params.repositoryAssetIds) == null ? void 0 : _a.length) body.repository_asset_ids = params.repositoryAssetIds;
+  if ((_b = params.paths) == null ? void 0 : _b.length) body.paths = params.paths;
+  if ((_c = params.languages) == null ? void 0 : _c.length) body.languages = params.languages;
+  return body;
+}
+function isAbortError(error) {
+  return (error instanceof DOMException || error instanceof Error) && error.name === "AbortError";
+}
+async function fetchRepoSearch(backendUrl, auth, params, opts = {}) {
+  const url = `${getAthenaApiBaseUrl(backendUrl)}${ATHENA_REPO_SEARCH_PATH}`;
+  const body = JSON.stringify(repoSearchRequestBody(params));
+  const post = async (staleAuth) => {
+    const headers = await resolveStatewireAuthHeaders(auth, { staleAuth });
+    try {
+      return await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...headers },
+        body,
+        signal: opts.signal ?? null
+      });
+    } catch (error) {
+      if (isAbortError(error)) throw error;
+      throw new AthenaSdkError({
+        code: "repo_search_failed",
+        message: "Repository search could not reach the Agora API.",
+        cause: error,
+        hint: "Check the network and that backendUrl points at the Agora API base."
+      });
+    }
+  };
+  let res = await post(false);
+  if (res.status === 401 && auth.getToken) res = await post(true);
+  if (!res.ok) {
+    const refused = res.status === 401 || res.status === 403;
+    throw new AthenaSdkError({
+      code: refused ? "auth_rejected" : "repo_search_failed",
+      message: `Repository search failed: ${res.status}`,
+      status: res.status,
+      detail: await res.json().catch(() => void 0),
+      hint: refused ? "Repository search is limited to Athena platform staff on the managed cloud; check the credential." : res.status === 404 ? "Repository search is not offered on this deployment (managed cloud only)." : "Check backendUrl points at the Agora API base and that Clio is available."
+    });
+  }
+  return await res.json();
+}
+function useAthenaRepoSearch({
+  enabled = true,
+  ...params
+}) {
+  const config = useAthenaConfig();
+  const { backendUrl, apiKey, getToken } = config;
+  const credentialsRef = useRef(credentialShape({ apiKey, token: config.token, getToken }));
+  const generationRef = useRef(0);
+  const currentCredentials = credentialShape({ apiKey, token: config.token, getToken });
+  if (!sameCredentialShape(credentialsRef.current, currentCredentials)) {
+    credentialsRef.current = currentCredentials;
+    generationRef.current += 1;
+  }
+  const body = repoSearchRequestBody(params);
+  const contextClient = useContext(QueryClientContext);
+  const [fallbackClient] = useState(() => contextClient ? void 0 : new QueryClient());
+  return useQuery(
+    {
+      queryKey: ["athena-sdk", "repo-search", backendUrl, generationRef.current, body],
+      // `config.token` is read at fetch time: the provider serves the latest
+      // token through a getter, so rotations reach the request.
+      queryFn: ({ signal }) => fetchRepoSearch(backendUrl, { apiKey, token: config.token, getToken }, params, { signal }),
+      enabled: enabled && body.query.length > 0 && backendUrl.length > 0,
+      staleTime: 3e4,
+      placeholderData: keepPreviousData,
+      refetchOnWindowFocus: false
+    },
+    contextClient ?? fallbackClient
+  );
+}
+export {
+  ATHENA_REPO_SEARCH_PATH,
+  fetchRepoSearch,
+  repoSearchRequestBody,
+  useAthenaRepoSearch
+};
+//# sourceMappingURL=useAthenaRepoSearch.js.map

package/dist/search/useAthenaRepoSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAthenaRepoSearch.js","sources":["../../src/search/useAthenaRepoSearch.ts"],"sourcesContent":["/**\n * Code search over the workspace's indexed repositories —\n * `POST /api/search/repositories` (agora `web/api/search/repositories.py`),\n * the HTTP face of Clio's repository source for a Devin-style \"Ask\" surface\n * that searches the monorepo without an agent turn. Athena platform staff\n * only (the account-level `is_admin`, not a workspace role) on the managed\n * cloud today: a non-staff caller reads `403`, a private deployment `404`.\n */\nimport {\n  keepPreviousData,\n  QueryClient,\n  QueryClientContext,\n  useQuery,\n  type UseQueryResult,\n} from '@tanstack/react-query';\nimport { useContext, useRef, useState } from 'react';\nimport { getAthenaApiBaseUrl } from '../collab/mint';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  resolveStatewireAuthHeaders,\n  type StatewireAuthSource,\n} from '../runtime/statewire-auth-headers';\nimport { credentialShape, sameCredentialShape } from '../threads/credential-shape';\n\nexport type AthenaRepoSearchMode = 'hybrid' | 'lexical';\n\n/** One file range of one indexed repository, as the route serves it. */\nexport interface AthenaRepoSearchHit {\n  /** The GitHub catalog asset the repository is connected through. */\n  catalogAssetId: string;\n  /** `owner/repo`; `null` when the catalog names no repository. */\n  repoFullName: string | null;\n  /** Repo-relative, `/`-separated. */\n  path: string;\n  /** 1-based, inclusive. */\n  startLine: number;\n  endLine: number;\n  /** The enclosing declaration (`Class.method`) when the chunk's header named one. */\n  symbol: string | null;\n  /** Clio's language name for the file (`python`, `typescript`, …). */\n  language: string | null;\n  /** `code` (an AST chunk) or `window` (a Markdown heading window). */\n  unitType: string;\n  score: number;\n  /** The indexed commit the hit was read at. */\n  commitSha: string | null;\n  /** `{origin}/{owner}/{repo}/blob/{sha}/{path}#L{a}-L{b}`, GHES-aware. */\n  githubUrl: string | null;\n  /** The chunk's lines, header line removed, line breaks preserved. */\n  snippet: string;\n  /** `asset_<catalog>?anchor=file_line_range&…` — what `read_asset` and a citation take. */\n  readAssetReference: string;\n}\n\nexport interface AthenaRepoSearchResponse {\n  /** Best first, at most `limit`. */\n  hits: AthenaRepoSearchHit[];\n  tookMs: number;\n  mode: AthenaRepoSearchMode;\n}\n\nexport interface AthenaRepoSearchParams {\n  query: string;\n  /** 1–25; the route's default is 10. */\n  limit?: number;\n  /** `hybrid` (default) or `lexical`. */\n  mode?: AthenaRepoSearchMode;\n  /** Search these GitHub catalog assets only; empty means every indexed repository. */\n  repositoryAssetIds?: string[];\n  /** gitignore-style globs a hit's path must match (`agora/**\\/*.py`, `docs/`). */\n  paths?: string[];\n  /** Clio language names a hit's file must be indexed as. */\n  languages?: string[];\n}\n\nexport interface UseAthenaRepoSearchOptions extends AthenaRepoSearchParams {\n  /** `false` holds the query idle (a blank `query` does too). Default `true`. */\n  enabled?: boolean;\n}\n\n/** The route's JSON body — snake_case, unset filters omitted. */\nexport interface AthenaRepoSearchRequestBody {\n  query: string;\n  limit?: number;\n  mode?: AthenaRepoSearchMode;\n  repository_asset_ids?: string[];\n  paths?: string[];\n  languages?: string[];\n}\n\nexport const ATHENA_REPO_SEARCH_PATH = '/api/search/repositories';\n\nexport function repoSearchRequestBody(params: AthenaRepoSearchParams): AthenaRepoSearchRequestBody {\n  const body: AthenaRepoSearchRequestBody = { query: params.query.trim() };\n  if (params.limit !== undefined) body.limit = params.limit;\n  if (params.mode !== undefined) body.mode = params.mode;\n  if (params.repositoryAssetIds?.length) body.repository_asset_ids = params.repositoryAssetIds;\n  if (params.paths?.length) body.paths = params.paths;\n  if (params.languages?.length) body.languages = params.languages;\n  return body;\n}\n\n/** A `fetch` the caller cancelled (unmount, a newer query): lifecycle, not failure. */\nfunction isAbortError(error: unknown): boolean {\n  return (error instanceof DOMException || error instanceof Error) && error.name === 'AbortError';\n}\n\n/**\n * One search request. The credential rides `Authorization: Bearer` (a token,\n * resolved live through `getToken` when the host provided one) or\n * `X-API-KEY`; with neither, a same-origin host's session cookie rides\n * automatically, as the SDK's other REST helpers allow. A `401` gets one\n * forced re-mint through `getToken` (`force: true`, the statewire\n * transport's `staleAuth` contract) — a getter that caches until forced would\n * otherwise resend the same expired token on every retry. Every failure is an\n * `AthenaSdkError`, transport rejections included; only an abort keeps its\n * own identity.\n */\nexport async function fetchRepoSearch(\n  backendUrl: string,\n  auth: StatewireAuthSource,\n  params: AthenaRepoSearchParams,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AthenaRepoSearchResponse> {\n  const url = `${getAthenaApiBaseUrl(backendUrl)}${ATHENA_REPO_SEARCH_PATH}`;\n  const body = JSON.stringify(repoSearchRequestBody(params));\n  const post = async (staleAuth: boolean): Promise<Response> => {\n    const headers = await resolveStatewireAuthHeaders(auth, { staleAuth });\n    try {\n      return await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', ...headers },\n        body,\n        signal: opts.signal ?? null,\n      });\n    } catch (error) {\n      if (isAbortError(error)) throw error;\n      throw new AthenaSdkError({\n        code: 'repo_search_failed',\n        message: 'Repository search could not reach the Agora API.',\n        cause: error,\n        hint: 'Check the network and that backendUrl points at the Agora API base.',\n      });\n    }\n  };\n  let res = await post(false);\n  if (res.status === 401 && auth.getToken) res = await post(true);\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'repo_search_failed',\n      message: `Repository search failed: ${res.status}`,\n      status: res.status,\n      detail: await res.json().catch(() => undefined),\n      hint: refused\n        ? 'Repository search is limited to Athena platform staff on the managed cloud; check the credential.'\n        : res.status === 404\n          ? 'Repository search is not offered on this deployment (managed cloud only).'\n          : 'Check backendUrl points at the Agora API base and that Clio is available.',\n    });\n  }\n  return (await res.json()) as AthenaRepoSearchResponse;\n}\n\n/**\n * Search the indexed repositories through TanStack Query with the provider's\n * `backendUrl` and credentials. Keyed by the non-secret request and a\n * credential generation (a counter that advances when the host's credentials\n * change), never by the credential itself. Uses the host's `QueryClient` when\n * one is in context (`enableThreadList` mounts the SDK's own) and a\n * hook-scoped client otherwise, so it works under any `<AthenaProvider>`.\n */\nexport function useAthenaRepoSearch({\n  enabled = true,\n  ...params\n}: UseAthenaRepoSearchOptions): UseQueryResult<AthenaRepoSearchResponse, Error> {\n  const config = useAthenaConfig();\n  const { backendUrl, apiKey, getToken } = config;\n  const credentialsRef = useRef(credentialShape({ apiKey, token: config.token, getToken }));\n  const generationRef = useRef(0);\n  const currentCredentials = credentialShape({ apiKey, token: config.token, getToken });\n  if (!sameCredentialShape(credentialsRef.current, currentCredentials)) {\n    credentialsRef.current = currentCredentials;\n    generationRef.current += 1;\n  }\n  const body = repoSearchRequestBody(params);\n  const contextClient = useContext(QueryClientContext);\n  const [fallbackClient] = useState(() => (contextClient ? undefined : new QueryClient()));\n  return useQuery(\n    {\n      queryKey: ['athena-sdk', 'repo-search', backendUrl, generationRef.current, body],\n      // `config.token` is read at fetch time: the provider serves the latest\n      // token through a getter, so rotations reach the request.\n      queryFn: ({ signal }) =>\n        fetchRepoSearch(backendUrl, { apiKey, token: config.token, getToken }, params, { signal }),\n      enabled: enabled && body.query.length > 0 && backendUrl.length > 0,\n      staleTime: 30_000,\n      placeholderData: keepPreviousData,\n      refetchOnWindowFocus: false,\n    },\n    contextClient ?? fallbackClient,\n  );\n}\n"],"names":[],"mappings":"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"}