{"_id":"@calypsohq/n8n-nodes-calypso","_rev":"4-1c8675fce617d37246637d9aa7004d62","name":"@calypsohq/n8n-nodes-calypso","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.1":{"name":"@calypsohq/n8n-nodes-calypso","version":"1.0.1","keywords":["n8n-community-node-package","n8n-nodes","calypso","calypso-rag","rag","retrieval-augmented-generation","grounded-ai","ai-agents","knowledge-base","openai-compatible","api-integration","workflow-automation","automation"],"author":{"url":"https://www.calypso.so/","name":"Calypso","email":"info@calypso.so"},"license":"MIT","_id":"@calypsohq/n8n-nodes-calypso@1.0.1","maintainers":[{"name":"calypsohq","email":"info@calypso.so"}],"homepage":"https://www.calypso.so/","bugs":{"url":"https://github.com/calypso-so/n8n-nodes-calypso/issues"},"n8n":{"nodes":["dist/nodes/CalypsoRag/CalypsoRag.node.js"],"credentials":["dist/credentials/CalypsoApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"0787830c817ef3fd3b0d3f0363ed8c419e763a49","tarball":"https://registry.npmjs.org/@calypsohq/n8n-nodes-calypso/-/n8n-nodes-calypso-1.0.1.tgz","fileCount":15,"integrity":"sha512-JmeJjmyIghD7y0E2nKggdi+xju+SLACDiUE05ZJA4iSO23j784rB++VOCQSQrziCdtxu+drqp2I2a6I5+OUOUg==","signatures":[{"sig":"MEYCIQC1+1lubJJ2rj5uqyvJ5BmzSLaBvzJRH/no5bNUGSdT4AIhAM3lrFnpwPt8b7ZdCofxd4FZjgCg3papkFAPXQwoR88O","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45223},"main":"dist/index.js","engines":{"npm":">=9.5.1","node":">=20.15"},"gitHead":"223bfba80d6cbf941dc2bb59970afcb9a20be273","scripts":{"dev":"tsc --watch","lint":"eslint . --ext .ts,.js","scan":"npx -p node@22 -p @n8n/scan-community-package scan-community-package @calypsohq/n8n-nodes-calypso","test":"echo \"No automated tests configured\"","build":"npx rimraf dist && tsc && gulp build:all","format":"prettier --write .","lintfix":"eslint . --ext .ts,.js --fix","package":"npm run build && npm pack","validate":"npm run build && npm run lint && npm run format:check","format:check":"prettier --check .","prepublishOnly":"npm run validate"},"_npmUser":{"name":"calypsohq","email":"info@calypso.so"},"repository":{"url":"git+https://github.com/calypso-so/n8n-nodes-calypso.git","type":"git"},"_npmVersion":"10.9.4","description":"n8n community node for Calypso RAG - call grounded Calypso agents from workflow automations","directories":{},"_nodeVersion":"22.22.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"gulp":"^5.0.1","eslint":"^8.0.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/node":"^18.0.0","@types/express":"^4.17.13","@types/form-data":"^2.2.1","@typescript-eslint/parser":"^6.0.0","eslint-plugin-n8n-nodes-base":"^1.16.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-calypso_1.0.1_1780688522114_0.5344806713288239","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@calypsohq/n8n-nodes-calypso","version":"1.0.2","keywords":["n8n-community-node-package","n8n-nodes","calypso","calypso-rag","rag","retrieval-augmented-generation","grounded-ai","ai-agents","knowledge-base","openai-compatible","api-integration","workflow-automation","automation"],"author":{"url":"https://www.calypso.so/","name":"Calypso","email":"info@calypso.so"},"license":"MIT","_id":"@calypsohq/n8n-nodes-calypso@1.0.2","maintainers":[{"name":"calypsohq","email":"info@calypso.so"}],"homepage":"https://www.calypso.so/","bugs":{"url":"https://github.com/calypso-so/n8n-nodes-calypso/issues"},"n8n":{"nodes":["dist/nodes/CalypsoRag/CalypsoRag.node.js"],"credentials":["dist/credentials/CalypsoApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"092c20bbb463d35d6d975b58eca066d94ba9236c","tarball":"https://registry.npmjs.org/@calypsohq/n8n-nodes-calypso/-/n8n-nodes-calypso-1.0.2.tgz","fileCount":15,"integrity":"sha512-zKldNFMlHVMWhn8niaIXZenvVYr99+HAoRwqAY5wEVbbkcWGMduwTSVSM4v0QZYH9B+Q5yydMBt8rwtiF74ZuQ==","signatures":[{"sig":"MEUCIQCpFqltvIlJUVWdITvb8qRrMBWB6nrCoWTrFanDYwVmgQIgOh5Kx4QTxx+6Strt1uy8GSRD+IuqIOLsSs8Sy2iqXW8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@calypsohq%2fn8n-nodes-calypso@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":39495},"main":"dist/index.js","engines":{"npm":">=9.5.1","node":">=20.15"},"gitHead":"f880944dacf397b1843913dc8fde0975637fa7a2","scripts":{"dev":"tsc --watch","lint":"eslint . --ext .ts,.js","scan":"npx -p node@22 -p @n8n/scan-community-package scan-community-package @calypsohq/n8n-nodes-calypso","test":"echo \"No automated tests configured\"","build":"npx rimraf dist && tsc && gulp build:all","format":"prettier --write .","lintfix":"eslint . --ext .ts,.js --fix","package":"npm run build && npm pack","validate":"npm run build && npm run lint && npm run format:check","format:check":"prettier --check .","prepublishOnly":"npm run validate"},"_npmUser":{"name":"calypsohq","email":"info@calypso.so"},"repository":{"url":"git+https://github.com/calypso-so/n8n-nodes-calypso.git","type":"git"},"_npmVersion":"11.13.0","description":"n8n community node for Calypso RAG - call grounded Calypso agents from workflow automations","directories":{},"_nodeVersion":"24.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"gulp":"^5.0.1","eslint":"^8.0.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/node":"^18.0.0","@types/express":"^4.17.13","@types/form-data":"^2.2.1","@typescript-eslint/parser":"^6.0.0","eslint-plugin-n8n-nodes-base":"^1.16.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-calypso_1.0.2_1780688938473_0.4938417583730992","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@calypsohq/n8n-nodes-calypso","version":"1.0.3","keywords":["n8n-community-node-package","n8n-nodes","calypso","calypso-rag","rag","retrieval-augmented-generation","grounded-ai","ai-agents","knowledge-base","openai-compatible","api-integration","workflow-automation","automation"],"author":{"url":"https://www.calypso.so/","name":"Calypso","email":"info@calypso.so"},"license":"MIT","_id":"@calypsohq/n8n-nodes-calypso@1.0.3","maintainers":[{"name":"calypsohq","email":"info@calypso.so"}],"homepage":"https://www.calypso.so/","bugs":{"url":"https://github.com/calypso-so/n8n-nodes-calypso/issues"},"n8n":{"nodes":["dist/nodes/CalypsoRag/CalypsoRag.node.js"],"credentials":["dist/credentials/CalypsoApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"59a0138955c2439504daff2ea22325a9a92774e2","tarball":"https://registry.npmjs.org/@calypsohq/n8n-nodes-calypso/-/n8n-nodes-calypso-1.0.3.tgz","fileCount":15,"integrity":"sha512-z25dr3iBJ6h7CdsG1VUY7uTCi3jS9k0h9ePVCKo8G6RiXjaUjfPchs8Qcx8PUw1Yx2ArUu+2a9T4tvDK4SxQ8g==","signatures":[{"sig":"MEQCIGgbDq+27qBYA+TeeFFN0Hw9BEWiEE2tAbWeLiMVO+qCAiBQDe8kGFQKYfUXDBxgeIaqb2IbNkWeq2V0VtygjoGpbA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@calypsohq%2fn8n-nodes-calypso@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":39309},"main":"dist/index.js","engines":{"npm":">=9.5.1","node":">=20.15"},"gitHead":"b585798eb7dac15f9aa285d1ebe8bb29c2679d9a","scripts":{"dev":"tsc --watch","lint":"eslint . --ext .ts,.js","scan":"npx -p node@22 -p @n8n/scan-community-package scan-community-package @calypsohq/n8n-nodes-calypso","test":"echo \"No automated tests configured\"","build":"npx rimraf dist && tsc && gulp build:all","format":"prettier --write .","lintfix":"eslint . --ext .ts,.js --fix","package":"npm run build && npm pack","validate":"npm run build && npm run lint && npm run format:check","format:check":"prettier --check .","prepublishOnly":"npm run validate"},"_npmUser":{"name":"calypsohq","email":"info@calypso.so"},"repository":{"url":"git+https://github.com/calypso-so/n8n-nodes-calypso.git","type":"git"},"_npmVersion":"11.13.0","description":"n8n community node for Calypso RAG - call grounded Calypso agents from workflow automations","directories":{},"_nodeVersion":"24.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"gulp":"^5.0.1","eslint":"^8.0.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/node":"^18.0.0","@types/express":"^4.17.13","@types/form-data":"^2.2.1","@typescript-eslint/parser":"^6.0.0","eslint-plugin-n8n-nodes-base":"^1.16.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-calypso_1.0.3_1780690382772_0.829067441232261","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@calypsohq/n8n-nodes-calypso","version":"1.0.4","description":"n8n community node for Calypso RAG - call grounded Calypso agents from workflow automations","keywords":["n8n-community-node-package","n8n-nodes","calypso","calypso-rag","rag","retrieval-augmented-generation","grounded-ai","ai-agents","knowledge-base","openai-compatible","api-integration","workflow-automation","automation"],"license":"MIT","homepage":"https://www.calypso.so/","author":{"name":"Calypso","email":"info@calypso.so","url":"https://www.calypso.so/"},"repository":{"type":"git","url":"git+https://github.com/calypso-so/n8n-nodes-calypso.git"},"bugs":{"url":"https://github.com/calypso-so/n8n-nodes-calypso/issues"},"engines":{"node":">=20.15","npm":">=9.5.1"},"main":"dist/index.js","scripts":{"build":"npx rimraf dist && tsc && gulp build:all","dev":"tsc --watch","package":"npm run build && npm pack","format":"prettier --write .","format:check":"prettier --check .","lint":"eslint . --ext .ts,.js","lintfix":"eslint . --ext .ts,.js --fix","scan":"npx -p node@22 -p @n8n/scan-community-package scan-community-package @calypsohq/n8n-nodes-calypso","test":"echo \"No automated tests configured\"","validate":"npm run build && npm run lint && npm run format:check","prepublishOnly":"npm run validate"},"n8n":{"n8nNodesApiVersion":1,"nodes":["dist/nodes/Calypso/Calypso.node.js"],"credentials":["dist/credentials/CalypsoApi.credentials.js"]},"devDependencies":{"@types/express":"^4.17.13","@types/form-data":"^2.2.1","@types/node":"^18.0.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","eslint":"^8.0.0","eslint-plugin-n8n-nodes-base":"^1.16.0","gulp":"^5.0.1","prettier":"^3.0.0","typescript":"^5.0.0"},"peerDependencies":{"n8n-workflow":"*"},"publishConfig":{"access":"public"},"gitHead":"ad857246004f8e2bf550c2dd9d4ce0f52fe111df","_id":"@calypsohq/n8n-nodes-calypso@1.0.4","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-Ol/eEULJbX/FGNzB+bdVyYcQctyMODQNiLoOytG2W12O7Rju0RVkfSHPbR5FJujs7eTcVhA9ykVlkADma8z+kw==","shasum":"95e8c1ca4c0f2a6ecce6638dfaeaedd56786362c","tarball":"https://registry.npmjs.org/@calypsohq/n8n-nodes-calypso/-/n8n-nodes-calypso-1.0.4.tgz","fileCount":15,"unpackedSize":83676,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@calypsohq%2fn8n-nodes-calypso@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDLPqi2tW2d5chm3m/WYvqbsBNcHpqOUQCx9G8DIiUPzAiEA7Rebq/w7IXlWQx4wZPhctBx61HIir8+gwYK7BNuImsg="}]},"_npmUser":{"name":"calypsohq","email":"info@calypso.so"},"directories":{},"maintainers":[{"name":"calypsohq","email":"info@calypso.so"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-calypso_1.0.4_1780692389314_0.855274111666241"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-05T19:42:01.899Z","modified":"2026-06-05T20:46:29.810Z","1.0.1":"2026-06-05T19:42:02.254Z","1.0.2":"2026-06-05T19:48:58.612Z","1.0.3":"2026-06-05T20:13:02.911Z","1.0.4":"2026-06-05T20:46:29.498Z"},"bugs":{"url":"https://github.com/calypso-so/n8n-nodes-calypso/issues"},"author":{"name":"Calypso","email":"info@calypso.so","url":"https://www.calypso.so/"},"license":"MIT","homepage":"https://www.calypso.so/","keywords":["n8n-community-node-package","n8n-nodes","calypso","calypso-rag","rag","retrieval-augmented-generation","grounded-ai","ai-agents","knowledge-base","openai-compatible","api-integration","workflow-automation","automation"],"repository":{"type":"git","url":"git+https://github.com/calypso-so/n8n-nodes-calypso.git"},"description":"n8n community node for Calypso RAG - call grounded Calypso agents from workflow automations","maintainers":[{"name":"calypsohq","email":"info@calypso.so"}],"readme":"# Calypso Multimodal RAG for n8n\n\n**The easiest way to add Calypso Multimodal RAG to your n8n workflows.**\n\nSend grounded, multimodal questions to your Calypso workspace directly from n8n. Leverage native Gemini File Search for PDFs, screenshots, charts, diagrams, images, and more. Keep retrieval policy, bucket scoping, and grounding rules inside Calypso while n8n handles orchestration and automation.\n\n[![npm version](https://img.shields.io/npm/v/%40calypsohq%2Fn8n-nodes-calypso.svg)](https://www.npmjs.com/package/@calypsohq/n8n-nodes-calypso)\n[![GitHub stars](https://img.shields.io/github/stars/calypso-so/n8n-nodes-calypso?style=social)](https://github.com/calypso-so/n8n-nodes-calypso)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Calypso Multimodal RAG](https://img.shields.io/badge/Calypso_Multimodal_RAG-Gemini-blue)](https://www.calypso.so)\n\n## Quick Start\n\n1. Install the **Calypso** community node\n2. Add **Calypso API** credentials (your project API key)\n3. Drop the node into your workflow and start sending multimodal grounded queries\n\n**Example Input:**\n\n```json\n{\n\t\"model\": \"calypso-rag-agent\",\n\t\"input\": \"Explain this setup screenshot together with the attached policy PDF. What should the support rep do next?\"\n}\n```\n\n## Features\n\n- **True Multimodal RAG**: Powered by Calypso’s Gemini File Search — handles text + visuals (PDFs, screenshots, charts, diagrams, images) natively.\n- **Easy Agent Calls**: Use the default `calypso-rag-agent` or pick a named profile loaded from your API key, such as `calypso-rag-agent:support`.\n- **Native File Uploads**: Upload one binary file or a batch of incoming binary files directly into a selected Calypso knowledge bucket.\n- **Authenticated Bucket Picker**: Upload operations load active bucket options from the connected Calypso project API key.\n- **Project-scoped Security**: Calypso project API keys keep workspace, buckets, and policies aligned.\n- **Rich Outputs**: Answer text + source annotations, metadata, and optional usage stats.\n- **n8n AI Agent Ready**: Use as a tool in n8n AI workflows.\n- **Reliable**: Standard n8n error handling with structured Continue-on-Fail support.\n\n## Installation\n\n### n8n Cloud\n\n- Go to **Settings → Community nodes**\n- Install package: `@calypsohq/n8n-nodes-calypso`\n- Or search for \"Calypso\" / \"Calypso Multimodal RAG\" in the nodes panel.\n\n### Self-hosted n8n\n\n```bash\nnpm install @calypsohq/n8n-nodes-calypso\n```\n\nRestart n8n, then search for **Calypso**.\n\n## Credentials\n\nCreate a **Calypso API** credential:\n\n- **API Key**: Your Calypso project API key (`sk-...`)\n- **Base URL**: `https://api.calypso.so/v1` (default — change only for self-hosted Calypso)\n\n## Node Configuration\n\n### Operation\n\n- **Ask Agent** — Send grounded multimodal requests to Calypso.\n- **Upload File** — Upload one binary file from each incoming n8n item to a selected Calypso bucket.\n- **Upload Batch** — Upload all incoming binary files in one durable Calypso batch request.\n\n### Model\n\n- Default: `calypso-rag-agent`\n- Named Profile: choose a full model ID from the dropdown, such as `calypso-rag-agent:support`. The list is loaded from the Calypso profiles available to your project API key.\n\n### Input\n\nYour question or instruction. Calypso Multimodal RAG shines when querying across text and visual content already indexed in your buckets.\n\n**Multimodal Example Prompts**:\n\n- \"Compare this screenshot with the pricing chart in our handbook PDF\"\n- \"Explain the diagram in the attached onboarding document\"\n- \"What does our policy PDF say about this setup error screenshot?\"\n- \"Summarize key changes from the latest report and supporting visuals\"\n- \"Recommend the right plan based on this customer screenshot and our pricing docs\"\n\n### Uploads\n\nFor **Upload File** and **Upload Batch**, choose **Bucket Name or ID** from the dynamic bucket dropdown. The list is loaded from the active buckets available to the connected Calypso project API key and shows bucket names with file counts.\n\nSet **Binary Property Name** to the n8n binary field that contains the file, usually `data`. Optional upload fields include tags, metadata, single-file title, single-file idempotency key, batch idempotency key, and batch dry-run validation.\n\nUpload responses confirm durable acceptance by Calypso. Newly uploaded files may still need indexing time before they are query-ready for agent answers.\n\n### Additional Options\n\n- **Include Token Usage**\n- **Include Raw Response** (useful for debugging)\n\n## Output Format\n\n```json\n{\n\t\"answer\": \"Based on the policy PDF and screenshot...\",\n\t\"sources\": [\n\t\t{\n\t\t\t\"name\": \"Support Handbook.pdf\",\n\t\t\t\"url\": \"https://...\"\n\t\t}\n\t],\n\t\"metadata\": {\n\t\t\"timestamp\": \"2026-06-05T...\",\n\t\t\"calypso\": {}\n\t},\n\t\"usage\": {}\n}\n```\n\n## How It Works\n\nThe node calls Calypso’s OpenAI-compatible `/v1/responses` endpoint. All multimodal retrieval, grounding, and policy enforcement happens inside Calypso Multimodal RAG. n8n stays lean — focused on workflow logic, triggers, and actions.\n\nThis creates a consistent knowledge layer across your tools (Claude, Cursor, n8n, etc.).\n\n## Best Practices\n\n- Test prompts in the Calypso Playground first.\n- Use named profiles for specific bucket or policy needs. n8n only shows profiles your Calypso project API key can access.\n- Use **Upload Batch** when multiple incoming items should be accepted as one retryable Calypso batch.\n- Ensure new uploads are fully indexed before querying.\n- Rotate project API keys regularly from the Calypso dashboard.\n\n## Companion Tool\n\nPair this node with the **[Calypso Multimodal RAG MCP Server](https://github.com/calypso-so/calypso-mcp-server)** for seamless integration across desktop agents and n8n automations.\n\n## Support & Links\n\n- **Website**: [calypso.so](https://www.calypso.so)\n- **GitHub**: [calypso-so/n8n-nodes-calypso](https://github.com/calypso-so/n8n-nodes-calypso)\n- **Issues**: [GitHub Issues](https://github.com/calypso-so/n8n-nodes-calypso/issues)\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n","readmeFilename":"README.md"}