@websitelabs/n8n-nodes-software-teams 0.12.3

package/dist/nodes/SoftwareTeamsHitl/SoftwareTeamsHitl.node.js

@@ -0,0 +1,366 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftwareTeamsHitl = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const n8n_cast_1 = require("../../src/n8n-cast");
+const SINGLE_TURN_MODULE = '../../src/execution/single-turn';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { runAgentTurn } = require(SINGLE_TURN_MODULE);
+// Conversation-state store (T2) — reuses correlationId-keyed JSON file.
+const CONV_STATE_MODULE = '../../src/hitl/conversation-state';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const convState = require(CONV_STATE_MODULE);
+// Channel adapters (T8)
+const CHANNELS_MODULE = '../../src/hitl/channels';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const channelsModule = require(CHANNELS_MODULE);
+/**
+ * Generic, channel-agnostic HITL node (T8 — AC3, AC4).
+ *
+ * Supports Slack, Email, n8n-notification, AND Discord. Multi-round: on
+ * resume, if the agent still needs input, re-parks with an incremented
+ * round instead of deleting state. State is only deleted once the agent
+ * returns ok/error.
+ *
+ * ASK MODE (status: 'needs-input'): posts the question via the selected
+ * channel adapter, saves state with channel + round + delivery ref, then
+ * putExecutionToWait.
+ *
+ * RESUME MODE (hitlAnswer + correlationId): loads state, acks via the
+ * channel adapter, merges answer into context, runs runAgentTurn. If the
+ * agent returns needs-input again, re-saves state with incremented round
+ * and re-waits (genuine multi-round). Only deletes state on ok/error.
+ *
+ * PASS-THROUGH: status 'ok' or 'error' passes unchanged.
+ */
+class SoftwareTeamsHitl {
+    constructor() {
+        this.description = {
+            displayName: 'Software Teams HITL',
+            name: 'softwareTeamsHitl',
+            icon: 'file:softwareTeamsHitl.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Channel-agnostic human-in-the-loop node (AC3/AC4). ' +
+                'Supports Slack, Email, n8n-notification, and Discord with genuine ' +
+                'multi-round back-and-forth. When an upstream agent returns needs-input, ' +
+                'posts the question via the selected channel, pauses the workflow, and ' +
+                'resumes the same agent with the human\'s reply. Re-parks for additional ' +
+                'rounds until the agent returns ok or error.',
+            subtitle: '={{ $parameter["channel"] }} / {{ $parameter["destination"] }}',
+            defaults: { name: 'Software Teams HITL' },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [{ name: 'softwareTeamsApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Channel',
+                    name: 'channel',
+                    type: 'options',
+                    options: [
+                        { name: 'Auto (Envelope Hint)', value: 'auto' },
+                        { name: 'Discord', value: 'discord' },
+                        { name: 'Email', value: 'email' },
+                        { name: 'N8n Notification', value: 'notify' },
+                        { name: 'Slack', value: 'slack' },
+                    ],
+                    default: 'auto',
+                    description: 'Which channel to use for delivering questions to the human. ' +
+                        '"Auto" reads the optional hitlChannel hint from the upstream envelope ' +
+                        '(defaults to discord if no hint is present). The node\'s explicit selection ' +
+                        'always wins over the envelope hint.',
+                },
+                {
+                    displayName: 'Destination',
+                    name: 'destination',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Channel-specific destination: Slack channel ID (e.g. C0123456), ' +
+                        'Discord channel ID (e.g. 1234567890), email address, or n8n notification ' +
+                        'target identifier.',
+                },
+                {
+                    displayName: 'Wait Timeout (Hours)',
+                    name: 'waitTimeoutHours',
+                    type: 'number',
+                    default: 24,
+                    description: 'Maximum hours to wait for a human reply before execution times out. ' +
+                        'Set WEBHOOK_URL env var to the n8n public FQDN so the resume URL is ' +
+                        'reachable from the channel\'s servers.',
+                },
+            ],
+            usableAsTool: true,
+        };
+    }
+    async execute() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        const items = this.getInputData();
+        const returnData = [];
+        // Credentials (R-02: NEVER written to output)
+        const credentials = await this.getCredentials('softwareTeamsApi');
+        const slackToken = credentials['slackBotToken'];
+        const discordToken = credentials['discordBotToken'];
+        const smtpUrl = credentials['smtpUrl'];
+        const channelParam = this.getNodeParameter('channel', 0, 'auto');
+        const destination = this.getNodeParameter('destination', 0, '');
+        const waitTimeoutHours = this.getNodeParameter('waitTimeoutHours', 0, 24);
+        const itemCount = items.length > 0 ? items.length : 1;
+        for (const [i] of Array.from({ length: itemCount }).entries()) {
+            try {
+                const data = ((_b = (_a = items[i]) === null || _a === void 0 ? void 0 : _a.json) !== null && _b !== void 0 ? _b : {});
+                // ── RESUME MODE ──────────────────────────────────────────────────
+                if (typeof data['hitlAnswer'] === 'string' &&
+                    typeof data['correlationId'] === 'string') {
+                    const hitlAnswer = data['hitlAnswer'];
+                    const correlationId = data['correlationId'];
+                    const state = convState.loadState(correlationId);
+                    if (!state) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `HITL resume: no conversation state found for correlationId "${correlationId}". ` +
+                            'Ensure the HITL state file (HITL_STATE_PATH) is on persistent storage ' +
+                            'shared between the ask and resume execution contexts.', { itemIndex: i });
+                    }
+                    // Non-fatal channel acknowledgement
+                    const resolvedChannel = (_c = state.channel) !== null && _c !== void 0 ? _c : 'slack';
+                    const ackToken = resolveToken(resolvedChannel, { slackToken, discordToken, smtpUrl });
+                    if (ackToken && state.delivery) {
+                        try {
+                            const adapter = channelsModule.getChannel(resolvedChannel);
+                            await adapter.postAck({
+                                answer: hitlAnswer,
+                                correlationId,
+                                token: ackToken,
+                                delivery: state.delivery,
+                            });
+                        }
+                        catch {
+                            // ack failure must not block agent resume
+                        }
+                    }
+                    // Merge the human's answer into context
+                    const originalContext = state.originalEnvelope.input.context;
+                    const mergedContext = {
+                        ...(typeof originalContext === 'object' &&
+                            originalContext !== null &&
+                            !Array.isArray(originalContext)
+                            ? originalContext
+                            : { originalContext }),
+                        hitl: {
+                            question: state.question,
+                            answer: hitlAnswer,
+                            round: (_d = state.round) !== null && _d !== void 0 ? _d : 1,
+                        },
+                    };
+                    const resumeEnvelope = {
+                        ...state.originalEnvelope,
+                        status: 'ok',
+                        input: {
+                            prompt: state.originalEnvelope.input.prompt,
+                            context: mergedContext,
+                        },
+                        result: { text: '' },
+                    };
+                    const agentResult = await runAgentTurn(resumeEnvelope).catch((err) => {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `HITL resume: runAgentTurn failed: ${err instanceof Error ? err.message : String(err)}`, { itemIndex: i });
+                    });
+                    // ── MULTI-ROUND RE-PARK (AC3 / R-07) ──────────────────────────
+                    // If the agent still needs input, re-save state with incremented
+                    // round and re-wait instead of deleting state.
+                    if (agentResult.status === 'needs-input') {
+                        const nextRound = convState.nextRound(state);
+                        const newQuestion = agentResult.result.text;
+                        // Post the new question via the same channel
+                        const questionToken = resolveToken(resolvedChannel, { slackToken, discordToken, smtpUrl });
+                        if (!questionToken && resolvedChannel !== 'notify') {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `HITL multi-round: no token available for channel "${resolvedChannel}". ` +
+                                'Ensure the appropriate credential field is set on SoftwareTeamsApi.', { itemIndex: i });
+                        }
+                        const resumeUrl = this.getSignedResumeUrl();
+                        const adapter = channelsModule.getChannel(resolvedChannel);
+                        const { deliveryRef } = await adapter.postQuestion({
+                            question: newQuestion,
+                            correlationId,
+                            resumeUrl,
+                            token: questionToken !== null && questionToken !== void 0 ? questionToken : '',
+                            destination: resolveDestination(resolvedChannel, destination, state.delivery),
+                        }).catch((err) => {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `HITL multi-round: failed to post follow-up question via ${resolvedChannel}: ${err instanceof Error ? err.message : String(err)}`, { itemIndex: i });
+                        });
+                        // Re-save state with incremented round
+                        convState.saveState({
+                            correlationId,
+                            originalEnvelope: agentResult,
+                            slackChannel: (_f = (_e = deliveryRef['slackChannel']) !== null && _e !== void 0 ? _e : state.slackChannel) !== null && _f !== void 0 ? _f : '',
+                            slackThreadTs: (_h = (_g = deliveryRef['slackThreadTs']) !== null && _g !== void 0 ? _g : state.slackThreadTs) !== null && _h !== void 0 ? _h : '',
+                            resumeUrl,
+                            question: newQuestion,
+                            createdAt: Date.now(),
+                            channel: resolvedChannel,
+                            round: nextRound,
+                            delivery: deliveryRef,
+                        });
+                        const waitTill = new Date(Date.now() + waitTimeoutHours * 60 * 60 * 1000);
+                        await this.putExecutionToWait(waitTill);
+                        returnData.push({
+                            json: (0, n8n_cast_1.toDataObject)({
+                                ...agentResult,
+                                hitl: {
+                                    question: newQuestion,
+                                    channel: resolvedChannel,
+                                    round: nextRound,
+                                    delivery: deliveryRef,
+                                    resumeUrl,
+                                },
+                            }),
+                            pairedItem: { item: i },
+                        });
+                        continue;
+                    }
+                    // Agent returned ok/error — clear state (end of conversation).
+                    try {
+                        convState.deleteState(correlationId);
+                    }
+                    catch {
+                        // stale state is benign
+                    }
+                    returnData.push({
+                        json: (0, n8n_cast_1.toDataObject)(agentResult),
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                // ── ASK MODE ─────────────────────────────────────────────────────
+                const envelope = (0, n8n_cast_1.fromDataObject)(items[i].json);
+                if (envelope.status !== 'needs-input') {
+                    returnData.push({
+                        json: (0, n8n_cast_1.toDataObject)(data),
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                const question = envelope.result.text;
+                const correlationId = envelope.correlationId;
+                // Resolve the channel: explicit param wins, then envelope hint, then discord default.
+                const resolvedChannel = resolveChannelName(channelParam, envelope);
+                const token = resolveToken(resolvedChannel, { slackToken, discordToken, smtpUrl });
+                if (!token && resolvedChannel !== 'notify') {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `No credential token found for channel "${resolvedChannel}". ` +
+                        resolveTokenHint(resolvedChannel), { itemIndex: i });
+                }
+                const resumeUrl = this.getSignedResumeUrl();
+                const adapter = channelsModule.getChannel(resolvedChannel);
+                const { deliveryRef } = await adapter.postQuestion({
+                    question,
+                    correlationId,
+                    resumeUrl,
+                    token: token !== null && token !== void 0 ? token : '',
+                    destination,
+                }).catch((err) => {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Failed to post agent question via ${resolvedChannel}: ${err instanceof Error ? err.message : String(err)}`, { itemIndex: i });
+                });
+                convState.saveState({
+                    correlationId,
+                    originalEnvelope: envelope,
+                    slackChannel: (_j = deliveryRef['slackChannel']) !== null && _j !== void 0 ? _j : '',
+                    slackThreadTs: (_k = deliveryRef['slackThreadTs']) !== null && _k !== void 0 ? _k : '',
+                    resumeUrl,
+                    question,
+                    createdAt: Date.now(),
+                    channel: resolvedChannel,
+                    round: 1,
+                    delivery: deliveryRef,
+                });
+                const waitTill = new Date(Date.now() + waitTimeoutHours * 60 * 60 * 1000);
+                await this.putExecutionToWait(waitTill);
+                returnData.push({
+                    json: (0, n8n_cast_1.toDataObject)({
+                        ...envelope,
+                        hitl: {
+                            question,
+                            channel: resolvedChannel,
+                            round: 1,
+                            delivery: deliveryRef,
+                            resumeUrl,
+                        },
+                    }),
+                    pairedItem: { item: i },
+                });
+            }
+            catch (err) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: err instanceof Error ? err.message : String(err) },
+                        pairedItem: { item: i },
+                    });
+                }
+                else {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), err instanceof Error ? err.message : String(err));
+                }
+            }
+        }
+        return [returnData];
+    }
+}
+exports.SoftwareTeamsHitl = SoftwareTeamsHitl;
+// ── Helpers ────────────────────────────────────────────────────────────────
+/** Resolve the effective channel name from param + envelope hint. */
+function resolveChannelName(param, envelope) {
+    if (param !== 'auto')
+        return param;
+    // Check the envelope's optional hitlChannel hint (T3)
+    const hint = envelope['hitlChannel'];
+    if (hint === 'slack' || hint === 'email' || hint === 'notify' || hint === 'discord') {
+        return hint;
+    }
+    // Default to discord for the first live test
+    return 'discord';
+}
+/** Return the credential token for a given channel. */
+function resolveToken(channel, tokens) {
+    switch (channel) {
+        case 'slack':
+            return tokens.slackToken || undefined;
+        case 'discord':
+            return tokens.discordToken || undefined;
+        case 'email':
+            return tokens.smtpUrl || undefined;
+        case 'notify':
+            return undefined; // notify needs no token
+    }
+}
+/** Return a user-friendly hint about which credential field to set. */
+function resolveTokenHint(channel) {
+    switch (channel) {
+        case 'slack':
+            return 'Add a Slack Bot OAuth token (xoxb-...) to the SoftwareTeamsApi credential under "Slack Bot Token".';
+        case 'discord':
+            return 'Add a Discord Bot Token to the SoftwareTeamsApi credential under "Discord Bot Token".';
+        case 'email':
+            return 'Add an SMTP URL (smtp://user:pass@host:port) to the SoftwareTeamsApi credential under "SMTP URL".';
+        case 'notify':
+            return ''; // should never reach here
+    }
+}
+/**
+ * Resolve the destination for a multi-round follow-up question.
+ * On re-park we may need the destination from the original delivery ref
+ * (e.g. the Discord channel ID) if it differs from the node param.
+ */
+function resolveDestination(channel, nodeDestination, delivery) {
+    var _a, _b, _c, _d;
+    if (nodeDestination)
+        return nodeDestination;
+    if (!delivery)
+        return '';
+    switch (channel) {
+        case 'slack':
+            return (_a = delivery['slackChannel']) !== null && _a !== void 0 ? _a : '';
+        case 'discord':
+            return (_b = delivery['discordChannelId']) !== null && _b !== void 0 ? _b : '';
+        case 'email':
+            return (_c = delivery['emailTo']) !== null && _c !== void 0 ? _c : '';
+        case 'notify':
+            return (_d = delivery['destination']) !== null && _d !== void 0 ? _d : '';
+    }
+}
+//# sourceMappingURL=SoftwareTeamsHitl.node.js.map

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

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

package/dist/nodes/SoftwareTeamsHitl/softwareTeamsHitl.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
+  <!-- Background rounded rectangle — multi-channel teal tone -->
+  <rect width="60" height="60" rx="10" ry="10" fill="#0D7377"/>
+  <!-- Speech bubble body -->
+  <rect x="8" y="10" width="38" height="26" rx="6" ry="6" fill="none" stroke="white" stroke-width="2.5"/>
+  <!-- Speech bubble tail -->
+  <path d="M14 36 L10 46 L22 38" fill="none" stroke="white" stroke-width="2.5" stroke-linejoin="round"/>
+  <!-- Circular arrow inside bubble — represents multi-round -->
+  <path d="M22 20 A7 7 0 1 1 22 28" fill="none" stroke="#F0C040" stroke-width="2.5" stroke-linecap="round"/>
+  <polyline points="22,17 22,21 26,20" fill="none" stroke="#F0C040" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

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

@@ -0,0 +1,15 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+/**
+ * SoftwareTeamsOrchestrator node (AC4, R-04, R-05).
+ *
+ * Accepts an epic / sprint goal, runs ONE single-turn planning pass through the
+ * T3 adapter as `software-teams-planner`, and emits one output item per
+ * wave-task as a NodeEnvelope, ordered by wave then dependency.
+ * ARCHITECTURE.md §"Decision C — Canvas handoff" is the authority for item
+ * emission. Run state is persisted to workflow static data (R-05).
+ */
+export declare class SoftwareTeamsOrchestrator implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=SoftwareTeamsOrchestrator.node.d.ts.map

package/dist/nodes/SoftwareTeamsOrchestrator/SoftwareTeamsOrchestrator.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoftwareTeamsOrchestrator.node.d.ts","sourceRoot":"","sources":["../../../nodes/SoftwareTeamsOrchestrator/SoftwareTeamsOrchestrator.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EAGrB,MAAM,cAAc,CAAC;AA0CtB;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,SAAS;IACzD,WAAW,EAAE,oBAAoB,CA+E/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CA0UxE"}