@stainless-api/docs 0.1.0-beta.93 → 0.1.0-beta.95

package/plugin/vendor/templates/cli.md

@@ -0,0 +1 @@
+SDK_Readme

package/plugin/vendor/templates/go.md

@@ -7,6 +7,8 @@ from applications written in Go.
 
 SDK_GeneratedByStainless
 
+SDK_MCPReadmeSection
+
 ## Installation
 
 SDK_ReleasePleaseMarkdownBlockStart
@@ -307,7 +309,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](SDK_GitHubRepoURL/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](SDK_RepoURL/issues) with questions, bugs, or suggestions.
 
 ## Contributing
 

package/plugin/vendor/templates/java.md

@@ -11,6 +11,8 @@ SDK_SectionSimilarToOtherSDK
 
 SDK_GeneratedByStainless
 
+SDK_MCPReadmeSection
+
 SDK_SectionDocumentationReference
 
 SDK_SectionInstallation
@@ -84,4 +86,4 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](SDK_GitHubRepoURL/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](SDK_RepoURL/issues) with questions, bugs, or suggestions.

package/plugin/vendor/templates/kotlin.md

@@ -11,6 +11,8 @@ SDK_SectionSimilarToOtherSDK
 
 SDK_GeneratedByStainless
 
+SDK_MCPReadmeSection
+
 SDK_SectionDocumentationReference
 
 SDK_SectionInstallation
@@ -84,4 +86,4 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](SDK_GitHubRepoURL/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](SDK_RepoURL/issues) with questions, bugs, or suggestions.

package/plugin/vendor/templates/node.md

@@ -10,6 +10,8 @@ SDK_DocumentationReference
 
 SDK_GeneratedByStainless
 
+SDK_MCPReadmeSection
+
 ## Installation
 
 SDK_NPMInstallInstructions
@@ -169,7 +171,7 @@ import SDK_PackageName from 'SDK_NPMPackage';
 ```
 
 To do the inverse, add `import "SDK_NPMPackage/shims/node"` (which does import polyfills).
-This can also be useful if you are getting the wrong TypeScript types for `Response` ([more details](SDK_GitHubRepoCodeURL/src/_shims#readme)).
+This can also be useful if you are getting the wrong TypeScript types for `Response` ([more details](SDK_RepoCodeURL/src/_shims#readme)).
 
 ### Logging and middleware
 
@@ -214,7 +216,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](SDK_GitHubRepoURL/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](SDK_RepoURL/issues) with questions, bugs, or suggestions.
 
 ## Requirements
 

package/plugin/vendor/templates/python.md

@@ -9,6 +9,8 @@ SDK_ScreencastURL
 
 SDK_GeneratedByStainless
 
+SDK_MCPReadmeSection
+
 ## Documentation
 
 SDK_DocumentationCallout SDK_APIReferenceCallout
@@ -227,7 +229,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](SDK_GitHubRepoURL/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](SDK_RepoURL/issues) with questions, bugs, or suggestions.
 
 ### Determining the installed version
 

package/plugin/vendor/templates/ruby.md

@@ -1,11 +1,13 @@
 # SDK_PackageTitle API library
 
-SDK_ReadmeOpening It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](SDK_GitHubURL#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
+SDK_ReadmeOpening It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](SDK_RepoURL#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
 SDK_ScreencastURL
 
 SDK_GeneratedByStainless
 
+SDK_MCPReadmeSection
+
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](SDK_RubyDocInfoURL).
@@ -142,4 +144,4 @@ Ruby SDK_RubyMinVersion or higher.
 
 ## Contributing
 
-See [the contributing documentation](SDK_GitHubAssetURL/CONTRIBUTING.md).
+See [the contributing documentation](SDK_RepoAssetURL/CONTRIBUTING.md).

package/plugin/vendor/templates/terraform.md

@@ -53,7 +53,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](SDK_GitHubRepoURL/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](SDK_RepoURL/issues) with questions, bugs, or suggestions.
 
 ## Contributing
 

package/plugin/vendor/templates/typescript.md

@@ -10,6 +10,8 @@ SDK_DocumentationReference
 
 SDK_GeneratedByStainless
 
+SDK_MCPReadmeSection
+
 ## Installation
 
 SDK_NPMInstallInstructions
@@ -298,7 +300,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](SDK_GitHubRepoURL/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](SDK_RepoURL/issues) with questions, bugs, or suggestions.
 
 ## Requirements
 

package/virtual-module.d.ts

@@ -73,12 +73,28 @@ declare module 'virtual:stl-docs/components/AiChat.tsx' {
   export const STAINLESS_PROJECT: string | undefined;
 }
 
-declare module 'virtual:stainless-sdk-json-manifest' {
-  export const specPath: string;
+declare module 'virtual:stainless-apis-manifest' {
+  import type { DocsLanguage } from '@stainless-api/docs-ui/routing';
+
+  export type APIManifestEntry = {
+    languages: {
+      sdkJSONFilePath: string;
+      language: DocsLanguage;
+    }[];
+  };
+
+  export const api: APIManifestEntry;
 }
 
 declare module 'virtual:stl-starlight-reference-sidebars' {
   import type { DocsLanguage } from '@stainless-api/docs-ui/routing';
   import type { StarlightRouteData } from '@astrojs/starlight/route-data';
-  export const sidebars: { id: number; language: DocsLanguage; entries: StarlightRouteData['sidebar'] }[];
+
+  export type GeneratedSidebarDef = {
+    id: number;
+    language: DocsLanguage;
+    entries: StarlightRouteData['sidebar'];
+  };
+
+  export const sidebars: GeneratedSidebarDef[];
 }

package/plugin/helpers/getDocsLanguages.ts

@@ -1,9 +0,0 @@
-import { DocsLanguage } from '@stainless-api/docs-ui/routing';
-import type * as SDKJSON from '@stainless/sdk-json';
-
-export function getDocsLanguages(spec: SDKJSON.Spec, excludeLanguages: DocsLanguage[]) {
-  // TODO: should not force unwrap this
-  const languages: DocsLanguage[] = spec.docs!.languages ?? ['http'];
-
-  return languages.filter((language) => !excludeLanguages.includes(language));
-}