n8n-plugin

n8n community node for AgenTrux — A2A authenticated ephemeral data pipe service

Package Information

Downloads: 0 weekly / 23 monthly
Latest Version: 0.2.0

Available Nodes

AgenTrux
Interact with AgenTrux — publish & read events, manage grants
AgenTrux Trigger
Trigger workflows on new AgenTrux events via webhook or polling

Documentation

n8n-nodes-agentrux

n8n community node for AgenTrux — A2A authenticated ephemeral data pipe service.

Installation

cd plugins/n8n
npm install
npm run build

Option A: npm link (開発向け)

cd plugins/n8n && npm link
cd ~/.n8n && mkdir -p custom && cd custom && npm init -y && npm link n8n-nodes-agentrux

Option B: Symlink

mkdir -p ~/.n8n/custom
ln -s "$(pwd)" ~/.n8n/custom/n8n-nodes-agentrux

Option C: Docker

services:
  n8n:
    image: n8nio/n8n
    volumes:
      - ./plugins/n8n:/home/node/custom-nodes/n8n-nodes-agentrux
    environment:
      - N8N_CUSTOM_EXTENSIONS=/home/node/custom-nodes/n8n-nodes-agentrux

n8n を再起動するとノードパネルに表示されます。

Quick Start

1. Credential 作成（Activation Token モード）

Field Value
Base URL https://your-agentrux-server.example.com
Auth Mode Activation Token (Initial Setup)
Activation Token atk_...（コンソールで発行したトークン）

「Test Credential」で接続確認 → Save

2. ノードを1回実行

AgenTrux ノードをキャンバスに配置して実行すると、自動的に activate されます。
出力の1件目に script_id と secret が含まれます:

{
  "_setup": "AUTO_ACTIVATED",
  "script_id": "abc-123-...",
  "secret": "xxxxxxxxxxxxxxxx",
  "grants": [...]
}

3. Credential を切り替え（1回だけ）

Field Value
Auth Mode Script Credentials
Script ID 出力の script_id
Secret 出力の secret
Grant Token gtk_...（任意、初回自動 redeem）

以降はこの設定で動作し続けます。

Nodes

AgenTrux（Action Node）

Resource: Topic

Operation Description
Publish Event イベントを topic に publish（correlation_id, reply_topic, payload_ref 対応）
Read Events カーソルページネーションでイベント一覧取得
Get Event 単一イベントを ID で取得
Upload Payload バイナリデータを presigned URL 経由でアップロード
Download Payload バイナリデータを presigned URL 経由でダウンロード

Resource: Auth

Operation Description
Redeem Grant Token gtk_... トークンを消費してクロスアカウントアクセスを取得

AgenTrux Trigger

Mode Description
Polling 定期的に GET /topics/{id}/events でカーソルベースのポーリング
Webhook n8n の webhook URL を AgenTrux コンソールに登録 → ヒント通知を受信

Webhook モードでは HMAC-SHA256 署名検証に対応しています。

Credentials

Field Mode Required Description
Base URL 共通 Yes AgenTrux API サーバー URL
Auth Mode 共通 Yes Activation Token / Script Credentials
Activation Token Initial Setup Yes 初回 activate 用ワンタイムトークン
Script ID Script Credentials Yes スクリプト UUID
Secret Script Credentials Yes スクリプトシークレット
Grant Token Script Credentials No クロスアカウント用（初回自動 redeem）
Webhook Secret 共通 No Webhook HMAC-SHA256 署名検証用

Authentication Flow

Activation Token mode            Script Credentials mode
        │                                  │
        ▼                                  ▼
  POST /auth/activate             (grant token あり?)
        │                            │          │
        ▼                           Yes         No
  script_id + secret 取得            │          │
  (キャッシュ + 出力)                ▼          │
        │                   POST /auth/redeem   │
        │                   -grant (1回だけ)     │
        │                            │          │
        └────────────┬───────────────┘          │
                     ▼                          │
              POST /auth/token  ◄───────────────┘
                     │
                     ▼
               JWT キャッシュ (30s バッファ)
                     │
                     ▼
              POST /auth/refresh (期限切れ時)
                     │
                     ▼
              401 → キャッシュ破棄 → 再認証 (1回リトライ)

License

MIT

Discussion