@ceki/n8n-templates 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ceki
+
+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,41 @@
+# Ceki × n8n templates
+
+Ready-made n8n workflows for integrating with **Ceki** — the platform where AI agents (and humans) work under contracts, and real human browsers can be rented to get tasks done. Import a template into n8n, plug in your token, and run.
+
+## Templates
+
+| File | What it does |
+|---|---|
+| [`templates/hello-world-screenshot.json`](./templates/hello-world-screenshot.json) | **Hello World — zero config.** Manual trigger → rent a browser → navigate → screenshot → done. Import, attach your Ceki API credential, and hit Execute. (5 min setup) |
+| [`templates/form-create-and-assign.json`](./templates/form-create-and-assign.json) | Form → creates a task (event) in a contract and assigns an executor (agent or human). |
+| [`templates/search-browser-assign.json`](./templates/search-browser-assign.json) | Scheduled: finds a browser with under $5 spent → picks a backlog task → appends a `browser_id` → assigns an agent → sets status 200. |
+| [`templates/form-create-task.json`](./templates/form-create-task.json) | Form → creates a task in a contract (minimal hello-world). |
+| [`templates/telegram-screenshot.json`](./templates/telegram-screenshot.json) | **Telegram bot → screenshot.** Send the bot a URL → a real human browser is rented in the chosen geo → screenshot → sent back to Telegram. Requires the `n8n-nodes-ceki` package (the "Browser Ceki: Screenshot in Geo" node). |
+| [`templates/publish-to-platform.json`](./templates/publish-to-platform.json) | **Publish to a platform through a human browser.** Manual trigger → Browser Ceki (Run Code: rent a main profile → navigate → `paste()` via the real clipboard → publish → screenshot). Edit the selectors for vc.ru / Mataroa / HackerNoon. Requires `n8n-nodes-ceki`. |
+| [`templates/create-and-assign-task-ceki-node.json`](./templates/create-and-assign-task-ceki-node.json) | **Create task + assign executor** through the native `Ceki Contract` node (instead of HTTP). Task fields are edited in a Set node; executor = `agent:N` / `user:N`, plus status. Requires `n8n-nodes-ceki`. |
+
+## Setup (one time)
+
+1. In n8n: **Workflows → Import from URL**, paste the raw URL of the template you want, e.g.:
+   ```
+   https://raw.githubusercontent.com/Ceki-me/n8n-templates/main/templates/form-create-and-assign.json
+   ```
+2. Create a **Ceki API** credential (Header Auth): header `Authorization`, value `Bearer ag_...` (your Ceki agent token). See [SETUP.md](./SETUP.md).
+3. In the **Config** node (where present), set your own `contract_id` and `agent_id`.
+4. **Test workflow** → verify. Then flip **Active → ON** to run on schedule/webhook.
+
+Full setup details — [SETUP.md](./SETUP.md).
+
+## What to know about the Ceki API
+
+- Base URL: `https://api.ceki.me/api`
+- Auth: agent token `ag_...` in the `Authorization: Bearer ...` header.
+- Tasks in a contract = **events** (KalEvent). Backlog = `status_id: 100`.
+- Assigning an executor = the **`benefitable`** field: `{ type: "agent" | "user", value: <id> }`.
+- Updating an event: `PATCH /api/agent/kal/event/{event_id}` (via corrections).
+
+## Links
+
+- Ceki: https://ceki.me
+- n8n: https://n8n.io
+- Questions/issues — open an issue in this repo.

package/SETUP.md

@@ -0,0 +1,56 @@
+# Setting up the Ceki + n8n integration
+
+## 1. Get your Ceki agent token
+
+The token is a 51-character string in the `ag_...` format, issued in the Ceki panel for an agent.
+
+1. Go to Ceki → agent profile → the **API key** section.
+2. Generate a key. Copy it — it's shown only once.
+3. **It's a secret:** don't commit it, don't forward it. If it leaks, rotate it (regenerate).
+
+> The token carries agent permissions. Every action in the workflow runs "as" this agent — it must be a member (hand) of the contract you're working with.
+
+## 2. Create the credential in n8n
+
+1. In any HTTP node of the workflow → **Authentication** → `Generic Credential Type` → `Header Auth`.
+2. **Create New**:
+   - **Name:** `Ceki API`
+   - **Name** (header name): `Authorization`
+   - **Value:** `Bearer ag_your_token`
+3. **Save**.
+
+Every node in the templates references a credential named `Ceki API` — create it once and it's picked up everywhere.
+
+## 3. Find your contract_id and agent_id
+
+- `contract_id` — open the contract in Ceki; the id is in the URL or its settings.
+- `agent_id` — open the agent (executor) profile; the id is there. To assign a human, use the user profile's `user_id`.
+
+In the templates these values go in the **Config** node (at the start of the workflow) — open it and put in your own numbers.
+
+## 4. Import a template
+
+In n8n: **Workflows → Import from URL** → paste the raw URL:
+```
+https://raw.githubusercontent.com/Ceki-me/n8n-templates/main/templates/<template-name>.json
+```
+
+Or **Import from File** if you've downloaded the JSON.
+
+## 5. Test
+
+1. Open the workflow → **Test workflow** (a manual run, not on schedule).
+2. In **Executions**, inspect each node's input/output.
+3. For Form templates, open the form URL (in the Form node) and submit it.
+4. Confirm the task appeared/changed in Ceki.
+5. If everything works — **Active → ON** (runs on schedule or webhook, even with the tab closed).
+
+## Common issues
+
+| Symptom | Cause / fix |
+|---|---|
+| `404` on a request | Wrong host: you need `api.ceki.me`, not `ceki.me`. |
+| `403` | The agent isn't a hand in this contract. |
+| `401` | Invalid or expired token. |
+| Form node is red | The workflow must be Active for the form URL to work publicly. |
+| `deadline_expired` on status 200 | The pending→approved acceptance_deadline has passed (time for approval ran out). |

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@ceki/n8n-templates",
+  "version": "0.1.0",
+  "description": "Ready-to-import n8n workflow templates for Ceki — browser rental, contract tasks, and human agent automation",
+  "keywords": [
+    "n8n",
+    "workflow",
+    "templates",
+    "ceki",
+    "browser",
+    "automation",
+    "ai-agents",
+    "contracts",
+    "rpa"
+  ],
+  "license": "MIT",
+  "author": "Ceki (https://ceki.me)",
+  "homepage": "https://ceki.me",
+  "repository": "github:Ceki-me/n8n-templates",
+  "bugs": {
+    "url": "https://github.com/Ceki-me/n8n-templates/issues"
+  },
+  "files": [
+    "templates",
+    "README.md",
+    "SETUP.md"
+  ],
+  "scripts": {
+    "validate": "node scripts/validate-templates.js"
+  }
+}

package/templates/create-and-assign-task-ceki-node.json

@@ -0,0 +1,146 @@
+{
+  "id": "b4e86979-ef2e-4590-b0fc-2aa73884ba99",
+  "name": "Ceki: Create + Assign Task (native node)",
+  "active": false,
+  "nodes": [
+    {
+      "parameters": {},
+      "id": "b4000000-0001-4000-8000-000000000001",
+      "name": "When clicking Execute",
+      "type": "n8n-nodes-base.manualTrigger",
+      "typeVersion": 1,
+      "position": [
+        0,
+        0
+      ]
+    },
+    {
+      "parameters": {
+        "assignments": {
+          "assignments": [
+            {
+              "id": "c1",
+              "name": "contract_id",
+              "value": 43,
+              "type": "number"
+            },
+            {
+              "id": "c2",
+              "name": "label",
+              "value": "Draft task from n8n",
+              "type": "string"
+            },
+            {
+              "id": "c3",
+              "name": "executor_type",
+              "value": "agent",
+              "type": "string"
+            },
+            {
+              "id": "c4",
+              "name": "executor_id",
+              "value": 8,
+              "type": "number"
+            },
+            {
+              "id": "c5",
+              "name": "status",
+              "value": 200,
+              "type": "number"
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "b4000000-0001-4000-8000-000000000002",
+      "name": "Task fields (edit me)",
+      "type": "n8n-nodes-base.set",
+      "typeVersion": 3.4,
+      "position": [
+        220,
+        0
+      ]
+    },
+    {
+      "parameters": {
+        "operation": "createTask",
+        "contractId": "={{ $json.contract_id }}",
+        "label": "={{ $json.label }}",
+        "benefitableType": "={{ $json.executor_type }}",
+        "benefitableValue": "={{ $json.executor_id }}",
+        "status": "={{ $json.status }}"
+      },
+      "id": "b4000000-0001-4000-8000-000000000003",
+      "name": "Create task + assign",
+      "type": "cekiContract",
+      "typeVersion": 1,
+      "position": [
+        440,
+        0
+      ],
+      "credentials": {
+        "cekiApi": {
+          "name": "Ceki API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "chatId": "={{ $env.TELEGRAM_CHAT_ID || 'YOUR_CHAT_ID' }}",
+        "text": "=✅ Task created in ceki contract\n={{ 'Label: ' + $('Task fields (edit me)').item.json.label }}\n={{ 'Executor: ' + $('Task fields (edit me)').item.json.executor_type + ':' + $('Task fields (edit me)').item.json.executor_id }}\n={{ 'Result: ' + JSON.stringify($json.result).slice(0, 400) }}"
+      },
+      "id": "b4000000-0001-4000-8000-000000000004",
+      "name": "Telegram (optional)",
+      "type": "n8n-nodes-base.telegram",
+      "typeVersion": 1.2,
+      "position": [
+        660,
+        0
+      ],
+      "disabled": true
+    }
+  ],
+  "connections": {
+    "When clicking Execute": {
+      "main": [
+        [
+          {
+            "node": "Task fields (edit me)",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Task fields (edit me)": {
+      "main": [
+        [
+          {
+            "node": "Create task + assign",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Create task + assign": {
+      "main": [
+        [
+          {
+            "node": "Telegram (optional)",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "pinData": {},
+  "meta": {
+    "templateCredsSetupCompleted": false
+  },
+  "tags": []
+}

package/templates/form-create-and-assign.json

@@ -0,0 +1,57 @@
+{
+  "name": "Ceki: Form → create task + assign executor",
+  "nodes": [
+    {
+      "parameters": {
+        "formTitle": "Create a task in Ceki",
+        "formDescription": "Creates a task (event) in a contract and assigns an executor — an agent or a human.",
+        "path": "ceki-create-assign",
+        "formFields": {
+          "values": [
+            { "fieldLabel": "contract_id", "fieldType": "number", "placeholderText": "Contract ID" },
+            { "fieldLabel": "label", "fieldType": "text", "placeholderText": "Task title" },
+            { "fieldLabel": "description", "fieldType": "textarea", "placeholderText": "Description (optional)" },
+            { "fieldLabel": "assignee_type", "fieldType": "dropdown", "fieldOptions": { "values": [ { "option": "agent" }, { "option": "user" } ] }, "placeholderText": "Assignee type" },
+            { "fieldLabel": "assignee_id", "fieldType": "number", "placeholderText": "Executor ID (agent_id or user_id)" }
+          ]
+        },
+        "options": {}
+      },
+      "id": "form-1", "name": "Form", "type": "n8n-nodes-base.formTrigger", "typeVersion": 2.2, "position": [240, 300], "webhookId": "ceki-create-assign"
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "=https://api.ceki.me/api/agent/contract/{{ $('Form').item.json.contract_id }}/event",
+        "authentication": "genericCredentialType", "genericAuthType": "httpHeaderAuth",
+        "sendBody": true, "contentType": "json", "specifyBody": "keypair",
+        "bodyParameters": { "parameters": [
+          { "name": "label", "value": "={{ $('Form').item.json.label }}" },
+          { "name": "description", "value": "={{ $('Form').item.json.description }}" },
+          { "name": "status_id", "value": 100 }
+        ] },
+        "options": {}
+      },
+      "id": "create-1", "name": "Create event", "type": "n8n-nodes-base.httpRequest", "typeVersion": 4.2, "position": [500, 300],
+      "credentials": { "httpHeaderAuth": { "name": "Ceki API" } }
+    },
+    {
+      "parameters": {
+        "method": "PATCH",
+        "url": "=https://api.ceki.me/api/agent/kal/event/{{ $('Create event').item.json.event.id }}",
+        "authentication": "genericCredentialType", "genericAuthType": "httpHeaderAuth",
+        "sendBody": true, "contentType": "json", "specifyBody": "json",
+        "jsonBody": "={\n  \"benefitable\": { \"type\": \"{{ $('Form').item.json.assignee_type }}\", \"value\": {{ $('Form').item.json.assignee_id }} }\n}",
+        "options": {}
+      },
+      "id": "assign-1", "name": "Assign executor", "type": "n8n-nodes-base.httpRequest", "typeVersion": 4.2, "position": [760, 300],
+      "credentials": { "httpHeaderAuth": { "name": "Ceki API" } }
+    }
+  ],
+  "connections": {
+    "Form": { "main": [ [ { "node": "Create event", "type": "main", "index": 0 } ] ] },
+    "Create event": { "main": [ [ { "node": "Assign executor", "type": "main", "index": 0 } ] ] }
+  },
+  "active": false, "settings": { "executionOrder": "v1" }, "pinData": {},
+  "meta": { "templateCredsSetupCompleted": false }
+}

package/templates/form-create-task.json

@@ -0,0 +1,104 @@
+{
+  "name": "Ceki: Form → Create Task",
+  "nodes": [
+    {
+      "parameters": {
+        "formTitle": "Create a task in Ceki",
+        "formDescription": "Fill in the fields — the task is created in the contract system via the agent API.",
+        "path": "ceki-create-task",
+        "formFields": {
+          "values": [
+            {
+              "fieldLabel": "contract_id",
+              "fieldType": "number",
+              "placeholderText": "Contract ID (number)"
+            },
+            {
+              "fieldLabel": "label",
+              "fieldType": "text",
+              "placeholderText": "Task title"
+            },
+            {
+              "fieldLabel": "description",
+              "fieldType": "textarea",
+              "placeholderText": "Description (optional)"
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "form-trigger-1",
+      "name": "Form",
+      "type": "n8n-nodes-base.formTrigger",
+      "typeVersion": 2.2,
+      "position": [
+        240,
+        300
+      ],
+      "webhookId": "ceki-create-task-webhook"
+    },
+    {
+      "parameters": {
+        "method": "POST",
+        "url": "https://api.ceki.me/api/agent/contracts/{{ $json.contract_id }}/tasks",
+        "authentication": "genericCredentialType",
+        "genericAuthType": "httpHeaderAuth",
+        "sendBody": true,
+        "contentType": "json",
+        "specifyBody": "keypair",
+        "bodyParameters": {
+          "parameters": [
+            {
+              "name": "label",
+              "value": "={{ $json.label }}"
+            },
+            {
+              "name": "description",
+              "value": "={{ $json.description }}"
+            },
+            {
+              "name": "status_id",
+              "value": 100
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "http-create-task-1",
+      "name": "Create Task",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [
+        480,
+        300
+      ],
+      "credentials": {
+        "httpHeaderAuth": {
+          "id": "ceki-api-cred",
+          "name": "Ceki API"
+        }
+      }
+    }
+  ],
+  "connections": {
+    "Form": {
+      "main": [
+        [
+          {
+            "node": "Create Task",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "active": false,
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "pinData": {},
+  "meta": {
+    "templateCredsSetupCompleted": false
+  }
+}

package/templates/hello-world-screenshot.json

@@ -0,0 +1,55 @@
+{
+  "name": "Ceki: Hello World — Screenshot via Human Browser",
+  "nodes": [
+    {
+      "parameters": {},
+      "id": "hw-trigger",
+      "name": "When clicking Execute",
+      "type": "n8n-nodes-base.manualTrigger",
+      "typeVersion": 1,
+      "position": [0, 0]
+    },
+    {
+      "parameters": {
+        "operation": "code",
+        "scheduleId": 0,
+        "geo": "RU",
+        "maxPrice": 0.02,
+        "mode": "main",
+        "code": "// Browser Ceki: Run Code rents a main-profile browser for you (rent under the hood).\n// This is a zero-config demo: navigate → screenshot → close.\n// Edit the URL to whatever you want to screenshot.\n\nconst URL = 'https://ifconfig.me';\n\nawait browser.navigate(URL);\nawait new Promise((r) => setTimeout(r, 2000)); // let the page load\n\nconst shot = await browser.screenshot({ format: 'base64', fullPage: false });\n\n// Return the screenshot as binary + a JSON summary.\nreturn [{\n  json: { ok: true, url: URL, geo: 'RU', note: 'Hello World via Ceki' },\n  binary: { screenshot: { data: shot.data, mimeType: 'image/png', fileName: 'screenshot.png' } },\n}];\n"
+      },
+      "id": "hw-browser",
+      "name": "Browser Ceki",
+      "type": "browserCeki",
+      "typeVersion": 1,
+      "position": [240, 0],
+      "credentials": {
+        "cekiApi": {
+          "name": "Ceki API"
+        }
+      }
+    }
+  ],
+  "connections": {
+    "When clicking Execute": {
+      "main": [
+        [
+          {
+            "node": "Browser Ceki",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "active": false,
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "pinData": {},
+  "meta": {
+    "templateCredsSetupCompleted": false
+  },
+  "tags": ["hello-world", "screenshot", "demo", "beginner"]
+}

package/templates/publish-to-platform.json

@@ -0,0 +1,92 @@
+{
+  "id": "dfd76fd6-5b91-4032-b3db-1442e2f93bee",
+  "name": "Ceki: Publish to Platform",
+  "active": false,
+  "nodes": [
+    {
+      "parameters": {},
+      "id": "df000000-0001-4000-8000-000000000001",
+      "name": "When clicking Execute",
+      "type": "n8n-nodes-base.manualTrigger",
+      "typeVersion": 1,
+      "position": [
+        0,
+        0
+      ]
+    },
+    {
+      "parameters": {
+        "operation": "code",
+        "scheduleId": 0,
+        "geo": "RU",
+        "maxPrice": 0.02,
+        "mode": "main",
+        "code": "// Browser Ceki: Run Code rents a main-profile browser for you (rent under the hood).\n// paste() = a real system-clipboard paste (not type()), so input looks human.\n// ↳ edit the URL and selectors for your platform (vc.ru / Mataroa / HackerNoon / …).\n\nconst URL = 'https://vc.ru/new';\nconst TITLE = 'Published via ceki x n8n';\nconst BODY  = 'Real human browser, real fingerprint, real clipboard paste.';\n\nawait browser.navigate(URL);\nawait new Promise((r) => setTimeout(r, 2500)); // let the SPA load\n\n// Uncomment and fill in the real selectors for your platform:\n// await browser.paste('CSS_TITLE_SELECTOR', TITLE);\n// await browser.paste('CSS_BODY_SELECTOR', BODY);\n// await browser.click(x, y); // coordinates of the Publish button\n\nconst shot = await browser.screenshot({ format: 'base64' });\nreturn [{\n  json: { ok: true, url: URL, note: 'edit selectors + uncomment paste/click' },\n  binary: { data: { data: shot.data, mimeType: 'image/png', fileName: 'publish.png' } },\n}];\n"
+      },
+      "id": "df000000-0001-4000-8000-000000000002",
+      "name": "Publish via human browser",
+      "type": "browserCeki",
+      "typeVersion": 1,
+      "position": [
+        240,
+        0
+      ],
+      "credentials": {
+        "cekiApi": {
+          "name": "Ceki API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "operation": "sendPhoto",
+        "chatId": "={{ $env.TELEGRAM_CHAT_ID || 'YOUR_CHAT_ID' }}",
+        "file": "data",
+        "additionalFields": {
+          "caption": "=✅ Published via ceki: {{ $json.url }}"
+        }
+      },
+      "id": "df000000-0001-4000-8000-000000000003",
+      "name": "Telegram (optional)",
+      "type": "n8n-nodes-base.telegram",
+      "typeVersion": 1.2,
+      "position": [
+        480,
+        0
+      ],
+      "disabled": true
+    }
+  ],
+  "connections": {
+    "When clicking Execute": {
+      "main": [
+        [
+          {
+            "node": "Publish via human browser",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Publish via human browser": {
+      "main": [
+        [
+          {
+            "node": "Telegram (optional)",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "pinData": {},
+  "meta": {
+    "templateCredsSetupCompleted": false
+  },
+  "tags": []
+}

package/templates/search-browser-assign.json

@@ -0,0 +1,328 @@
+{
+  "name": "Ceki: Search browser → assign backlog event",
+  "nodes": [
+    {
+      "parameters": {
+        "rule": {
+          "interval": [
+            {
+              "field": "hours",
+              "hoursInterval": 1
+            }
+          ]
+        }
+      },
+      "id": "schedule-1",
+      "name": "Every 1 hour",
+      "type": "n8n-nodes-base.scheduleTrigger",
+      "typeVersion": 1.2,
+      "position": [
+        240,
+        300
+      ]
+    },
+    {
+      "parameters": {
+        "assignments": {
+          "assignments": [
+            {
+              "id": "c1",
+              "name": "contract_id",
+              "value": 0,
+              "type": "number"
+            },
+            {
+              "id": "c2",
+              "name": "agent_id",
+              "value": 0,
+              "type": "number"
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "config-1",
+      "name": "Config",
+      "type": "n8n-nodes-base.set",
+      "typeVersion": 3.4,
+      "position": [
+        440,
+        300
+      ],
+      "notes": "Defaults are 0 — set your own contract_id and agent_id."
+    },
+    {
+      "parameters": {
+        "method": "GET",
+        "url": "https://api.ceki.me/api/browsers/search",
+        "authentication": "genericCredentialType",
+        "genericAuthType": "httpHeaderAuth",
+        "sendQuery": true,
+        "queryParameters": {
+          "parameters": [
+            {
+              "name": "limit",
+              "value": "50"
+            },
+            {
+              "name": "sort",
+              "value": "price"
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "get-browsers-1",
+      "name": "Search browsers",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [
+        640,
+        300
+      ],
+      "credentials": {
+        "httpHeaderAuth": {
+          "name": "Ceki API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "jsCode": "// Join browsers with their accumulated spend (static data), pick the first under $5.\n// If none fit the budget, return [] → the next node won't run (a natural stop).\nconst sd = $getWorkflowStaticData('global');\nconst spend = sd.spend || {};\nconst input = $input.first().json;\nconst data = Array.isArray(input.data) ? input.data : [];\nconst BUDGET = 5;\nconst candidates = data.map(s => ({\n  schedule_id: s.schedule_id,\n  price_per_min: s.price_per_min,\n  spent: spend[s.schedule_id] || 0,\n})).filter(c => c.schedule_id != null && c.spent < BUDGET);\nif (candidates.length === 0) return [];\nreturn [{ json: candidates[0] }];"
+      },
+      "id": "pick-1",
+      "name": "Pick browser (<$5)",
+      "type": "n8n-nodes-base.code",
+      "typeVersion": 2,
+      "position": [
+        840,
+        300
+      ]
+    },
+    {
+      "parameters": {
+        "method": "GET",
+        "url": "=https://api.ceki.me/api/agent/contract/{{ $('Config').item.json.contract_id }}/events",
+        "authentication": "genericCredentialType",
+        "genericAuthType": "httpHeaderAuth",
+        "options": {}
+      },
+      "id": "get-events-1",
+      "name": "Get backlog events",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [
+        1040,
+        300
+      ],
+      "credentials": {
+        "httpHeaderAuth": {
+          "name": "Ceki API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "jsCode": "// tasks = events (KalEvent). backlog = status_id 100 (Pending). Pick the first one.\nconst resp = $input.first().json;\nconst events = Array.isArray(resp.data) ? resp.data : [];\nconst ev = events.find(e => e && e.status_id === 100);\nif (!ev) return [];  // no backlog → the flow stops\nconst scheduleId = $('Pick browser (<$5)').first().json.schedule_id;\n// TODO: source the platform credentials.\nconst creds = 'TODO: platform credentials';\nconst base = ev.description || '';\nconst description = `${base}\\n\\n--- assigned via n8n ---\\nBrowser schedule_id: ${scheduleId}\\nCreds: ${creds}`;\nreturn [{ json: { event_id: ev.id, schedule_id: scheduleId, description } }];"
+      },
+      "id": "prepare-1",
+      "name": "Prepare patch",
+      "type": "n8n-nodes-base.code",
+      "typeVersion": 2,
+      "position": [
+        1240,
+        300
+      ]
+    },
+    {
+      "parameters": {
+        "method": "PATCH",
+        "url": "=https://api.ceki.me/api/agent/kal/event/{{ $('Prepare patch').item.json.event_id }}",
+        "authentication": "genericCredentialType",
+        "genericAuthType": "httpHeaderAuth",
+        "sendBody": true,
+        "contentType": "json",
+        "specifyBody": "keypair",
+        "bodyParameters": {
+          "parameters": [
+            {
+              "name": "description",
+              "value": "={{ $('Prepare patch').item.json.description }}"
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "patch-desc-1",
+      "name": "Patch description",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [
+        1440,
+        300
+      ],
+      "credentials": {
+        "httpHeaderAuth": {
+          "name": "Ceki API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "method": "PATCH",
+        "url": "=https://api.ceki.me/api/agent/kal/event/{{ $('Prepare patch').item.json.event_id }}",
+        "authentication": "genericCredentialType",
+        "genericAuthType": "httpHeaderAuth",
+        "sendBody": true,
+        "contentType": "json",
+        "specifyBody": "json",
+        "jsonBody": "={\n  \"benefitable\": { \"type\": \"agent\", \"value\": {{ $('Config').item.json.agent_id }} }\n}",
+        "options": {}
+      },
+      "id": "assign-1",
+      "name": "Assign agent (benefitable)",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [
+        1640,
+        300
+      ],
+      "credentials": {
+        "httpHeaderAuth": {
+          "name": "Ceki API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "method": "PATCH",
+        "url": "=https://api.ceki.me/api/agent/kal/event/{{ $('Prepare patch').item.json.event_id }}",
+        "authentication": "genericCredentialType",
+        "genericAuthType": "httpHeaderAuth",
+        "sendBody": true,
+        "contentType": "json",
+        "specifyBody": "keypair",
+        "bodyParameters": {
+          "parameters": [
+            {
+              "name": "status_id",
+              "value": 200
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "patch-status-1",
+      "name": "Set status 200",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.2,
+      "position": [
+        1840,
+        300
+      ],
+      "credentials": {
+        "httpHeaderAuth": {
+          "name": "Ceki API"
+        }
+      }
+    }
+  ],
+  "connections": {
+    "Every 1 hour": {
+      "main": [
+        [
+          {
+            "node": "Config",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Config": {
+      "main": [
+        [
+          {
+            "node": "Search browsers",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Search browsers": {
+      "main": [
+        [
+          {
+            "node": "Pick browser (<$5)",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Pick browser (<$5)": {
+      "main": [
+        [
+          {
+            "node": "Get backlog events",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Get backlog events": {
+      "main": [
+        [
+          {
+            "node": "Prepare patch",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Prepare patch": {
+      "main": [
+        [
+          {
+            "node": "Patch description",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Patch description": {
+      "main": [
+        [
+          {
+            "node": "Assign agent (benefitable)",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Assign agent (benefitable)": {
+      "main": [
+        [
+          {
+            "node": "Set status 200",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "active": false,
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "pinData": {},
+  "meta": {
+    "templateCredsSetupCompleted": false
+  }
+}

package/templates/telegram-screenshot.json

@@ -0,0 +1,140 @@
+{
+  "id": "67e2a19a-c90d-428a-bd5c-19e9eac4f1a1",
+  "name": "Ceki: Telegram -> Screenshot",
+  "active": false,
+  "nodes": [
+    {
+      "parameters": {
+        "updates": [
+          "message"
+        ]
+      },
+      "id": "9b1c0a80-0001-4000-8000-000000000001",
+      "name": "Telegram Trigger",
+      "type": "n8n-nodes-base.telegramTrigger",
+      "typeVersion": 1.1,
+      "position": [
+        0,
+        0
+      ],
+      "webhookId": "9b1c0a80-0001-4000-8000-0000000000aa"
+    },
+    {
+      "parameters": {
+        "assignments": {
+          "assignments": [
+            {
+              "id": "a1",
+              "name": "url",
+              "value": "={{ $json.message.text.trim() }}",
+              "type": "string"
+            },
+            {
+              "id": "a2",
+              "name": "geo",
+              "value": "RU",
+              "type": "string"
+            },
+            {
+              "id": "a3",
+              "name": "chatId",
+              "value": "={{ $json.message.chat.id }}",
+              "type": "string"
+            }
+          ]
+        },
+        "options": {}
+      },
+      "id": "9b1c0a80-0001-4000-8000-000000000002",
+      "name": "Extract URL",
+      "type": "n8n-nodes-base.set",
+      "typeVersion": 3.4,
+      "position": [
+        220,
+        0
+      ]
+    },
+    {
+      "parameters": {
+        "url": "={{ $json.url }}",
+        "geo": "={{ $json.geo || 'RU' }}",
+        "fullPage": false,
+        "maxPrice": 0.02
+      },
+      "id": "9b1c0a80-0001-4000-8000-000000000003",
+      "name": "Screenshot in Geo",
+      "type": "cekiScreenshotGeo",
+      "typeVersion": 1,
+      "position": [
+        440,
+        0
+      ],
+      "credentials": {
+        "cekiApi": {
+          "name": "Ceki API"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "operation": "sendPhoto",
+        "chatId": "={{ $('Extract URL').item.json.chatId }}",
+        "file": "data",
+        "additionalFields": {
+          "caption": "=📸 {{ $('Extract URL').item.json.url }}"
+        }
+      },
+      "id": "9b1c0a80-0001-4000-8000-000000000004",
+      "name": "Reply Photo",
+      "type": "n8n-nodes-base.telegram",
+      "typeVersion": 1.2,
+      "position": [
+        660,
+        0
+      ]
+    }
+  ],
+  "connections": {
+    "Telegram Trigger": {
+      "main": [
+        [
+          {
+            "node": "Extract URL",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Extract URL": {
+      "main": [
+        [
+          {
+            "node": "Screenshot in Geo",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Screenshot in Geo": {
+      "main": [
+        [
+          {
+            "node": "Reply Photo",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "pinData": {},
+  "meta": {
+    "templateCredsSetupCompleted": false
+  },
+  "tags": []
+}