n8n-nodes-tendem 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toloka AI BV
+
+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,268 @@
+# n8n-nodes-tendem
+
+An [n8n](https://n8n.io) community node for [Tendem](https://tendem.ai) — a hybrid
+AI + human task service. You submit a task in plain English, Tendem's orchestrator
+scopes it in a chat and quotes a transparent price, and once a **human** approves
+the spend, a vetted expert executes it and returns verified results as markdown
+plus files.
+
+Use it when a workflow hits work an automation can't reliably nail: research and
+competitive analysis, copywriting and editing, design review, data cleaning, list
+building, anything needing real judgement. Don't use it for quick
+general-knowledge lookups, and note that Tendem declines data-scraping work by
+policy.
+
+- [Installation](#installation)
+- [Credentials](#credentials)
+- [Operations](#operations)
+- [Approving a task spends real money](#approving-a-task-spends-real-money)
+- [Worked example](#worked-example-research-brief-end-to-end)
+- [Polling without a busy loop](#polling-without-a-busy-loop)
+- [Attaching input files](#attaching-input-files)
+- [Compatibility](#compatibility)
+
+## Installation
+
+Go to **Settings → Community nodes → Install**, enter `n8n-nodes-tendem`, accept
+the risk prompt, and install. A **Tendem** node appears in the node panel.
+
+Other setups are covered in n8n's own guide: [Installing community
+nodes](https://docs.n8n.io/integrations/community-nodes/installation/).
+
+## Credentials
+
+The node talks to Tendem's hosted MCP server over streamable HTTP. Authentication
+is an **API key**, sent as `Authorization: ApiKey <token>`.
+
+1. Sign in at [agent.tendem.ai](https://agent.tendem.ai).
+2. Go to [agent.tendem.ai/mcp](https://agent.tendem.ai/mcp), open the **Agent
+   builders** tab, and click **Generate API key**.
+3. In n8n: **Credentials → New → Tendem API**, paste the token, save.
+
+Use n8n's **Test** button on the credential — it performs a real MCP `initialize`
+handshake against the endpoint, so a bad key fails immediately rather than at the
+first workflow run.
+
+| Field | Default | Notes |
+|---|---|---|
+| API Key | — | Required. Stored encrypted by n8n; never put it in a node parameter or an HTTP Request node. |
+| MCP Endpoint | `https://mcp.tendem.ai/mcp?utm_hash=83dad40a52` | Overridable, but only change it to target a non-production Tendem deployment. The `utm_hash` is n8n channel attribution. |
+
+Tendem also supports interactive OAuth, which is what the Claude Code / Cursor /
+Gemini plugins use. n8n workflows run unattended, so this node deliberately does
+API keys only.
+
+## Operations
+
+| Resource | Operation | Tendem tool | Spends money |
+|---|---|---|---|
+| Task | Create | `create_task` | no |
+| Task | Get | `get_task` | no |
+| Task | Get Contract | `get_contract` | no |
+| Task | **Approve (Spends Money)** | `approve_task` | **yes** |
+| Task | Get Cancel URL | `cancel_task` | no |
+| Task | Get Result | `get_task_result` | no |
+| Task | List | `list_tasks` | no |
+| Task | Wait for Change | `get_task` (long-poll) | no |
+| Chat | Read | `read_chat` | no |
+| Chat | Send | `send_message` | no |
+| Account | Get | `get_account` | no |
+| File | Get Upload URL | `get_file_upload_url` | no |
+
+Every response is passed through as JSON on the item, including Tendem's guidance
+envelope — `next_action`, `poll_after_seconds`, `poll_timeout_seconds`,
+`guidance`. **Branch on `next_action`, not on the raw `status`**; Tendem treats it
+as authoritative. The statuses you'll see are `ACTING`, `LISTENING`,
+`NEEDS_REPAIR`, `CLOSED` (terminal, but the result is still fetchable) and
+`DELETED`.
+
+### Note on Get Cancel URL
+
+`cancel_task` does **not** cancel anything. It returns a Tendem UI URL where a
+person can cancel. Send them there.
+
+## Approving a task spends real money
+
+Approval charges the Tendem account, so the node treats it as a distinct,
+deliberate act rather than a step that can happen on the way to something else.
+Four things stand in the way, and they are structural, not documentation:
+
+1. **Approval is its own operation.** `approve_task` is reachable only from
+   Task → Approve. A workflow author has to add that node on purpose.
+2. **Per-operation capability guard.** Each operation executes against an
+   allowlist naming the single Tendem tool it may call. Approve is the only row
+   containing `approve_task`; every other operation is refused *before* any HTTP
+   request is made. Creating a task, polling one, or reading its chat cannot
+   approve it even if the code above them were wrong.
+3. **Confirm Spend must be on.** The Approve operation refuses while the
+   **Confirm Spend** toggle is off. Drive it from an expression if a human
+   decision upstream — an n8n Wait-for-form, a Slack approval, an email gate —
+   should decide. It is evaluated per item, so confirming one item never
+   approves another.
+4. **A price must be supplied.** Approve requires the quoted price, which means
+   the amount being committed had to be read before it could be committed.
+
+The node also never tops up and never retries. Insufficient balance comes back as
+**data**, not an exception, so you can route on it:
+
+```
+{ "approved": false, "spendBlocked": true, "topupUrl": "https://…", "reason": "insufficient_balance" }
+```
+
+Send `topupUrl` to the user. That link is task-bound: paying it tops up *and*
+auto-approves this task, so don't call Approve again afterwards.
+
+On success you get `approved: true`, `spendBlocked: false`, `topupUrl: null`.
+
+### Why the node isn't available as an AI Agent tool
+
+n8n's `usableAsTool` is all-or-nothing per node — there is no form of it that
+exposes some operations and withholds others. Turning it on would hand a model
+the Approve operation. Spend is a workflow author's decision, so this node stays
+off the AI tool surface. An agent that needs the read-only parts can talk to the
+[Tendem MCP server](https://github.com/Toloka/tendem-mcp) directly, where the
+host application owns the approval gate.
+
+## Worked example: research brief, end to end
+
+A workflow that submits a brief, surfaces the quote to a human, and only then
+spends. Nine nodes:
+
+```
+Manual Trigger
+  → Tendem: Task → Create
+  → Tendem: Task → Wait for Change            (until the quote is ready)
+  → Tendem: Task → Get Contract               (scope + price)
+  → Slack / Email: send the scope and price to a human
+  → Wait for approval (n8n Wait node with a form / webhook resume)
+  → IF: did the human approve?
+      true  → Tendem: Task → Approve          (Confirm Spend = the human's answer)
+              → Tendem: Task → Wait for Change  (until the work is done)
+              → Tendem: Task → Get Result
+      false → Tendem: Task → Get Cancel URL   (and send it to the human)
+```
+
+**1. Task → Create.** Pass the requester's own words through verbatim. Don't
+pre-interrogate them and don't rewrite the brief — Tendem's orchestrator does the
+scoping and asks follow-up questions over chat.
+
+| Parameter | Value |
+|---|---|
+| Name | `Competitor research for EU freight brokerage` |
+| Description | `Research the top 5 competitors in EU freight brokerage and summarise their pricing models in a one-page brief.` |
+| Conversation ID | *(optional)* `{{ $execution.id }}` — lets Tendem correlate several tasks from one run |
+
+Output carries `task_id` and `last_seen_offset`. Nothing is charged yet.
+
+**2. Task → Wait for Change.** Task ID `{{ $json.task_id }}`. This blocks until
+Tendem needs you. When `next_action` comes back `await_input`, Tendem asked a
+scoping question: read it with **Chat → Read** and answer with **Chat → Send**,
+then wait again. Send figures out the conversation position on its own (that's
+the "Resolve Offset Automatically" toggle, on by default), so there is no offset
+to thread through the workflow. When `next_action` is `await_user_approval`, the
+quote is ready.
+
+**3. Task → Get Contract.** Returns the scope Tendem committed to
+(`task_description`, `criteria`) and the price. Scope is ready before the price
+is, so a contract can legitimately come back with `price: null` — that means keep
+waiting, not approve at zero.
+
+**4–6. Show a human the scope and the price, and wait for an answer.** This is
+the part the node cannot do for you and deliberately will not fake. Any n8n
+approval mechanism works: a Wait node with a form, a Slack interactive message, a
+webhook.
+
+**7. Task → Approve.**
+
+| Parameter | Value |
+|---|---|
+| Task ID | `{{ $json.task_id }}` |
+| Name | `{{ $json.name }}` |
+| Price | `{{ $json.price }}` — the number the human was shown |
+| Confirm Spend | `{{ $json.humanApproved === true }}` |
+
+Route `spendBlocked === true` to a branch that sends the human `topupUrl`.
+
+**8. Task → Wait for Change** again, until `next_action` is `fetch_result` or
+`done`. Expert work takes minutes to hours, so set **Max Rounds** to what you're
+willing to hold an execution open for (each round is at most 30 seconds) and
+handle `tendemWait.timedOut === true` by re-entering the wait on a schedule
+rather than by raising the cap.
+
+**9. Task → Get Result.** Returns the result markdown plus pre-signed download
+URLs for any files. Fetch those with an HTTP Request node if you need the bytes.
+
+## Polling without a busy loop
+
+**Wait for Change** does not spin. Each round is a single
+`get_task(task_id, wait_for_change_seconds=N)` call, and the *server* holds the
+request open until the task actually changes — no client-side interval, no
+repeated requests while nothing is happening.
+
+| Parameter | Default | Range |
+|---|---|---|
+| Wait for Change (Seconds) | 30 | 5–30 (30 is the Tendem API's ceiling) |
+| Max Rounds | 20 | 1–240 |
+
+The round count is a hard cap. When the budget runs out the node emits the latest
+snapshot with:
+
+```json
+{ "tendemWait": { "settled": false, "timedOut": true, "rounds": 20 } }
+```
+
+Branch on `tendemWait.timedOut` and re-enter the wait later. At the defaults, one
+node holds an execution open for at most ten minutes.
+
+There's a backstop underneath: if a round returns faster than the server could
+plausibly have blocked — a proxy that doesn't support long-polling, say — the node
+sleeps before the next one, honouring Tendem's `poll_after_seconds` hint. A
+misbehaving endpoint degrades to a paced poll, never to a hot loop.
+
+Transient failures are absorbed too: read operations retry a
+`TEMPORARILY_UNAVAILABLE`, a 5xx, or a dropped connection with backoff (up to 5
+attempts) instead of failing the workflow, so an hours-long expert wait survives
+the blips it will inevitably see. Operations that write — Create, Send, Approve —
+are never retried, because repeating them could duplicate a task, a message, or
+a charge.
+
+## Attaching input files
+
+Uploads need a `task_id`, so they can only happen *after* Create.
+
+1. **File → Get Upload URL** with the task ID. You get a short-lived, folder-level
+   pre-signed URL.
+2. For each file, build the PUT URL from the folder URL and upload with an HTTP
+   Request node:
+   - swap the host from `.dfs.core.windows.net` to `.blob.core.windows.net`,
+   - append the file name to the path **before** the query string —
+     `<base>/<filename>?<query>`,
+   - `PUT` the raw bytes with the header `x-ms-blob-type: BlockBlob`.
+
+   All three matter: a `PUT` to the URL exactly as returned fails with HTTP 400.
+   Keep names simple; avoid spaces. Subpaths like `data/input.csv` are fine.
+3. **Chat → Send** naming the files you uploaded, e.g.
+   `I've uploaded brief.pdf and data/input.csv for this task.` Tendem waits for
+   this message; without it the expert never sees the files.
+
+If the brief already references the files, mention them in the Create description
+and promise them. Tendem may ask for them before your upload finishes — that race
+is expected, and the confirming chat message settles it.
+
+## Compatibility
+
+- n8n API version 1, node type version 1
+- Node.js >= 20.19
+- No runtime dependencies. The MCP client is implemented in this package, in
+  ~350 lines, against the [Streamable HTTP
+  transport](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports)
+  spec — so there is nothing to audit but this repository.
+
+## Support
+
+- Issues: <https://github.com/Toloka/tendem-mcp/issues>
+- Email: <support@tendem.ai>
+
+## License
+
+[MIT](./LICENSE) © Toloka AI BV

package/dist/credentials/TendemApi.credentials.d.ts

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

package/dist/credentials/TendemApi.credentials.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TendemApi = void 0;
+const transport_1 = require("../nodes/Tendem/transport");
+class TendemApi {
+    constructor() {
+        this.name = 'tendemApi';
+        this.displayName = 'Tendem API';
+        this.icon = 'file:../nodes/Tendem/tendem.svg';
+        this.documentationUrl = 'https://github.com/Toloka/tendem-mcp';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Tendem API key. Create one at https://agent.tendem.ai/mcp, on the "Agent builders" tab. Sent as the "Authorization: ApiKey <token>" header.',
+            },
+            {
+                displayName: 'MCP Endpoint',
+                name: 'endpoint',
+                type: 'string',
+                default: transport_1.TENDEM_DEFAULT_ENDPOINT,
+                required: true,
+                description: 'Tendem MCP endpoint (Streamable HTTP). Change this only to target a non-production Tendem deployment.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=ApiKey {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                url: '={{$credentials.endpoint}}',
+                method: 'POST',
+                headers: {
+                    Accept: 'application/json, text/event-stream',
+                    'Content-Type': 'application/json',
+                },
+                body: {
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'initialize',
+                    params: {
+                        protocolVersion: transport_1.MCP_PROTOCOL_VERSION,
+                        capabilities: {},
+                        clientInfo: { name: transport_1.MCP_CLIENT_NAME, version: transport_1.MCP_CLIENT_VERSION },
+                    },
+                },
+            },
+        };
+    }
+}
+exports.TendemApi = TendemApi;
+//# sourceMappingURL=TendemApi.credentials.js.map

package/dist/credentials/TendemApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TendemApi.credentials.js","sourceRoot":"","sources":["../../credentials/TendemApi.credentials.ts"],"names":[],"mappings":";;;AAQA,yDAKmC;AAEnC,MAAa,SAAS;IAAtB;QACC,SAAI,GAAG,WAAW,CAAC;QAEnB,gBAAW,GAAG,YAAY,CAAC;QAO3B,SAAI,GAAS,iCAAiC,CAAC;QAE/C,qBAAgB,GAAG,sCAAsC,CAAC;QAE1D,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EACV,6IAA6I;aAC9I;YACD;gBACC,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,mCAAuB;gBAChC,QAAQ,EAAE,IAAI;gBACd,WAAW,EACV,uGAAuG;aACxG;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAGF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,GAAG,EAAE,4BAA4B;gBACjC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACR,MAAM,EAAE,qCAAqC;oBAC7C,cAAc,EAAE,kBAAkB;iBAClC;gBACD,IAAI,EAAE;oBACL,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,CAAC;oBACL,MAAM,EAAE,YAAY;oBACpB,MAAM,EAAE;wBACP,eAAe,EAAE,gCAAoB;wBACrC,YAAY,EAAE,EAAE;wBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,2BAAe,EAAE,OAAO,EAAE,8BAAkB,EAAE;qBAClE;iBACD;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAlED,8BAkEC"}

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

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

package/dist/nodes/Tendem/Tendem.node.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tendem = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const descriptions_1 = require("./descriptions");
+const transport_1 = require("./transport");
+const retry_1 = require("./retry");
+const tools_1 = require("./tools");
+const waitForTask_1 = require("./waitForTask");
+class Tendem {
+    constructor() {
+        this.description = {
+            displayName: 'Tendem',
+            name: 'tendem',
+            icon: 'file:tendem.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Delegate work to vetted human experts through Tendem',
+            defaults: { name: 'Tendem' },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [{ name: 'tendemApi', required: true }],
+            properties: [
+                descriptions_1.resourceField,
+                descriptions_1.taskOperations,
+                descriptions_1.chatOperations,
+                descriptions_1.accountOperations,
+                descriptions_1.fileOperations,
+                ...descriptions_1.taskFields,
+                ...descriptions_1.chatFields,
+                ...descriptions_1.fileFields,
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('tendemApi');
+        const endpoint = typeof credentials.endpoint === 'string' && credentials.endpoint.trim() !== ''
+            ? credentials.endpoint.trim()
+            : transport_1.TENDEM_DEFAULT_ENDPOINT;
+        const requester = async (options) => (await this.helpers.httpRequestWithAuthentication.call(this, 'tendemApi', options));
+        const session = new transport_1.McpSession(requester, { endpoint });
+        const retrying = new retry_1.RetryingToolCaller(session, { sleep: n8n_workflow_1.sleep });
+        for (let i = 0; i < items.length; i += 1) {
+            try {
+                const resource = this.getNodeParameter('resource', i);
+                const operation = this.getNodeParameter('operation', i);
+                const key = (0, tools_1.operationKey)(resource, operation);
+                const guarded = (0, tools_1.guardFor)(retrying, key);
+                const payload = await runOperation.call(this, guarded, key, i);
+                returnData.push(...this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(payload), {
+                    itemData: { item: i },
+                }));
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error instanceof Error ? error.message : String(error) },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw asNodeError.call(this, error, i);
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Tendem = Tendem;
+function asNodeError(error, itemIndex) {
+    if (error instanceof n8n_workflow_1.NodeOperationError || error instanceof n8n_workflow_1.NodeApiError)
+        return error;
+    return new n8n_workflow_1.NodeApiError(this.getNode(), error, {
+        itemIndex,
+        message: error instanceof Error ? error.message : String(error),
+    });
+}
+async function runOperation(guarded, key, i) {
+    switch (key) {
+        case 'task:create': {
+            const args = {
+                name: this.getNodeParameter('taskName', i),
+                description: this.getNodeParameter('description', i),
+            };
+            const conversationId = this.getNodeParameter('conversationId', i, '');
+            if (conversationId !== '')
+                args.conversation_id = conversationId;
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.CREATE_TASK, args);
+        }
+        case 'task:get':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.GET_TASK, {
+                task_id: this.getNodeParameter('taskId', i),
+            });
+        case 'task:getContract':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.GET_CONTRACT, {
+                task_id: this.getNodeParameter('taskId', i),
+            });
+        case 'task:approve':
+            return await approveTask.call(this, guarded, i);
+        case 'task:cancel':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.CANCEL_TASK, {
+                task_id: this.getNodeParameter('taskId', i),
+                name: this.getNodeParameter('taskName', i),
+            });
+        case 'task:getResult':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.GET_TASK_RESULT, {
+                task_id: this.getNodeParameter('taskId', i),
+            });
+        case 'task:list':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.LIST_TASKS, {
+                limit: this.getNodeParameter('limit', i, 50),
+                offset: this.getNodeParameter('offset', i, 0),
+            });
+        case 'task:wait': {
+            const outcome = await (0, waitForTask_1.waitForTaskChange)({ caller: guarded, sleep: n8n_workflow_1.sleep, now: () => Date.now() }, {
+                taskId: this.getNodeParameter('taskId', i),
+                waitForChangeSeconds: this.getNodeParameter('waitForChangeSeconds', i, 30),
+                maxRounds: this.getNodeParameter('maxRounds', i, 20),
+            });
+            return {
+                ...outcome.task,
+                tendemWait: {
+                    settled: outcome.settled,
+                    timedOut: outcome.timedOut,
+                    rounds: outcome.rounds,
+                },
+            };
+        }
+        case 'chat:read':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.READ_CHAT, {
+                task_id: this.getNodeParameter('taskId', i),
+                from_offset: this.getNodeParameter('fromOffset', i, 0),
+            });
+        case 'chat:send':
+            return await sendChatMessage.call(this, guarded, i);
+        case 'account:get':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.GET_ACCOUNT, {});
+        case 'file:getUploadUrl':
+            return await guarded.callTool(tools_1.TENDEM_TOOLS.GET_FILE_UPLOAD_URL, {
+                task_id: this.getNodeParameter('taskId', i),
+            });
+        default:
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unsupported Tendem operation "${key}"`, {
+                itemIndex: i,
+            });
+    }
+}
+async function sendChatMessage(guarded, i) {
+    const taskId = this.getNodeParameter('taskId', i);
+    const text = this.getNodeParameter('text', i);
+    const autoOffset = this.getNodeParameter('autoOffset', i, true);
+    const latestOffset = async () => {
+        const chat = await guarded.callTool(tools_1.TENDEM_TOOLS.READ_CHAT, {
+            task_id: taskId,
+            from_offset: 0,
+        });
+        return typeof chat.last_seen_offset === 'number' ? chat.last_seen_offset : 0;
+    };
+    let offset = autoOffset
+        ? await latestOffset()
+        : this.getNodeParameter('lastSeenOffset', i, 0);
+    let response = await guarded.callTool(tools_1.TENDEM_TOOLS.SEND_MESSAGE, {
+        task_id: taskId,
+        text,
+        last_seen_offset: offset,
+    });
+    if (autoOffset && response.response_type === 'race') {
+        offset =
+            typeof response.last_seen_offset === 'number' ? response.last_seen_offset : await latestOffset();
+        response = await guarded.callTool(tools_1.TENDEM_TOOLS.SEND_MESSAGE, {
+            task_id: taskId,
+            text,
+            last_seen_offset: offset,
+        });
+    }
+    return response;
+}
+async function approveTask(guarded, i) {
+    const taskId = this.getNodeParameter('taskId', i);
+    const taskName = this.getNodeParameter('taskName', i);
+    const price = this.getNodeParameter('price', i);
+    const confirmed = this.getNodeParameter('confirmSpend', i, false);
+    if (confirmed !== true) {
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Refusing to approve a Tendem task: the spend was not confirmed', {
+            itemIndex: i,
+            description: 'Approving charges the Tendem account. Read the scope and price with the "Get Contract" operation, surface it to a human, then enable "Confirm Spend" on this node.',
+        });
+    }
+    if (typeof price !== 'string' || price.trim() === '') {
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Refusing to approve a Tendem task: no price was supplied', {
+            itemIndex: i,
+            description: 'Pass the quoted price through from the Get Task or Get Contract operation, so the approval names the amount being committed.',
+        });
+    }
+    const response = await guarded.callTool(tools_1.TENDEM_TOOLS.APPROVE_TASK, {
+        task_id: taskId,
+        name: taskName,
+        price,
+    });
+    const approvedRaw = response.approved;
+    const approved = typeof approvedRaw === 'boolean' ? approvedRaw : undefined;
+    return {
+        ...response,
+        approved: approved === undefined ? null : approved,
+        spendBlocked: approved === false,
+        topupUrl: typeof response.topup_url === 'string' ? response.topup_url : null,
+    };
+}
+//# sourceMappingURL=Tendem.node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tendem.node.js","sourceRoot":"","sources":["../../../nodes/Tendem/Tendem.node.ts"],"names":[],"mappings":";;;AAAA,+CAWsB;AAEtB,iDASwB;AACxB,2CAKqB;AACrB,mCAA6C;AAC7C,mCAAgF;AAChF,+CAAkD;AAYlD,MAAa,MAAM;IAAnB;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,QAAQ;YACrB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,CAAC,WAAW,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,sDAAsD;YACnE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAE5B,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACpD,UAAU,EAAE;gBACX,4BAAa;gBACb,6BAAc;gBACd,6BAAc;gBACd,gCAAiB;gBACjB,6BAAc;gBACd,GAAG,yBAAU;gBACb,GAAG,yBAAU;gBACb,GAAG,yBAAU;aACb;SACD,CAAC;IAuDH,CAAC;IArDA,KAAK,CAAC,OAAO;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,UAAU,GAAyB,EAAE,CAAC;QAE5C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3D,MAAM,QAAQ,GACb,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;YAC7E,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC7B,CAAC,CAAC,mCAAuB,CAAC;QAE5B,MAAM,SAAS,GAAG,KAAK,EAAE,OAA8B,EAA4B,EAAE,CACpF,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,CACrD,IAAI,EACJ,WAAW,EACX,OAAO,CACP,CAAoB,CAAC;QAEvB,MAAM,OAAO,GAAG,IAAI,sBAAU,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAGxD,MAAM,QAAQ,GAAG,IAAI,0BAAkB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAL,oBAAK,EAAE,CAAC,CAAC;QAE5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAW,CAAC;gBAChE,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAW,CAAC;gBAClE,MAAM,GAAG,GAAG,IAAA,oBAAY,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;gBAI9C,MAAM,OAAO,GAAe,IAAA,gBAAQ,EAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;gBAEpD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;gBAE/D,UAAU,CAAC,IAAI,CACd,GAAG,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE;oBACjF,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;iBACrB,CAAC,CACF,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;oBAC3B,UAAU,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;wBACvE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;qBACvB,CAAC,CAAC;oBACH,SAAS;gBACV,CAAC;gBACD,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;QACF,CAAC;QAED,OAAO,CAAC,UAAU,CAAC,CAAC;IACrB,CAAC;CACD;AA/ED,wBA+EC;AAQD,SAAS,WAAW,CAA0B,KAAc,EAAE,SAAiB;IAC9E,IAAI,KAAK,YAAY,iCAAkB,IAAI,KAAK,YAAY,2BAAY;QAAE,OAAO,KAAK,CAAC;IACvF,OAAO,IAAI,2BAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAmB,EAAE;QAC5D,SAAS;QACT,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC/D,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAE1B,OAAmB,EACnB,GAAW,EACX,CAAS;IAET,QAAQ,GAAG,EAAE,CAAC;QACb,KAAK,aAAa,CAAC,CAAC,CAAC;YACpB,MAAM,IAAI,GAAgB;gBACzB,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAW;gBACpD,WAAW,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAW;aAC9D,CAAC;YACF,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAW,CAAC;YAChF,IAAI,cAAc,KAAK,EAAE;gBAAE,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;YACjE,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;QAED,KAAK,UAAU;YACd,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,QAAQ,EAAE;gBACpD,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW;aACrD,CAAC,CAAC;QAEJ,KAAK,kBAAkB;YACtB,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,YAAY,EAAE;gBACxD,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW;aACrD,CAAC,CAAC;QAEJ,KAAK,cAAc;YAClB,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAEjD,KAAK,aAAa;YACjB,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,WAAW,EAAE;gBACvD,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW;gBACrD,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAW;aACpD,CAAC,CAAC;QAEJ,KAAK,gBAAgB;YACpB,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,eAAe,EAAE;gBAC3D,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW;aACrD,CAAC,CAAC;QAEJ,KAAK,WAAW;YACf,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,UAAU,EAAE;gBACtD,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAW;gBACtD,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAW;aACvD,CAAC,CAAC;QAEJ,KAAK,WAAW,CAAC,CAAC,CAAC;YAClB,MAAM,OAAO,GAAG,MAAM,IAAA,+BAAiB,EACtC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAL,oBAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EACjD;gBACC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW;gBACpD,oBAAoB,EAAE,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,CAAC,EAAE,EAAE,CAAW;gBACpF,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAW;aAC9D,CACD,CAAC;YACF,OAAO;gBACN,GAAG,OAAO,CAAC,IAAI;gBACf,UAAU,EAAE;oBACX,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACtB;aACD,CAAC;QACH,CAAC;QAED,KAAK,WAAW;YACf,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,SAAS,EAAE;gBACrD,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW;gBACrD,WAAW,EAAE,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAW;aAChE,CAAC,CAAC;QAEJ,KAAK,WAAW;YACf,OAAO,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAErD,KAAK,aAAa;YACjB,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE7D,KAAK,mBAAmB;YACvB,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,mBAAmB,EAAE;gBAC/D,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW;aACrD,CAAC,CAAC;QAEJ;YACC,MAAM,IAAI,iCAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,iCAAiC,GAAG,GAAG,EAAE;gBACrF,SAAS,EAAE,CAAC;aACZ,CAAC,CAAC;IACL,CAAC;AACF,CAAC;AAcD,KAAK,UAAU,eAAe,CAE7B,OAAmB,EACnB,CAAS;IAET,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAW,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC,EAAE,IAAI,CAAY,CAAC;IAE3E,MAAM,YAAY,GAAG,KAAK,IAAqB,EAAE;QAChD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,SAAS,EAAE;YAC3D,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,CAAC;SACd,CAAC,CAAC;QACH,OAAO,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC;IAEF,IAAI,MAAM,GAAG,UAAU;QACtB,CAAC,CAAC,MAAM,YAAY,EAAE;QACtB,CAAC,CAAE,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,CAAY,CAAC;IAE7D,IAAI,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,YAAY,EAAE;QAChE,OAAO,EAAE,MAAM;QACf,IAAI;QACJ,gBAAgB,EAAE,MAAM;KACxB,CAAC,CAAC;IAEH,IAAI,UAAU,IAAI,QAAQ,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;QACrD,MAAM;YACL,OAAO,QAAQ,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,YAAY,EAAE,CAAC;QAClG,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,YAAY,EAAE;YAC5D,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,gBAAgB,EAAE,MAAM;SACxB,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAWD,KAAK,UAAU,WAAW,CAEzB,OAAmB,EACnB,CAAS;IAET,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAW,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAW,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAW,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,EAAE,KAAK,CAAY,CAAC;IAE7E,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,iCAAkB,CAC3B,IAAI,CAAC,OAAO,EAAE,EACd,gEAAgE,EAChE;YACC,SAAS,EAAE,CAAC;YACZ,WAAW,EACV,oKAAoK;SACrK,CACD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,iCAAkB,CAC3B,IAAI,CAAC,OAAO,EAAE,EACd,0DAA0D,EAC1D;YACC,SAAS,EAAE,CAAC;YACZ,WAAW,EACV,8HAA8H;SAC/H,CACD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,oBAAY,CAAC,YAAY,EAAE;QAClE,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,QAAQ;QACd,KAAK;KACL,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,OAAO;QACN,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;QAClD,YAAY,EAAE,QAAQ,KAAK,KAAK;QAChC,QAAQ,EAAE,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;KAC5E,CAAC;AACH,CAAC"}

package/dist/nodes/Tendem/Tendem.node.json

@@ -0,0 +1,18 @@
+{
+	"node": "n8n-nodes-tendem.tendem",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Utility", "Productivity"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://github.com/Toloka/tendem-mcp/tree/main/integrations/n8n-nodes-tendem#credentials"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://github.com/Toloka/tendem-mcp/tree/main/integrations/n8n-nodes-tendem"
+			}
+		]
+	}
+}

package/dist/nodes/Tendem/descriptions.d.ts

@@ -0,0 +1,9 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const resourceField: INodeProperties;
+export declare const taskOperations: INodeProperties;
+export declare const chatOperations: INodeProperties;
+export declare const accountOperations: INodeProperties;
+export declare const fileOperations: INodeProperties;
+export declare const taskFields: INodeProperties[];
+export declare const chatFields: INodeProperties[];
+export declare const fileFields: INodeProperties[];