n8n-nodes-promptguard

n8n-nodes-promptguard

Thin-client n8n community nodes that call the PromptGuard Gateway.

$3

If published to npm, install via n8n’s Community Nodes UI: n8n-nodes-promptguard.

For local development (unpublished) in Docker, use N8N_CUSTOM_EXTENSIONS.
Important: when installing with npm, point N8N_CUSTOM_EXTENSIONS at the node_modules directory so n8n discovers the package.

``bash
docker run --rm -it --name n8n \
-p 5678:5678 \
-e N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom/node_modules \
-e N8N_HOST=localhost \
-e N8N_PORT=5678 \
-e N8N_PROTOCOL=http \
-e WEBHOOK_URL=http://localhost:5678/ \
-v n8n_data:/home/node/.n8n \
-v /path/to/.n8n-custom:/tmp/pg \
--user root \
--entrypoint /bin/sh \
n8nio/n8n -lc 'set -e; mkdir -p /home/node/.n8n/custom; chmod -R a+rwx /home/node/.n8n/custom; npm i --prefix /home/node/.n8n/custom /tmp/pg/n8n-nodes-promptguard-*.tgz; chmod -R a+rX /home/node/.n8n/custom; exec su -s /bin/sh node -c "n8n"'
`

In n8n, add credentials PromptGuard API:
- Base URL: http://host.docker.internal:8080 (or your gateway URL)
- API key: optional (leave empty in demo)

$3

- PromptGuardPlan → POST /v1/plan
- PromptGuardValidate → POST /v1/validate
- PromptGuardDistill → POST /v1/distill
- PromptGuardLinearize → POST /v1/linearize
- PromptGuardApprove → POST /v1/approve

$3

1. Start the gateway (local dev uses http://localhost:8080).
2. In n8n, create PromptGuard API credentials with the base URL + API key.
3. Import the example workflow at packages/examples/workflows/promptguard-approval-roundtrip.json.
4. Update the example nodes with your intent text and credentials, then run.

The approval flow is: Plan → Validate → Linearize → Approve → Validate. Your execution layer should only run when the second validation returns ALLOW.

$3

TODO: add screenshots:
- docs/screenshots/plan.png
- docs/screenshots/validate.png
- docs/screenshots/distill.png
- docs/screenshots/linearize.png
- docs/screenshots/approve.png`