openclaw-seatalk 0.3.0 → 0.3.2

package/openclaw.plugin.json

@@ -1,6 +1,86 @@
 {
 	"id": "openclaw-seatalk",
 	"channels": ["seatalk"],
+	"channelConfigs": {
+		"seatalk": {
+			"label": "SeaTalk",
+			"description": "SeaTalk internal messaging integration.",
+			"schema": {
+				"type": "object",
+				"additionalProperties": false,
+				"properties": {
+					"enabled": { "type": "boolean" },
+					"appId": { "type": "string" },
+					"appSecret": { "type": "string" },
+					"signingSecret": { "type": "string" },
+					"mode": { "type": "string", "enum": ["webhook", "relay"] },
+					"relayUrl": { "type": "string" },
+					"webhookPort": { "type": "integer", "minimum": 1 },
+					"webhookPath": { "type": "string" },
+					"dmPolicy": { "type": "string", "enum": ["open", "allowlist", "pairing"] },
+					"allowFrom": { "type": "array", "items": { "type": "string" } },
+					"groupPolicy": { "type": "string", "enum": ["disabled", "allowlist", "open"] },
+					"groupAllowFrom": { "type": "array", "items": { "type": "string" } },
+					"groupSenderAllowFrom": { "type": "array", "items": { "type": "string" } },
+					"outboundCoalescing": { "type": "boolean" },
+					"processingIndicator": { "type": "string", "enum": ["typing", "off"] },
+					"mediaAllowHosts": { "type": "array", "items": { "type": "string" } },
+					"tools": {
+						"type": "object",
+						"properties": {
+							"groupInfo": { "type": "boolean" },
+							"groupHistory": { "type": "boolean" },
+							"groupList": { "type": "boolean" },
+							"threadHistory": { "type": "boolean" },
+							"getMessage": { "type": "boolean" }
+						}
+					},
+					"accounts": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "object",
+							"properties": {
+								"enabled": { "type": "boolean" },
+								"appId": { "type": "string" },
+								"appSecret": { "type": "string" },
+								"signingSecret": { "type": "string" },
+								"mode": { "type": "string", "enum": ["webhook", "relay"] },
+								"relayUrl": { "type": "string" },
+								"webhookPort": { "type": "integer", "minimum": 1 },
+								"webhookPath": { "type": "string" },
+								"dmPolicy": {
+									"type": "string",
+									"enum": ["open", "allowlist", "pairing"]
+								},
+								"allowFrom": { "type": "array", "items": { "type": "string" } },
+								"groupPolicy": {
+									"type": "string",
+									"enum": ["disabled", "allowlist", "open"]
+								},
+								"groupAllowFrom": {
+									"type": "array",
+									"items": { "type": "string" }
+								},
+								"groupSenderAllowFrom": {
+									"type": "array",
+									"items": { "type": "string" }
+								},
+								"outboundCoalescing": { "type": "boolean" },
+								"processingIndicator": {
+									"type": "string",
+									"enum": ["typing", "off"]
+								},
+								"mediaAllowHosts": {
+									"type": "array",
+									"items": { "type": "string" }
+								}
+							}
+						}
+					}
+				}
+			}
+		}
+	},
 	"configSchema": {
 		"type": "object",
 		"additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "openclaw-seatalk",
-	"version": "0.3.0",
+	"version": "0.3.2",
 	"description": "OpenClaw SeaTalk channel plugin",
 	"type": "module",
 	"license": "Apache-2.0",
@@ -21,7 +21,8 @@
 		"lint": "biome lint .",
 		"lint:fix": "biome lint --fix .",
 		"check": "biome check .",
-		"check:fix": "biome check --fix ."
+		"check:fix": "biome check --fix .",
+		"pack:clawhub": "mkdir -p dist && npm pack --pack-destination dist"
 	},
 	"dependencies": {
 		"@sinclair/typebox": "0.34.48",
@@ -60,6 +61,10 @@
 		},
 		"compat": {
 			"pluginApi": ">=2026.3.22"
+		},
+		"build": {
+			"openclawVersion": "2026.3.22",
+			"pluginSdkVersion": "2026.3.22"
 		}
 	}
 }

package/src/accounts.ts

@@ -1,5 +1,8 @@
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/core";
+import {
+	DEFAULT_ACCOUNT_ID,
+	type OpenClawConfig,
+	normalizeAccountId,
+} from "openclaw/plugin-sdk/core";
 import type { ResolvedSeaTalkAccount, SeaTalkAccountConfig, SeaTalkConfig } from "./types.js";
 
 function listConfiguredAccountIds(cfg: OpenClawConfig): string[] {

package/src/bot.ts

@@ -1,10 +1,11 @@
-import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
 import { createChannelPairingController } from "openclaw/plugin-sdk/channel-pairing";
 import {
 	DM_GROUP_ACCESS_REASON,
 	resolveDmGroupAccessWithLists,
 } from "openclaw/plugin-sdk/channel-policy";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
 import { resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
+import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import { checkGroupAccess } from "./access.js";
 import { resolveSeaTalkAccount } from "./accounts.js";
 import type { SeaTalkClient } from "./client.js";

package/src/channel.ts

@@ -1,5 +1,9 @@
-import type { ChannelPlugin, OpenClawConfig } from "openclaw/plugin-sdk";
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
+import {
+	type ChannelPlugin,
+	type OpenClawConfig,
+	buildChannelConfigSchema,
+} from "openclaw/plugin-sdk/core";
 import { DEFAULT_ACCOUNT_ID, PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/core";
 import {
 	listSeaTalkAccountIds,
@@ -7,6 +11,7 @@ import {
 	resolveSeaTalkAccount,
 } from "./accounts.js";
 import { resolveSeaTalkClient } from "./client.js";
+import { SeaTalkConfigSchema } from "./config-schema.js";
 import { seatalkOutbound } from "./outbound.js";
 import { probeSeaTalk } from "./probe.js";
 import { sendTextMessage } from "./send.js";
@@ -49,65 +54,7 @@ export const seatalkPlugin: ChannelPlugin<ResolvedSeaTalkAccount> = {
 		reply: false,
 	},
 	reload: { configPrefixes: ["channels.seatalk"] },
-	configSchema: {
-		schema: {
-			type: "object",
-			additionalProperties: false,
-			properties: {
-				enabled: { type: "boolean" },
-				appId: { type: "string" },
-				appSecret: { type: "string" },
-				signingSecret: { type: "string" },
-				mode: { type: "string", enum: ["webhook", "relay"] },
-				relayUrl: { type: "string" },
-				webhookPort: { type: "integer", minimum: 1 },
-				webhookPath: { type: "string" },
-				dmPolicy: { type: "string", enum: ["open", "allowlist", "pairing"] },
-				allowFrom: { type: "array", items: { type: "string" } },
-				groupPolicy: { type: "string", enum: ["disabled", "allowlist", "open"] },
-				groupAllowFrom: { type: "array", items: { type: "string" } },
-				groupSenderAllowFrom: { type: "array", items: { type: "string" } },
-				processingIndicator: { type: "string", enum: ["typing", "off"] },
-				mediaAllowHosts: { type: "array", items: { type: "string" } },
-				tools: {
-					type: "object",
-					properties: {
-						groupInfo: { type: "boolean" },
-						groupHistory: { type: "boolean" },
-						groupList: { type: "boolean" },
-						threadHistory: { type: "boolean" },
-						getMessage: { type: "boolean" },
-					},
-				},
-				accounts: {
-					type: "object",
-					additionalProperties: {
-						type: "object",
-						properties: {
-							enabled: { type: "boolean" },
-							appId: { type: "string" },
-							appSecret: { type: "string" },
-							signingSecret: { type: "string" },
-							mode: { type: "string", enum: ["webhook", "relay"] },
-							relayUrl: { type: "string" },
-							webhookPort: { type: "integer", minimum: 1 },
-							webhookPath: { type: "string" },
-							dmPolicy: { type: "string", enum: ["open", "allowlist", "pairing"] },
-							allowFrom: { type: "array", items: { type: "string" } },
-							groupPolicy: {
-								type: "string",
-								enum: ["disabled", "allowlist", "open"],
-							},
-							groupAllowFrom: { type: "array", items: { type: "string" } },
-							groupSenderAllowFrom: { type: "array", items: { type: "string" } },
-							processingIndicator: { type: "string", enum: ["typing", "off"] },
-							mediaAllowHosts: { type: "array", items: { type: "string" } },
-						},
-					},
-				},
-			},
-		},
-	},
+	configSchema: buildChannelConfigSchema(SeaTalkConfigSchema),
 	config: {
 		listAccountIds: (cfg) => listSeaTalkAccountIds(cfg),
 		resolveAccount: (cfg, accountId) => resolveSeaTalkAccount({ cfg, accountId }),

package/src/monitor.ts

@@ -1,6 +1,7 @@
 import * as crypto from "node:crypto";
 import * as http from "node:http";
-import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import {
 	listEnabledSeaTalkAccounts,
 	resolveSeaTalkAccount,

package/src/outbound.ts

@@ -1,5 +1,5 @@
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
 import type { ChannelOutboundAdapter } from "openclaw/plugin-sdk/channel-send-result";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
 import { resolveSeaTalkAccount } from "./accounts.js";
 import { type SeaTalkClient, resolveSeaTalkClient } from "./client.js";
 import { getSeatalkRuntime } from "./runtime.js";

package/src/relay-client.ts

@@ -1,4 +1,5 @@
-import type { OpenClawConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import WebSocket from "ws";
 import {
 	listEnabledSeaTalkAccounts,
@@ -13,6 +14,7 @@ import type { ResolvedSeaTalkAccount, SeaTalkCallbackRequest } from "./types.js"
 const INITIAL_BACKOFF_MS = 1_000;
 const MAX_BACKOFF_MS = 30_000;
 const BACKOFF_MULTIPLIER = 2;
+const STALE_TIMEOUT_MS = 75_000;
 
 function sleep(ms: number, signal?: AbortSignal): Promise<void> {
 	return new Promise((resolve) => {
@@ -63,13 +65,36 @@ async function connectSingleAccount(params: {
 				log(`seatalk[${accountId}]: connecting to relay ${relayUrl}...`);
 				const ws = new WebSocket(relayUrl);
 
+				let staleTimer: ReturnType<typeof setTimeout> | undefined;
+				const clearStaleTimer = () => {
+					if (staleTimer) {
+						clearTimeout(staleTimer);
+						staleTimer = undefined;
+					}
+				};
+				const armStaleTimer = () => {
+					clearStaleTimer();
+					staleTimer = setTimeout(() => {
+						error(
+							`seatalk[${accountId}]: relay silent for ${STALE_TIMEOUT_MS}ms, terminating`,
+						);
+						ws.terminate();
+					}, STALE_TIMEOUT_MS);
+				};
+
 				const handleAbort = () => {
+					clearStaleTimer();
 					ws.close();
 					resolve();
 				};
 				abortSignal?.addEventListener("abort", handleAbort, { once: true });
 
+				ws.on("upgrade", (response) => {
+					response.socket.setKeepAlive(true, 60_000);
+				});
+
 				ws.on("open", () => {
+					armStaleTimer();
 					log(`seatalk[${accountId}]: relay connected, authenticating...`);
 					ws.send(
 						JSON.stringify({
@@ -84,6 +109,7 @@ async function connectSingleAccount(params: {
 				let authenticated = false;
 
 				ws.on("message", (raw) => {
+					armStaleTimer();
 					let msg: { type: string; event?: SeaTalkCallbackRequest; error?: string };
 					try {
 						msg = JSON.parse(String(raw));
@@ -131,6 +157,7 @@ async function connectSingleAccount(params: {
 				});
 
 				ws.on("close", (code, reason) => {
+					clearStaleTimer();
 					abortSignal?.removeEventListener("abort", handleAbort);
 					if (authenticated) {
 						log(
@@ -141,6 +168,7 @@ async function connectSingleAccount(params: {
 				});
 
 				ws.on("error", (err) => {
+					clearStaleTimer();
 					abortSignal?.removeEventListener("abort", handleAbort);
 					error(`seatalk[${accountId}]: relay connection error: ${String(err)}`);
 					resolve();

package/src/runtime.ts

@@ -1,4 +1,4 @@
-import type { PluginRuntime } from "openclaw/plugin-sdk";
+import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 
 let runtime: PluginRuntime | null = null;
 

package/src/tool.ts

@@ -1,4 +1,4 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import { listEnabledSeaTalkAccounts, resolveSeaTalkAccount } from "./accounts.js";
 import type { SeaTalkClient } from "./client.js";
 import { resolveSeaTalkClient } from "./client.js";