@axonflow/n8n-nodes-axonflow 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AxonFlow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# n8n-nodes-axonflow
+
+AxonFlow API integration for [n8n](https://n8n.io). Call the AxonFlow policy and HITL endpoints directly from your n8n workflows.
+
+[![npm version](https://img.shields.io/npm/v/@axonflow/n8n-nodes-axonflow)](https://www.npmjs.com/package/@axonflow/n8n-nodes-axonflow)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What it does
+
+This package contributes a single `AxonFlow` node with four operations against an AxonFlow Agent:
+
+| Operation | Endpoint | When to use |
+|---|---|---|
+| **Check Policy** | `POST /api/v1/mcp/check-input` | Before a workflow takes a sensitive action — receive `{allowed, block_reason?}` and branch on it. |
+| **Record Decision** | `POST /api/v1/audit/tool-call` | After a successful action — capture inputs, outputs, policies applied. |
+| **Audit Log** | `POST /api/v1/audit/tool-call` | From error branches — record the failed action with `success: false` and `error_message`. |
+| **Wait for Approval** | `POST /api/v1/hitl/queue` | When the workflow needs a human in the loop — creates an approval entry and pairs with an n8n Wait node for webhook resume. |
+
+Plus a single `AxonFlow API` credential type holding the endpoint + Basic-auth (`clientId` + `userToken`).
+
+## Install
+
+### n8n GUI (self-hosted)
+
+1. **Settings > Community Nodes > Install.**
+2. npm package name: `@axonflow/n8n-nodes-axonflow`.
+3. Restart n8n.
+
+### Manual (self-hosted)
+
+```bash
+cd ~/.n8n/custom
+npm install @axonflow/n8n-nodes-axonflow
+# restart n8n
+```
+
+> n8n Cloud does not currently allow unverified community nodes. Use the [stock-HTTP-node recipe](https://docs.getaxonflow.com/docs/integration/n8n/) on n8n Cloud until this package is verified.
+
+## Configure the credential
+
+**Credentials > New > AxonFlow API.**
+
+| Field | Description |
+|---|---|
+| Endpoint | Base URL of your AxonFlow Agent. SaaS: `https://try.getaxonflow.com`. Self-hosted: typically port 8080. |
+| Client ID | Your tenant identifier. |
+| User Token | Sent as the password half of HTTP Basic auth. Stored encrypted in n8n. |
+
+## Quickstart
+
+1. Install the community node (see above).
+2. Create an **AxonFlow API** credential with your endpoint + Client ID + User Token.
+3. Add an **AxonFlow** node to your workflow.
+4. Pick an operation:
+   - **Check Policy** — submit a proposed action and branch on `allowed: true/false`.
+   - **Record Decision** — log the outcome of a downstream action.
+   - **Audit Log** — log a failed action from an error branch.
+   - **Wait for Approval** — create a HITL request and pair with a Wait node for webhook resume.
+5. Run the workflow.
+
+## Three things to know
+
+1. **Bearer Auth > Header Auth.** This credential uses the Header Auth pattern (Authorization built inline) rather than n8n's built-in Bearer Auth class, which silently drops the header in some n8n versions ([n8n#15261](https://github.com/n8n-io/n8n/issues/15261)).
+2. **Idempotency by default.** Every operation sends `Idempotency-Key: {executionId}-{itemIndex}-{nodeName}` so n8n's `Retry on Fail` doesn't double-record. Override at the node parameter level if you need a domain-specific key.
+3. **HITL pairs with the Wait node.** `Wait for Approval` creates the AxonFlow approval entry; pair it with a downstream Wait node configured for **On Webhook Call** mode. As of platform v8.1.0+, pass the Wait node's webhook URL as `notify_url` in the HITL queue request and AxonFlow will POST to it automatically on approval/rejection — no polling sidecar needed. For self-hosted deployments on v8.0.x, two manual paths work: (a) run a small **polling sidecar** that watches `GET /api/v1/hitl/queue/{id}` and POSTs to the Wait node's webhook URL when status changes, or (b) have a reviewer trigger the resume URL manually from the portal. See the [n8n integration docs](https://docs.getaxonflow.com/docs/integration/n8n/#hitl) for details.
+
+## Example workflow
+
+[`examples/governed-loan-workflow.json`](./examples/governed-loan-workflow.json) — an importable workflow that:
+
+1. Receives a loan request via HTTP trigger,
+2. Calls **Check Policy** on the amount,
+3. If `allowed=false`, branches to **Wait for Approval** (workflow pauses),
+4. On approval, calls the downstream loan-issuance HTTP endpoint,
+5. Records the outcome with **Record Decision**, with an error branch to **Audit Log**.
+
+Import in n8n: **Workflows > Import from File >** `governed-loan-workflow.json`.
+
+## Build from source
+
+```bash
+git clone https://github.com/getaxonflow/axonflow-n8n-node.git
+cd axonflow-n8n-node
+npm install
+npm run build       # tsc > dist/
+npm run lint
+npm test            # node --test (25 tests)
+```
+
+## Documentation
+
+- [n8n + AxonFlow Integration Guide](https://docs.getaxonflow.com/docs/integration/n8n/) — full walkthrough including the stock-HTTP-node recipe, HITL polling sidecar, and idempotency details.
+- [AxonFlow](https://getaxonflow.com) — main project site.
+- [AxonFlow on GitHub](https://github.com/getaxonflow/axonflow) — community edition.
+
+## License
+
+MIT

package/dist/credentials/AxonFlowApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class AxonFlowApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/AxonFlowApi.credentials.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AxonFlowApi = void 0;
+class AxonFlowApi {
+    constructor() {
+        this.name = 'axonFlowApi';
+        this.displayName = 'AxonFlow API';
+        this.documentationUrl = 'https://docs.getaxonflow.com/docs/integration/n8n/';
+        this.properties = [
+            {
+                displayName: 'Endpoint',
+                name: 'endpoint',
+                type: 'string',
+                default: 'https://try.getaxonflow.com',
+                placeholder: 'https://try.getaxonflow.com',
+                description: 'Base URL of your AxonFlow Agent (port 8080 in self-hosted, or your SaaS host).',
+                required: true,
+            },
+            {
+                displayName: 'Client ID',
+                name: 'clientId',
+                type: 'string',
+                default: '',
+                description: 'AxonFlow client identifier (the tenant your workflow runs under).',
+                required: true,
+            },
+            {
+                displayName: 'User Token',
+                name: 'userToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'AxonFlow user token. Sent as the password half of HTTP Basic auth.',
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Basic {{ Buffer.from($credentials.clientId + ":" + $credentials.userToken).toString("base64") }}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{ $credentials.endpoint }}',
+                url: '/api/v1/mcp/check-input',
+                method: 'POST',
+                body: {
+                    client_id: '={{ $credentials.clientId }}',
+                    user_token: '={{ $credentials.userToken }}',
+                    tenant_id: '={{ $credentials.clientId }}',
+                    connector_type: 'credential_test',
+                    statement: 'n8n_credential_test_noop',
+                },
+            },
+        };
+    }
+}
+exports.AxonFlowApi = AxonFlowApi;
+//# sourceMappingURL=AxonFlowApi.credentials.js.map

package/dist/credentials/AxonFlowApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AxonFlowApi.credentials.js","sourceRoot":"","sources":["../../credentials/AxonFlowApi.credentials.ts"],"names":[],"mappings":";;;AAgBA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QAErB,gBAAW,GAAG,cAAc,CAAC;QAE7B,qBAAgB,GAAG,oDAAoD,CAAC;QAExE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,6BAA6B;gBACtC,WAAW,EAAE,6BAA6B;gBAC1C,WAAW,EACV,gFAAgF;gBACjF,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EACV,mEAAmE;gBACpE,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,WAAW,EACV,oEAAoE;gBACrE,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAgBF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EACZ,mGAAmG;iBACpG;aACD;SACD,CAAC;QAyBF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,8BAA8B;gBACvC,GAAG,EAAE,yBAAyB;gBAC9B,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE;oBACL,SAAS,EAAE,8BAA8B;oBACzC,UAAU,EAAE,+BAA+B;oBAC3C,SAAS,EAAE,8BAA8B;oBACzC,cAAc,EAAE,iBAAiB;oBACjC,SAAS,EAAE,0BAA0B;iBACrC;aACD;SACD,CAAC;IACH,CAAC;CAAA;AApGD,kCAoGC"}

package/dist/nodes/AxonFlow/AxonFlow.node.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class AxonFlow implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/AxonFlow/AxonFlow.node.js

@@ -0,0 +1,435 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AxonFlow = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const DEFAULT_IDEMPOTENCY_TEMPLATE = '={{ $execution.id }}-{{ $itemIndex }}-{{ $node.name }}';
+class AxonFlow {
+    constructor() {
+        this.description = {
+            displayName: 'AxonFlow',
+            name: 'axonFlow',
+            icon: 'file:axonflow.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{ $parameter["operation"] }}',
+            description: 'AxonFlow API integration — call policy and HITL endpoints from your workflow.',
+            defaults: {
+                name: 'AxonFlow',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'axonFlowApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Check Policy',
+                            value: 'checkPolicy',
+                            description: 'Submit a proposed action to AxonFlow and receive an allow/deny response',
+                            action: 'Check policy for a proposed action',
+                        },
+                        {
+                            name: 'Record Decision',
+                            value: 'recordDecision',
+                            description: 'Record the outcome of a downstream action in AxonFlow',
+                            action: 'Record a decision',
+                        },
+                        {
+                            name: 'Audit Log',
+                            value: 'auditLog',
+                            description: 'Record an event in AxonFlow (typically for error branches)',
+                            action: 'Record an event',
+                        },
+                        {
+                            name: 'Wait for Approval',
+                            value: 'waitForApproval',
+                            description: 'Create a HITL approval request and pause the workflow until a reviewer responds',
+                            action: 'Wait for HITL approval',
+                        },
+                    ],
+                    default: 'checkPolicy',
+                },
+                {
+                    displayName: 'Idempotency Key',
+                    name: 'idempotencyKey',
+                    type: 'string',
+                    default: DEFAULT_IDEMPOTENCY_TEMPLATE,
+                    description: 'Sent as the Idempotency-Key header. The default is unique per execution-item-node, so n8n retries do not double-record. Override only if you need a domain-specific key.',
+                },
+                {
+                    displayName: 'Failure Mode',
+                    name: 'failureMode',
+                    type: 'options',
+                    options: [
+                        {
+                            name: 'Open (Continue If AxonFlow Is Unreachable)',
+                            value: 'open',
+                        },
+                        {
+                            name: 'Closed (Fail If AxonFlow Is Unreachable)',
+                            value: 'closed',
+                        },
+                    ],
+                    default: 'open',
+                    description: 'On network errors / 5xx responses from AxonFlow. Open matches the AxonFlow ADK plugin default — the workflow proceeds with a structured fallback payload so the underlying action is not held hostage by an AxonFlow outage. Closed re-throws and stops the workflow; choose this for high-stakes flows where you would rather fail than skip the policy check.',
+                },
+                {
+                    displayName: 'Connector Type',
+                    name: 'connectorType',
+                    type: 'string',
+                    default: 'n8n',
+                    displayOptions: { show: { operation: ['checkPolicy'] } },
+                    description: 'AxonFlow connector type for this request. Use "n8n" unless you have a custom connector wired up.',
+                    required: true,
+                },
+                {
+                    displayName: 'Statement',
+                    name: 'statement',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { operation: ['checkPolicy'] } },
+                    description: 'The proposed action as a string (e.g. SQL, prompt, API verb+path). AxonFlow evaluates this against policies.',
+                    required: true,
+                },
+                {
+                    displayName: 'Operation Type',
+                    name: 'mcpOperation',
+                    type: 'options',
+                    options: [
+                        { name: 'Execute', value: 'execute' },
+                        { name: 'Query', value: 'query' },
+                    ],
+                    default: 'execute',
+                    displayOptions: { show: { operation: ['checkPolicy'] } },
+                },
+                {
+                    displayName: 'Parameters (JSON)',
+                    name: 'parameters',
+                    type: 'json',
+                    default: '{}',
+                    displayOptions: { show: { operation: ['checkPolicy'] } },
+                    description: 'Optional parameters passed alongside the statement',
+                },
+                {
+                    displayName: 'Tool Name',
+                    name: 'toolName',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: { operation: ['recordDecision', 'auditLog'] },
+                    },
+                    description: 'Name of the tool / action being recorded (e.g. "approve_loan")',
+                    required: true,
+                },
+                {
+                    displayName: 'Workflow ID',
+                    name: 'workflowId',
+                    type: 'string',
+                    default: '={{ $workflow.id }}',
+                    displayOptions: {
+                        show: { operation: ['recordDecision', 'auditLog'] },
+                    },
+                    description: 'Defaults to the running n8n workflow ID so entries are searchable',
+                },
+                {
+                    displayName: 'Step ID',
+                    name: 'stepId',
+                    type: 'string',
+                    default: '={{ $node.name }}',
+                    displayOptions: {
+                        show: { operation: ['recordDecision', 'auditLog'] },
+                    },
+                },
+                {
+                    displayName: 'Input (JSON)',
+                    name: 'auditInput',
+                    type: 'json',
+                    default: '={{ JSON.stringify($json) }}',
+                    displayOptions: {
+                        show: { operation: ['recordDecision', 'auditLog'] },
+                    },
+                    description: 'Inputs to record alongside the decision. Defaults to the current item.',
+                },
+                {
+                    displayName: 'Output (JSON)',
+                    name: 'auditOutput',
+                    type: 'json',
+                    default: '{}',
+                    displayOptions: {
+                        show: { operation: ['recordDecision', 'auditLog'] },
+                    },
+                },
+                {
+                    displayName: 'Success',
+                    name: 'auditSuccess',
+                    type: 'boolean',
+                    default: true,
+                    displayOptions: {
+                        show: { operation: ['recordDecision', 'auditLog'] },
+                    },
+                    description: 'Whether the recorded action succeeded. Set false from error branches.',
+                },
+                {
+                    displayName: 'Error Message',
+                    name: 'auditErrorMessage',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: { operation: ['recordDecision', 'auditLog'] },
+                    },
+                },
+                {
+                    displayName: 'Request Type',
+                    name: 'requestType',
+                    type: 'string',
+                    default: 'workflow_step',
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                    description: 'AxonFlow request_type for the approval entry',
+                },
+                {
+                    displayName: 'Original Query / Action',
+                    name: 'originalQuery',
+                    type: 'string',
+                    default: '',
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                    description: 'Short description of what needs approval',
+                    required: true,
+                },
+                {
+                    displayName: 'Triggered Policy ID',
+                    name: 'triggeredPolicyId',
+                    type: 'string',
+                    default: 'n8n-manual',
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                    description: 'AxonFlow static_policies.ID that triggered this approval. Use "n8n-manual" for workflow-initiated approvals not tied to a specific policy.',
+                },
+                {
+                    displayName: 'Triggered Policy Name',
+                    name: 'triggeredPolicyName',
+                    type: 'string',
+                    default: 'n8n manual approval',
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                },
+                {
+                    displayName: 'Trigger Reason',
+                    name: 'triggerReason',
+                    type: 'string',
+                    default: 'Approval requested from n8n workflow',
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                },
+                {
+                    displayName: 'Severity',
+                    name: 'severity',
+                    type: 'options',
+                    options: [
+                        { name: 'Low', value: 'low' },
+                        { name: 'Medium', value: 'medium' },
+                        { name: 'High', value: 'high' },
+                        { name: 'Critical', value: 'critical' },
+                    ],
+                    default: 'medium',
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                },
+                {
+                    displayName: 'Limit Wait Time (Seconds)',
+                    name: 'limitWaitTime',
+                    type: 'number',
+                    default: 86400,
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                    description: 'Maps to expires_in_seconds on the AxonFlow approval. Defaults to 24h.',
+                },
+                {
+                    displayName: 'Request Context (JSON)',
+                    name: 'requestContext',
+                    type: 'json',
+                    default: '={{ JSON.stringify($json) }}',
+                    displayOptions: { show: { operation: ['waitForApproval'] } },
+                    description: 'Arbitrary context surfaced in the AxonFlow portal. Defaults to the current item.',
+                },
+            ],
+        };
+    }
+    async execute() {
+        var _a;
+        const items = this.getInputData();
+        const credentials = await this.getCredentials('axonFlowApi');
+        const endpoint = String(credentials.endpoint || '').replace(/\/+$/, '');
+        const clientId = String(credentials.clientId || '');
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            const operation = this.getNodeParameter('operation', i);
+            const idempotencyKey = this.getNodeParameter('idempotencyKey', i, `${this.getExecutionId()}-${i}-${this.getNode().name}`);
+            const failureMode = this.getNodeParameter('failureMode', i, 'open');
+            try {
+                let result;
+                switch (operation) {
+                    case 'checkPolicy':
+                        result = await this.helpers.httpRequestWithAuthentication.call(this, 'axonFlowApi', buildRequest({
+                            endpoint,
+                            method: 'POST',
+                            path: '/api/v1/mcp/check-input',
+                            idempotencyKey,
+                            body: {
+                                client_id: clientId,
+                                user_token: String(credentials.userToken || ''),
+                                tenant_id: clientId,
+                                connector_type: this.getNodeParameter('connectorType', i),
+                                statement: this.getNodeParameter('statement', i),
+                                operation: this.getNodeParameter('mcpOperation', i),
+                                parameters: parseJsonParam(this.getNodeParameter('parameters', i, '{}')),
+                            },
+                        }));
+                        break;
+                    case 'recordDecision':
+                    case 'auditLog':
+                        result = await this.helpers.httpRequestWithAuthentication.call(this, 'axonFlowApi', buildRequest({
+                            endpoint,
+                            method: 'POST',
+                            path: '/api/v1/audit/tool-call',
+                            idempotencyKey,
+                            body: {
+                                tool_name: this.getNodeParameter('toolName', i),
+                                tool_type: operation === 'auditLog' ? 'n8n_audit' : 'n8n_decision',
+                                workflow_id: this.getNodeParameter('workflowId', i),
+                                step_id: this.getNodeParameter('stepId', i),
+                                input: parseJsonParam(this.getNodeParameter('auditInput', i, '{}')),
+                                output: parseJsonParam(this.getNodeParameter('auditOutput', i, '{}')),
+                                success: this.getNodeParameter('auditSuccess', i),
+                                error_message: this.getNodeParameter('auditErrorMessage', i, ''),
+                            },
+                        }));
+                        break;
+                    case 'waitForApproval': {
+                        const limitWaitTime = this.getNodeParameter('limitWaitTime', i);
+                        const createResp = (await this.helpers.httpRequestWithAuthentication.call(this, 'axonFlowApi', buildRequest({
+                            endpoint,
+                            method: 'POST',
+                            path: '/api/v1/hitl/queue',
+                            idempotencyKey,
+                            body: {
+                                client_id: clientId,
+                                original_query: this.getNodeParameter('originalQuery', i),
+                                request_type: this.getNodeParameter('requestType', i),
+                                request_context: parseJsonParam(this.getNodeParameter('requestContext', i, '{}')),
+                                triggered_policy_id: this.getNodeParameter('triggeredPolicyId', i),
+                                triggered_policy_name: this.getNodeParameter('triggeredPolicyName', i),
+                                trigger_reason: this.getNodeParameter('triggerReason', i),
+                                severity: this.getNodeParameter('severity', i),
+                                expires_in_seconds: limitWaitTime,
+                            },
+                        })));
+                        const approvalData = extractApprovalData(createResp, this.getNode());
+                        result = {
+                            approval_id: approvalData.id,
+                            status: (_a = approvalData.status) !== null && _a !== void 0 ? _a : 'pending',
+                            expires_at: approvalData.expires_at,
+                            resume_hint: 'Use notify_url (v8.1.0+) to auto-POST approval events to a Wait node webhook, or poll GET /api/v1/hitl/queue/{id}. See https://docs.getaxonflow.com/docs/integration/n8n/#hitl.',
+                            raw: createResp,
+                        };
+                        break;
+                    }
+                    default:
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                }
+                returnData.push({
+                    json: result,
+                    pairedItem: { item: i },
+                });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                if (failureMode === 'open' && shouldFailOpen(error)) {
+                    returnData.push({
+                        json: {
+                            _axonflow_unreachable: true,
+                            error: error.message,
+                            operation,
+                        },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.AxonFlow = AxonFlow;
+function buildRequest(args) {
+    const headers = {
+        'Content-Type': 'application/json',
+        Accept: 'application/json',
+    };
+    if (args.idempotencyKey) {
+        headers['Idempotency-Key'] = args.idempotencyKey;
+    }
+    return {
+        method: args.method,
+        url: `${args.endpoint}${args.path}`,
+        headers,
+        body: args.body,
+        json: true,
+    };
+}
+function shouldFailOpen(error) {
+    var _a, _b;
+    if (error instanceof n8n_workflow_1.NodeOperationError)
+        return false;
+    const err = error;
+    const httpCode = (_a = (typeof err.httpCode === 'string' ? parseInt(err.httpCode, 10) : err.httpCode)) !== null && _a !== void 0 ? _a : (_b = err.context) === null || _b === void 0 ? void 0 : _b.statusCode;
+    if (typeof httpCode === 'number' && !Number.isNaN(httpCode)) {
+        return httpCode >= 500 && httpCode < 600;
+    }
+    return true;
+}
+function parseJsonParam(value) {
+    if (value === null || value === undefined)
+        return {};
+    if (typeof value === 'object')
+        return value;
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed)
+            return {};
+        try {
+            const parsed = JSON.parse(trimmed);
+            return (typeof parsed === 'object' && parsed !== null
+                ? parsed
+                : { value: parsed });
+        }
+        catch {
+            return { raw: value };
+        }
+    }
+    return {};
+}
+function extractApprovalData(resp, node) {
+    var _a;
+    const inner = resp.data;
+    if (!inner || typeof inner !== 'object') {
+        throw new n8n_workflow_1.NodeOperationError(node, 'AxonFlow returned an unexpected response shape from /api/v1/hitl/queue — missing `data` envelope. ' +
+            'Check that the request is hitting the AxonFlow Agent directly (not a proxy that strips the wrapping object).');
+    }
+    return {
+        id: (_a = inner.id) !== null && _a !== void 0 ? _a : inner.approval_id,
+        status: inner.status,
+        expires_at: inner.expires_at,
+    };
+}
+//# sourceMappingURL=AxonFlow.node.js.map

package/dist/nodes/AxonFlow/AxonFlow.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AxonFlow.node.js","sourceRoot":"","sources":["../../../nodes/AxonFlow/AxonFlow.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/AxonFlow/AxonFlow.node.json

@@ -0,0 +1,18 @@
+{
+	"node": "@axonflow/n8n-nodes-axonflow.axonFlow",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Development"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://docs.getaxonflow.com/docs/integration/n8n/"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://docs.getaxonflow.com/docs/integration/n8n/"
+			}
+		]
+	}
+}

package/dist/nodes/AxonFlow/axonflow.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="60" height="60" fill="none">
+  <rect width="64" height="64" rx="12" fill="#0F172A"/>
+  <path d="M16 44 L32 16 L48 44 Z" stroke="#22D3EE" stroke-width="3" stroke-linejoin="round" fill="none"/>
+  <circle cx="32" cy="36" r="3" fill="#22D3EE"/>
+</svg>

package/examples/README.md

@@ -0,0 +1,42 @@
+# Example workflows
+
+## `governed-loan-workflow.json`
+
+A complete HTTP-triggered loan-approval workflow that exercises all four AxonFlow operations.
+
+```
+Loan Request (Webhook)
+        │
+        ▼
+AxonFlow Check Policy ─── allowed=false ──▶ AxonFlow Wait for Approval
+        │                                           │
+        │ allowed=true                              ▼
+        │                                  Wait for Reviewer Webhook
+        │                                           │
+        ▼                                           ▼
+  Issue Loan (HTTP) ◀─────────────────────────────  ┘
+        │
+        ├──▶ AxonFlow Record Decision ──▶ Respond
+        └──▶ AxonFlow Audit Log (Error)
+```
+
+### Import
+
+In n8n: **Workflows → Import from File →** `governed-loan-workflow.json`.
+
+You will need:
+
+1. An **AxonFlow API** credential filled in (endpoint + Client ID + User Token).
+2. The `n8n-nodes-axonflow` community node installed (Settings → Community Nodes).
+3. The `Issue Loan (HTTP)` node pointed at a real downstream service (it defaults to `https://loan-service.internal/v1/loans` as a placeholder).
+
+### How HITL resume works in this workflow
+
+`AxonFlow Wait for Approval` creates the approval entry, then immediately returns the `approval_id`. The next node — a built-in n8n `Wait` configured for **On Webhook Call** mode — pauses the workflow.
+
+Two resume paths are supported on v8.0.x:
+
+1. **Polling sidecar** (recommended for unattended workflows). A small process polls `GET /api/v1/hitl/queue/{approval_id}` on a short interval. When the request status changes to `approved` or `rejected`, the sidecar POSTs the reviewer decision to the Wait node's webhook URL. Reference implementation is documented in the [n8n integration docs](https://docs.getaxonflow.com/docs/integration/n8n/#hitl).
+2. **Manual portal resume** (works without any sidecar). The reviewer copies the Wait node's webhook URL from the n8n workflow editor and POSTs to it from the AxonFlow portal's approval-detail screen after deciding.
+
+As of platform v8.1.0+, AxonFlow supports outbound webhooks via the `notify_url` field on `/api/v1/hitl/queue`. Pass the Wait node's webhook URL as `notify_url` and the platform will POST to it automatically on approval/rejection — the polling sidecar can be retired. The Wait-node side of the workflow is unchanged.

package/examples/governed-loan-workflow.json

@@ -0,0 +1,211 @@
+{
+  "name": "Governed Loan Approval (AxonFlow)",
+  "nodes": [
+    {
+      "parameters": {
+        "httpMethod": "POST",
+        "path": "loan-request",
+        "responseMode": "responseNode",
+        "options": {}
+      },
+      "id": "1",
+      "name": "Loan Request (Webhook)",
+      "type": "n8n-nodes-base.webhook",
+      "typeVersion": 2,
+      "position": [220, 300],
+      "webhookId": "loan-request-axonflow-demo"
+    },
+    {
+      "parameters": {
+        "operation": "checkPolicy",
+        "idempotencyKey": "={{ $execution.id }}-{{ $itemIndex }}-{{ $node.name }}",
+        "connectorType": "n8n",
+        "statement": "=approve_loan amount={{ $json.body.amount }} customer={{ $json.body.customer_id }}",
+        "mcpOperation": "execute",
+        "parameters": "={{ JSON.stringify({ amount: $json.body.amount, customer_id: $json.body.customer_id }) }}"
+      },
+      "id": "2",
+      "name": "AxonFlow Check Policy",
+      "type": "@axonflow/n8n-nodes-axonflow.axonFlow",
+      "typeVersion": 1,
+      "position": [460, 300],
+      "credentials": {
+        "axonFlowApi": {
+          "id": "axonflow-default",
+          "name": "AxonFlow API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "conditions": {
+          "options": { "caseSensitive": true, "leftValue": "", "typeValidation": "strict" },
+          "conditions": [
+            {
+              "leftValue": "={{ $json.allowed }}",
+              "rightValue": true,
+              "operator": { "type": "boolean", "operation": "equals" }
+            }
+          ],
+          "combinator": "and"
+        }
+      },
+      "id": "3",
+      "name": "Allowed?",
+      "type": "n8n-nodes-base.if",
+      "typeVersion": 2,
+      "position": [700, 300]
+    },
+    {
+      "parameters": {
+        "operation": "waitForApproval",
+        "idempotencyKey": "={{ $execution.id }}-{{ $itemIndex }}-{{ $node.name }}",
+        "requestType": "loan_approval",
+        "originalQuery": "=Approve loan for {{ $json.body.customer_id }} amount={{ $json.body.amount }}",
+        "triggeredPolicyId": "high-value-loan",
+        "triggeredPolicyName": "High Value Loan Approval",
+        "triggerReason": "=AxonFlow policy denied: {{ $('AxonFlow Check Policy').item.json.block_reason }}",
+        "severity": "high",
+        "limitWaitTime": 86400,
+        "requestContext": "={{ JSON.stringify($('Loan Request (Webhook)').item.json.body) }}"
+      },
+      "id": "4",
+      "name": "AxonFlow Wait for Approval",
+      "type": "@axonflow/n8n-nodes-axonflow.axonFlow",
+      "typeVersion": 1,
+      "position": [940, 460],
+      "credentials": {
+        "axonFlowApi": {
+          "id": "axonflow-default",
+          "name": "AxonFlow API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "resume": "webhook",
+        "options": {}
+      },
+      "id": "5",
+      "name": "Wait for Reviewer Webhook",
+      "type": "n8n-nodes-base.wait",
+      "typeVersion": 1.1,
+      "position": [1180, 460],
+      "webhookId": "axonflow-approval-resume"
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "=https://loan-service.internal/v1/loans",
+        "sendBody": true,
+        "specifyBody": "json",
+        "jsonBody": "={{ JSON.stringify($('Loan Request (Webhook)').item.json.body) }}",
+        "options": {}
+      },
+      "id": "6",
+      "name": "Issue Loan (HTTP)",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [1420, 300],
+      "onError": "continueErrorOutput"
+    },
+    {
+      "parameters": {
+        "operation": "recordDecision",
+        "idempotencyKey": "={{ $execution.id }}-{{ $itemIndex }}-{{ $node.name }}",
+        "toolName": "issue_loan",
+        "workflowId": "={{ $workflow.id }}",
+        "stepId": "={{ $node.name }}",
+        "auditInput": "={{ JSON.stringify($('Loan Request (Webhook)').item.json.body) }}",
+        "auditOutput": "={{ JSON.stringify($json) }}",
+        "auditSuccess": true,
+        "auditErrorMessage": ""
+      },
+      "id": "7",
+      "name": "AxonFlow Record Decision",
+      "type": "@axonflow/n8n-nodes-axonflow.axonFlow",
+      "typeVersion": 1,
+      "position": [1660, 300],
+      "credentials": {
+        "axonFlowApi": {
+          "id": "axonflow-default",
+          "name": "AxonFlow API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "operation": "auditLog",
+        "idempotencyKey": "={{ $execution.id }}-{{ $itemIndex }}-{{ $node.name }}",
+        "toolName": "issue_loan",
+        "workflowId": "={{ $workflow.id }}",
+        "stepId": "issue-loan-error",
+        "auditInput": "={{ JSON.stringify($('Loan Request (Webhook)').item.json.body) }}",
+        "auditOutput": "={{ JSON.stringify($json) }}",
+        "auditSuccess": false,
+        "auditErrorMessage": "=Loan issuance failed: {{ $json.error || 'unknown' }}"
+      },
+      "id": "8",
+      "name": "AxonFlow Audit Log (Error)",
+      "type": "@axonflow/n8n-nodes-axonflow.axonFlow",
+      "typeVersion": 1,
+      "position": [1660, 600],
+      "credentials": {
+        "axonFlowApi": {
+          "id": "axonflow-default",
+          "name": "AxonFlow API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "respondWith": "json",
+        "responseBody": "={{ JSON.stringify({ status: 'recorded', decision: $('AxonFlow Record Decision').item.json }) }}",
+        "options": {}
+      },
+      "id": "9",
+      "name": "Respond",
+      "type": "n8n-nodes-base.respondToWebhook",
+      "typeVersion": 1.1,
+      "position": [1900, 300]
+    }
+  ],
+  "connections": {
+    "Loan Request (Webhook)": {
+      "main": [[{ "node": "AxonFlow Check Policy", "type": "main", "index": 0 }]]
+    },
+    "AxonFlow Check Policy": {
+      "main": [[{ "node": "Allowed?", "type": "main", "index": 0 }]]
+    },
+    "Allowed?": {
+      "main": [
+        [{ "node": "Issue Loan (HTTP)", "type": "main", "index": 0 }],
+        [{ "node": "AxonFlow Wait for Approval", "type": "main", "index": 0 }]
+      ]
+    },
+    "AxonFlow Wait for Approval": {
+      "main": [[{ "node": "Wait for Reviewer Webhook", "type": "main", "index": 0 }]]
+    },
+    "Wait for Reviewer Webhook": {
+      "main": [[{ "node": "Issue Loan (HTTP)", "type": "main", "index": 0 }]]
+    },
+    "Issue Loan (HTTP)": {
+      "main": [
+        [{ "node": "AxonFlow Record Decision", "type": "main", "index": 0 }],
+        [{ "node": "AxonFlow Audit Log (Error)", "type": "main", "index": 0 }]
+      ]
+    },
+    "AxonFlow Record Decision": {
+      "main": [[{ "node": "Respond", "type": "main", "index": 0 }]]
+    }
+  },
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "tags": [
+    { "name": "axonflow-demo" }
+  ],
+  "meta": {
+    "templateCredsSetupCompleted": false
+  }
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@axonflow/n8n-nodes-axonflow",
+  "version": "1.0.0",
+  "description": "AxonFlow API integration for n8n — call AxonFlow policy and HITL endpoints from your workflows.",
+  "keywords": [
+    "n8n-community-node-package",
+    "axonflow",
+    "policy",
+    "hitl"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/getaxonflow/axonflow-n8n-node",
+  "author": {
+    "name": "AxonFlow",
+    "email": "hello@getaxonflow.com",
+    "url": "https://getaxonflow.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getaxonflow/axonflow-n8n-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/getaxonflow/axonflow-n8n-node/issues"
+  },
+  "engines": {
+    "node": ">=18.10"
+  },
+  "scripts": {
+    "build": "tsc && node ./scripts/copy-assets.js",
+    "lint": "eslint nodes credentials package.json",
+    "test": "node --test --import tsx test/AxonFlow.node.test.ts test/AxonFlowApi.credentials.test.ts",
+    "format": "prettier nodes credentials --write",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "examples"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/AxonFlowApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/AxonFlow/AxonFlow.node.js"
+    ]
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.15.0",
+    "@typescript-eslint/parser": "^7.15.0",
+    "eslint": "^8.57.0",
+    "eslint-plugin-n8n-nodes-base": "^1.16.3",
+    "n8n-workflow": "^1.82.0",
+    "prettier": "^3.3.3",
+    "tsx": "^4.16.0",
+    "typescript": "^5.4.0"
+  }
+}