docs: create documentation for Alchemyst AI Retriever

src/oss/javascript/integrations/retrievers/alchemystai-retriever.mdx

@@ -0,0 +1,43 @@
+---
+title: Alchemyst AI Retriever
+description: "Integrate the Alchemyst AI Retriever into your Generative AI Application"
+---
+
+# Alchemyst AI Retriever
+
+The [**Alchemyst AI Retriever**](https://getalchemystai.com) enables your generative AI applications to retrieve relevant context and knowledge. It sources this information from the Alchemyst platform. It provides a unified interface for accessing, searching, and retrieving data to enhance LLM and agent responses.
+## Setup
+
+1. If you don't have an account, [sign up for a new account](https://platform.getalchemystai.com/signup) on the Alchemyst Platform.
+2. After logging in, go to [**Alchemyst Platform Settings**](https://platform.getalchemystai.com/settings) to get your API keys.
+
+import IntegrationInstallTooltip from '/snippets/javascript-integrations/integration-install-tooltip.mdx';
+
+<IntegrationInstallTooltip></IntegrationInstallTooltip>
+
+<CodeGroup>
+```sh npm
+npm i @alchemystai/langchain-js
+```
+
+```sh yarn
+yarn add @alchemystai/langchain-js
+```
+
+```sh pnpm
+pnpm add @alchemystai/langchain-js
+```
+
+```sh bun
+bun add @alchemystai/langchain-js
+```
+</CodeGroup>
+
+## Usage
+
+import AlchemystAiRetrieverExample from "/snippets/javascript-integrations/examples/retrievers/alchemystai.mdx";
+
+<AlchemystAiRetrieverExample />
+
+## Support and Feedback
+For support, feedback, or to report issues, please visit the [Alchemyst AI Documentation](https://docs.getalchemystai.com), where you'll find the latest contact and community information.

src/oss/javascript/integrations/retrievers/index.mdx

@@ -20,6 +20,13 @@ If you'd like to contribute an integration, see [Contributing integrations](/oss
 ## All retrievers
 
 <Columns cols={3}>
+  <Card
+    title="Alchemyst AI Retriever"
+    icon="link"
+    href="/oss/integrations/retrievers/alchemystai-retriever"
+    arrow="true"
+    cta="View guide"
+  />
   <Card
     title="ArxivRetriever"
     icon="link"

src/snippets/javascript-integrations/examples/retrievers/alchemystai.mdx

@@ -0,0 +1,33 @@
+```typescript
+import { AlchemystRetriever } from "@alchemystai/langchain-js";
+import { RunnableSequence } from "@langchain/core/runnables";
+import dotenv from "dotenv";
+
+dotenv.config();
+
+// Instantiate the retriever with your API key and optional config
+const retriever = new AlchemystRetriever({
+  apiKey: process.env.ALCHEMYST_AI_API_KEY!,
+  similarityThreshold: 0.8,
+  minimumSimilarityThreshold: 0.5,
+  scope: "internal"
+});
+
+// Example: Use the retriever in a LangChain pipeline
+async function main() {
+  // Create a simple pipeline that retrieves documents and outputs their content
+  const pipeline = RunnableSequence.from([
+    async (input: string) => {
+      const docs = await retriever.getRelevantDocuments(input);
+      return docs.map(doc => doc.pageContent).join("\n---\n");
+    }
+  ]);
+
+  const query = "Show me the latest HR policies"; // Put your business/practical query here
+  const result = await pipeline.invoke(query);
+
+  console.log("Retrieved Documents:\n", result);
+}
+
+main().catch(console.error);
+```