@stainless-api/docs 0.1.0-beta.129 → 0.1.0-beta.130

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @stainless-api/docs
 
+## 0.1.0-beta.130
+
+### Minor Changes
+
+- da5debb: Move ai chat packages into stl-starlight, and extract to a generic interface
+
+### Patch Changes
+
+- 3019a8b: Adds support for generating an llms.txt
+- 4d3b938: Remove dead code flagged by knip
+- b887dbb: Fix off-axis rotation of loading spinner in safari
+- cfd8ea1: Minor fixes for Python and Ruby
+- Updated dependencies [3019a8b]
+- Updated dependencies [4d3b938]
+- Updated dependencies [0791fb6]
+- Updated dependencies [01b77d0]
+- Updated dependencies [15e07d8]
+- Updated dependencies [ebc039a]
+- Updated dependencies [cfd8ea1]
+- Updated dependencies [68a7bf8]
+  - @stainless-api/docs-ui@0.1.0-beta.93
+  - @stainless-api/ui-primitives@0.1.0-beta.53
+  - @stainless-api/docs-search@0.1.0-beta.46
+
 ## 0.1.0-beta.129
 
 ### Minor Changes

package/ambient.d.ts

@@ -0,0 +1,6 @@
+import 'react';
+declare module 'react' {
+  interface CSSProperties {
+    [key: `--${string}`]: string | number;
+  }
+}

package/eslint-suppressions.json

@@ -12,11 +12,6 @@
       "count": 2
     }
   },
-  "plugin/generateAPIReferenceLink.ts": {
-    "@typescript-eslint/no-unsafe-assignment": {
-      "count": 2
-    }
-  },
   "plugin/globalJs/copy.ts": {
     "@typescript-eslint/no-explicit-any": {
       "count": 4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/docs",
-  "version": "0.1.0-beta.129",
+  "version": "0.1.0-beta.130",
   "publishConfig": {
     "access": "public"
   },
@@ -42,46 +42,50 @@
   },
   "dependencies": {
     "@astrojs/markdown-remark": "^7.1.0",
-    "@astrojs/react": "^5.0.2",
+    "@astrojs/react": "^5.0.3",
     "@markdoc/markdoc": "^0.5.7",
     "@stainless-api/sdk": "0.5.0",
-    "astro-expressive-code": "^0.41.7",
+    "@streamparser/json-whatwg": "^0.0.22",
     "cheerio": "^1.2.0",
     "clsx": "^2.1.1",
-    "dotenv": "17.4.0",
+    "dotenv": "17.4.1",
     "lucide-react": "^0.577.0",
+    "motion": "^12.38.0",
     "node-html-parser": "^7.1.0",
     "rehype-parse": "^9.0.1",
     "rehype-remark": "^10.0.1",
+    "react-markdown": "^10.1.0",
+    "react-syntax-highlighter": "^16.1.1",
     "remark-gfm": "^4.0.1",
     "remark-github-alerts": "^0.1.1",
     "remark-stringify": "^11.0.0",
+    "remend": "^1.3.0",
     "shiki": "^4.0.2",
     "unified": "^11.0.5",
     "vite-plugin-prebundle-workers": "^0.2.0",
     "web-worker": "^1.5.0",
-    "yaml": "^2.8.3",
-    "@stainless-api/docs-search": "0.1.0-beta.45",
-    "@stainless-api/docs-ui": "0.1.0-beta.92",
-    "@stainless-api/ui-primitives": "0.1.0-beta.52"
+    "@stainless-api/docs-search": "0.1.0-beta.46",
+    "@stainless-api/docs-ui": "0.1.0-beta.93",
+    "@stainless-api/ui-primitives": "0.1.0-beta.53"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.8",
-    "@types/node": "24.12.0",
+    "@types/node": "24.12.2",
     "@types/react": "19.2.14",
     "@types/react-dom": "^19.2.3",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "astro": "^6.1.5",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "tsx": "^4.21.0",
     "typescript": "6.0.2",
-    "vite": "^7.3.1",
-    "vitest": "^4.1.2",
+    "vite": "^7.3.2",
+    "vitest": "^4.1.3",
     "zod": "^4.3.6",
-    "@stainless/eslint-config": "0.1.0-beta.1",
-    "@stainless/sdk-json": "^0.1.0-beta.9"
+    "@stainless/eslint-config": "0.1.0-beta.2",
+    "@stainless/sdk-json": "^0.1.0-beta.10"
   },
   "scripts": {
-    "vendor-deps": "tsx scripts/vendor_deps.ts",
+    "vendor-deps": "node scripts/vendor_deps.ts",
     "lint": "eslint --flag unstable_native_nodejs_ts_config . --max-warnings 0",
     "sync": "astro sync",
     "check:types": "astro check",

package/plugin/generateAPIReferenceLink.ts

@@ -1,47 +1,7 @@
 // This is probably temporary, but it fills in functionality needed for Mintlify imports
 
-import type { StarlightRouteData } from '@astrojs/starlight/route-data';
-import type * as SDKJSON from '@stainless/sdk-json';
-import { walkTree } from '@stainless-api/docs-ui/routing';
-
 const INTERNAL_REFERENCE_ENTRY_MARKER = 'STL_STARLIGHT_API_REFERENCE_METHOD_LINK_PLACEHOLDER';
 
-type SidebarEntry = StarlightRouteData['sidebar'][number];
-
-type SidebarLink = Extract<SidebarEntry, { href: string }>;
-
-export function getMethodFromSDKJSON(spec: SDKJSON.Spec, endpoint: string) {
-  for (const entry of walkTree(spec)) {
-    if (entry.data.kind === 'http_method' && entry.data.endpoint === endpoint) {
-      return entry.data;
-    }
-  }
-  throw new Error(`Endpoint ${endpoint} not found in API`);
-}
-
-export function recursiveReplacePlaceholderItems(
-  sidebar: SidebarEntry[],
-  modifyFn: (entry: SidebarLink, props: { endpoint: string; label?: string }) => void,
-) {
-  for (const entry of sidebar) {
-    const endpoint = 'attrs' in entry && entry.attrs?.['data-stldocs-endpoint'];
-    if (
-      'attrs' in entry &&
-      entry.attrs?.about === INTERNAL_REFERENCE_ENTRY_MARKER &&
-      endpoint &&
-      typeof endpoint === 'string'
-    ) {
-      modifyFn(entry, {
-        endpoint,
-        label: entry.attrs?.['data-stldocs-label'],
-      });
-    }
-    if ('entries' in entry) {
-      recursiveReplacePlaceholderItems(entry.entries, modifyFn);
-    }
-  }
-}
-
 type GenerateProps = string | { label?: string; endpoint: string };
 
 function normalizeGenerateProps(generateProps: GenerateProps) {

package/plugin/index.ts

@@ -190,6 +190,16 @@ function stlStarlightAstroIntegration(pluginConfig: NormalizedStainlessStarlight
           prerender: pluginConfig.experimentalPrerender ? command === 'build' : false,
         });
 
+        if (pluginConfig.llmsTxt.enabled) {
+          injectRoute({
+            pattern: '/llms.txt',
+            entrypoint: resolveSrcFile('/plugin/routes/llms.ts'),
+            prerender: pluginConfig.experimentalPrerender ? command === 'build' : false,
+          });
+        } else {
+          logger.info('LLMS.txt generation is disabled.');
+        }
+
         updateConfig({
           vite: {
             plugins: [
@@ -314,6 +324,8 @@ function stlStarlightAstroIntegration(pluginConfig: NormalizedStainlessStarlight
                         EXPERIMENTAL_PLAYGROUNDS: !!pluginConfig.experimentalPlaygrounds,
                         EXPERIMENTAL_REQUEST_BUILDER: pluginConfig.experimentalRequestBuilder,
                         STAINLESS_PROJECT: pluginConfig.stainlessProject,
+                        LLMS_TXT_DESCRIPTION: pluginConfig.llmsTxt.description,
+                        LLMS_TXT_DETAIL_THRESHOLD: pluginConfig.llmsTxt.detailThreshold,
                       } satisfies Omit<typeof StlStarlightVirtualModule, 'MIDDLEWARE'>),
                       vmMiddlewareExport,
                     ].join('\n');

package/plugin/loadPluginConfig.ts

@@ -14,11 +14,11 @@ export type LanguageGenerateQuery = {
   list: DocsLanguage[];
 };
 
-export type AstroCommand = 'dev' | 'build' | 'preview' | 'sync';
+type AstroCommand = 'dev' | 'build' | 'preview' | 'sync';
 
-export type ContentLayout = 'double-pane' | 'single-pane';
+type ContentLayout = 'double-pane' | 'single-pane';
 
-export type VersionUserConfig = {
+type VersionUserConfig = {
   version: string;
   stainlessProject: string;
   branch: string;
@@ -165,6 +165,31 @@ export type StainlessStarlightUserConfig = {
    * @default true
    */
   experimentalPrerender?: boolean;
+
+  /**
+   * Configuration for the generated `/llms.txt` file.
+   */
+  llmsTxt?: {
+    /**
+     * Whether to disable the generated `/llms.txt` file.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * A short description of the site, used as the blockquote summary at the top of the file.
+     * Falls back to the top-level Starlight `description` field if not set.
+     */
+    description?: string;
+    /**
+     * The maximum number of total routes (prose + API reference) at which the file switches
+     * from compact mode (resources only) to detailed mode (resources and
+     * methods).
+     *
+     * @default 2000
+     */
+    detailThreshold?: number;
+  };
 };
 
 // TODO: eventually? re-add support for external spec servers
@@ -198,7 +223,7 @@ function getLocalFilePaths(command: AstroCommand) {
   };
 }
 
-export type ApiKeySource = 'explicit-config' | 'environment-variable' | 'cli';
+type ApiKeySource = 'explicit-config' | 'environment-variable' | 'cli';
 
 export type LoadedApiKey = {
   value: string;
@@ -252,6 +277,7 @@ function loadApiKey(configValue: string | undefined): LoadedApiKey | null {
   return { value: accessToken, source: 'cli' };
 }
 
+/** @public but discouraged - used by cloudflare via relative import */
 export function forceLoadStainlessCredentials(): LoadedApiKey {
   const v = loadApiKey(undefined);
   if (!v) {
@@ -265,7 +291,7 @@ type AstroOptions = {
   base: string;
 };
 
-export type ResolvedAPIConfigEntry = {
+type ResolvedAPIConfigEntry = {
   loadSpecs: () => Promise<SpecCacheResult[]>;
 };
 
@@ -385,6 +411,11 @@ function normalizeConfig(partial: SomeStainlessStarlightUserConfig, astroOptions
     experimentalRequestBuilder: partial.experimentalRequestBuilder ?? false,
     experimentalPrerender: partial.experimentalPrerender ?? true,
     stainlessProject: partial.stainlessProject,
+    llmsTxt: {
+      enabled: partial.llmsTxt?.disabled ?? true,
+      description: partial.llmsTxt?.description ?? null,
+      detailThreshold: partial.llmsTxt?.detailThreshold ?? 2000,
+    },
   };
 
   const api = loadAPIConfig(partial, astroOptions);

package/plugin/markdown/highlighter.ts

@@ -54,7 +54,7 @@ let astroShikiHighlighter:
   | HighlighterGeneric<BundledLanguage, BundledTheme>
   | Promise<HighlighterGeneric<BundledLanguage, BundledTheme>>
   | null = null;
-export async function getAstroHighlighter() {
+async function getAstroHighlighter() {
   if (astroShikiHighlighter) {
     return astroShikiHighlighter;
   }

package/plugin/react/Routing.tsx

@@ -5,22 +5,15 @@ import { astroMarkdownRenderText } from '../markdown';
 import { highlight } from '../markdown/highlighter';
 
 import type { MarkdownHeading } from 'astro';
-import type { StarlightRouteData } from '@astrojs/starlight/route-data';
 import type * as SDKJSON from '@stainless/sdk-json';
 import { LanguageNames, type DocsLanguage } from '@stainless-api/docs-ui/routing';
 
-import {
-  generateRoute,
-  parseStainlessPath,
-  walkTree,
-  getLanguageSnippet,
-} from '@stainless-api/docs-ui/routing';
+import { parseStainlessPath, getLanguageSnippet } from '@stainless-api/docs-ui/routing';
 
 import {
   DocsProvider,
   MarkdownProvider,
   NavigationProvider,
-  useSpec,
   type ContentPanelLayout,
 } from '@stainless-api/docs-ui/contexts';
 
@@ -40,7 +33,6 @@ import { Dropdown } from '@stainless-api/docs/components';
 
 import {
   RESOLVED_API_REFERENCE_PATH,
-  EXPAND_RESOURCES,
   BREADCRUMB_CONFIG,
   PROPERTY_SETTINGS,
   ENABLE_CONTEXT_MENU,
@@ -61,66 +53,6 @@ import { AIDropdown } from '../../stl-docs/components/AIDropdown';
 import { ChevronsUpDownIcon } from 'lucide-react';
 import { MethodDescription } from '../components/MethodDescription';
 
-function isResourceNonEmpty(resource: SDKJSON.Resource) {
-  return (
-    Object.keys(resource.methods ?? {}).length > 0 ||
-    Object.keys(resource.subresources ?? {}).length > 0 ||
-    Object.keys(resource.models ?? {}).length > 0
-  );
-}
-
-type SidebarEntry = StarlightRouteData['sidebar'][number];
-
-export function buildSidebar(
-  basePath: string,
-  language: DocsLanguage,
-  current: string,
-  spec: SDKJSON.Spec,
-  resources?: Record<string, SDKJSON.Resource>,
-  nested?: boolean,
-): StarlightRouteData['sidebar'] {
-  const totalRoutes = Array.from(walkTree(spec, false)).filter(
-    (item) => item.data.kind === 'http_method',
-  ).length;
-
-  return Object.values(resources ?? spec.resources ?? [])
-    .filter((resource) => isResourceNonEmpty(resource))
-    .sort((a, b) => (a.name.startsWith('$') === b.name.startsWith('$') ? 0 : a.name.startsWith('$') ? 1 : -1))
-    .map((resource) => {
-      const subs = buildSidebar(basePath, language, current, spec, resource.subresources, true);
-
-      const overview: SidebarEntry = {
-        type: 'link',
-        isCurrent: current === resource.stainlessPath,
-        attrs: { 'data-stldocs-overview': resource.name },
-        label: 'Overview',
-        href: generateRoute(basePath, language, resource.stainlessPath) ?? basePath,
-        badge: undefined,
-      };
-
-      const meths: SidebarEntry[] = Object.values(resource.methods ?? [])
-        .filter((method) => spec.decls?.[language]?.[method.stainlessPath])
-        .map((method) => ({
-          type: 'link',
-          isCurrent: current === method.stainlessPath,
-          attrs: { 'data-stldocs-method': method.httpMethod },
-          label: method.summary ?? method.name,
-          href: generateRoute(basePath, language, method.stainlessPath) ?? basePath,
-          badge: undefined,
-        }));
-
-      const shouldExpand = EXPAND_RESOURCES ?? totalRoutes < 20;
-
-      return {
-        type: 'group',
-        label: resource.title,
-        badge: undefined,
-        collapsed: !shouldExpand || nested === true,
-        entries: [...(resources ? [] : [overview]), ...meths, ...subs],
-      };
-    });
-}
-
 export function buildPageNavigation(resource: SDKJSON.Resource, depth: number = 2): MarkdownHeading[] {
   const output: MarkdownHeading[] = [{ depth, slug: resource.stainlessPath, text: resource.title }];
 
@@ -321,22 +253,6 @@ export function RenderSpec({
   );
 }
 
-export function RenderMethod({ path }: { path: string }) {
-  const spec = useSpec();
-  if (!spec) return null;
-
-  const parsed = parseStainlessPath(path);
-  const resource = getResourceFromSpec(path, spec);
-
-  if (!resource || !parsed) {
-    console.warn(`Could not find resource or parsed path for '${path}'`);
-    return null;
-  }
-
-  const method = resource.methods[parsed.method!]!;
-  return <SDKMethod method={method} />;
-}
-
 export async function getReadmeContent(spec: SDKJSON.Spec, language: DocsLanguage) {
   const repoUrl = spec.metadata?.[language]?.repo_url;
 

package/plugin/referencePlaceholderUtils.ts

@@ -21,7 +21,7 @@ export function makePlaceholderItems(id: number) {
 
 type StarlightConfig = Parameters<typeof starlight>[0];
 
-export type SidebarConfigEntry = Exclude<StarlightConfig['sidebar'], undefined>[number];
+type SidebarConfigEntry = Exclude<StarlightConfig['sidebar'], undefined>[number];
 
 export function getAPIReferencePlaceholderItemFromSidebarConfig(
   sidebar: SidebarConfigEntry[],

package/plugin/routes/llms.ts

@@ -0,0 +1,186 @@
+import type { APIRoute } from 'astro';
+import { getCollection } from 'astro:content';
+import { base as ASTRO_BASE } from 'astro:config/server';
+import { SITE_TITLE, API_REFERENCE_BASE_PATH } from 'virtual:stl-docs-virtual-module';
+import { LLMS_TXT_DESCRIPTION, LLMS_TXT_DETAIL_THRESHOLD } from 'virtual:stl-starlight-virtual-module';
+import { getSDKJSONInSSR } from '../specs/fetchSpecSSR';
+import Markdoc from '@markdoc/markdoc';
+import type { Node } from '@markdoc/markdoc';
+import * as md from '@stainless-api/docs-ui/markdown/md';
+import type * as SDKJSON from '@stainless/sdk-json';
+import { generateRoute, walkTree } from '@stainless-api/docs-ui/routing';
+
+export const prerender = true;
+
+function joinUrlParts(...parts: (string | boolean | null | undefined)[]) {
+  return (
+    '/' +
+    parts
+      .map((p) => {
+        if (typeof p === 'string') {
+          return p.split('/');
+        }
+        return p;
+      })
+      .flat()
+      .filter(Boolean)
+      .join('/')
+  );
+}
+
+export type ProsePageEntry = {
+  id: string;
+  title: string;
+  description?: string;
+};
+
+function isResourceEmpty(resource: SDKJSON.Resource) {
+  return Object.values(resource.methods).length < 1 && Object.values(resource.subresources ?? {}).length < 1;
+}
+
+function trimPath(path: string) {
+  return path.endsWith('/') ? path.slice(0, -1) : path;
+}
+
+function apiHref(basePath: string, language: string, stainlessPath: string) {
+  const href = generateRoute(basePath, language, stainlessPath);
+  if (!href) return null;
+  return joinUrlParts(ASTRO_BASE, href, 'index.md');
+}
+
+function linkListItem(title: string, url: string, description?: string): Node {
+  const children = [md.link(url, title)];
+  if (description) children.push(md.text(`: ${description}`));
+  return md.item(md.inline(...children));
+}
+
+function generateProseIndex(routes: ProsePageEntry[], detailed: boolean) {
+  const pageEntryLink = (page: ProsePageEntry) =>
+    linkListItem(
+      page.title,
+      joinUrlParts(ASTRO_BASE, page.id === 'index' ? null : page.id, 'index.md'),
+      detailed ? page.description : undefined,
+    );
+  return [md.heading(2, 'Docs'), md.list(...routes.map(pageEntryLink))];
+}
+
+function renderMethods(basePath: string, language: string, methods: Record<string, SDKJSON.Method>) {
+  const output: Node[] = [];
+
+  for (const method of Object.values(methods)) {
+    const href = apiHref(basePath, language, method.stainlessPath);
+    if (href) output.push(linkListItem(method.title, href, method.summary));
+  }
+
+  return md.list(...output);
+}
+
+function renderResource(
+  basePath: string,
+  language: string,
+  detailed: boolean,
+  resource: SDKJSON.Resource,
+): Node {
+  const href = apiHref(basePath, language, resource.stainlessPath);
+  const output = [md.paragraph(href ? md.link(href, resource.title) : md.text(resource.title))];
+  if (resource.methods && detailed) output.push(renderMethods(basePath, language, resource.methods));
+  if (resource.subresources) output.push(renderSubs(basePath, language, detailed, resource.subresources));
+  return md.item(...output);
+}
+
+function renderSubs(
+  basePath: string,
+  language: string,
+  detailed: boolean,
+  resources: Record<string, SDKJSON.Resource>,
+): Node {
+  return md.list(
+    ...Object.values(resources)
+      .filter((res) => !isResourceEmpty(res))
+      .map((sub) => renderResource(basePath, language, detailed, sub)),
+  );
+}
+
+function renderLanguageNote(basePath: string, languages: string[]) {
+  return [
+    md.paragraph(
+      md.text('Links below point to language-neutral HTTP documentation. '),
+      md.text(
+        'SDK-specific docs follow the same URL structure with the language inserted after the base path: ',
+      ),
+      md.code(`${trimPath(basePath)}/{language}/resources/...`),
+      md.text('.'),
+    ),
+    md.paragraph(md.text(`Available languages: ${languages.join(', ')}`)),
+  ];
+}
+
+function generateRefIndex(
+  basePath: string,
+  languages: string[],
+  language: string,
+  detailed: boolean,
+  spec: SDKJSON.Spec,
+) {
+  const output = [md.heading(2, 'API Reference'), ...renderLanguageNote(basePath, languages)];
+
+  for (const resource of Object.values(spec.resources)) {
+    if (isResourceEmpty(resource)) continue;
+    const href = apiHref(basePath, language, resource.stainlessPath);
+    output.push(md.heading(3, [href ? md.link(href, resource.title) : md.text(resource.title)]));
+    if (resource.methods && detailed) output.push(renderMethods(basePath, language, resource.methods));
+    if (resource.subresources) output.push(renderSubs(basePath, language, detailed, resource.subresources));
+  }
+
+  return output;
+}
+
+function generateMarkdownIndex({
+  siteTitle,
+  description,
+  basePath,
+  languages,
+  spec,
+  detailed,
+  proseRoutes,
+}: {
+  siteTitle: string;
+  description: string | null;
+  basePath: string;
+  languages: string[];
+  spec: SDKJSON.Spec;
+  detailed: boolean;
+  proseRoutes: ProsePageEntry[];
+}) {
+  const output: Node[] = [md.heading(1, siteTitle)];
+  if (description) output.push(md.paragraph(md.text(description)));
+  if (proseRoutes.length > 0) output.push(...generateProseIndex(proseRoutes, detailed));
+  if (languages.length > 0) output.push(...generateRefIndex(basePath, languages, 'http', detailed, spec));
+
+  const doc = new Markdoc.Ast.Node('document', {}, output);
+  return Markdoc.format(doc);
+}
+
+export const GET: APIRoute = async () => {
+  const [docsCollection, spec] = await Promise.all([getCollection('docs'), getSDKJSONInSSR('http')]);
+  const apiEntries = [...walkTree(spec)].filter((n) => n.data.kind !== 'model');
+  const proseRoutes = docsCollection.map((entry) => ({
+    id: entry.id,
+    title: entry.data.title,
+    description: entry.data.description,
+  }));
+
+  const content = generateMarkdownIndex({
+    siteTitle: SITE_TITLE,
+    description: LLMS_TXT_DESCRIPTION,
+    basePath: API_REFERENCE_BASE_PATH,
+    languages: spec.docs?.languages ?? [],
+    detailed: apiEntries.length + proseRoutes.length < LLMS_TXT_DETAIL_THRESHOLD,
+    spec,
+    proseRoutes,
+  });
+
+  return new Response(content, {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  });
+};

package/plugin/sidebar-utils/sidebar-builder.ts

@@ -173,8 +173,8 @@ export class SidebarConfigItemsBuilder {
     const decls = this.spec.decls[this.language] ?? {};
     const decl = decls[entry.stainlessPath];
     if (decl !== undefined) {
-      if ('ident' in decl) {
-        return decl;
+      if ('ident' in decl && decl.ident !== undefined) {
+        return decl as MethodDecl;
       }
     }
     return null;
@@ -338,11 +338,6 @@ function forceGenerateRoute({
   return route;
 }
 
-export type BuildSidebarParams = {
-  basePath: string;
-  currentSlug: string;
-};
-
 type ToStarlightSidebarParams = {
   basePath: string;
   spec: SDKJSON.Spec;

package/plugin/specs/FileCache.ts

@@ -4,7 +4,7 @@ import { readdir, readFile, rm, writeFile } from 'fs/promises';
 
 type CacheResultSource = 'memory' | 'disk' | 'generation';
 
-export type CacheGetResult<T> = {
+type CacheGetResult<T> = {
   resultSource: CacheResultSource;
   data: T;
   filePath: string;

package/plugin/specs/index.ts

@@ -5,17 +5,12 @@ import type * as VirtualManifestModule from 'virtual:stainless-apis-manifest';
 
 import { makeAsyncVirtualModPlugin } from '../../shared/virtualModule';
 
-import { NormalizedStainlessStarlightConfig, ResolvedAPIConfigEntry } from '../loadPluginConfig';
+import { NormalizedStainlessStarlightConfig } from '../loadPluginConfig';
 
 import { specCache, SpecCacheResult } from './generateSpec';
 import { AstroIntegrationLogger } from 'astro';
 import type * as SDKJSON from '@stainless/sdk-json';
 
-export type LoadedAPIConfigEntry = Omit<ResolvedAPIConfigEntry, 'loadSpecs'> & {
-  specs: SpecCacheResult[];
-  languages: SDKJSON.SpecLanguage[];
-};
-
 /**
  * A helper class to manage multiple spec cache results for a single API
  * An API may have multiple spec cache results if it has multiple languages