Package Information
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Vorion
Documentation
@vorionsys/n8n-nodes-cognigate
n8n community node for Cognigate — AI agent trust scoring, capability enforcement, and cryptographic audit proof via the BASIS standard.
Installation
In n8n Desktop / Self-Hosted
- Go to Settings → Community Nodes
- Enter
@vorionsys/n8n-nodes-cognigate - Click Install
Via npm
cd ~/.n8n
npm install @vorionsys/n8n-nodes-cognigate
Credentials
| Field | Description |
|---|---|
| Base URL | Your Cognigate instance URL (default: https://cognigate.dev) |
| API Key | Pipeline API key — used for intent, enforce, proof, trust endpoints |
| Admin Key | (optional) Admin API key — required only for admin & compliance trigger operations |
Generate an API key at your Cognigate dashboard or via POST /v1/auth/keys.
Resources & Operations
Intent — Goal Processing
| Operation | Description |
|---|---|
| Create | Normalize an agent goal into a structured plan with risk scoring |
| Get | Retrieve a previously processed intent by ID |
Enforce — Policy Validation
| Operation | Description |
|---|---|
| Validate | Validate a plan against BASIS policies (lite / standard / strict rigor) |
| List Policies | List all available enforcement policies |
| Get Policy | Get details for a specific policy |
Proof — Cryptographic Audit Ledger
| Operation | Description |
|---|---|
| Create | Create an immutable proof record from an enforcement verdict |
| Get | Retrieve a proof record by ID |
| Query | Query proof records with filters (entity, decision, date range) |
| Stats | Get proof ledger statistics and chain integrity |
| Verify | Verify proof integrity and hash-chain linkage |
Agent — Agent CRUD
| Operation | Description |
|---|---|
| Register | Register a new AI agent with capabilities and observation tier |
| List | List all registered agents (filter by tier) |
| Get | Get agent details |
| Update | Update agent name or capabilities |
| Revoke | Revoke an agent |
Trust — Trust Lifecycle
| Operation | Description |
|---|---|
| Admit | Admit an agent into the trust system |
| Get Status | Get current trust score, tier, and capabilities |
| Record Signal | Record success / failure / violation / neutral signals |
| Revoke | Revoke agent trust with reason |
| History | Get trust signal history |
| List Tiers | Get all 8 tier definitions (T0–T7) |
Health — Instance Monitoring
| Operation | Description |
|---|---|
| Full Check | Full health check with subsystem status |
| Liveness | Lightweight k8s liveness probe |
| Readiness | Readiness check |
Reference — Read-Only Lookups
| Operation | Description |
|---|---|
| List Tiers | All 8 trust tiers (T0–T7) with score ranges |
| Lookup Tier | Lookup tier by numeric trust score (0–1000) |
| Capabilities | All 24 capability codes with tier requirements |
| Errors | All error codes with retry guidance |
| Rate Limits | Rate limits per trust tier |
| Versions | API version registry |
Compliance — Continuous Monitoring (CA-7)
| Operation | Description |
|---|---|
| Health | All control health across all frameworks |
| Framework Health | Framework-specific control health |
| Snapshot | Point-in-time compliance snapshot |
| Dashboard | Aggregated compliance dashboard |
| Evidence | Evidence for a specific control ID |
| Trigger Monitor | Trigger full compliance check (admin key required) |
Supported frameworks: NIST 800-53, EU AI Act, ISO 42001, SOC 2, NIST AI RMF, CMMC 2.0
Example: Full Governance Pipeline
Chain three Cognigate nodes to implement INTENT → ENFORCE → PROOF:
- Intent: Create — Parse the agent's goal into a structured plan with risk analysis
- Enforce: Validate — Pass the plan through BASIS policy evaluation
- Proof: Create — Record the enforcement verdict as an immutable audit proof
This gives you a complete governance pipeline with cryptographic evidence for every agent action.
Development
cd packages/n8n-nodes-cognigate
npm install
npm run build
Testing locally with n8n
# Link the package
cd packages/n8n-nodes-cognigate
npm link
# In your n8n installation
cd ~/.n8n
npm link @vorionsys/n8n-nodes-cognigate
License
Apache-2.0 — see LICENSE for details.