@elizaos/plugin-pdf 1.0.0-alpha.26

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shaw Walters, aka Moon aka @lalalune
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,384 @@
+# @elizaos/plugin-pdf
+
+Core Node.js plugin for Eliza OS that provides essential services and actions for file operations, media processing, and cloud integrations.
+
+## Overview
+
+The Node plugin serves as a foundational component of Eliza OS, bridging core Node.js capabilities with the Eliza ecosystem. It provides crucial services for file operations, media processing, speech synthesis, and cloud integrations, enabling both local and cloud-based functionality for Eliza agents.
+
+## Features
+
+- **AWS S3 Integration**: File upload and management with AWS S3
+- **Browser Automation**: Web scraping and content extraction with Playwright
+- **Image Processing**: Image description and analysis capabilities
+- **PDF Processing**: PDF text extraction and parsing
+- **Speech Synthesis**: Text-to-speech using ElevenLabs and VITS
+- **Transcription**: Speech-to-text using various providers (OpenAI, Deepgram, Local)
+- **Video Processing**: YouTube video download and transcription
+- **LLaMA Integration**: Local LLM support with LLaMA models
+
+## Installation
+
+```bash
+npx elizaos plugin add @elizaos/plugin-pdf
+```
+
+## Configuration
+
+The plugin requires various environment variables depending on which services you plan to use:
+
+### Core Settings
+
+```env
+OPENAI_API_KEY=your_openai_api_key
+```
+
+### Voice Settings (Optional)
+
+```env
+ELEVENLABS_API_KEY=your_elevenlabs_api_key
+ELEVENLABS_MODEL_ID=eleven_monolingual_v1
+ELEVENLABS_VOICE_ID=your_voice_id
+ELEVENLABS_VOICE_STABILITY=0.5
+ELEVENLABS_VOICE_SIMILARITY_BOOST=0.75
+ELEVENLABS_OPTIMIZE_STREAMING_LATENCY=0
+ELEVENLABS_OUTPUT_FORMAT=pcm_16000
+VITS_VOICE=en_US-hfc_female-medium
+```
+
+### AWS Settings (Optional)
+
+```env
+AWS_ACCESS_KEY_ID=your_aws_access_key
+AWS_SECRET_ACCESS_KEY=your_aws_secret_key
+AWS_REGION=your_aws_region
+AWS_S3_BUCKET=your_s3_bucket
+AWS_S3_UPLOAD_PATH=your_upload_path
+AWS_S3_ENDPOINT=an_alternative_endpoint
+AWS_S3_SSL_ENABLED=boolean(true|false)
+AWS_S3_FORCE_PATH_STYLE=boolean(true|false)
+```
+
+## Usage
+
+```typescript
+import { createNodePlugin } from "@elizaos/plugin-node";
+
+// Initialize the plugin
+const nodePlugin = createNodePlugin();
+
+// Register with Eliza OS
+elizaos.registerPlugin(nodePlugin);
+```
+
+## Services
+
+### AwsS3Service
+
+Handles file uploads and management with AWS S3.
+
+### BrowserService
+
+Provides web scraping and content extraction capabilities using Playwright.
+
+### ImageDescriptionService
+
+Processes and analyzes images to generate descriptions. Supports multiple providers:
+
+- Local processing using Florence model
+- OpenAI Vision API
+- Google Gemini
+
+Configuration:
+
+```env
+# For OpenAI Vision
+OPENAI_API_KEY=your_openai_api_key
+
+# For Google Gemini
+GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key
+```
+
+Provider selection:
+
+- If `imageVisionModelProvider` is set to `google/openai`, it will use this one.
+- Else if `model` is set to `google/openai`, it will use this one.
+- Default if nothing is set is OpenAI.
+
+The service automatically handles different image formats, including GIFs (first frame extraction).
+
+Features by provider:
+
+**Local (Florence):**
+
+- Basic image captioning
+- Local processing without API calls
+
+**OpenAI Vision:**
+
+- Detailed image descriptions
+- Text detection
+- Object recognition
+
+**Google Gemini 1.5:**
+
+- High-quality image understanding
+- Detailed descriptions with natural language
+- Multi-modal context understanding
+- Support for complex scenes and content
+
+The provider can be configured through the runtime settings, allowing easy switching between providers based on your needs.
+
+### LlamaService
+
+Provides local LLM capabilities using LLaMA models.
+
+### PdfService
+
+Extracts and processes text content from PDF files.
+
+### SpeechService
+
+Handles text-to-speech conversion using ElevenLabs and VITS.
+
+### TranscriptionService
+
+Converts speech to text using various providers.
+
+### VideoService
+
+Processes video content, including YouTube video downloads and transcription.
+
+## Actions
+
+### describeImage
+
+Analyzes and generates descriptions for images.
+
+```typescript
+// Example usage
+const result = await runtime.executeAction("DESCRIBE_IMAGE", {
+    imageUrl: "path/to/image.jpg",
+});
+```
+
+## Dependencies
+
+The plugin requires several peer dependencies:
+
+- `onnxruntime-node`: 1.20.1
+- `whatwg-url`: 7.1.0
+
+And trusted dependencies:
+
+- `onnxruntime-node`: 1.20.1
+- `sharp`: 0.33.5
+
+## Safety & Security
+
+### File Operations
+
+- **Path Sanitization**: All file paths are sanitized to prevent directory traversal attacks
+- **File Size Limits**: Enforced limits on upload sizes
+- **Type Checking**: Strict file type validation
+- **Temporary File Cleanup**: Automatic cleanup of temporary files
+
+### API Keys & Credentials
+
+- **Environment Isolation**: Sensitive credentials are isolated in environment variables
+- **Access Scoping**: Services are initialized with minimum required permissions
+- **Key Rotation**: Support for credential rotation without service interruption
+
+### Media Processing
+
+- **Resource Limits**: Memory and CPU usage limits for media processing
+- **Timeout Controls**: Automatic termination of long-running processes
+- **Format Validation**: Strict media format validation before processing
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Service Initialization Failures**
+
+```bash
+Error: Service initialization failed
+```
+
+- Verify environment variables are properly set
+- Check service dependencies are installed
+- Ensure sufficient system permissions
+
+2. **Media Processing Errors**
+
+```bash
+Error: Failed to process media file
+```
+
+- Verify file format is supported
+- Check available system memory
+- Ensure ffmpeg is properly installed
+
+3. **AWS S3 Connection Issues**
+
+```bash
+Error: AWS credentials not configured
+```
+
+- Verify AWS credentials are set
+- Check S3 bucket permissions
+- Ensure correct region configuration
+
+### Debug Mode
+
+Enable debug logging for detailed troubleshooting:
+
+```typescript
+process.env.DEBUG = "eliza:plugin-node:*";
+```
+
+### System Requirements
+
+- Node.js 16.x or higher
+- FFmpeg for media processing
+- Minimum 4GB RAM recommended
+- CUDA-compatible GPU (optional, for ML features)
+
+### Performance Optimization
+
+1. **Cache Management**
+
+    - Regular cleanup of `content_cache` directory
+    - Implement cache size limits
+    - Monitor disk usage
+
+2. **Memory Usage**
+
+    - Configure max buffer sizes
+    - Implement streaming for large files
+    - Monitor memory consumption
+
+3. **Concurrent Operations**
+    - Adjust queue size limits
+    - Configure worker threads
+    - Monitor process pool
+
+## Support
+
+For issues and feature requests, please:
+
+1. Check the troubleshooting guide above
+2. Review existing GitHub issues
+3. Submit a new issue with:
+    - System information
+    - Error logs
+    - Steps to reproduce
+
+## Future Enhancements
+
+1. **File Operations**
+
+    - Enhanced streaming capabilities
+    - Advanced compression options
+    - Batch file processing
+    - File type detection
+    - Metadata management
+    - Version control integration
+
+2. **Media Processing**
+
+    - Additional video formats
+    - Advanced image processing
+    - Audio enhancement tools
+    - Real-time processing
+    - Quality optimization
+    - Format conversion
+
+3. **Cloud Integration**
+
+    - Multi-cloud support
+    - Advanced caching
+    - CDN optimization
+    - Auto-scaling features
+    - Cost optimization
+    - Backup automation
+
+4. **Speech Services**
+
+    - Additional voice models
+    - Language expansion
+    - Emotion detection
+    - Voice cloning
+    - Real-time synthesis
+    - Custom voice training
+
+5. **Browser Automation**
+
+    - Headless optimization
+    - Parallel processing
+    - Session management
+    - Cookie handling
+    - Proxy support
+    - Resource optimization
+
+6. **Security Features**
+
+    - Enhanced encryption
+    - Access control
+    - Audit logging
+    - Threat detection
+    - Rate limiting
+    - Compliance tools
+
+7. **Performance Optimization**
+
+    - Memory management
+    - CPU utilization
+    - Concurrent operations
+    - Resource pooling
+    - Cache strategies
+    - Load balancing
+
+8. **Developer Tools**
+    - Enhanced debugging
+    - Testing framework
+    - Documentation generator
+    - CLI improvements
+    - Monitoring tools
+    - Integration templates
+
+We welcome community feedback and contributions to help prioritize these enhancements.
+
+## Contributing
+
+Contributions are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for more information.
+
+## Credits
+
+This plugin integrates with and builds upon several key technologies:
+
+- [Node.js](https://nodejs.org/) - The core runtime environment
+- [FFmpeg](https://ffmpeg.org/) - Media processing capabilities
+- [ElevenLabs](https://elevenlabs.io/) - Voice synthesis
+- [OpenAI](https://openai.com/) - Transcription and AI services
+- [AWS S3](https://aws.amazon.com/s3/) - Cloud storage
+- [Playwright](https://playwright.dev/) - Browser automation
+- [LLaMA](https://github.com/facebookresearch/llama) - Local language models
+- [VITS](https://github.com/jaywalnut310/vits) - Voice synthesis
+- [Deepgram](https://deepgram.com/) - Speech recognition
+- [Sharp](https://sharp.pixelplumbing.com/) - Image processing
+
+Special thanks to:
+
+- The Node.js community and all the open-source contributors who make these integrations possible.
+- The Eliza community for their contributions and feedback.
+
+For more information about Node.js capabilities:
+
+- [Node.js Documentation](https://nodejs.org/en/docs/)
+- [Node.js Developer Portal](https://nodejs.org/en/about/)
+- [Node.js GitHub Repository](https://github.com/nodejs/node)
+
+## License
+
+This plugin is part of the Eliza project. See the main project repository for license information.

package/dist/index.js

@@ -0,0 +1,82 @@
+// src/services/pdf.ts
+import {
+  Service,
+  ServiceTypes
+} from "@elizaos/core";
+import { getDocument } from "pdfjs-dist";
+var PdfService = class _PdfService extends Service {
+  static serviceType = ServiceTypes.PDF;
+  capabilityDescription = "The agent is able to convert PDF files to text";
+  /**
+   * Constructor for creating a new instance of the class.
+   *
+   * @param {IAgentRuntime} runtime - The runtime object passed to the constructor.
+   */
+  constructor(runtime) {
+    super();
+    this.runtime = runtime;
+  }
+  /**
+   * Starts the PdfService asynchronously.
+   * @param {IAgentRuntime} runtime - The runtime object for the agent.
+   * @returns {Promise<PdfService>} A promise that resolves with the PdfService instance.
+   */
+  static async start(runtime) {
+    const service = new _PdfService(runtime);
+    return service;
+  }
+  /**
+   * Stop the PDF service in the given runtime.
+   *
+   * @param {IAgentRuntime} runtime - The runtime to stop the PDF service in.
+   * @returns {Promise<void>} - A promise that resolves once the PDF service is stopped.
+   */
+  static async stop(runtime) {
+    const service = runtime.getService(ServiceTypes.PDF);
+    if (service) {
+      await service.stop();
+    }
+  }
+  /**
+   * Asynchronously stops the process.
+   * Does nothing.
+   */
+  async stop() {
+  }
+  /**
+   * Converts a PDF Buffer to text.
+   *
+   * @param {Buffer} pdfBuffer - The PDF Buffer to convert to text.
+   * @returns {Promise<string>} A Promise that resolves with the text content of the PDF.
+   */
+  async convertPdfToText(pdfBuffer) {
+    const uint8Array = new Uint8Array(pdfBuffer);
+    const pdf = await getDocument({ data: uint8Array }).promise;
+    const numPages = pdf.numPages;
+    const textPages = [];
+    for (let pageNum = 1; pageNum <= numPages; pageNum++) {
+      const page = await pdf.getPage(pageNum);
+      const textContent = await page.getTextContent();
+      const pageText = textContent.items.filter(isTextItem).map((item) => item.str).join(" ");
+      textPages.push(pageText);
+    }
+    return textPages.join("\n");
+  }
+};
+function isTextItem(item) {
+  return "str" in item;
+}
+
+// src/index.ts
+var pdfPlugin = {
+  name: "pdf",
+  description: "Plugin for PDF reading and processing",
+  services: [PdfService],
+  actions: []
+};
+var index_default = pdfPlugin;
+export {
+  index_default as default,
+  pdfPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/pdf.ts","../src/index.ts"],"sourcesContent":["import {\n\ttype IAgentRuntime,\n\ttype IPdfService,\n\tService,\n\ttype ServiceType,\n\tServiceTypes,\n} from \"@elizaos/core\";\nimport { type PDFDocumentProxy, getDocument } from \"pdfjs-dist\";\nimport type {\n\tTextItem,\n\tTextMarkedContent,\n} from \"pdfjs-dist/types/src/display/api\";\n\n/**\n * Class representing a PDF service that can convert PDF files to text.\n * * @extends Service\n * @implements IPdfService\n */\nexport class PdfService extends Service implements IPdfService {\n\tstatic serviceType: ServiceType = ServiceTypes.PDF;\n\tcapabilityDescription = \"The agent is able to convert PDF files to text\";\n\n\t/**\n\t * Constructor for creating a new instance of the class.\n\t *\n\t * @param {IAgentRuntime} runtime - The runtime object passed to the constructor.\n\t */\n\tconstructor(runtime: IAgentRuntime) {\n\t\tsuper();\n\t\tthis.runtime = runtime;\n\t}\n\n\t/**\n\t * Starts the PdfService asynchronously.\n\t * @param {IAgentRuntime} runtime - The runtime object for the agent.\n\t * @returns {Promise<PdfService>} A promise that resolves with the PdfService instance.\n\t */\n\tstatic async start(runtime: IAgentRuntime): Promise<PdfService> {\n\t\tconst service = new PdfService(runtime);\n\t\treturn service;\n\t}\n\n\t/**\n\t * Stop the PDF service in the given runtime.\n\t *\n\t * @param {IAgentRuntime} runtime - The runtime to stop the PDF service in.\n\t * @returns {Promise<void>} - A promise that resolves once the PDF service is stopped.\n\t */\n\tstatic async stop(runtime: IAgentRuntime) {\n\t\tconst service = runtime.getService(ServiceTypes.PDF);\n\t\tif (service) {\n\t\t\tawait service.stop();\n\t\t}\n\t}\n\n\t/**\n\t * Asynchronously stops the process.\n\t * Does nothing.\n\t */\n\tasync stop() {\n\t\t// do nothing\n\t}\n\n\t/**\n\t * Converts a PDF Buffer to text.\n\t *\n\t * @param {Buffer} pdfBuffer - The PDF Buffer to convert to text.\n\t * @returns {Promise<string>} A Promise that resolves with the text content of the PDF.\n\t */\n\tasync convertPdfToText(pdfBuffer: Buffer): Promise<string> {\n\t\t// Convert Buffer to Uint8Array\n\t\tconst uint8Array = new Uint8Array(pdfBuffer);\n\n\t\tconst pdf: PDFDocumentProxy = await getDocument({ data: uint8Array })\n\t\t\t.promise;\n\t\tconst numPages = pdf.numPages;\n\t\tconst textPages: string[] = [];\n\n\t\tfor (let pageNum = 1; pageNum <= numPages; pageNum++) {\n\t\t\tconst page = await pdf.getPage(pageNum);\n\t\t\tconst textContent = await page.getTextContent();\n\t\t\tconst pageText = textContent.items\n\t\t\t\t.filter(isTextItem)\n\t\t\t\t.map((item) => item.str)\n\t\t\t\t.join(\" \");\n\t\t\ttextPages.push(pageText);\n\t\t}\n\n\t\treturn textPages.join(\"\\n\");\n\t}\n}\n\n// Type guard function\n/**\n * Check if the input is a TextItem.\n *\n * @param item - The input item to check.\n * @returns A boolean indicating if the input is a TextItem.\n */\nfunction isTextItem(item: TextItem | TextMarkedContent): item is TextItem {\n\treturn \"str\" in item;\n}\n","import type { Plugin } from \"@elizaos/core\";\n\nimport { PdfService } from \"./services/pdf\";\n\nexport const pdfPlugin: Plugin = {\n\tname: \"pdf\",\n\tdescription: \"Plugin for PDF reading and processing\",\n\tservices: [PdfService],\n\tactions: [],\n};\n\nexport default pdfPlugin;"],"mappings":";AAAA;AAAA,EAGC;AAAA,EAEA;AAAA,OACM;AACP,SAAgC,mBAAmB;AAW5C,IAAM,aAAN,MAAM,oBAAmB,QAA+B;AAAA,EAC9D,OAAO,cAA2B,aAAa;AAAA,EAC/C,wBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOxB,YAAY,SAAwB;AACnC,UAAM;AACN,SAAK,UAAU;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,MAAM,SAA6C;AAC/D,UAAM,UAAU,IAAI,YAAW,OAAO;AACtC,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAa,KAAK,SAAwB;AACzC,UAAM,UAAU,QAAQ,WAAW,aAAa,GAAG;AACnD,QAAI,SAAS;AACZ,YAAM,QAAQ,KAAK;AAAA,IACpB;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO;AAAA,EAEb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,iBAAiB,WAAoC;AAE1D,UAAM,aAAa,IAAI,WAAW,SAAS;AAE3C,UAAM,MAAwB,MAAM,YAAY,EAAE,MAAM,WAAW,CAAC,EAClE;AACF,UAAM,WAAW,IAAI;AACrB,UAAM,YAAsB,CAAC;AAE7B,aAAS,UAAU,GAAG,WAAW,UAAU,WAAW;AACrD,YAAM,OAAO,MAAM,IAAI,QAAQ,OAAO;AACtC,YAAM,cAAc,MAAM,KAAK,eAAe;AAC9C,YAAM,WAAW,YAAY,MAC3B,OAAO,UAAU,EACjB,IAAI,CAAC,SAAS,KAAK,GAAG,EACtB,KAAK,GAAG;AACV,gBAAU,KAAK,QAAQ;AAAA,IACxB;AAEA,WAAO,UAAU,KAAK,IAAI;AAAA,EAC3B;AACD;AASA,SAAS,WAAW,MAAsD;AACzE,SAAO,SAAS;AACjB;;;ACjGO,IAAM,YAAoB;AAAA,EAChC,MAAM;AAAA,EACN,aAAa;AAAA,EACb,UAAU,CAAC,UAAU;AAAA,EACrB,SAAS,CAAC;AACX;AAEA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "@elizaos/plugin-pdf",
+	"version": "1.0.0-alpha.26",
+	"type": "module",
+	"main": "dist/index.js",
+	"module": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		"./package.json": "./package.json",
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		}
+	},
+	"files": [
+		"dist",
+		"scripts",
+		"package.json",
+		"LICENSE",
+		"tsup.config.ts"
+	],
+	"dependencies": {
+		"@aws-sdk/client-s3": "^3.705.0",
+		"@aws-sdk/s3-request-presigner": "^3.705.0",
+		"@elizaos/core": "1.0.0-alpha.26",
+		"@types/uuid": "10.0.0",
+		"capsolver-npm": "2.0.2",
+		"fluent-ffmpeg": "2.1.3",
+		"glob": "11.0.0",
+		"patchright": "1.50.1",
+		"pdfjs-dist": "4.7.76",
+		"uuid": "11.0.3",
+		"youtube-dl-exec": "3.0.15"
+	},
+	"trustedDependencies": [
+		"youtube-dl-exec"
+	],
+	"devDependencies": {
+		"@types/node": "22.8.4",
+		"tsup": "8.4.0"
+	},
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"postinstall": "node scripts/postinstall.js",
+		"lint": "biome check ./src --config-path=./ --apply-unsafe && biome format ./ --config-path=./ --write",
+		"clean": "rm -rf dist .turbo node_modules .turbo-tsconfig.json tsconfig.tsbuildinfo"
+	},
+	"peerDependencies": {
+		"whatwg-url": "7.1.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"gitHead": "bc8404af5c9e930c2de5c426c4bf730b86aacf8c"
+}

package/scripts/postinstall.js

@@ -0,0 +1,70 @@
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+
+const platform = os.platform();
+const rel = os.release();
+
+if (platform !== "linux") {
+	console.log(
+		"Skipping [patchright] installation: non-Linux platform detected:",
+		platform,
+	);
+	process.exit(0);
+}
+
+function getDistroName() {
+	try {
+		const osReleaseContent = fs.readFileSync("/etc/os-release", "utf8");
+		const lines = osReleaseContent.split("\n");
+		const info = {};
+		for (const line of lines) {
+			const [key, value] = line.split("=");
+			if (key && value) {
+				info[key.toLowerCase()] = value.replace(/"/g, "").toLowerCase().trim();
+			}
+		}
+		return info.id || info.id_like || null;
+	} catch (err) {
+		console.error("Error reading /etc/os-release:", err.message);
+	}
+	return null;
+}
+
+const distro = getDistroName();
+console.log("Detected Linux distribution:", distro || "unknown");
+
+const supportedDistros = [
+	"ubuntu",
+	"debian",
+	"pve",
+	"raspbian",
+	"pop",
+	"zorin",
+	"linuxmint",
+	"elementary",
+	"pureos",
+	"kali",
+];
+
+if (!distro || !supportedDistros.some((name) => distro.includes(name))) {
+	console.log(
+		"Skipping [patchright] installation on unsupported platform:",
+		platform,
+		rel,
+		distro || "unknown distro",
+	);
+	process.exit(0);
+}
+
+try {
+	execSync("npx patchright install", {
+		stdio: "inherit",
+	});
+} catch (err) {
+	console.error(
+		"Failed to install [patchright] you may need to install [patchright] deps with 'sudo npx patchright install-deps'. Error: ",
+		err.message,
+	);
+	process.exit(1);
+}

package/tsup.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+	entry: ["src/index.ts"],
+	outDir: "dist",
+	tsconfig: "./tsconfig.build.json", // Use build-specific tsconfig
+	sourcemap: true,
+	clean: true,
+	format: ["esm"], // Ensure you're targeting CommonJS
+	dts: false, // Skip DTS generation to avoid external import issues // Ensure you're targeting CommonJS
+	external: [
+		"dotenv", // Externalize dotenv to prevent bundling
+		"fs", // Externalize fs to use Node.js built-in module
+		"path", // Externalize other built-ins if necessary
+		"@reflink/reflink",
+		"https",
+		"http",
+		"agentkeepalive",
+		"zod",
+		// Add other modules you want to externalize
+	],
+});