port42-openclaw 0.1.0 → 0.3.0

package/.github/workflows/publish.yml

@@ -12,14 +12,17 @@ permissions:
 jobs:
   publish:
     runs-on: ubuntu-latest
+    environment: npm
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
           registry-url: 'https://registry.npmjs.org'
 
       - run: npm ci
       - run: npm run build
-      - run: npm publish
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -14,7 +14,7 @@ Someone shares a Port42 channel invite link with you. Add it to OpenClaw:
 
 ```bash
 openclaw channel add port42 \
-  --invite "https://your-host.ngrok-free.dev/invite?id=CHANNEL-UUID&name=my-channel&key=BASE64KEY" \
+  --invite "https://your-host.ngrok-free.dev/invite?id=CHANNEL-UUID&name=my-channel&key=BASE64KEY&token=GATEWAY_TOKEN" \
   --agent my-researcher \
   --name "Researcher"
 ```
@@ -30,7 +30,7 @@ Or edit `openclaw.json` directly:
   "channels": {
     "port42-project": {
       "type": "port42",
-      "invite": "https://your-host.ngrok-free.dev/invite?id=CHANNEL-UUID&name=my-channel&key=BASE64KEY",
+      "invite": "https://your-host.ngrok-free.dev/invite?id=CHANNEL-UUID&name=my-channel&key=BASE64KEY&token=GATEWAY_TOKEN",
       "displayName": "Researcher",
       "trigger": "mention"
     }
@@ -46,6 +46,7 @@ Or edit `openclaw.json` directly:
 | `gateway` | yes* | — | WebSocket URL (derived from invite if provided) |
 | `channelId` | yes* | — | Channel UUID (parsed from invite if provided) |
 | `encryptionKey` | no | — | AES-256 key (parsed from invite if provided) |
+| `token` | no | — | Gateway auth token (parsed from invite if provided) |
 | `displayName` | yes | — | How the agent appears in Port42 |
 | `trigger` | no | `mention` | `mention` (respond to @name) or `all` (respond to everything) |
 

package/dist/connection.d.ts

@@ -7,6 +7,7 @@ export interface ConnectionConfig {
     senderId: string;
     displayName: string;
     encryptionKey: string | null;
+    token: string | null;
     trigger: 'mention' | 'all';
     onMessage: (senderName: string, content: string, messageId: string) => void;
     onPresence?: (onlineIds: string[]) => void;

package/dist/connection.js

@@ -57,7 +57,12 @@ class Port42Connection {
     }
     openSocket() {
         try {
-            this.ws = new ws_1.default(this.config.gateway);
+            let url = this.config.gateway;
+            if (this.config.token) {
+                const sep = url.includes('?') ? '&' : '?';
+                url = `${url}${sep}token=${encodeURIComponent(this.config.token)}`;
+            }
+            this.ws = new ws_1.default(url);
         }
         catch (err) {
             console.error('[port42] Failed to create WebSocket:', err);

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export interface Port42ChannelConfig {
     gateway?: string;
     channelId?: string;
     encryptionKey?: string;
+    token?: string;
     displayName: string;
     trigger?: 'mention' | 'all';
 }

package/dist/index.js

@@ -38,6 +38,7 @@ function resolveConfig(config) {
             gateway: config.gateway || parsed.gateway,
             channelId: config.channelId || parsed.channelId,
             encryptionKey: config.encryptionKey || parsed.encryptionKey,
+            token: config.token || parsed.token,
         };
     }
     if (!config.gateway || !config.channelId) {
@@ -47,6 +48,7 @@ function resolveConfig(config) {
         gateway: config.gateway,
         channelId: config.channelId,
         encryptionKey: config.encryptionKey || null,
+        token: config.token || null,
     };
 }
 /**
@@ -67,6 +69,7 @@ function register(api) {
                     senderId,
                     displayName: config.displayName,
                     encryptionKey: resolved.encryptionKey,
+                    token: resolved.token,
                     trigger,
                     onMessage(senderName, content, messageId) {
                         if (messageHandler) {

package/dist/invite.d.ts

@@ -2,12 +2,13 @@
  * Parse Port42 HTTPS invite links into connection config.
  *
  * Invite format:
- * https://<host>/invite?id=<channel-uuid>&name=<channel-name>&key=<url-encoded-base64-aes-key>
+ * https://<host>/invite?id=<channel-uuid>&name=<channel-name>&key=<url-encoded-base64-aes-key>&token=<gateway-token>
  */
 export interface InviteConfig {
     gateway: string;
     channelId: string;
     channelName: string;
     encryptionKey: string | null;
+    token: string | null;
 }
 export declare function parseInviteLink(invite: string): InviteConfig;

package/dist/invite.js

@@ -3,7 +3,7 @@
  * Parse Port42 HTTPS invite links into connection config.
  *
  * Invite format:
- * https://<host>/invite?id=<channel-uuid>&name=<channel-name>&key=<url-encoded-base64-aes-key>
+ * https://<host>/invite?id=<channel-uuid>&name=<channel-name>&key=<url-encoded-base64-aes-key>&token=<gateway-token>
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseInviteLink = parseInviteLink;
@@ -15,9 +15,10 @@ function parseInviteLink(invite) {
     }
     const channelName = url.searchParams.get('name') || 'unknown';
     const encryptionKey = url.searchParams.get('key') || null;
+    const token = url.searchParams.get('token') || null;
     // Derive WebSocket URL from the HTTPS host
     const protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
     const gateway = `${protocol}//${url.host}/ws`;
-    return { gateway, channelId, channelName, encryptionKey };
+    return { gateway, channelId, channelName, encryptionKey, token };
 }
 //# sourceMappingURL=invite.js.map

package/openclaw.plugin.json

@@ -29,6 +29,11 @@
       "description": "Base64 AES-256 encryption key",
       "required": false
     },
+    "token": {
+      "type": "string",
+      "description": "Gateway authentication token",
+      "required": false
+    },
     "displayName": {
       "type": "string",
       "description": "Agent display name in Port42",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "port42-openclaw",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Port42 channel adapter for OpenClaw — bring your agents into Port42 companion computing channels",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/connection.ts

@@ -20,6 +20,7 @@ export interface ConnectionConfig {
   senderId: string;
   displayName: string;
   encryptionKey: string | null;
+  token: string | null;
   trigger: 'mention' | 'all';
   onMessage: (senderName: string, content: string, messageId: string) => void;
   onPresence?: (onlineIds: string[]) => void;
@@ -90,7 +91,12 @@ export class Port42Connection {
 
   private openSocket(): void {
     try {
-      this.ws = new WebSocket(this.config.gateway);
+      let url = this.config.gateway;
+      if (this.config.token) {
+        const sep = url.includes('?') ? '&' : '?';
+        url = `${url}${sep}token=${encodeURIComponent(this.config.token)}`;
+      }
+      this.ws = new WebSocket(url);
     } catch (err) {
       console.error('[port42] Failed to create WebSocket:', err);
       this.scheduleReconnect();

package/src/index.ts

@@ -15,6 +15,7 @@ export interface Port42ChannelConfig {
   gateway?: string;
   channelId?: string;
   encryptionKey?: string;
+  token?: string;
   displayName: string;
   trigger?: 'mention' | 'all';
 }
@@ -64,6 +65,7 @@ function resolveConfig(config: Port42ChannelConfig): {
   gateway: string;
   channelId: string;
   encryptionKey: string | null;
+  token: string | null;
 } {
   if (config.invite) {
     const parsed = parseInviteLink(config.invite);
@@ -71,6 +73,7 @@ function resolveConfig(config: Port42ChannelConfig): {
       gateway: config.gateway || parsed.gateway,
       channelId: config.channelId || parsed.channelId,
       encryptionKey: config.encryptionKey || parsed.encryptionKey,
+      token: config.token || parsed.token,
     };
   }
 
@@ -82,6 +85,7 @@ function resolveConfig(config: Port42ChannelConfig): {
     gateway: config.gateway,
     channelId: config.channelId,
     encryptionKey: config.encryptionKey || null,
+    token: config.token || null,
   };
 }
 
@@ -106,6 +110,7 @@ export function register(api: PluginAPI): void {
           senderId,
           displayName: config.displayName,
           encryptionKey: resolved.encryptionKey,
+          token: resolved.token,
           trigger,
 
           onMessage(senderName, content, messageId) {

package/src/invite.ts

@@ -2,7 +2,7 @@
  * Parse Port42 HTTPS invite links into connection config.
  *
  * Invite format:
- * https://<host>/invite?id=<channel-uuid>&name=<channel-name>&key=<url-encoded-base64-aes-key>
+ * https://<host>/invite?id=<channel-uuid>&name=<channel-name>&key=<url-encoded-base64-aes-key>&token=<gateway-token>
  */
 
 export interface InviteConfig {
@@ -10,6 +10,7 @@ export interface InviteConfig {
   channelId: string;
   channelName: string;
   encryptionKey: string | null;
+  token: string | null;
 }
 
 export function parseInviteLink(invite: string): InviteConfig {
@@ -22,10 +23,11 @@ export function parseInviteLink(invite: string): InviteConfig {
 
   const channelName = url.searchParams.get('name') || 'unknown';
   const encryptionKey = url.searchParams.get('key') || null;
+  const token = url.searchParams.get('token') || null;
 
   // Derive WebSocket URL from the HTTPS host
   const protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
   const gateway = `${protocol}//${url.host}/ws`;
 
-  return { gateway, channelId, channelName, encryptionKey };
+  return { gateway, channelId, channelName, encryptionKey, token };
 }