githits 0.2.0 → 0.2.1

package/dist/shared/{chunk-1t81jdax.js → chunk-ykr7x8jp.js}

@@ -1,6 +1,6 @@
 import {
   version
-} from "./chunk-fa4571ch.js";
+} from "./chunk-szjytcvw.js";
 
 // src/services/auth-service.ts
 import { createServer } from "node:http";
@@ -602,14 +602,22 @@ function debugLog(area, payload) {
   process.stderr.write(`${text}
 `);
 }
+function isDebugAreaEnabled(area) {
+  return isAreaEnabled(area);
+}
 function isAreaEnabled(area) {
   const raw = process.env.GITHITS_DEBUG;
   if (!raw || raw === "")
     return false;
-  if (raw === "*")
-    return true;
   const scopes = raw.split(",").map((s) => s.trim()).filter(Boolean);
-  return scopes.includes(area) || scopes.includes("*");
+  if (scopes.includes(area))
+    return true;
+  if (isExplicitOnlyArea(area))
+    return false;
+  return scopes.includes("*");
+}
+function isExplicitOnlyArea(area) {
+  return area === "code-nav-wire";
 }
 
 // src/shared/request-headers.ts
@@ -1199,84 +1207,6 @@ class CodeNavigationBackendError extends Error {
     this.name = "CodeNavigationBackendError";
   }
 }
-
-class InvalidSearchSymbolsRequestError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "InvalidSearchSymbolsRequestError";
-  }
-}
-var SEARCH_SYMBOLS_QUERY = `
-query SearchSymbols(
-  $registry: Registry
-  $packageName: String
-  $repoUrl: String
-  $gitRef: String
-  $query: String
-  $keywords: [String!]
-  $matchMode: MatchMode
-  $kind: SymbolKind
-  $category: SymbolCategory
-  $filePath: String
-  $version: String
-  $limit: Int
-  $fileIntent: FileIntent
-  $waitTimeoutMs: Int
-) {
-  searchSymbols(
-    registry: $registry
-    packageName: $packageName
-    repoUrl: $repoUrl
-    gitRef: $gitRef
-    query: $query
-    keywords: $keywords
-    matchMode: $matchMode
-    kind: $kind
-    category: $category
-    filePath: $filePath
-    version: $version
-    limit: $limit
-    fileIntent: $fileIntent
-    mode: DETAILED
-    waitTimeoutMs: $waitTimeoutMs
-  ) {
-    results {
-      name
-      filePath
-      startLine
-      endLine
-      preview
-      code
-      language
-      symbolRef
-      qualifiedPath
-      kind
-      category
-      arity
-      isPublic
-      containedSymbols
-    }
-    totalMatches
-    hasMore
-    indexedVersion
-    resolution {
-      requestedVersion
-      requestedRef
-      resolvedRef
-      commitSha
-    }
-    diagnostics {
-      hint
-    }
-    warning
-    codeIndexState
-    indexingRef
-    availableVersions {
-      version
-      ref
-    }
-  }
-}`;
 var UNIFIED_SEARCH_QUERY = `
 query UnifiedSearch(
   $targets: [SearchPackageInput!]!
@@ -1320,8 +1250,11 @@ query UnifiedSearch(
           packageName
           version
           pageId
+          sourceKind
+          sourceUrl
           repoUrl
           gitRef
+          requestedRef
           filePath
           startLine
           endLine
@@ -1400,8 +1333,11 @@ query UnifiedSearchStatus($searchRef: String!, $includeResults: Boolean!) {
           packageName
           version
           pageId
+          sourceKind
+          sourceUrl
           repoUrl
           gitRef
+          requestedRef
           filePath
           startLine
           endLine
@@ -1437,45 +1373,57 @@ query UnifiedSearchStatus($searchRef: String!, $includeResults: Boolean!) {
     }
   }
 }`;
+function debugUnifiedSearchRequest(variables) {
+  if (!isDebugAreaEnabled("code-nav"))
+    return;
+  const serialised = serialiseForDebug(variables);
+  const filters = asRecord(serialised.filters);
+  debugLog("code-nav", {
+    event: "request",
+    operation: "search",
+    targetCount: Array.isArray(serialised.targets) ? serialised.targets.length : 0,
+    sources: Array.isArray(serialised.sources) ? serialised.sources : [],
+    hasFilters: filters !== undefined,
+    filterKeys: filters ? Object.keys(filters).sort() : [],
+    fileIntent: filters && typeof filters.fileIntent === "string" ? filters.fileIntent : "omitted",
+    allowPartialResults: serialised.allowPartialResults === true,
+    presentVariableKeys: Object.keys(serialised).sort(),
+    hasLimit: typeof serialised.limit === "number",
+    hasOffset: typeof serialised.offset === "number",
+    waitTimeoutMs: typeof serialised.waitTimeoutMs === "number" ? serialised.waitTimeoutMs : undefined
+  });
+}
+function debugGraphqlWireRequest(operation, graphqlQuery, variables) {
+  if (!isDebugAreaEnabled("code-nav-wire"))
+    return;
+  debugLog("code-nav-wire", {
+    event: "wire-request",
+    operation,
+    graphqlQuery,
+    variables: serialiseForDebug(variables)
+  });
+}
+function serialiseForDebug(value) {
+  try {
+    const text = JSON.stringify(value);
+    if (!text)
+      return {};
+    const parsed = JSON.parse(text);
+    return asRecord(parsed) ?? {};
+  } catch {
+    return {};
+  }
+}
+function asRecord(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return;
+}
 var availableVersionSchema = z.object({
   version: z.string().nullable().optional(),
   ref: z.string()
 });
-var searchSymbolsResultEntrySchema = z.object({
-  name: z.string().nullable().optional(),
-  filePath: z.string().nullable().optional(),
-  startLine: z.number().int().nullable().optional(),
-  endLine: z.number().int().nullable().optional(),
-  preview: z.string().nullable().optional(),
-  code: z.string().nullable().optional(),
-  language: z.string().nullable().optional(),
-  symbolRef: z.string().nullable().optional(),
-  qualifiedPath: z.string().nullable().optional(),
-  kind: z.string().nullable().optional(),
-  category: z.string().nullable().optional(),
-  arity: z.number().int().nullable().optional(),
-  isPublic: z.boolean().nullable().optional(),
-  containedSymbols: z.number().int().nullable().optional()
-});
-var searchSymbolsResponseSchema = z.object({
-  results: z.array(searchSymbolsResultEntrySchema),
-  totalMatches: z.number().int(),
-  hasMore: z.boolean(),
-  indexedVersion: z.string().nullable().optional(),
-  resolution: z.object({
-    requestedVersion: z.string().nullable().optional(),
-    requestedRef: z.string().nullable().optional(),
-    resolvedRef: z.string().nullable().optional(),
-    commitSha: z.string().nullable().optional()
-  }).nullable().optional(),
-  diagnostics: z.object({
-    hint: z.string().nullable().optional()
-  }).nullable().optional(),
-  warning: z.string().nullable().optional(),
-  codeIndexState: z.string(),
-  indexingRef: z.string().nullable().optional(),
-  availableVersions: z.array(availableVersionSchema).nullable().optional()
-});
 var unifiedSearchSourceSchema = z.enum(["AUTO", "DOCS", "CODE", "SYMBOL"]);
 var unifiedSearchResultTypeSchema = z.enum([
   "DOCUMENTATION_PAGE",
@@ -1488,8 +1436,11 @@ var unifiedSearchLocatorSchema = z.object({
   packageName: z.string().nullable().optional(),
   version: z.string().nullable().optional(),
   pageId: z.string().nullable().optional(),
+  sourceKind: z.string().nullable().optional(),
+  sourceUrl: z.string().nullable().optional(),
   repoUrl: z.string().nullable().optional(),
   gitRef: z.string().nullable().optional(),
+  requestedRef: z.string().nullable().optional(),
   filePath: z.string().nullable().optional(),
   startLine: z.number().int().nullable().optional(),
   endLine: z.number().int().nullable().optional(),
@@ -1873,12 +1824,6 @@ query GrepRepo(
   }
 }`;
 }
-var graphQLResponseSchema = z.object({
-  data: z.object({
-    searchSymbols: searchSymbolsResponseSchema.nullable().optional()
-  }).nullable().optional(),
-  errors: z.array(graphQLErrorSchema).optional()
-});
 var unifiedSearchGraphQLResponseSchema = z.object({
   data: z.object({
     search: asyncUnifiedSearchResultSchema.nullable().optional()
@@ -1917,40 +1862,35 @@ class CodeNavigationServiceImpl {
       executeWithToken: (token) => this.executeUnifiedSearchStatus(token, searchRef)
     });
   }
-  async searchSymbols(params) {
-    return executeWithTokenRefresh({
-      getToken: () => this.tokenProvider.getToken(),
-      forceRefresh: () => this.tokenProvider.forceRefresh(),
-      shouldRefresh: (error) => error instanceof AuthenticationError,
-      executeWithToken: (token) => this.executeSearchSymbols(token, params)
-    });
-  }
   async executeUnifiedSearch(token, params) {
     if (params.targets.length === 0) {
       throw new CodeNavigationValidationError("At least one search target is required.");
     }
     let response;
+    const variables = {
+      targets: params.targets.map((target) => ({
+        registry: target.registry,
+        name: target.packageName,
+        version: target.version,
+        repoUrl: target.repoUrl,
+        gitRef: target.gitRef
+      })),
+      query: params.query,
+      sources: params.sources,
+      filters: params.filters,
+      allowPartialResults: params.allowPartialResults ?? false,
+      limit: params.limit,
+      offset: params.offset,
+      waitTimeoutMs: params.waitTimeoutMs
+    };
+    debugUnifiedSearchRequest(variables);
+    debugGraphqlWireRequest("search", UNIFIED_SEARCH_QUERY, variables);
     try {
       response = await postPkgseerGraphql({
         endpointUrl: this.codeNavigationUrl,
         token,
         query: UNIFIED_SEARCH_QUERY,
-        variables: {
-          targets: params.targets.map((target) => ({
-            registry: target.registry,
-            name: target.packageName,
-            version: target.version,
-            repoUrl: target.repoUrl,
-            gitRef: target.gitRef
-          })),
-          query: params.query,
-          sources: params.sources,
-          filters: params.filters,
-          allowPartialResults: params.allowPartialResults ?? false,
-          limit: params.limit,
-          offset: params.offset,
-          waitTimeoutMs: params.waitTimeoutMs
-        },
+        variables,
         fetchFn: this.fetchFn
       });
     } catch (cause) {
@@ -2027,93 +1967,6 @@ class CodeNavigationServiceImpl {
       progress
     };
   }
-  async executeSearchSymbols(token, params) {
-    if (!params.query && (!params.keywords || params.keywords.length === 0)) {
-      throw new InvalidSearchSymbolsRequestError("Either query or keywords must be provided.");
-    }
-    let response;
-    try {
-      response = await postPkgseerGraphql({
-        endpointUrl: this.codeNavigationUrl,
-        token,
-        query: SEARCH_SYMBOLS_QUERY,
-        variables: {
-          registry: params.target.registry,
-          packageName: params.target.packageName,
-          repoUrl: params.target.repoUrl,
-          gitRef: params.target.gitRef,
-          query: params.query,
-          keywords: params.keywords,
-          matchMode: params.matchMode,
-          kind: params.kind,
-          category: params.category,
-          filePath: params.filePath,
-          version: params.target.version,
-          limit: params.limit,
-          fileIntent: params.fileIntent,
-          waitTimeoutMs: params.waitTimeoutMs
-        },
-        fetchFn: this.fetchFn
-      });
-    } catch (cause) {
-      if (cause instanceof PkgseerTransportError) {
-        throw new CodeNavigationNetworkError("Could not reach the code navigation service. Check your connection or set GITHITS_CODE_NAV_URL.", { cause });
-      }
-      throw cause;
-    }
-    if (response.status < 200 || response.status >= 300) {
-      throw this.createHttpError(response);
-    }
-    const parsed = graphQLResponseSchema.safeParse(response.parsedBody);
-    if (!parsed.success) {
-      throw new MalformedCodeNavigationResponseError("Malformed response from code navigation service.");
-    }
-    if (parsed.data.errors && parsed.data.errors.length > 0) {
-      throw this.createGraphQLError(parsed.data.errors);
-    }
-    const data = parsed.data.data?.searchSymbols;
-    if (!data) {
-      throw new MalformedCodeNavigationResponseError("Malformed response from code navigation service.");
-    }
-    if (data.codeIndexState === "INDEXING") {
-      throw new CodeNavigationIndexingError(this.createIndexingMessage(data.indexingRef ?? undefined), data.indexingRef ?? undefined, data.availableVersions?.map((entry) => ({
-        version: entry.version ?? undefined,
-        ref: entry.ref
-      })));
-    }
-    if (data.codeIndexState === "UNRESOLVABLE") {
-      throw new CodeNavigationUnresolvableError("The requested target or version could not be resolved.");
-    }
-    return {
-      results: data.results.map((entry) => ({
-        name: entry.name ?? undefined,
-        filePath: entry.filePath ?? undefined,
-        startLine: entry.startLine ?? undefined,
-        endLine: entry.endLine ?? undefined,
-        preview: entry.preview ?? undefined,
-        code: entry.code ?? undefined,
-        language: entry.language ?? undefined,
-        symbolRef: entry.symbolRef ?? undefined,
-        qualifiedPath: entry.qualifiedPath ?? undefined,
-        kind: entry.kind ?? undefined,
-        category: entry.category ?? undefined,
-        arity: entry.arity ?? undefined,
-        isPublic: entry.isPublic ?? undefined,
-        containedSymbols: entry.containedSymbols ?? undefined
-      })),
-      totalMatches: data.totalMatches,
-      hasMore: data.hasMore,
-      version: data.indexedVersion ?? undefined,
-      resolution: data.resolution ? {
-        requestedVersion: data.resolution.requestedVersion ?? undefined,
-        requestedRef: data.resolution.requestedRef ?? undefined,
-        resolvedRef: data.resolution.resolvedRef ?? undefined,
-        commitSha: data.resolution.commitSha ?? undefined
-      } : undefined,
-      hint: data.diagnostics?.hint ?? undefined,
-      warning: data.warning ?? undefined
-    };
-  }
   createHttpError(response) {
     const status = response.status;
     const detail = parseDetail2(response.responseBody);
@@ -2250,8 +2103,11 @@ class CodeNavigationServiceImpl {
           packageName: entry.locator.packageName ?? undefined,
           version: entry.locator.version ?? undefined,
           pageId: entry.locator.pageId ?? undefined,
+          sourceKind: entry.locator.sourceKind ?? undefined,
+          sourceUrl: entry.locator.sourceUrl ?? undefined,
           repoUrl: entry.locator.repoUrl ?? undefined,
           gitRef: entry.locator.gitRef ?? undefined,
+          requestedRef: entry.locator.requestedRef ?? undefined,
           filePath: entry.locator.filePath ?? undefined,
           startLine: entry.locator.startLine ?? undefined,
           endLine: entry.locator.endLine ?? undefined,
@@ -3171,7 +3027,7 @@ var graphQLErrorSchema2 = z2.object({
   message: z2.string(),
   extensions: z2.record(z2.string(), z2.unknown()).optional()
 });
-var graphQLResponseSchema2 = z2.object({
+var graphQLResponseSchema = z2.object({
   data: z2.object({
     packageSummary: packageSummaryResponseSchema.nullable().optional()
   }).nullable().optional(),
@@ -3539,6 +3395,141 @@ query PackageChangelog(
     }
   }
 }`;
+var packageDocSourceKindSchema = z2.enum(["CRAWLED", "REPOSITORY"]);
+var packageDocPageSummarySchema = z2.object({
+  id: z2.string().nullable().optional(),
+  title: z2.string().nullable().optional(),
+  slug: z2.string().nullable().optional(),
+  order: z2.number().int().nullable().optional(),
+  linkName: z2.string().nullable().optional(),
+  lastUpdatedAt: z2.string().nullable().optional(),
+  sourceKind: packageDocSourceKindSchema.nullable().optional(),
+  sourceUrl: z2.string().nullable().optional(),
+  repoUrl: z2.string().nullable().optional(),
+  gitRef: z2.string().nullable().optional(),
+  requestedRef: z2.string().nullable().optional(),
+  filePath: z2.string().nullable().optional()
+});
+var packageDocsPageInfoSchema = z2.object({
+  hasNextPage: z2.boolean(),
+  endCursor: z2.string().nullable().optional(),
+  totalCount: z2.number().int().nullable().optional()
+}).nullable().optional();
+var packageDocsListResponseSchema = z2.object({
+  registry: z2.string().nullable().optional(),
+  packageName: z2.string().nullable().optional(),
+  version: z2.string().nullable().optional(),
+  stale: z2.boolean().nullable().optional(),
+  pages: z2.array(packageDocPageSummarySchema).nullable().optional(),
+  pageInfo: packageDocsPageInfoSchema
+});
+var packageDocSourceSchema = z2.object({
+  url: z2.string().nullable().optional(),
+  label: z2.string().nullable().optional()
+}).nullable().optional();
+var packageDocPageSchema = z2.object({
+  id: z2.string().nullable().optional(),
+  title: z2.string().nullable().optional(),
+  content: z2.string().nullable().optional(),
+  contentFormat: z2.string().nullable().optional(),
+  breadcrumbs: z2.array(z2.string()).nullable().optional(),
+  linkName: z2.string().nullable().optional(),
+  lastUpdatedAt: z2.string().nullable().optional(),
+  sourceKind: packageDocSourceKindSchema.nullable().optional(),
+  source: packageDocSourceSchema,
+  repoUrl: z2.string().nullable().optional(),
+  gitRef: z2.string().nullable().optional(),
+  requestedRef: z2.string().nullable().optional(),
+  filePath: z2.string().nullable().optional(),
+  baseUrl: z2.string().nullable().optional()
+}).nullable().optional();
+var packageDocResultResponseSchema = z2.object({
+  registry: z2.string().nullable().optional(),
+  packageName: z2.string().nullable().optional(),
+  version: z2.string().nullable().optional(),
+  sourceKind: packageDocSourceKindSchema.nullable().optional(),
+  page: packageDocPageSchema
+});
+var packageDocsListGraphQLResponseSchema = z2.object({
+  data: z2.object({
+    listPackageDocs: packageDocsListResponseSchema.nullable().optional()
+  }).nullable().optional(),
+  errors: z2.array(graphQLErrorSchema2).optional()
+});
+var packageDocReadGraphQLResponseSchema = z2.object({
+  data: z2.object({
+    getDocPage: packageDocResultResponseSchema.nullable().optional()
+  }).nullable().optional(),
+  errors: z2.array(graphQLErrorSchema2).optional()
+});
+var LIST_PACKAGE_DOCS_QUERY = `
+query ListPackageDocs(
+  $registry: Registry!
+  $packageName: String!
+  $version: String
+  $limit: Int
+  $after: String
+) {
+  listPackageDocs(
+    registry: $registry
+    packageName: $packageName
+    version: $version
+    limit: $limit
+    after: $after
+  ) {
+    registry
+    packageName
+    version
+    stale
+    pages {
+      id
+      title
+      slug
+      order
+      linkName
+      lastUpdatedAt
+      sourceKind
+      sourceUrl
+      repoUrl
+      gitRef
+      requestedRef
+      filePath
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+      totalCount
+    }
+  }
+}`;
+var READ_PACKAGE_DOC_QUERY = `
+query ReadPackageDoc($pageId: String!) {
+  getDocPage(pageId: $pageId) {
+    registry
+    packageName
+    version
+    sourceKind
+    page {
+      id
+      title
+      content
+      contentFormat
+      breadcrumbs
+      linkName
+      lastUpdatedAt
+      sourceKind
+      source {
+        url
+        label
+      }
+      repoUrl
+      gitRef
+      requestedRef
+      filePath
+      baseUrl
+    }
+  }
+}`;
 
 class PackageIntelligenceServiceImpl {
   endpointUrl;
@@ -3579,7 +3570,7 @@ class PackageIntelligenceServiceImpl {
     if (response.status < 200 || response.status >= 300) {
       throw this.createHttpError(response);
     }
-    const parsed = graphQLResponseSchema2.safeParse(response.parsedBody);
+    const parsed = graphQLResponseSchema.safeParse(response.parsedBody);
     if (!parsed.success) {
       throw new MalformedPackageIntelligenceResponseError("Malformed response from the package-intelligence service.");
     }
@@ -3983,6 +3974,148 @@ class PackageIntelligenceServiceImpl {
       entries
     };
   }
+  async listPackageDocs(params) {
+    return withTelemetrySpan("pkg-intel.docs.list", () => executeWithTokenRefresh({
+      getToken: () => this.tokenProvider.getToken(),
+      forceRefresh: () => this.tokenProvider.forceRefresh(),
+      shouldRefresh: (error) => error instanceof AuthenticationError,
+      executeWithToken: (token) => this.executeListPackageDocs(token, params)
+    }));
+  }
+  async executeListPackageDocs(token, params) {
+    let response;
+    try {
+      response = await postPkgseerGraphql({
+        endpointUrl: this.endpointUrl,
+        token,
+        query: LIST_PACKAGE_DOCS_QUERY,
+        variables: {
+          registry: params.registry,
+          packageName: params.packageName,
+          version: params.version,
+          limit: params.limit,
+          after: params.after
+        },
+        fetchFn: this.fetchFn
+      });
+    } catch (cause) {
+      if (cause instanceof PkgseerTransportError) {
+        throw new PackageIntelligenceNetworkError("Could not reach the package intelligence service. Check your connection or set GITHITS_CODE_NAV_URL.", { cause });
+      }
+      throw cause;
+    }
+    if (response.status < 200 || response.status >= 300) {
+      throw this.createHttpError(response);
+    }
+    const parsed = packageDocsListGraphQLResponseSchema.safeParse(response.parsedBody);
+    if (!parsed.success) {
+      throw new MalformedPackageIntelligenceResponseError("Malformed response from the package-intelligence service.");
+    }
+    if (parsed.data.errors && parsed.data.errors.length > 0) {
+      throw promoteGenericVersionNotFound(this.createGraphQLError(parsed.data.errors), params);
+    }
+    const data = parsed.data.data?.listPackageDocs;
+    if (!data) {
+      throw new MalformedPackageIntelligenceResponseError("Empty response from the package-intelligence service.");
+    }
+    return this.normalisePackageDocsList(data);
+  }
+  normalisePackageDocsList(data) {
+    return {
+      registry: data.registry ?? undefined,
+      packageName: data.packageName ?? undefined,
+      version: data.version ?? undefined,
+      stale: data.stale ?? undefined,
+      pages: data.pages?.map((page) => ({
+        id: page.id ?? undefined,
+        title: page.title ?? undefined,
+        slug: page.slug ?? undefined,
+        order: page.order ?? undefined,
+        linkName: page.linkName ?? undefined,
+        lastUpdatedAt: page.lastUpdatedAt ?? undefined,
+        sourceKind: page.sourceKind ?? undefined,
+        sourceUrl: page.sourceUrl ?? undefined,
+        repoUrl: page.repoUrl ?? undefined,
+        gitRef: page.gitRef ?? undefined,
+        requestedRef: page.requestedRef ?? undefined,
+        filePath: page.filePath ?? undefined
+      })) ?? [],
+      pageInfo: data.pageInfo ? {
+        hasNextPage: data.pageInfo.hasNextPage,
+        endCursor: data.pageInfo.endCursor ?? undefined,
+        totalCount: data.pageInfo.totalCount ?? undefined
+      } : undefined
+    };
+  }
+  async readPackageDoc(params) {
+    return withTelemetrySpan("pkg-intel.docs.read", () => executeWithTokenRefresh({
+      getToken: () => this.tokenProvider.getToken(),
+      forceRefresh: () => this.tokenProvider.forceRefresh(),
+      shouldRefresh: (error) => error instanceof AuthenticationError,
+      executeWithToken: (token) => this.executeReadPackageDoc(token, params)
+    }));
+  }
+  async executeReadPackageDoc(token, params) {
+    let response;
+    try {
+      response = await postPkgseerGraphql({
+        endpointUrl: this.endpointUrl,
+        token,
+        query: READ_PACKAGE_DOC_QUERY,
+        variables: {
+          pageId: params.pageId
+        },
+        fetchFn: this.fetchFn
+      });
+    } catch (cause) {
+      if (cause instanceof PkgseerTransportError) {
+        throw new PackageIntelligenceNetworkError("Could not reach the package intelligence service. Check your connection or set GITHITS_CODE_NAV_URL.", { cause });
+      }
+      throw cause;
+    }
+    if (response.status < 200 || response.status >= 300) {
+      throw this.createHttpError(response);
+    }
+    const parsed = packageDocReadGraphQLResponseSchema.safeParse(response.parsedBody);
+    if (!parsed.success) {
+      throw new MalformedPackageIntelligenceResponseError("Malformed response from the package-intelligence service.");
+    }
+    if (parsed.data.errors && parsed.data.errors.length > 0) {
+      throw this.createGraphQLError(parsed.data.errors);
+    }
+    const data = parsed.data.data?.getDocPage;
+    if (!data) {
+      throw new MalformedPackageIntelligenceResponseError("Empty response from the package-intelligence service.");
+    }
+    return this.normalisePackageDocResult(data);
+  }
+  normalisePackageDocResult(data) {
+    return {
+      registry: data.registry ?? undefined,
+      packageName: data.packageName ?? undefined,
+      version: data.version ?? undefined,
+      sourceKind: data.sourceKind ?? undefined,
+      page: data.page ? {
+        id: data.page.id ?? undefined,
+        title: data.page.title ?? undefined,
+        content: data.page.content ?? undefined,
+        contentFormat: data.page.contentFormat ?? undefined,
+        breadcrumbs: data.page.breadcrumbs ?? undefined,
+        linkName: data.page.linkName ?? undefined,
+        lastUpdatedAt: data.page.lastUpdatedAt ?? undefined,
+        sourceKind: data.page.sourceKind ?? undefined,
+        source: data.page.source ? {
+          url: data.page.source.url ?? undefined,
+          label: data.page.source.label ?? undefined
+        } : undefined,
+        repoUrl: data.page.repoUrl ?? undefined,
+        gitRef: data.page.gitRef ?? undefined,
+        requestedRef: data.page.requestedRef ?? undefined,
+        filePath: data.page.filePath ?? undefined,
+        baseUrl: data.page.baseUrl ?? undefined
+      } : undefined
+    };
+  }
 }
 function parseDetail3(body) {
   if (!body)
@@ -4300,4 +4433,4 @@ async function loadStartupTokens(mcpUrl) {
   });
 }
 
-export { getCodeNavigationCapability, debugLog, setMcpClientVersionProvider, setClientMode, isTelemetryEnabled, withTelemetrySpan, startTelemetrySpan, endTelemetrySpan, flushTelemetry, AuthenticationError, CodeNavigationAccessError, CodeNavigationGraphQLError, CodeNavigationIndexingError, CodeNavigationUnresolvableError, MalformedCodeNavigationResponseError, CodeNavigationTargetNotFoundError, CodeNavigationFileNotFoundError, CodeNavigationVersionNotFoundError, CodeNavigationValidationError, CodeNavigationFeatureFlagRequiredError, CodeNavigationNetworkError, CodeNavigationBackendError, getCodeNavigationUrl, isCodeNavigationCliOverrideEnabled, ExecServiceImpl, FileSystemServiceImpl, PackageIntelligenceAccessError, PackageIntelligenceFeatureFlagRequiredError, PackageIntelligenceNetworkError, PackageIntelligenceBackendError, PackageIntelligenceGraphQLError, PackageIntelligenceTargetNotFoundError, PackageIntelligenceValidationError, PackageIntelligenceVersionNotFoundError, MalformedPackageIntelligenceResponseError, PackageIntelligenceChangelogSourceNotFoundError, PromptServiceImpl, refreshExpiredToken, createContainer, resolveStartupCodeNavigationCapability, resolveStartupCodeNavigationRegistrationState };
+export { getCodeNavigationCapability, debugLog, setMcpClientVersionProvider, setClientMode, isTelemetryEnabled, withTelemetrySpan, startTelemetrySpan, endTelemetrySpan, flushTelemetry, AuthenticationError, CodeNavigationAccessError, CodeNavigationGraphQLError, CodeNavigationIndexingError, CodeNavigationUnresolvableError, MalformedCodeNavigationResponseError, CodeNavigationTargetNotFoundError, CodeNavigationFileNotFoundError, CodeNavigationVersionNotFoundError, CodeNavigationValidationError, CodeNavigationFeatureFlagRequiredError, CodeNavigationNetworkError, CodeNavigationBackendError, getCodeNavigationUrl, getEnvApiToken, isCodeNavigationCliOverrideEnabled, ExecServiceImpl, FileSystemServiceImpl, PackageIntelligenceAccessError, PackageIntelligenceFeatureFlagRequiredError, PackageIntelligenceNetworkError, PackageIntelligenceBackendError, PackageIntelligenceGraphQLError, PackageIntelligenceTargetNotFoundError, PackageIntelligenceValidationError, PackageIntelligenceVersionNotFoundError, MalformedPackageIntelligenceResponseError, PackageIntelligenceChangelogSourceNotFoundError, PromptServiceImpl, refreshExpiredToken, createContainer, resolveStartupCodeNavigationCapability, resolveStartupCodeNavigationRegistrationState };