n8n-nodes-opencode-ai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dante Labs
+
+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,190 @@
+# n8n-nodes-opencode-ai
+
+[![npm version](https://badge.fury.io/js/n8n-nodes-opencode-ai.svg)](https://www.npmjs.com/package/n8n-nodes-opencode-ai)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+This is an n8n community node package that provides integration with [OpenCode](https://opencode.ai/) AI Server API.
+
+[OpenCode](https://github.com/opencode-ai/opencode) is a powerful terminal-based AI coding assistant. This node enables you to interact with OpenCode Server from your n8n workflows.
+
+## Features
+
+- **Session Management**: Create, list, get, delete, and abort OpenCode sessions
+- **Message Operations**: Send messages (sync/async), execute commands, run shell commands
+- **AI Agent Integration**: LangChain-compatible Tool and ChatModel nodes for n8n AI agents
+- **Dynamic Configuration**: Auto-load available models, agents, and commands from server
+
+## Prerequisites
+
+> **⚠️ Important**: This package requires a running OpenCode Server instance. The node connects to OpenCode Server via REST API, so you must have the server running before using this node.
+
+### Installing OpenCode
+
+```bash
+# Install OpenCode CLI
+curl -fsSL https://opencode.ai/install | bash
+```
+
+For other installation methods (npm, Homebrew, Scoop, etc.), see the [OpenCode Installation Guide](https://opencode.ai/docs/installation/).
+
+### Oh My OpenCode (Optional, Recommended)
+
+[Oh My OpenCode](https://ohmyopencode.com/) is a powerful plugin that enhances OpenCode with specialized agents like **Sisyphus** (Claude Opus 4.5 with extended thinking) and parallel background task execution.
+
+```bash
+# Install via bunx
+bunx oh-my-opencode install
+
+# Or via npm
+npm install -g oh-my-opencode
+```
+
+For more details, visit [Oh My OpenCode GitHub](https://github.com/code-yeongyu/oh-my-opencode).
+
+### Starting OpenCode Server
+
+```bash
+# Set authentication credentials via environment variables
+OPENCODE_SERVER_USERNAME=your_username OPENCODE_SERVER_PASSWORD=your_password opencode serve --port 4096
+```
+
+You can change the port number as needed. The credentials you set here will be used in the n8n credential configuration.
+
+### Security Considerations
+
+> **🔒 Security Warning**: The example above is for development/testing purposes only.
+
+For production deployments:
+
+- **Never hardcode credentials** in scripts or command lines
+- Use secure environment variable management (e.g., `.env` files with proper permissions, secrets managers)
+- Deploy behind a **reverse proxy** (nginx, Caddy) with HTTPS/TLS encryption
+- Implement **network-level security** (firewall rules, VPN, private networks)
+- Use **strong passwords** and consider rotating credentials regularly
+- Monitor access logs and set up alerts for suspicious activity
+
+Example production setup with environment file:
+
+```bash
+# .env file (chmod 600)
+OPENCODE_SERVER_USERNAME=secure_username
+OPENCODE_SERVER_PASSWORD=strong_random_password
+
+# Start server
+source .env && opencode serve --port 4096
+```
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Go to **Settings > Community Nodes** in your n8n instance
+2. Click **Install**
+3. Enter `n8n-nodes-opencode-ai` and click **Install**
+
+### Manual Installation
+
+```bash
+npm install n8n-nodes-opencode-ai
+```
+
+## Nodes
+
+| Node | Description |
+|------|-------------|
+| **OpenCode** | Main node for session and message operations |
+| **OpenCode Tool** | LangChain tool for AI agent workflows |
+| **OpenCode Chat Model** | LangChain chat model for AI agent workflows |
+
+## Credentials
+
+This node uses Basic Authentication to connect to OpenCode Server.
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| Base URL | OpenCode Server URL | `http://127.0.0.1:4096` |
+| Username | Basic Auth username | - |
+| Password | Basic Auth password | - |
+
+## Operations
+
+### Session Resource
+- **List**: Get all sessions
+- **Get**: Get a specific session
+- **Create**: Create a new session
+- **Delete**: Delete a session
+- **Abort**: Abort a running session
+- **Status**: Get status of all sessions
+
+### Message Resource
+- **Send**: Send a message and wait for response
+- **Send Async**: Send a message without waiting
+- **Execute Command**: Run a slash command (e.g., /help)
+- **Run Shell**: Execute a shell command
+- **List**: Get all messages in a session
+- **Get**: Get a specific message by ID
+
+### Config Resource
+- **Get Providers**: List available AI providers and models
+
+## Usage Examples
+
+### Basic Message Send
+
+1. Add the **OpenCode** node to your workflow
+2. Select **Message** resource and **Send** operation
+3. Choose or create a session
+4. Enter your message
+5. Execute to get AI response
+
+### Using with AI Agent
+
+1. Add **OpenCode Chat Model** node as the model
+2. Add **OpenCode Tool** node as a tool
+3. Connect to an AI Agent node
+4. The agent can now use OpenCode for coding tasks
+
+### Temporary Session Mode
+
+Enable **Temporary Session** mode to automatically create and delete sessions per request - useful for stateless operations.
+
+## Requirements
+
+- **OpenCode Server** running and accessible (see [Prerequisites](#prerequisites))
+- n8n version 1.0.0 or later
+- Node.js 18.0.0 or later
+
+## Related Links
+
+- [OpenCode Official Site](https://opencode.ai/)
+- [OpenCode GitHub Repository](https://github.com/opencode-ai/opencode)
+- [OpenCode Installation Guide](https://opencode.ai/docs/installation/)
+- [OpenCode Server Documentation](https://opencode.ai/docs/server/)
+- [Oh My OpenCode](https://ohmyopencode.com/) - Recommended plugin with specialized agents
+- [Oh My OpenCode GitHub](https://github.com/code-yeongyu/oh-my-opencode)
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+
+This is an independent community node and is not officially affiliated with or endorsed by OpenCode. [OpenCode](https://github.com/opencode-ai/opencode) is also licensed under the MIT License.
+
+---
+
+## Dante Labs
+
+**Developed and maintained by Dante Labs**
+
+- **Homepage**: [dante-datalab.com](https://dante-datalab.com)
+- **YouTube**: [@dante-labs](https://youtube.com/@dante-labs)
+- **Discord**: [Dante Labs Community](https://discord.com/invite/rXyy5e9ujs)
+- **Email**: datapod.k@gmail.com
+
+### Support
+
+If you find this project helpful, consider supporting the development!
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow?style=for-the-badge&logo=buy-me-a-coffee)](https://buymeacoffee.com/dante.labs)
+
+**☕ Buy Me a Coffee**: https://buymeacoffee.com/dante.labs

package/dist/assets/opencode.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" fill="none">
+  <rect width="60" height="60" rx="8" fill="#1a1a2e"/>
+  <path d="M20 22L12 30L20 38" stroke="#00d9ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M40 22L48 30L40 38" stroke="#00d9ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M35 16L25 44" stroke="#ff6b6b" stroke-width="3" stroke-linecap="round"/>
+</svg>

package/dist/credentials/OpenCodeApi.credentials.d.ts

@@ -0,0 +1,8 @@
+import { ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class OpenCodeApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    test: ICredentialTestRequest;
+}

package/dist/credentials/OpenCodeApi.credentials.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenCodeApi = void 0;
+class OpenCodeApi {
+    constructor() {
+        this.name = 'openCodeApi';
+        this.displayName = 'OpenCode API';
+        this.documentationUrl = 'https://opencode.ai/docs/server/';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'http://127.0.0.1:4096',
+                required: true,
+                description: 'The base URL of the OpenCode server (e.g., http://127.0.0.1:4096)',
+            },
+            {
+                displayName: 'Username',
+                name: 'username',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'Username for Basic Auth (OPENCODE_SERVER_USERNAME)',
+            },
+            {
+                displayName: 'Password',
+                name: 'password',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Password for Basic Auth (OPENCODE_SERVER_PASSWORD)',
+            },
+        ];
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/session',
+                method: 'GET',
+                auth: {
+                    username: '={{$credentials.username}}',
+                    password: '={{$credentials.password}}',
+                },
+            },
+        };
+    }
+}
+exports.OpenCodeApi = OpenCodeApi;
+//# sourceMappingURL=OpenCodeApi.credentials.js.map

package/dist/credentials/OpenCodeApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenCodeApi.credentials.js","sourceRoot":"","sources":["../../src/credentials/OpenCodeApi.credentials.ts"],"names":[],"mappings":";;;AAMA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,cAAc,CAAC;QAC7B,qBAAgB,GAAG,kCAAkC,CAAC;QAEtD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,mEAAmE;aAChF;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,oDAAoD;aACjE;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,oDAAoD;aACjE;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,UAAU;gBACf,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE;oBACL,QAAQ,EAAE,4BAA4B;oBACtC,QAAQ,EAAE,4BAA4B;iBACtC;aACD;SACD,CAAC;IACH,CAAC;CAAA;AA5CD,kCA4CC"}

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

@@ -0,0 +1,13 @@
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class OpenCode implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getSessions(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getModels(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getAgents(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getCommands(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}