Live package

n8n-nodes-stacksona

Native Stacksona Gate operations for n8n, including request-and-wait, revisions, decision lookup, tool resolution, signed proof, and audit events.

Install and place it

1
Install community node.
Settings → Community Nodes → n8n-nodes-stacksona.
2
Create credentials.
Use your Gate URL and sg_ agent API key.
3
Put Stacksona before the side effect.
Use Request Decision and Wait for the common approval path.

Simplest workflow

text

AI Agent / workflow builds final action
                ↓
Stacksona Gate
Request Decision and Wait
                ↓
      allow / approved
                ↓
Gmail / HTTP / CRM / payment / database node

Example refund configuration

Field	Value
Operation	`Request Decision and Wait`
Task ID	`refund-{{$json.order_id}}`
Tool Name	`issue_refund`
Subject	`Refund order {{$json.order_id}}`
Risk Level	`high`
Payload JSON	`={{ JSON.stringify({ order_id: $json.order_id, amount: $json.amount, currency: $json.currency }) }}`

If Gate returns pending_review, the node follows that exact thread_id. Route only allow and approved to the side-effect node.

Operations

Operation	Use it for
Resolve Tools	Load registered Gate names, descriptions, and input schemas.
Log Event	Append timeline evidence.
Request Decision	Evaluate one exact call and return immediately.
Request Decision and Wait	Evaluate and wait when human review is required.
Get Decision	Read a review by Thread ID or Task ID.
List Decisions	List recent pending or completed review references.
Submit Revision	Submit requested changes on the same review thread.
Validate Approval Token	Validate and consume signed one-time proof.

Requested changes

Request Decision and Wait returns on changes_requested. Revise the proposal, then use Submit Revision with the same Task ID and Thread ID. The node generates a Revision ID when you leave it blank.

Long reviews

The wait operation uses a 15-second fallback poll interval, honors Gate's recommended polling delay, and defaults to a 600-second maximum. For longer reviews, use Request Decision, persist thread_id, and resume later with Get Decision.

Signed approvals

When signed proof is required, pass the approved decision's task ID and approval token into Validate Approval Token before the real action. Branch on valid, not HTTP success alone.

Package version

n8n-nodes-stacksona 0.2.0 · Node.js 22+