{"_id":"@basalt-ai/n8n-nodes","_rev":"2-7a549d234078db3537633ff9ae629646","name":"@basalt-ai/n8n-nodes","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@basalt-ai/n8n-nodes","version":"0.0.1","keywords":["n8n-community-node-package","n8n","basalt","ai","prompts"],"author":{"name":"Basalt AI","email":"support@basalt.ai"},"license":"MIT","_id":"@basalt-ai/n8n-nodes@0.0.1","maintainers":[{"name":"will-m","email":"tech@getbasalt.ai"},{"name":"theocousin","email":"cousin.theophile@gmail.com"},{"name":"basalt.zakaria","email":"zakaria@getbasalt.ai"}],"homepage":"https://github.com/basalt-ai/n8n-nodes","bugs":{"url":"https://github.com/basalt-ai/n8n-nodes/issues"},"n8n":{"nodes":["dist/nodes/Basalt/Basalt.node.js"],"credentials":["dist/credentials/BasaltApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"0b31843b2e48ae479ff6809cb7cfebe7c451bc03","tarball":"https://registry.npmjs.org/@basalt-ai/n8n-nodes/-/n8n-nodes-0.0.1.tgz","fileCount":14,"integrity":"sha512-+Gm6S3CcFtPxJcGJWXjkpfSzJkFoci5wfkf/+UVZQFdgN87sgS87xdEEuIxxnmEk22LzveSoBSr+eWW+rVXlhw==","signatures":[{"sig":"MEYCIQCFQgJ54QdkQaKfe6y/NpNGoFDcaRdRoizlEZ/OBWp3RAIhAIyxAEtpHAk7S7o4KuGvd2fAucq154fcOQ/8nNZpVHNt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28797},"main":"./dist/index.js","type":"commonjs","types":"./dist/index.d.ts","gitHead":"861742b014ee493a37f4c4bd8bd65e44dfc91828","scripts":{"test":"node -e \"console.log('No tests yet, but node structure is valid')\"","build":"tsc --build tsconfig.json"},"_npmUser":{"name":"will-m","email":"tech@getbasalt.ai"},"repository":{"url":"git+https://github.com/basalt-ai/n8n-nodes.git","type":"git","directory":"n8n-nodes"},"_npmVersion":"10.7.0","description":"n8n node for Basalt API","directories":{},"_nodeVersion":"18.20.4","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0","n8n-workflow":"^1.0.0"},"peerDependencies":{"n8n-workflow":"^1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes_0.0.1_1763060503406_0.1551165236170855","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-11-13T19:01:43.293Z","modified":"2026-02-09T20:08:22.405Z","0.0.1":"2025-11-13T19:01:43.636Z"},"bugs":{"url":"https://github.com/basalt-ai/n8n-nodes/issues"},"author":{"name":"Basalt AI","email":"support@basalt.ai"},"license":"MIT","homepage":"https://github.com/basalt-ai/n8n-nodes","keywords":["n8n-community-node-package","n8n","basalt","ai","prompts"],"repository":{"url":"git+https://github.com/basalt-ai/n8n-nodes.git","type":"git","directory":"n8n-nodes"},"description":"n8n node for Basalt API","maintainers":[{"email":"thomas@getbasalt.ai","name":"batmot1"},{"email":"tech@getbasalt.ai","name":"will-m"},{"email":"cousin.theophile@gmail.com","name":"theocousin"},{"email":"zakaria@getbasalt.ai","name":"basalt.zakaria"}],"readme":"# @basalt-ai/n8n-node\n\nn8n community node for the Basalt API - Manage prompts, monitoring, and datasets through n8n workflows.\n\n## Features\n\nThis n8n node allows you to:\n\n### Prompts\n- **Get** - Retrieve a specific prompt by slug\n- **Get Many** - List all prompts in your workspace\n- **Describe** - Get detailed information about a prompt including its variables\n- **Publish** - Publish a prompt version with a specific tag\n\n### Monitoring\n- **Create Experiment** - Create a new experiment for testing prompt variations\n- **Log Output** - Monitor individual prompt outputs with detailed metrics\n\n### Datasets\n- **Get** - Retrieve a specific dataset by slug\n- **Get Many** - List all datasets in your workspace\n- **Create Item** - Add a new row to a dataset\n\n## Installation\n\n### Community Nodes (n8n Cloud & Desktop)\n\n1. Go to **Settings > Community Nodes**\n2. Select **Install**\n3. Enter `@basalt-ai/n8n-node` in the **Enter npm package name** field\n4. Agree to the risks and click **Install**\n\n### Manual Installation (Self-Hosted)\n\nNavigate to your n8n root directory and run:\n\n```bash\nnpm install @basalt-ai/n8n-node\n```\n\nThen restart your n8n instance.\n\n## Credentials\n\nTo use this node, you'll need:\n\n1. **API Key**: Your Basalt API key (available in your Basalt dashboard)\n2. **API URL**: The base URL for the Basalt API (defaults to `https://api.getbasalt.ai`)\n\n### Setting up Credentials\n\n1. In n8n, go to **Credentials** and click **Add credential**\n2. Search for **Basalt API**\n3. Enter your API key and API URL\n4. Save the credential\n\n## Usage Examples\n\n### Example 1: Get a Prompt and Use it in a Workflow\n\n```\n1. Basalt Node (Get Prompt)\n   - Resource: Prompt\n   - Operation: Get\n   - Slug: my-prompt-slug\n   - Version: 1.0.0\n\n2. HTTP Request Node\n   - Use the prompt text from previous step\n   - Make API call with the prompt configuration\n```\n\n### Example 2: Log Prompt Outputs for Monitoring\n\n```\n1. Your LLM Node\n   - Execute your AI workflow\n\n2. Basalt Node (Log Output)\n   - Resource: Monitoring\n   - Operation: Log Output\n   - Prompt Slug: {{ $json.promptSlug }}\n   - Output: {{ $json.llmResponse }}\n   - Input Tokens: {{ $json.usage.inputTokens }}\n   - Output Tokens: {{ $json.usage.outputTokens }}\n```\n\n### Example 3: Create Experiment\n\n```\n1. Basalt Node (Create Experiment)\n   - Resource: Monitoring\n   - Operation: Create Experiment\n   - Feature Slug: my-feature\n   - Name: A/B Test - Version 1.0 vs 2.0\n```\n\n### Example 4: Add Items to a Dataset\n\n```\n1. Webhook Trigger\n   - Receives new data\n\n2. Basalt Node (Create Dataset Item)\n   - Resource: Dataset\n   - Operation: Create Item\n   - Slug: training-data\n   - Values: { \"input\": \"...\", \"output\": \"...\" }\n   - Ideal Output: \"Expected response\"\n```\n\n## API Operations\n\nAll operations support the full Basalt API specification. For detailed API documentation, visit [https://docs.getbasalt.ai](https://docs.getbasalt.ai)\n\n## Resources\n\n- [Basalt Documentation](https://docs.getbasalt.ai)\n- [Basalt API Reference](https://api.getbasalt.ai)\n- [n8n Community](https://community.n8n.io)\n\n## Development\n\n### Building the Node\n\n```bash\nnpm run build\n```\n\n### Testing Locally\n\n1. Build the node:\n   ```bash\n   npm run build\n   ```\n\n2. Link the package:\n   ```bash\n   npm link\n   ```\n\n3. Link to your n8n installation:\n   ```bash\n   cd ~/.n8n/nodes\n   npm link @basalt-ai/n8n-node\n   ```\n\n4. Restart n8n\n\n## License\n\nMIT\n\n## Support\n\nFor issues and questions:\n- GitHub Issues: [basalt-ai/basalt](https://github.com/basalt-ai/basalt/issues)\n- Email: support@getbasalt.ai\n","readmeFilename":"README.md"}