node-red-contrib-copilot 0.0.1

package/README.md

@@ -0,0 +1,223 @@
+# node-red-contrib-copilot
+
+![node-red-contrib-copilot](https://img.shields.io/npm/v/node-red-contrib-copilot?label=npm)
+![Node-RED](https://img.shields.io/badge/node--red-%3E%3D3.0.0-red)
+![License](https://img.shields.io/badge/license-ISC-blue)
+
+Embed GitHub Copilot into your Node-RED flows. Send prompts and file attachments to any Copilot model and wire the response into the rest of your automation.
+
+Built on the [`@github/copilot-sdk`](https://github.com/github/copilot-sdk) — the same engine that powers Copilot CLI.
+
+---
+
+## Requirements
+
+### GitHub Copilot subscription
+
+A GitHub Copilot subscription is required. A free tier with limited usage is available — see [GitHub Copilot pricing](https://github.com/features/copilot#pricing).
+
+### Authentication
+
+Two methods are supported:
+
+| Method | When to use |
+|--------|-------------|
+| **OAuth (default)** | You are logged in via `gh auth login` or the Copilot CLI on the host machine |
+| **Fine-grained PAT** | Headless / containerised deployments; token must have the **Copilot Requests** permission |
+
+> ⚠️ Classic PATs with the `copilot` scope do **not** work. You must use a fine-grained PAT with **Copilot Requests** permission.
+
+### Node.js
+
+**Node.js v24** is required. The `@github/copilot` CLI binary bundled with the SDK is a native binary that requires a glibc-based (non-musl) environment.
+
+---
+
+## Docker
+
+The recommended container is:
+
+```
+nodered/node-red-dev:5.0.0-beta.3-debian
+```
+
+This image provides:
+- Node-RED 5.0 (beta)
+- **Node.js v24** — required by the bundled Copilot CLI binary
+- **Debian (glibc)** — the CLI binary is dynamically linked against glibc; Alpine (musl) is **not** supported
+
+### Quick start
+
+```bash
+docker run -d \
+  --name nodered \
+  -p 1880:1880 \
+  -v /your/data:/data \
+  nodered/node-red-dev:5.0.0-beta.3-debian
+```
+
+---
+
+## Installation
+
+### Via the Node-RED Palette Manager
+
+Search for `node-red-contrib-copilot` in the Palette Manager and click **Install**.
+
+### Via npm (inside your Node-RED data directory)
+
+```bash
+cd /your/node-red/data
+npm install node-red-contrib-copilot
+```
+
+### In Docker
+
+```bash
+docker exec nodered npm install node-red-contrib-copilot --prefix /data
+docker restart nodered
+```
+
+---
+
+## Nodes
+
+### `copilot-config` (configuration node)
+
+Holds credentials and connection settings. Referenced by one or more `copilot` nodes.
+
+| Field | Description |
+|-------|-------------|
+| **Name** | Label for this configuration |
+| **Auth method** | `oauth` — use locally stored `gh` credentials; `token` — use a fine-grained PAT |
+| **Token** | Fine-grained PAT with **Copilot Requests** permission (only when auth method is `token`) |
+| **CLI Path** | Override the path to the `copilot` binary (leave blank to use the bundled binary) |
+| **CLI URL** | Connect to an external CLI server instead of spawning a local process |
+
+### `copilot` (prompt node)
+
+Sends a prompt to GitHub Copilot and emits the response.
+
+#### Inputs
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `msg.payload` | `string` | Plain string used as the prompt |
+| `msg.payload` | `object` | `{ prompt: string, attachments: Attachment[] }` |
+| `msg.attachments` | `Attachment[]` | Merged with any attachments in `msg.payload` |
+| `msg.model` | `string` | Override the model for this message only |
+
+#### Attachment formats
+
+```js
+// File path (passed directly to the SDK)
+{ type: "file", path: "/absolute/path/to/file.png" }
+
+// Base64-encoded data
+{ type: "base64", data: "<base64 string>", name: "image.jpg" }
+
+// Node.js Buffer
+{ type: "buffer", data: Buffer.from(...), name: "file.bin" }
+
+// Shorthand — type is inferred as "file"
+{ path: "/absolute/path/to/file.txt" }
+```
+
+#### Outputs
+
+| Output | Property | Type | Description |
+|--------|----------|------|-------------|
+| **1 — Response** | `msg.payload` | `string` | The assistant's response text |
+| | `msg.sessionId` | `string` | Copilot session ID |
+| | `msg.events` | `array` | All events emitted during the session |
+| **2 — Error** | `msg.payload` | `string` | Error message |
+| | `msg.error` | `Error` | The error object |
+
+#### Node configuration
+
+| Field | Description |
+|-------|-------------|
+| **Config** | Select a `copilot-config` node |
+| **Model** | Dynamically populated from the API — shows token cost multiplier, e.g. `claude-haiku-4.5 (0x)` |
+| **Reasoning** | Reasoning effort hint: `low`, `medium`, `high`, `xhigh` (model-dependent) |
+| **Timeout** | Request timeout in milliseconds (default: 60,000) |
+
+---
+
+## Architecture
+
+```
+Node-RED flow
+      ↓
+ copilot node
+      ↓
+@github/copilot-sdk (Node.js)
+      ↓  JSON-RPC
+Copilot CLI (bundled, spawned as subprocess)
+      ↓  HTTPS
+GitHub Copilot API
+```
+
+The SDK manages the CLI process lifecycle automatically. The CLI binary is bundled with the `@github/copilot` package (a dependency of `@github/copilot-sdk`) and is resolved automatically at startup — no manual PATH configuration needed.
+
+---
+
+## Example flow
+
+```json
+[
+  { "id": "cfg1", "type": "copilot-config", "name": "My Copilot", "authMethod": "token" },
+  { "id": "inj1", "type": "inject", "payload": "What is the capital of France?", "payloadType": "str", "wires": [["prompt1"]] },
+  { "id": "prompt1", "type": "copilot-prompt", "copilotConfig": "cfg1", "model": "gpt-4.1", "wires": [["dbg1"], ["err1"]] },
+  { "id": "dbg1", "type": "debug", "complete": "payload" },
+  { "id": "err1", "type": "debug", "complete": "payload" }
+]
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/yourname/node-red-contrib-copilot
+cd node-red-contrib-copilot
+npm install
+
+# Unit tests (mocked, no API key required)
+npm test
+
+# Integration tests (real API — requires a fine-grained PAT)
+GITHUB_TOKEN=<your-fine-grained-pat> npm run test:integration
+```
+
+### Deploying to Docker during development
+
+```bash
+npm pack
+cp node-red-contrib-copilot-*.tgz ~/your/node-red/data/
+docker exec nodered npm install /data/node-red-contrib-copilot-*.tgz --prefix /data
+docker restart nodered
+```
+
+---
+
+## Dependencies
+
+| Package | Role |
+|---------|------|
+| [`@github/copilot-sdk`](https://www.npmjs.com/package/@github/copilot-sdk) `0.1.30` | Copilot client — session management, model listing, prompt dispatch |
+| [`@github/copilot`](https://www.npmjs.com/package/@github/copilot) | Copilot CLI binary (bundled, installed transitively via the SDK) |
+
+---
+
+## Billing
+
+Each prompt counts against your Copilot premium request quota. The model dropdown shows each model's cost multiplier (e.g. `(0x)` = free/included, `(1x)` = one premium request). See [Requests in GitHub Copilot](https://docs.github.com/en/copilot/concepts/billing/copilot-requests) for details.
+
+---
+
+## License
+
+ISC
+
+Icon derived from [primer/octicons](https://github.com/primer/octicons) — MIT License © GitHub, Inc.

package/index.js

@@ -0,0 +1,6 @@
+'use strict';
+
+module.exports = function (RED) {
+    require('./nodes/copilot-config/copilot-config')(RED);
+    require('./nodes/copilot-prompt/copilot-prompt')(RED);
+};

package/nodes/copilot-config/copilot-config.html

@@ -0,0 +1,69 @@
+<script type="text/javascript">
+    RED.nodes.registerType('copilot-config', {
+        category: 'config',
+        defaults: {
+            name: { value: '' },
+            authMethod: { value: 'oauth' },
+            cliPath: { value: '' },
+            cliUrl: { value: '' },
+        },
+        credentials: {
+            githubToken: { type: 'password' },
+        },
+        label: function () {
+            return this.name || 'GitHub Copilot';
+        },
+        oneditprepare: function () {
+            function toggleTokenField() {
+                const method = $('#node-config-input-authMethod').val();
+                $('#copilot-token-row').toggle(method === 'token');
+            }
+            $('#node-config-input-authMethod').on('change', toggleTokenField);
+            toggleTokenField();
+        },
+    });
+</script>
+
+<script type="text/html" data-template-name="copilot-config">
+    <div class="form-row">
+        <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-config-input-name" placeholder="GitHub Copilot">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-authMethod"><i class="fa fa-lock"></i> Auth</label>
+        <select id="node-config-input-authMethod">
+            <option value="oauth">GitHub OAuth (logged-in user)</option>
+            <option value="token">Personal Access Token</option>
+        </select>
+    </div>
+    <div class="form-row" id="copilot-token-row">
+        <label for="node-config-input-githubToken"><i class="fa fa-key"></i> Token</label>
+        <input type="password" id="node-config-input-githubToken" placeholder="ghp_...">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-cliPath"><i class="fa fa-terminal"></i> CLI Path</label>
+        <input type="text" id="node-config-input-cliPath" placeholder="(optional) /path/to/copilot">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-cliUrl"><i class="fa fa-link"></i> CLI URL</label>
+        <input type="text" id="node-config-input-cliUrl" placeholder="(optional) localhost:8080">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="copilot-config">
+    <p>Configuration node for GitHub Copilot.</p>
+    <h3>Properties</h3>
+    <dl class="message-properties">
+        <dt>Auth <span class="property-type">select</span></dt>
+        <dd>
+            <b>GitHub OAuth</b> — uses credentials stored by the Copilot CLI (<code>gh auth login</code>). No token needed.<br>
+            <b>Personal Access Token</b> — fallback for environments where OAuth isn't set up.
+        </dd>
+        <dt>Token <span class="property-type">password</span></dt>
+        <dd>Required when Auth is set to <em>Personal Access Token</em>. Stored as a credential and never sent to the browser.</dd>
+        <dt>CLI Path <span class="property-type">string</span></dt>
+        <dd>Optional override for the <code>copilot</code> CLI binary. Defaults to the bundled binary in <code>node_modules</code>.</dd>
+        <dt>CLI URL <span class="property-type">string</span></dt>
+        <dd>Optional URL of an existing Copilot CLI server (e.g. <code>localhost:8080</code>). When set, no CLI process is spawned.</dd>
+    </dl>
+</script>

package/nodes/copilot-config/copilot-config.js

@@ -0,0 +1,131 @@
+'use strict';
+
+// @github/copilot-sdk is ESM-only — must be loaded with dynamic import(), not require().
+// _sdk.load is exposed so tests can inject a mock without needing proxyquire.
+const _sdk = {
+    load: () => import('@github/copilot-sdk'),
+};
+
+// Resolve the copilot CLI binary bundled with @github/copilot, which is
+// a dependency of @github/copilot-sdk. Using __dirname keeps this reliable
+// regardless of how the module is loaded, and works inside Docker volumes.
+function resolveBundledCliPath() {
+    const path = require('path');
+    const fs = require('fs');
+    // Walk up from this file through each node_modules search path until we find
+    // @github/copilot — works in dev (nested) and flat container installs alike.
+    let dir = __dirname;
+    while (true) {
+        const pkgJsonPath = path.join(dir, 'node_modules', '@github', 'copilot', 'package.json');
+        if (fs.existsSync(pkgJsonPath)) {
+            try {
+                const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+                const binEntry = pkgJson.bin && (pkgJson.bin.copilot || Object.values(pkgJson.bin)[0]);
+                if (binEntry) {
+                    const resolved = path.resolve(path.dirname(pkgJsonPath), binEntry);
+                    if (fs.existsSync(resolved)) return resolved;
+                }
+            } catch (_) { /* fall through */ }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) break; // reached filesystem root
+        dir = parent;
+    }
+    return 'copilot'; // last resort: assume it's on PATH
+}
+
+const BUNDLED_CLI_PATH = resolveBundledCliPath();
+
+module.exports = function (RED) {
+    function CopilotConfigNode(config) {
+        RED.nodes.createNode(this, config);
+        this.authMethod = config.authMethod || 'oauth'; // 'oauth' | 'token'
+        this.cliPath = config.cliPath || undefined;
+        this.cliUrl = config.cliUrl || undefined;
+        // this.credentials.githubToken populated by Node-RED when authMethod === 'token'
+        this._client = null;
+        this._startPromise = null;
+
+        this.on('close', async (done) => {
+            if (this._client) {
+                try {
+                    await this._client.stop();
+                } catch (err) {
+                    this.warn('Error stopping CopilotClient: ' + err.message);
+                }
+                this._client = null;
+                this._startPromise = null;
+            }
+            done();
+        });
+    }
+
+    /**
+     * Returns a started CopilotClient, creating and starting it on first call.
+     * Subsequent calls return the same client (or wait for it to start).
+     */
+    CopilotConfigNode.prototype.getClient = function () {
+        if (this._startPromise) {
+            return this._startPromise;
+        }
+
+        const options = {
+            autoStart: false,
+            autoRestart: true,
+        };
+
+        const token = this.credentials && this.credentials.githubToken;
+        if (this.authMethod === 'token' && token) {
+            // PAT fallback — explicit token takes priority, disables logged-in user auth
+            options.githubToken = token;
+            options.useLoggedInUser = false;
+        } else {
+            // Primary: use GitHub OAuth credentials stored by the Copilot CLI (gh auth)
+            options.useLoggedInUser = true;
+        }
+        if (this.cliPath) {
+            options.cliPath = this.cliPath;
+        } else if (!this.cliUrl) {
+            // Use the bundled CLI binary so the node works without copilot on PATH
+            options.cliPath = BUNDLED_CLI_PATH;
+        }
+        if (this.cliUrl) {
+            options.cliUrl = this.cliUrl;
+        }
+
+        // Set _startPromise synchronously to prevent duplicate starts on concurrent calls
+        this._startPromise = _sdk.load().then(({ CopilotClient }) => {
+            this._client = new CopilotClient(options);
+            return this._client.start().then(() => this._client);
+        });
+        return this._startPromise;
+    };
+
+    RED.nodes.registerType('copilot-config', CopilotConfigNode, {
+        credentials: {
+            githubToken: { type: 'password' },
+        },
+    });
+
+    // Admin endpoint: GET /copilot/models?configId=<id>
+    // Used by the prompt node editor to populate the model dropdown dynamically.
+    RED.httpAdmin.get('/copilot/models', RED.auth.needsPermission('copilot-config.read'), async (req, res) => {
+        const configNode = RED.nodes.getNode(req.query.configId);
+        if (!configNode) {
+            return res.status(404).json({ error: 'Config node not found' });
+        }
+        try {
+            const client = await configNode.getClient();
+            const models = await client.listModels();
+            res.json(models.map(m => ({
+                id: m.id,
+                multiplier: m.billing ? m.billing.multiplier : null,
+            })));
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+};
+
+// Exposed for testing — allows injecting a mock SDK without proxyquire
+module.exports._sdk = _sdk;

package/nodes/copilot-prompt/copilot-prompt.html

@@ -0,0 +1,128 @@
+<script type="text/javascript">
+    RED.nodes.registerType('copilot-prompt', {
+        category: 'ai',
+        color: '#e8dff5',
+        defaults: {
+            name: { value: '' },
+            copilotConfig: { value: '', type: 'copilot-config', required: true },
+            model: { value: '' },
+            reasoningEffort: { value: '' },
+            timeout: { value: 60000 },
+        },
+        inputs: 1,
+        outputs: 2,
+        outputLabels: ['response', 'error'],
+        icon: 'copilot.svg',
+        label: function () {
+            return this.name || 'copilot';
+        },
+        paletteLabel: 'copilot',
+        oneditprepare: function () {
+            const nodeId = this.id;
+            const savedModel = this.model;
+
+            function loadModels(configId) {
+                if (!configId) return;
+                const $select = $('#node-input-model');
+                $select.empty().append($('<option>', { value: '', text: '— loading… —', disabled: true, selected: true }));
+                $.getJSON(`copilot/models?configId=${encodeURIComponent(configId)}`)
+                    .done(function (models) {
+                        $select.empty();
+                        $select.append($('<option>', { value: '', text: '— select model —' }));
+                        models.forEach(function (m) {
+                            const cost = m.multiplier != null ? `(${m.multiplier}x)` : '';
+                            $select.append($('<option>', { value: m.id, text: `${m.id} ${cost}`.trim() }));
+                        });
+                        if (savedModel) $select.val(savedModel);
+                        if (!$select.val()) $select.prop('selectedIndex', 0);
+                    })
+                    .fail(function () {
+                        $select.empty().append($('<option>', { value: savedModel || '', text: savedModel || '— unable to load —' }));
+                    });
+            }
+
+            // Load models whenever the config node selection changes
+            $('#node-input-copilotConfig').on('change', function () {
+                loadModels($(this).val());
+            });
+
+            // Initial load using the already-selected config node
+            loadModels($('#node-input-copilotConfig').val());
+        },
+    });
+</script>
+
+<script type="text/html" data-template-name="copilot-prompt">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="copilot">
+    </div>
+    <div class="form-row">
+        <label for="node-input-copilotConfig"><i class="fa fa-cog"></i> Config</label>
+        <input type="text" id="node-input-copilotConfig">
+    </div>
+    <div class="form-row">
+        <label for="node-input-model"><i class="fa fa-microchip"></i> Model</label>
+        <select id="node-input-model" style="width:70%">
+            <option value="">— select a config first —</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-reasoningEffort"><i class="fa fa-brain"></i> Reasoning</label>
+        <select id="node-input-reasoningEffort">
+            <option value="">— default —</option>
+            <option value="low">low</option>
+            <option value="medium">medium</option>
+            <option value="high">high</option>
+            <option value="xhigh">xhigh</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-timeout"><i class="fa fa-clock-o"></i> Timeout (ms)</label>
+        <input type="number" id="node-input-timeout" placeholder="60000" min="1000">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="copilot-prompt">
+    <p>Send a prompt (with optional attachments) to GitHub Copilot and receive a response.</p>
+
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">string | object</span></dt>
+        <dd>
+            A plain string is used as the prompt.<br>
+            An object may contain <code>{ prompt, attachments }</code>.
+        </dd>
+        <dt class="optional">attachments <span class="property-type">array</span></dt>
+        <dd>
+            Array of attachment descriptors. Each may be:<br>
+            <code>{ type: "file", path: "/abs/path" }</code><br>
+            <code>{ type: "base64", data: "...", name: "img.jpg" }</code><br>
+            <code>{ type: "buffer", data: Buffer, name: "file.bin" }</code>
+        </dd>
+        <dt class="optional">model <span class="property-type">string</span></dt>
+        <dd>Override the model for this message (e.g. <code>"gpt-5"</code>).</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <ol class="node-ports">
+        <li>Response
+            <dl class="message-properties">
+                <dt>payload <span class="property-type">string</span></dt>
+                <dd>The assistant's response text.</dd>
+                <dt>sessionId <span class="property-type">string</span></dt>
+                <dd>The Copilot session ID.</dd>
+                <dt>events <span class="property-type">array</span></dt>
+                <dd>All session events emitted during the request.</dd>
+            </dl>
+        </li>
+        <li>Error
+            <dl class="message-properties">
+                <dt>payload <span class="property-type">string</span></dt>
+                <dd>Error message.</dd>
+                <dt>error <span class="property-type">Error</span></dt>
+                <dd>The error object.</dd>
+            </dl>
+        </li>
+    </ol>
+</script>

package/nodes/copilot-prompt/copilot-prompt.js

@@ -0,0 +1,163 @@
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const DEFAULT_MODEL = 'claude-haiku-4.5';
+const DEFAULT_TIMEOUT = 60000;
+
+/**
+ * Normalises an attachment descriptor into an SDK-compatible `{ type, path }` object.
+ * Binary and base64 payloads are written to temp files; the caller is responsible
+ * for deleting them once the session send has completed.
+ *
+ * Supported input shapes:
+ *   { type: 'file',   path: '/abs/path' }               → passed through
+ *   { path: '/abs/path' }                                → shorthand for type=file
+ *   { type: 'base64', data: '<b64 string>', name: '…' } → decoded to temp file
+ *   { type: 'buffer', data: Buffer,         name: '…' } → written to temp file
+ *
+ * Returns { sdkAttachment, tempFile } where tempFile is the path to clean up (or null).
+ */
+function normaliseAttachment(attachment) {
+    if (attachment.type === 'file' || (!attachment.type && attachment.path)) {
+        return { sdkAttachment: { type: 'file', path: attachment.path }, tempFile: null };
+    }
+
+    const tmpDir = os.tmpdir();
+    const name = attachment.name || 'attachment';
+    const tempFile = path.join(tmpDir, `nr-copilot-${Date.now()}-${Math.random().toString(36).slice(2)}-${name}`);
+
+    if (attachment.type === 'base64') {
+        fs.writeFileSync(tempFile, Buffer.from(attachment.data, 'base64'));
+    } else if (attachment.type === 'buffer') {
+        fs.writeFileSync(tempFile, attachment.data);
+    } else {
+        throw new Error(`Unsupported attachment type: "${attachment.type}"`);
+    }
+
+    return { sdkAttachment: { type: 'file', path: tempFile, displayName: name }, tempFile };
+}
+
+/**
+ * Cleans up a list of temp file paths, swallowing any errors.
+ */
+function cleanupTempFiles(tempFiles) {
+    for (const f of tempFiles) {
+        try { fs.unlinkSync(f); } catch (_) { /* ignore */ }
+    }
+}
+
+module.exports = function (RED) {
+    function CopilotPromptNode(config) {
+        RED.nodes.createNode(this, config);
+        this.configNodeId = config.copilotConfig;
+        this.model = config.model || DEFAULT_MODEL;
+        this.reasoningEffort = config.reasoningEffort || undefined;
+        this.timeout = parseInt(config.timeout, 10) || DEFAULT_TIMEOUT;
+
+        const node = this;
+
+        this.on('input', async function (msg, send, done) {
+            // Support both old (1-arg send) and new (2-arg) Node-RED APIs
+            send = send || function () { node.send.apply(node, arguments); };
+            done = done || function (err) { if (err) { node.error(err, msg); } };
+
+            node.status({ fill: 'blue', shape: 'dot', text: 'sending…' });
+
+            // --- Resolve config node ---
+            const configNode = RED.nodes.getNode(node.configNodeId);
+            if (!configNode) {
+                node.status({ fill: 'red', shape: 'ring', text: 'no config' });
+                const err = new Error('copilot-prompt: no copilot-config node configured');
+                send([null, { payload: err.message, error: err, _msgid: msg._msgid }]);
+                return done();
+            }
+
+            // --- Parse prompt + attachments from msg ---
+            let prompt;
+            let rawAttachments = [];
+
+            if (typeof msg.payload === 'string') {
+                prompt = msg.payload;
+            } else if (msg.payload && typeof msg.payload === 'object') {
+                prompt = msg.payload.prompt || '';
+                rawAttachments = msg.payload.attachments || [];
+            } else {
+                prompt = String(msg.payload || '');
+            }
+
+            // msg.attachments can supplement / override
+            if (Array.isArray(msg.attachments)) {
+                rawAttachments = rawAttachments.concat(msg.attachments);
+            }
+
+            // Model can be overridden per-message
+            const model = msg.model || node.model;
+
+            // --- Normalise attachments ---
+            const tempFiles = [];
+            let sdkAttachments;
+            try {
+                sdkAttachments = rawAttachments.map((a) => {
+                    const { sdkAttachment, tempFile } = normaliseAttachment(a);
+                    if (tempFile) tempFiles.push(tempFile);
+                    return sdkAttachment;
+                });
+            } catch (err) {
+                cleanupTempFiles(tempFiles);
+                node.status({ fill: 'red', shape: 'ring', text: 'attachment error' });
+                send([null, { payload: err.message, error: err, _msgid: msg._msgid }]);
+                return done();
+            }
+
+            // --- Build session config ---
+            const { approveAll } = await import('@github/copilot-sdk');
+            const sessionConfig = { model, onPermissionRequest: approveAll };
+            if (node.reasoningEffort) {
+                sessionConfig.reasoningEffort = node.reasoningEffort;
+            }
+
+            // --- Send to Copilot ---
+            let client;
+            let session;
+            try {
+                client = await configNode.getClient();
+                session = await client.createSession(sessionConfig);
+
+                const messageOptions = { prompt };
+                if (sdkAttachments.length > 0) {
+                    messageOptions.attachments = sdkAttachments;
+                }
+
+                const events = [];
+                session.on((event) => events.push(event));
+
+                const response = await session.sendAndWait(messageOptions, node.timeout);
+
+                cleanupTempFiles(tempFiles);
+                await session.destroy();
+
+                const responseText = response ? response.data.content : '';
+                node.status({ fill: 'green', shape: 'dot', text: 'done' });
+
+                msg.payload = responseText;
+                msg.sessionId = session.sessionId;
+                msg.events = events;
+                send([msg, null]);
+                done();
+            } catch (err) {
+                cleanupTempFiles(tempFiles);
+                if (session) {
+                    try { await session.destroy(); } catch (_) { /* ignore */ }
+                }
+                node.status({ fill: 'red', shape: 'ring', text: 'error' });
+                send([null, { payload: err.message, error: err, _msgid: msg._msgid }]);
+                done();
+            }
+        });
+    }
+
+    RED.nodes.registerType('copilot-prompt', CopilotPromptNode);
+};

package/nodes/copilot-prompt/icons/copilot.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
+  <!-- Copilot icon from github/primer/octicons — MIT License -->
+  <defs>
+    <linearGradient id="cg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#a371f7"/>
+      <stop offset="100%" style="stop-color:#388bfd"/>
+    </linearGradient>
+  </defs>
+  <path fill="url(#cg)" d="M23.922 16.992c-.861 1.495-5.859 5.023-11.922 5.023-6.063 0-11.061-3.528-11.922-5.023A.641.641 0 0 1 0 16.736v-2.869a.841.841 0 0 1 .053-.22c.372-.935 1.347-2.292 2.605-2.656.167-.429.414-1.055.644-1.517a10.195 10.195 0 0 1-.052-1.086c0-1.331.282-2.499 1.132-3.368.397-.406.89-.717 1.474-.952 1.399-1.136 3.392-2.093 6.122-2.093 2.731 0 4.767.957 6.166 2.093.584.235 1.077.546 1.474.952.85.869 1.132 2.037 1.132 3.368 0 .368-.014.733-.052 1.086.23.462.477 1.088.644 1.517 1.258.364 2.233 1.721 2.605 2.656a.832.832 0 0 1 .053.22v2.869a.641.641 0 0 1-.078.256ZM12.172 11h-.344a4.323 4.323 0 0 1-.355.508C10.703 12.455 9.555 13 7.965 13c-1.725 0-2.989-.359-3.782-1.259a2.005 2.005 0 0 1-.085-.104L4 11.741v6.585c1.435.779 4.514 2.179 8 2.179 3.486 0 6.565-1.4 8-2.179v-6.585l-.098-.104s-.033.045-.085.104c-.793.9-2.057 1.259-3.782 1.259-1.59 0-2.738-.545-3.508-1.492a4.323 4.323 0 0 1-.355-.508h-.016.016Zm.641-2.935c.136 1.057.403 1.913.878 2.497.442.544 1.134.938 2.344.938 1.573 0 2.292-.337 2.657-.751.384-.435.558-1.15.558-2.361 0-1.14-.243-1.847-.705-2.319-.477-.488-1.319-.862-2.824-1.025-1.487-.161-2.192.138-2.533.529-.269.307-.437.808-.438 1.578v.021c0 .265.021.562.063.893Zm-1.626 0c.042-.331.063-.628.063-.894v-.02c-.001-.77-.169-1.271-.438-1.578-.341-.391-1.046-.69-2.533-.529-1.505.163-2.347.537-2.824 1.025-.462.472-.705 1.179-.705 2.319 0 1.211.175 1.926.558 2.361.365.414 1.084.751 2.657.751 1.21 0 1.902-.394 2.344-.938.475-.584.742-1.44.878-2.497Z"/>
+  <path fill="url(#cg)" d="M14.5 14.25a1 1 0 0 1 1 1v2a1 1 0 0 1-2 0v-2a1 1 0 0 1 1-1Zm-5 0a1 1 0 0 1 1 1v2a1 1 0 0 1-2 0v-2a1 1 0 0 1 1-1Z"/>
+</svg>

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "node-red-contrib-copilot",
+  "version": "0.0.1",
+  "description": "Node-RED nodes for GitHub Copilot via @github/copilot-sdk",
+  "license": "ISC",
+  "author": "George Talusan",
+  "type": "commonjs",
+  "main": "index.js",
+  "keywords": [
+    "node-red",
+    "copilot",
+    "github",
+    "ai"
+  ],
+  "scripts": {
+    "test": "mocha 'test/unit/**/*_spec.js' --timeout 10000",
+    "test:integration": "mocha 'test/integration/**/*_spec.js' --timeout 120000"
+  },
+  "engines": {
+    "node": ">=24.0.0",
+    "npm": ">=10.0.0"
+  },
+  "node-red": {
+    "version": ">=3.0.0",
+    "nodes": {
+      "copilot-config": "nodes/copilot-config/copilot-config.js",
+      "copilot-prompt": "nodes/copilot-prompt/copilot-prompt.js"
+    }
+  },
+  "dependencies": {
+    "@github/copilot-sdk": "0.1.30"
+  },
+  "devDependencies": {
+    "mocha": "^10.8.2",
+    "node-red": "^4.1.7",
+    "node-red-node-test-helper": "^0.3.6",
+    "proxyquire": "^2.1.3",
+    "sinon": "^17.0.1"
+  }
+}