n8n-nodes-orboto 1.0.1

package/dist/nodes/orboto/orbotoTrigger.node.js

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orbotoTrigger = exports.ORBOTO_WEBHOOK_EVENTS = void 0;
+exports.signatureMatches = signatureMatches;
+const node_crypto_1 = require("node:crypto");
+const n8n_workflow_1 = require("n8n-workflow");
+const GenericFunctions_1 = require("./shared/GenericFunctions");
+/** The orboto webhook event catalog (16 events), versioned with this package. */
+exports.ORBOTO_WEBHOOK_EVENTS = [
+    'ticket.created',
+    'ticket.updated',
+    'ticket.deleted',
+    'ticket.ready',
+    'ticket.checklist_item.completed',
+    'comment.created',
+    'comment.updated',
+    'comment.deleted',
+    'project.member_added',
+    'project.member_removed',
+    'milestone.created',
+    'milestone.updated',
+    'version.released',
+    'symphony.candidates_changed',
+    'inbound.signal.received',
+    'agent.escalation_raised',
+];
+function selectedEvents(context) {
+    const chosen = context.getNodeParameter('events', 0, []) ?? [];
+    const extra = String(context.getNodeParameter('additionalEvents', 0, '') ?? '');
+    const extras = extra
+        .split(',')
+        .map((e) => e.trim())
+        .filter(Boolean);
+    return [...new Set([...chosen, ...extras])];
+}
+/** Constant-time hex comparison; length-mismatched input is rejected outright. */
+function signatureMatches(received, expectedHex) {
+    if (!received)
+        return false;
+    const match = /^sha256=([0-9a-fA-F]{64})$/.exec(received.trim());
+    if (!match)
+        return false;
+    const receivedBuf = Buffer.from(match[1].toLowerCase(), 'utf8');
+    const expectedBuf = Buffer.from(expectedHex.toLowerCase(), 'utf8');
+    return receivedBuf.length === expectedBuf.length && (0, node_crypto_1.timingSafeEqual)(receivedBuf, expectedBuf);
+}
+class orbotoTrigger {
+    description = {
+        displayName: 'orboto Trigger',
+        name: 'orbotoTrigger',
+        icon: 'file:orbotoTrigger.svg',
+        group: ['trigger'],
+        version: 1,
+        subtitle: '={{$parameter["events"].join(", ")}}',
+        description: 'Starts a workflow when events happen in orboto (ticket created/updated/deleted/ready, comments, milestones, agent escalations and more). Deliveries are HMAC-verified.',
+        defaults: {
+            name: 'orboto Trigger',
+        },
+        inputs: [],
+        outputs: ['main'],
+        credentials: [
+            {
+                name: 'orbotoApi',
+                required: true,
+                displayOptions: {
+                    show: {
+                        authType: ['apiKey'],
+                    },
+                },
+            },
+            {
+                name: 'orbotoOAuth2Api',
+                required: true,
+                displayOptions: {
+                    show: {
+                        authType: ['oauth'],
+                    },
+                },
+            },
+        ],
+        webhooks: [
+            {
+                name: 'default',
+                httpMethod: 'POST',
+                path: 'webhook',
+                responseMode: 'onReceived',
+            },
+        ],
+        properties: [
+            {
+                displayName: 'Authentication',
+                name: 'authType',
+                type: 'options',
+                noDataExpression: true,
+                options: [
+                    {
+                        name: 'API Key',
+                        value: 'apiKey',
+                    },
+                    {
+                        name: 'OAuth2',
+                        value: 'oauth',
+                    },
+                ],
+                default: 'apiKey',
+                description: 'Which orboto credential style this node uses',
+            },
+            {
+                displayName: 'Project Name or ID',
+                name: 'project',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getProjects',
+                },
+                required: true,
+                default: '',
+                description: 'The orboto project whose events to listen to (webhooks are project-scoped). Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+            },
+            {
+                displayName: 'Events',
+                name: 'events',
+                type: 'multiOptions',
+                required: true,
+                options: exports.ORBOTO_WEBHOOK_EVENTS.map((value) => ({ name: value, value })),
+                default: ['ticket.created'],
+                description: 'The events that fire this trigger',
+            },
+            {
+                displayName: 'Additional Events',
+                name: 'additionalEvents',
+                type: 'string',
+                default: '',
+                placeholder: 'some.future.event, another.event',
+                description: 'Comma-separated event types beyond the catalog above, for orboto versions newer than this package',
+            },
+        ],
+    };
+    webhookMethods = {
+        default: {
+            /** n8n calls this on activation: is a matching webhook already registered? */
+            async checkExists() {
+                const webhookData = this.getWorkflowStaticData('node');
+                const webhookUrl = this.getNodeWebhookUrl('default');
+                const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+                const projectId = String(this.getNodeParameter('project', 0));
+                const registered = (await client.request(`/projects/${encodeURIComponent(projectId)}/webhooks`));
+                const list = Array.isArray(registered) ? registered : [];
+                const match = list.find((w) => w.url === webhookUrl);
+                if (!match)
+                    return false;
+                // A matching registration is only reusable when we still hold its
+                // secret (it is returned once, at creation). Otherwise delete the
+                // orphan so create() can register a fresh one with a new secret.
+                const wanted = selectedEvents(this);
+                const eventsMatch = Array.isArray(match.events) &&
+                    match.events.length === wanted.length &&
+                    wanted.every((e) => match.events.includes(e));
+                if (webhookData.webhookId === match.id && webhookData.secret && eventsMatch) {
+                    return true;
+                }
+                await client.request(`/webhooks/${match.id}`, { method: 'DELETE' });
+                delete webhookData.webhookId;
+                delete webhookData.secret;
+                return false;
+            },
+            /** n8n calls this on activation when checkExists returned false. */
+            async create() {
+                const webhookData = this.getWorkflowStaticData('node');
+                const webhookUrl = this.getNodeWebhookUrl('default');
+                if (!webhookUrl) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'No webhook URL available - set the WEBHOOK_URL environment variable in n8n');
+                }
+                const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+                const projectId = String(this.getNodeParameter('project', 0));
+                const events = selectedEvents(this);
+                if (events.length === 0) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Select at least one event for the trigger');
+                }
+                const created = await client.request(`/projects/${encodeURIComponent(projectId)}/webhooks`, {
+                    method: 'POST',
+                    body: {
+                        // The default (orboto-shaped) payload format is the only one
+                        // that is HMAC-signed - vendor shapes skip the signature.
+                        payloadFormat: 'generic',
+                        name: `n8n workflow ${this.getWorkflow().id} - ${this.getNode().name}`.slice(0, 100),
+                        url: webhookUrl,
+                        events,
+                    },
+                });
+                webhookData.webhookId = created.id;
+                webhookData.secret = created.secret;
+                return true;
+            },
+            /** n8n calls this on deactivation. */
+            async delete() {
+                const webhookData = this.getWorkflowStaticData('node');
+                const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+                if (webhookData.webhookId) {
+                    await client.request(`/webhooks/${webhookData.webhookId}`, { method: 'DELETE' });
+                }
+                delete webhookData.webhookId;
+                delete webhookData.secret;
+                return true;
+            },
+        },
+    };
+    async webhook() {
+        const bodyData = this.getBodyData();
+        const req = this.getRequestObject();
+        const headerData = this.getHeaderData();
+        const webhookData = this.getWorkflowStaticData('node');
+        const secret = webhookData.secret;
+        if (!secret) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'The stored webhook secret is missing', {
+                description: 'Deactivate and re-activate the workflow so n8n can re-register the webhook with orboto.',
+            });
+        }
+        const received = headerData['x-orboto-signature'];
+        const raw = req.rawBody;
+        if (!raw || !signatureMatches(received, (0, node_crypto_1.createHmac)('sha256', secret).update(raw).digest('hex'))) {
+            throw new n8n_workflow_1.NodeApiError(this.getNode(), new Error('Invalid webhook signature'), {
+                description: 'Delivery rejected: the X-Orboto-Signature header does not match the body (missing, forged, or wrong secret).',
+                httpCode: '401',
+            });
+        }
+        const event = String(headerData['x-orboto-event'] ?? '');
+        const subscribed = selectedEvents(this);
+        if (event && !subscribed.includes(event)) {
+            // orboto should only deliver subscribed events; ignore anything else.
+            return {};
+        }
+        const payload = bodyData && typeof bodyData === 'object' && Object.keys(bodyData).length > 0
+            ? { ...bodyData }
+            : { raw: raw.toString('utf8') };
+        if (event && payload.event === undefined)
+            payload.event = event;
+        return {
+            workflowData: [[{ json: payload }]],
+        };
+    }
+}
+exports.orbotoTrigger = orbotoTrigger;
+//# sourceMappingURL=orbotoTrigger.node.js.map

package/dist/nodes/orboto/orbotoTrigger.node.js.map

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

package/dist/nodes/orboto/orbotoTrigger.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24">
+  <circle cx="12" cy="12" r="10" fill="#4f46e5"/>
+  <circle cx="12" cy="12" r="4.5" fill="#ffffff"/>
+</svg>

package/dist/nodes/orboto/resources/agent/agent.resource.d.ts

@@ -0,0 +1,7 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeProperties } from 'n8n-workflow';
+/**
+ * Agent resource - the n8n-to-AI-agent bridge (added in the 2026-08-29 design
+ * review): notify an agent identity, fetch its inbox, acknowledge messages.
+ */
+export declare const agentOperations: INodeProperties[];
+export declare function executeAgentOperation(context: IExecuteFunctions, itemIndex: number): Promise<INodeExecutionData[]>;

package/dist/nodes/orboto/resources/agent/agent.resource.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentOperations = void 0;
+exports.executeAgentOperation = executeAgentOperation;
+const GenericFunctions_1 = require("../../shared/GenericFunctions");
+/**
+ * Agent resource - the n8n-to-AI-agent bridge (added in the 2026-08-29 design
+ * review): notify an agent identity, fetch its inbox, acknowledge messages.
+ */
+exports.agentOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: { show: { resource: ['agent'] } },
+        required: true,
+        default: 'notify',
+        options: [
+            { name: 'Ack Messages', value: 'ack' },
+            { name: 'Get Messages', value: 'getMessages' },
+            { name: 'Notify', value: 'notify' },
+        ].sort((a, b) => a.value.localeCompare(b.value)),
+    },
+    {
+        displayName: 'Target Email',
+        name: 'targetEmail',
+        type: 'string',
+        required: true,
+        displayOptions: { show: { resource: ['agent'], operation: ['notify'] } },
+        default: '',
+        placeholder: 'agent@orboto.io',
+        description: 'Email of the agent identity to notify',
+    },
+    {
+        displayName: 'Subject',
+        name: 'subject',
+        type: 'string',
+        required: true,
+        displayOptions: { show: { resource: ['agent'], operation: ['notify'] } },
+        default: '',
+        description: 'Subject line (max 200 characters)',
+    },
+    {
+        displayName: 'Kind',
+        name: 'kind',
+        type: 'options',
+        options: [
+            { name: 'Info', value: 'info' },
+            { name: 'Request', value: 'request' },
+            { name: 'Complete', value: 'complete' },
+            { name: 'Error', value: 'error' },
+        ],
+        displayOptions: { show: { resource: ['agent'], operation: ['notify'] } },
+        default: 'info',
+        description: 'Info is FYI, request expects an answer, complete closes a request, error reports failure',
+    },
+    {
+        displayName: 'Payload (JSON)',
+        name: 'payloadJson',
+        type: 'json',
+        displayOptions: { show: { resource: ['agent'], operation: ['notify'] } },
+        default: '',
+        description: 'Structured payload for the agent to read',
+    },
+    {
+        displayName: 'Thread ID',
+        name: 'threadId',
+        type: 'string',
+        displayOptions: { show: { resource: ['agent'], operation: ['notify'] } },
+        default: '',
+        description: 'Thread ID to chain a conversation',
+    },
+    {
+        displayName: 'Project Scope',
+        name: 'project',
+        type: 'string',
+        displayOptions: { show: { resource: ['agent'], operation: ['notify', 'getMessages'] } },
+        default: '',
+        placeholder: 'ONN',
+        description: 'Project key so the message routes to the right session',
+    },
+    {
+        displayName: 'Sender Reference',
+        name: 'senderRef',
+        type: 'string',
+        displayOptions: { show: { resource: ['agent'], operation: ['notify'] } },
+        default: '',
+        description: 'Stable reference of the sender (e.g. the workflow name)',
+    },
+    {
+        displayName: 'Include Already-Delivered',
+        name: 'all',
+        type: 'boolean',
+        displayOptions: { show: { resource: ['agent'], operation: ['getMessages'] } },
+        default: false,
+        description: 'Whether to include messages the agent already received',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        typeOptions: { numberPrecision: 0 },
+        displayOptions: { show: { resource: ['agent'], operation: ['getMessages'] } },
+        default: 50,
+        description: 'Max number of results to return',
+    },
+    {
+        displayName: 'Exclude Reference',
+        name: 'excludeRef',
+        type: 'string',
+        displayOptions: { show: { resource: ['agent'], operation: ['getMessages'] } },
+        default: '',
+        description: 'Skip messages sent from this sender reference',
+    },
+    {
+        displayName: 'Message IDs',
+        name: 'ids',
+        type: 'string',
+        required: true,
+        displayOptions: { show: { resource: ['agent'], operation: ['ack'] } },
+        default: '',
+        description: 'Comma-separated message IDs to acknowledge',
+    },
+];
+async function executeAgentOperation(context, itemIndex) {
+    const operation = context.getNodeParameter('operation', itemIndex);
+    try {
+        const client = await (0, GenericFunctions_1.getClient)(context);
+        switch (operation) {
+            case 'notify': {
+                const body = {
+                    targetEmail: context.getNodeParameter('targetEmail', itemIndex),
+                    subject: context.getNodeParameter('subject', itemIndex),
+                    kind: context.getNodeParameter('kind', itemIndex, 'info'),
+                };
+                const payloadJson = context.getNodeParameter('payloadJson', itemIndex, '');
+                if (payloadJson !== '' && payloadJson !== undefined && payloadJson !== null) {
+                    body.payload = typeof payloadJson === 'string' ? JSON.parse(payloadJson) : payloadJson;
+                }
+                const threadId = context.getNodeParameter('threadId', itemIndex, '');
+                if (threadId !== '')
+                    body.threadId = threadId;
+                const project = context.getNodeParameter('project', itemIndex, '');
+                if (project !== '')
+                    body.project = project;
+                const senderRef = context.getNodeParameter('senderRef', itemIndex, '');
+                if (senderRef !== '')
+                    body.senderRef = senderRef;
+                const sent = await client.request('/v1/agent/notify', { method: 'POST', body });
+                return [(0, GenericFunctions_1.jsonOutput)(sent)];
+            }
+            case 'getMessages': {
+                const messages = await client.request('/v1/agent/messages', {
+                    query: {
+                        all: context.getNodeParameter('all', itemIndex, false) || undefined,
+                        limit: context.getNodeParameter('limit', itemIndex, 20),
+                        project: context.getNodeParameter('project', itemIndex, '') || undefined,
+                        excludeRef: context.getNodeParameter('excludeRef', itemIndex, '') || undefined,
+                    },
+                });
+                return [(0, GenericFunctions_1.jsonOutput)(messages)];
+            }
+            case 'ack': {
+                const ids = String(context.getNodeParameter('ids', itemIndex) ?? '')
+                    .split(',')
+                    .map((id) => id.trim())
+                    .filter(Boolean);
+                const result = await client.request('/v1/agent/messages/ack', {
+                    method: 'POST',
+                    body: { ids },
+                });
+                return [(0, GenericFunctions_1.jsonOutput)(result)];
+            }
+            default:
+                throw new Error(`Unknown agent operation: ${operation}`);
+        }
+    }
+    catch (error) {
+        throw (0, GenericFunctions_1.toNodeError)(context.getNode(), error, itemIndex);
+    }
+}
+//# sourceMappingURL=agent.resource.js.map

package/dist/nodes/orboto/resources/agent/agent.resource.js.map

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

package/dist/nodes/orboto/resources/doc/doc.resource.d.ts

@@ -0,0 +1,3 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeProperties } from 'n8n-workflow';
+export declare const docOperations: INodeProperties[];
+export declare function executeDocOperation(context: IExecuteFunctions, itemIndex: number): Promise<INodeExecutionData[]>;