@websitelabs/n8n-nodes-software-teams 0.12.3

package/dist/src/execution/single-turn.js.map

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

package/dist/src/hitl/channels.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Channel-agnostic HITL delivery adapters (T8 — AC3, AC4).
+ *
+ * Each adapter implements `postQuestion` (deliver the agent's question to the
+ * human) and `postAck` (acknowledge receipt of the human's reply). All
+ * secrets/tokens are passed in as function arguments — adapters NEVER read
+ * from `process.env` directly (R-02 / AC8).
+ */
+/** Delivery coordinates returned by a channel adapter after posting a question. */
+export interface DeliveryRef {
+    [key: string]: unknown;
+}
+/** Arguments passed to every channel adapter's `postQuestion`. */
+export interface PostQuestionArgs {
+    /** The agent's question text. */
+    question: string;
+    /** The stable correlation id for this run/conversation. */
+    correlationId: string;
+    /** The n8n signed resume URL that the human (or their handler) should POST to. */
+    resumeUrl: string;
+    /** Channel-specific credential token (e.g. Slack bot token, Discord bot token, SMTP URL). */
+    token: string;
+    /** Channel-specific destination (e.g. Slack channel ID, Discord channel ID, email address). */
+    destination: string;
+}
+/** Arguments passed to every channel adapter's `postAck`. */
+export interface PostAckArgs {
+    /** The human's reply text. */
+    answer: string;
+    /** The stable correlation id for this run/conversation. */
+    correlationId: string;
+    /** Channel-specific credential token. */
+    token: string;
+    /** Delivery coordinates from the original `postQuestion` call. */
+    delivery: DeliveryRef;
+}
+/** Channel adapter contract. */
+export interface HitlChannelAdapter {
+    postQuestion(args: PostQuestionArgs): Promise<{
+        deliveryRef: DeliveryRef;
+    }>;
+    postAck(args: PostAckArgs): Promise<void>;
+}
+/** Supported HITL channel names. */
+export type ChannelName = 'slack' | 'email' | 'notify' | 'discord';
+/** Return the channel adapter for the given channel name. */
+export declare function getChannel(name: ChannelName): HitlChannelAdapter;
+//# sourceMappingURL=channels.d.ts.map

package/dist/src/hitl/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/hitl/channels.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,+FAA+F;IAC/F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,gCAAgC;AAChC,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAC5E,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAmVnE,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAQhE"}

package/dist/src/hitl/channels.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * Channel-agnostic HITL delivery adapters (T8 — AC3, AC4).
+ *
+ * Each adapter implements `postQuestion` (deliver the agent's question to the
+ * human) and `postAck` (acknowledge receipt of the human's reply). All
+ * secrets/tokens are passed in as function arguments — adapters NEVER read
+ * from `process.env` directly (R-02 / AC8).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChannel = getChannel;
+const https = __importStar(require("node:https"));
+const tls = __importStar(require("node:tls"));
+const net = __importStar(require("node:net"));
+// ── Slack adapter ──────────────────────────────────────────────────────────
+/**
+ * Slack adapter — reuses the Block Kit post + thread reply pattern from
+ * `src/hitl/slack.ts`. Delegates to the existing helpers via require so the
+ * Slack-specific HTTP logic is not duplicated.
+ */
+const slackAdapter = {
+    async postQuestion(args) {
+        const SLACK_MODULE = './slack';
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const slackHelpers = require(SLACK_MODULE);
+        const result = await slackHelpers.postQuestion(args.token, args.destination, args.question, args.correlationId, args.resumeUrl);
+        return {
+            deliveryRef: {
+                slackChannel: result.channel,
+                slackThreadTs: result.ts,
+            },
+        };
+    },
+    async postAck(args) {
+        const SLACK_MODULE = './slack';
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const slackHelpers = require(SLACK_MODULE);
+        const channel = args.delivery['slackChannel'];
+        const threadTs = args.delivery['slackThreadTs'];
+        if (!channel || !threadTs)
+            return;
+        await slackHelpers.postThreadReply(args.token, channel, threadTs, `Reply received: "${args.answer}" -- resuming agent...`);
+    },
+};
+// ── Discord adapter ────────────────────────────────────────────────────────
+/**
+ * Discord adapter — posts the question to a Discord channel via the bot
+ * token using the Discord REST API v10. Records channel + message id in the
+ * delivery ref so we can thread follow-ups.
+ */
+const discordAdapter = {
+    async postQuestion(args) {
+        const content = `**Agent question** (correlation: \`${args.correlationId}\`)\n\n` +
+            `${args.question}\n\n` +
+            `> Reply via the resume endpoint or use the correlation id to respond.`;
+        const result = await discordApiCall('POST', `/channels/${args.destination}/messages`, args.token, { content });
+        return {
+            deliveryRef: {
+                discordChannelId: args.destination,
+                discordMessageId: result['id'],
+            },
+        };
+    },
+    async postAck(args) {
+        const channelId = args.delivery['discordChannelId'];
+        const messageId = args.delivery['discordMessageId'];
+        if (!channelId || !messageId)
+            return;
+        const content = `Reply received: "${args.answer}" -- resuming agent... (correlation: \`${args.correlationId}\`)`;
+        await discordApiCall('POST', `/channels/${channelId}/messages`, args.token, {
+            content,
+            message_reference: { message_id: messageId },
+        });
+    },
+};
+/** Low-level Discord REST API call. */
+async function discordApiCall(method, path, botToken, payload) {
+    const body = JSON.stringify(payload);
+    const contentLength = Buffer.byteLength(body, 'utf8');
+    return new Promise((resolve, reject) => {
+        const req = https.request({
+            hostname: 'discord.com',
+            path: `/api/v10${path}`,
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': contentLength,
+                Authorization: `Bot ${botToken}`,
+                Accept: 'application/json',
+            },
+        }, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                const raw = Buffer.concat(chunks).toString('utf8');
+                try {
+                    const parsed = JSON.parse(raw);
+                    if (res.statusCode && res.statusCode >= 400) {
+                        reject(new Error(`Discord API ${method} ${path} returned ${res.statusCode}: ${raw.slice(0, 300)}`));
+                    }
+                    else {
+                        resolve(parsed);
+                    }
+                }
+                catch {
+                    reject(new Error(`Discord API: failed to parse response: ${raw.slice(0, 200)}`));
+                }
+            });
+            res.on('error', reject);
+        });
+        req.on('error', reject);
+        req.write(body, 'utf8');
+        req.end();
+    });
+}
+// ── Email adapter ──────────────────────────────────────────────────────────
+/**
+ * Email adapter — sends via SMTP using a single connection string `smtpUrl`
+ * (e.g. `smtp://user:pass@host:port`). Uses raw SMTP commands via Node
+ * `net`/`tls` to avoid external dependencies.
+ *
+ * The `destination` field is the recipient email address. The `token` field is
+ * the full `smtpUrl` connection string.
+ */
+const emailAdapter = {
+    async postQuestion(args) {
+        const messageId = `<hitl-${args.correlationId}-${Date.now()}@software-teams>`;
+        await sendSmtpEmail({
+            smtpUrl: args.token,
+            to: args.destination,
+            subject: `[Software Teams] Agent question (${args.correlationId})`,
+            body: `Agent question:\n\n${args.question}\n\n` +
+                `Correlation ID: ${args.correlationId}\n` +
+                `Resume URL: ${args.resumeUrl}`,
+            messageId,
+        });
+        return {
+            deliveryRef: {
+                emailTo: args.destination,
+                emailMessageId: messageId,
+            },
+        };
+    },
+    async postAck(args) {
+        const originalMessageId = args.delivery['emailMessageId'];
+        const to = args.delivery['emailTo'];
+        if (!to)
+            return;
+        await sendSmtpEmail({
+            smtpUrl: args.token,
+            to,
+            subject: `Re: [Software Teams] Agent question (${args.correlationId})`,
+            body: `Reply received: "${args.answer}" -- resuming agent...\n\nCorrelation ID: ${args.correlationId}`,
+            messageId: `<hitl-ack-${args.correlationId}-${Date.now()}@software-teams>`,
+            inReplyTo: originalMessageId,
+        });
+    },
+};
+/** Parse an SMTP URL into connection components. */
+function parseSmtpUrl(smtpUrl) {
+    const url = new URL(smtpUrl);
+    const secure = url.protocol === 'smtps:' || url.port === '465';
+    return {
+        host: url.hostname,
+        port: url.port ? parseInt(url.port, 10) : (secure ? 465 : 587),
+        user: decodeURIComponent(url.username),
+        pass: decodeURIComponent(url.password),
+        secure,
+    };
+}
+/** Send an email via raw SMTP. Minimal implementation for HITL notifications. */
+async function sendSmtpEmail(opts) {
+    const conn = parseSmtpUrl(opts.smtpUrl);
+    const fromAddr = conn.user.includes('@') ? conn.user : `hitl@software-teams.local`;
+    const headers = [
+        `From: Software Teams HITL <${fromAddr}>`,
+        `To: ${opts.to}`,
+        `Subject: ${opts.subject}`,
+        `Message-ID: ${opts.messageId}`,
+        ...(opts.inReplyTo ? [`In-Reply-To: ${opts.inReplyTo}`, `References: ${opts.inReplyTo}`] : []),
+        `Date: ${new Date().toUTCString()}`,
+        `MIME-Version: 1.0`,
+        `Content-Type: text/plain; charset=utf-8`,
+    ];
+    const message = headers.join('\r\n') + '\r\n\r\n' + opts.body;
+    return new Promise((resolve, reject) => {
+        const onConnect = (socket) => {
+            // We just need a minimal SMTP exchange
+            let state = 0; // 0=greeting, 1=EHLO, 2=AUTH, 3=MAIL, 4=RCPT, 5=DATA, 6=body, 7=QUIT
+            const commands = [
+                `EHLO software-teams\r\n`,
+                `AUTH PLAIN ${Buffer.from(`\0${conn.user}\0${conn.pass}`).toString('base64')}\r\n`,
+                `MAIL FROM:<${fromAddr}>\r\n`,
+                `RCPT TO:<${opts.to}>\r\n`,
+                `DATA\r\n`,
+                `${message}\r\n.\r\n`,
+                `QUIT\r\n`,
+            ];
+            socket.on('data', (data) => {
+                const response = data.toString('utf8');
+                const code = parseInt(response.slice(0, 3), 10);
+                if (code >= 400 && state < 7) {
+                    socket.destroy();
+                    reject(new Error(`SMTP error at state ${state}: ${response.trim()}`));
+                    return;
+                }
+                if (state < commands.length) {
+                    socket.write(commands[state]);
+                    state++;
+                }
+                else {
+                    socket.destroy();
+                    resolve();
+                }
+            });
+            socket.on('error', reject);
+        };
+        const socket = conn.secure
+            ? tls.connect({ host: conn.host, port: conn.port, rejectUnauthorized: true }, function () { onConnect(this); })
+            : net.connect({ host: conn.host, port: conn.port }, function () { onConnect(this); });
+        socket.on('error', reject);
+    });
+}
+// ── Notify adapter ─────────────────────────────────────────────────────────
+/**
+ * n8n-notification adapter — emits a structured payload that downstream
+ * n8n nodes (e.g. an n8n Notification node, a Set node, or a webhook) can
+ * consume. No external API call is needed; the "delivery" is the payload
+ * itself, available in the node's output for downstream wiring.
+ */
+const notifyAdapter = {
+    async postQuestion(args) {
+        return {
+            deliveryRef: {
+                type: 'n8n-notification',
+                correlationId: args.correlationId,
+                question: args.question,
+                resumeUrl: args.resumeUrl,
+                destination: args.destination,
+                timestamp: Date.now(),
+            },
+        };
+    },
+    async postAck(_args) {
+        // No external action needed for n8n-notification — downstream nodes
+        // handle acknowledgement via the workflow itself.
+    },
+};
+// ── Factory ────────────────────────────────────────────────────────────────
+const adapters = {
+    slack: slackAdapter,
+    discord: discordAdapter,
+    email: emailAdapter,
+    notify: notifyAdapter,
+};
+/** Return the channel adapter for the given channel name. */
+function getChannel(name) {
+    const adapter = adapters[name];
+    if (!adapter) {
+        throw new Error(`Unknown HITL channel "${name}". Supported channels: ${Object.keys(adapters).join(', ')}`);
+    }
+    return adapter;
+}
+//# sourceMappingURL=channels.js.map

package/dist/src/hitl/channels.js.map

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

package/dist/src/hitl/conversation-state.d.ts

@@ -0,0 +1,45 @@
+import type { NodeEnvelope } from '@websitelabs/software-teams';
+/** Supported HITL delivery channels. */
+export type HitlChannel = 'slack' | 'email' | 'notify' | 'discord';
+/** All the state the HITL node needs to resume a parked run. */
+export interface ConversationState {
+    correlationId: string;
+    originalEnvelope: NodeEnvelope;
+    slackChannel: string;
+    slackThreadTs: string;
+    resumeUrl: string;
+    question: string;
+    createdAt: number;
+    /**
+     * Which delivery channel this conversation is using.
+     * Optional for back-compat — omitted states are implicitly Slack.
+     */
+    channel?: HitlChannel;
+    /**
+     * Current round number (1-based). Omitted states default to round 1.
+     * Callers increment via `nextRound()` and re-save to continue the loop.
+     */
+    round?: number;
+    /**
+     * Generic bag for non-Slack channel delivery coordinates (e.g. Discord
+     * channel/message id, email thread id). Avoids adding new top-level
+     * fields for every channel.
+     */
+    delivery?: Record<string, unknown>;
+}
+/** Resolve the path for the JSON state file. */
+export declare function getStorePath(): string;
+/** Persist a conversation state record keyed by `correlationId`. */
+export declare function saveState(state: ConversationState): void;
+/** Load the conversation state for `correlationId`. Returns `null` if not found. */
+export declare function loadState(correlationId: string): ConversationState | null;
+/** Remove the conversation state for `correlationId` after a successful resume. */
+export declare function deleteState(correlationId: string): void;
+/** Return all stored states (useful for auditing / expiry sweeps). */
+export declare function allStates(): ConversationState[];
+/**
+ * Return the next round number for a conversation state.
+ * States with no `round` field are treated as round 1, so the next is 2.
+ */
+export declare function nextRound(state: ConversationState): number;
+//# sourceMappingURL=conversation-state.d.ts.map

package/dist/src/hitl/conversation-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-state.d.ts","sourceRoot":"","sources":["../../../src/hitl/conversation-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,YAAY,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAID,gDAAgD;AAChD,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAsBD,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAIxD;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAGzE;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAKvD;AAED,sEAAsE;AACtE,wBAAgB,SAAS,IAAI,iBAAiB,EAAE,CAE/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE1D"}

package/dist/src/hitl/conversation-state.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStorePath = getStorePath;
+exports.saveState = saveState;
+exports.loadState = loadState;
+exports.deleteState = deleteState;
+exports.allStates = allStates;
+exports.nextRound = nextRound;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+/** Resolve the path for the JSON state file. */
+function getStorePath() {
+    var _a;
+    return ((_a = process.env['HITL_STATE_PATH']) !== null && _a !== void 0 ? _a : (0, node_path_1.join)((0, node_os_1.homedir)(), '.n8n', 'software-teams-hitl-state.json'));
+}
+function readStore() {
+    const path = getStorePath();
+    if (!(0, node_fs_1.existsSync)(path))
+        return {};
+    try {
+        const raw = (0, node_fs_1.readFileSync)(path, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function writeStore(store) {
+    const path = getStorePath();
+    const dir = (0, node_path_1.dirname)(path);
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, node_fs_1.writeFileSync)(path, JSON.stringify(store, null, 2), 'utf8');
+}
+/** Persist a conversation state record keyed by `correlationId`. */
+function saveState(state) {
+    const store = readStore();
+    store[state.correlationId] = state;
+    writeStore(store);
+}
+/** Load the conversation state for `correlationId`. Returns `null` if not found. */
+function loadState(correlationId) {
+    var _a;
+    const store = readStore();
+    return (_a = store[correlationId]) !== null && _a !== void 0 ? _a : null;
+}
+/** Remove the conversation state for `correlationId` after a successful resume. */
+function deleteState(correlationId) {
+    const store = readStore();
+    if (!(correlationId in store))
+        return;
+    delete store[correlationId];
+    writeStore(store);
+}
+/** Return all stored states (useful for auditing / expiry sweeps). */
+function allStates() {
+    return Object.values(readStore());
+}
+/**
+ * Return the next round number for a conversation state.
+ * States with no `round` field are treated as round 1, so the next is 2.
+ */
+function nextRound(state) {
+    var _a;
+    return ((_a = state.round) !== null && _a !== void 0 ? _a : 1) + 1;
+}
+//# sourceMappingURL=conversation-state.js.map

package/dist/src/hitl/conversation-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-state.js","sourceRoot":"","sources":["../../../src/hitl/conversation-state.ts"],"names":[],"mappings":";;AAyCA,oCAKC;AAuBD,8BAIC;AAGD,8BAGC;AAGD,kCAKC;AAGD,8BAEC;AAMD,8BAEC;AApGD,qCAA6E;AAC7E,yCAA0C;AAC1C,qCAAkC;AAsClC,gDAAgD;AAChD,SAAgB,YAAY;;IAC1B,OAAO,CACL,MAAA,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,mCAC9B,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,MAAM,EAAE,gCAAgC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAA,oBAAU,EAAC,GAAG,CAAC,EAAE,CAAC;QACrB,IAAA,mBAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAA,uBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,oEAAoE;AACpE,SAAgB,SAAS,CAAC,KAAwB;IAChD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;IACnC,UAAU,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,oFAAoF;AACpF,SAAgB,SAAS,CAAC,aAAqB;;IAC7C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,OAAO,MAAA,KAAK,CAAC,aAAa,CAAC,mCAAI,IAAI,CAAC;AACtC,CAAC;AAED,mFAAmF;AACnF,SAAgB,WAAW,CAAC,aAAqB;IAC/C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC;QAAE,OAAO;IACtC,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5B,UAAU,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,sEAAsE;AACtE,SAAgB,SAAS;IACvB,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,KAAwB;;IAChD,OAAO,CAAC,MAAA,KAAK,CAAC,KAAK,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/hitl/slack.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Verify a Slack interactivity webhook request using the HMAC-SHA256 signature
+ * Slack attaches to every inbound HTTP request.
+ *
+ * Security (R-05 / auth hardening — T13): the n8n resume URL is the outer auth
+ * layer; this adds a second layer by confirming the body was signed by YOUR Slack
+ * app's signing secret, so an attacker who learns the URL cannot forge a valid
+ * `hitlAnswer` without knowing that secret.
+ */
+export declare function verifySlackSignature(slackSignature: string | undefined, timestamp: string | undefined, rawBody: string, signingSecret: string | undefined, maxAgeSeconds?: number): boolean;
+/** Result of a successful chat.postMessage call. */
+export interface PostQuestionResult {
+    /** Slack message timestamp — use as `thread_ts` for threaded replies. */
+    ts: string;
+    /** Resolved channel ID (may differ from the channel param if given a name). */
+    channel: string;
+}
+/**
+ * Post an agent HITL question to Slack using Block Kit.
+ *
+ * Embeds correlationId (not the full resumeUrl) in the button value — Slack
+ * limits button values to 75 characters; the interactivity handler looks up
+ * the resumeUrl from the HITL state store keyed by correlationId.
+ */
+export declare function postQuestion(token: string, channel: string, question: string, correlationId: string, _resumeUrl: string): Promise<PostQuestionResult>;
+/**
+ * Post a threaded reply in an existing Slack conversation.
+ * Uses the Slack HTTP API directly to avoid the n8n built-in Slack tool's
+ * thread_ts bug (GitHub #21252).
+ */
+export declare function postThreadReply(token: string, channel: string, threadTs: string, message: string): Promise<void>;
+//# sourceMappingURL=slack.d.ts.map

package/dist/src/hitl/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/hitl/slack.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,aAAa,SAAM,GAClB,OAAO,CAmBT;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAsE7B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAOf"}