@feihan-im/openclaw-plugin 0.1.0 → 0.1.2

package/README.en.md

@@ -8,7 +8,9 @@
 
 [中文](./README.md) | English
 
-Feihan IM channel plugin for OpenClaw. Connects a Feihan bot to OpenClaw's AI agent pipeline so you can chat with your agent through Feihan.
+Feihan is a secure, self-hosted productivity platform for teams, integrating instant messaging, organizational structures, video conferencing, and file storage.
+
+Feihan IM channel plugin for OpenClaw. Connects a Feihan bot to OpenClaw's AI agent pipeline so you can chat with your agent through Feihan. See the [Setup Tutorial](https://feihanim.cn/docs/admin/bots/openclaw) for how to connect Feihan to OpenClaw.
 
 ## Features
 
@@ -50,7 +52,7 @@ Or manually edit `~/.openclaw/openclaw.json`:
     "feihan": {
       "appId": "your_app_id",
       "appSecret": "your_app_secret",
-      "backendUrl": "http://your-feihan-backend:21000"
+      "backendUrl": "https://your-backend-url.com"
     }
   }
 }
@@ -70,13 +72,13 @@ openclaw gateway restart
     "feihan": {
       "appId": "111111",
       "appSecret": "secret-1",
-      "backendUrl": "http://backend-1:21000",
+      "backendUrl": "https://your-backend-url.com",
       "accounts": {
         "bot2": {
           "enabled": true,
           "appId": "222222",
           "appSecret": "secret-2",
-          "backendUrl": "http://backend-2:21000"
+          "backendUrl": "https://your-backend-url.com"
         }
       }
     }

package/README.md

@@ -8,7 +8,9 @@
 
 中文 | [English](./README.en.md)
 
-飞函 IM 频道插件，用于 OpenClaw。将飞函机器人接入 OpenClaw 的 AI Agent 管线，通过飞函与 Agent 对话。
+飞函，是安全稳定的私有化一站式办公平台，功能包括即时通讯、组织架构、音视频会议、网盘等。
+
+飞函 IM 频道插件，用于 OpenClaw。将飞函机器人接入 OpenClaw 的 AI Agent 管线，通过飞函与 Agent 对话。请参阅[配置教程](https://feihanim.cn/docs/admin/bots/openclaw)了解如何将飞函连接到 OpenClaw。
 
 ## 功能
 
@@ -50,7 +52,7 @@ openclaw channels add --channel feihan
     "feihan": {
       "appId": "your_app_id",
       "appSecret": "your_app_secret",
-      "backendUrl": "http://your-feihan-backend:21000"
+      "backendUrl": "https://your-backend-url.com"
     }
   }
 }
@@ -70,13 +72,13 @@ openclaw gateway restart
     "feihan": {
       "appId": "111111",
       "appSecret": "secret-1",
-      "backendUrl": "http://backend-1:21000",
+      "backendUrl": "https://your-backend-url.com",
       "accounts": {
         "bot2": {
           "enabled": true,
           "appId": "222222",
           "appSecret": "secret-2",
-          "backendUrl": "http://backend-2:21000"
+          "backendUrl": "https://your-backend-url.com"
         }
       }
     }

package/dist/setup-entry.cjs

@@ -0,0 +1,67 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/setup-entry.ts
+var setup_entry_exports = {};
+__export(setup_entry_exports, {
+  default: () => setup_entry_default
+});
+module.exports = __toCommonJS(setup_entry_exports);
+var import_core = require("openclaw/plugin-sdk/core");
+var setup_entry_default = (0, import_core.defineSetupPluginEntry)({
+  async onSetup(context) {
+    const appId = await context.prompt({
+      type: "text",
+      message: "Enter your Feihan App ID:",
+      validate: (val) => val.length > 0 || "This field is required"
+    });
+    const appSecret = await context.prompt({
+      type: "password",
+      message: "Enter your Feihan App Secret:",
+      validate: (val) => val.length > 0 || "This field is required"
+    });
+    const backendUrl = await context.prompt({
+      type: "text",
+      message: "Enter Feihan backend server URL:",
+      validate: (val) => {
+        if (val.length === 0) return "This field is required";
+        try {
+          new URL(val);
+          return true;
+        } catch {
+          return "Please enter a valid URL";
+        }
+      }
+    });
+    const enableEncryption = await context.prompt({
+      type: "confirm",
+      message: "Enable message encryption?",
+      default: true
+    });
+    await context.updateConfig("channels.feihan.appId", appId);
+    await context.updateConfig("channels.feihan.appSecret", appSecret);
+    await context.updateConfig("channels.feihan.backendUrl", backendUrl);
+    await context.updateConfig("channels.feihan.enableEncryption", enableEncryption);
+    await context.updateConfig("channels.feihan.enabled", true);
+    console.log("\u2705 Feihan channel configuration saved successfully!");
+    console.log("\u{1F4C4} Config file: ~/.openclaw/openclaw.json");
+    console.log("\u{1F4D6} Deploy docs: https://feihanim.cn/docs/admin/bots/openclaw");
+  }
+});
+//# sourceMappingURL=setup-entry.cjs.map

package/dist/setup-entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup-entry.ts"],"sourcesContent":["// Copyright (c) 2026 上海飞函安全科技有限公司 (Shanghai Feihan Security Technology Co., Ltd.)\n// SPDX-License-Identifier: Apache-2.0\n\nimport { defineSetupPluginEntry } from \"openclaw/plugin-sdk/core\";\n\nexport default defineSetupPluginEntry({\n  async onSetup(context) {\n    const appId = await context.prompt({\n      type: \"text\",\n      message: \"Enter your Feihan App ID:\",\n      validate: (val: string) => val.length > 0 || \"This field is required\",\n    });\n\n    const appSecret = await context.prompt({\n      type: \"password\",\n      message: \"Enter your Feihan App Secret:\",\n      validate: (val: string) => val.length > 0 || \"This field is required\",\n    });\n\n    const backendUrl = await context.prompt({\n      type: \"text\",\n      message: \"Enter Feihan backend server URL:\",\n      validate: (val: string) => {\n        if (val.length === 0) return \"This field is required\";\n        try {\n          new URL(val);\n          return true;\n        } catch {\n          return \"Please enter a valid URL\";\n        }\n      },\n    });\n\n    const enableEncryption = await context.prompt({\n      type: \"confirm\",\n      message: \"Enable message encryption?\",\n      default: true,\n    });\n\n    // Write config to ~/.openclaw/openclaw.json\n    await context.updateConfig(\"channels.feihan.appId\", appId);\n    await context.updateConfig(\"channels.feihan.appSecret\", appSecret);\n    await context.updateConfig(\"channels.feihan.backendUrl\", backendUrl);\n    await context.updateConfig(\"channels.feihan.enableEncryption\", enableEncryption);\n    await context.updateConfig(\"channels.feihan.enabled\", true);\n\n    console.log(\"✅ Feihan channel configuration saved successfully!\");\n    console.log(\"📄 Config file: ~/.openclaw/openclaw.json\");\n    console.log(\"📖 Deploy docs: https://feihanim.cn/docs/admin/bots/openclaw\");\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAAuC;AAEvC,IAAO,0BAAQ,oCAAuB;AAAA,EACpC,MAAM,QAAQ,SAAS;AACrB,UAAM,QAAQ,MAAM,QAAQ,OAAO;AAAA,MACjC,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU,CAAC,QAAgB,IAAI,SAAS,KAAK;AAAA,IAC/C,CAAC;AAED,UAAM,YAAY,MAAM,QAAQ,OAAO;AAAA,MACrC,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU,CAAC,QAAgB,IAAI,SAAS,KAAK;AAAA,IAC/C,CAAC;AAED,UAAM,aAAa,MAAM,QAAQ,OAAO;AAAA,MACtC,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU,CAAC,QAAgB;AACzB,YAAI,IAAI,WAAW,EAAG,QAAO;AAC7B,YAAI;AACF,cAAI,IAAI,GAAG;AACX,iBAAO;AAAA,QACT,QAAQ;AACN,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,mBAAmB,MAAM,QAAQ,OAAO;AAAA,MAC5C,MAAM;AAAA,MACN,SAAS;AAAA,MACT,SAAS;AAAA,IACX,CAAC;AAGD,UAAM,QAAQ,aAAa,yBAAyB,KAAK;AACzD,UAAM,QAAQ,aAAa,6BAA6B,SAAS;AACjE,UAAM,QAAQ,aAAa,8BAA8B,UAAU;AACnE,UAAM,QAAQ,aAAa,oCAAoC,gBAAgB;AAC/E,UAAM,QAAQ,aAAa,2BAA2B,IAAI;AAE1D,YAAQ,IAAI,yDAAoD;AAChE,YAAQ,IAAI,kDAA2C;AACvD,YAAQ,IAAI,qEAA8D;AAAA,EAC5E;AACF,CAAC;","names":[]}

package/dist/setup-entry.d.cts

@@ -0,0 +1,5 @@
+import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
+
+declare const _default: openclaw_plugin_sdk_core.SetupPluginEntry;
+
+export { _default as default };

package/dist/setup-entry.d.ts

@@ -0,0 +1,5 @@
+import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
+
+declare const _default: openclaw_plugin_sdk_core.SetupPluginEntry;
+
+export { _default as default };

package/dist/setup-entry.js

@@ -0,0 +1,46 @@
+// src/setup-entry.ts
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";
+var setup_entry_default = defineSetupPluginEntry({
+  async onSetup(context) {
+    const appId = await context.prompt({
+      type: "text",
+      message: "Enter your Feihan App ID:",
+      validate: (val) => val.length > 0 || "This field is required"
+    });
+    const appSecret = await context.prompt({
+      type: "password",
+      message: "Enter your Feihan App Secret:",
+      validate: (val) => val.length > 0 || "This field is required"
+    });
+    const backendUrl = await context.prompt({
+      type: "text",
+      message: "Enter Feihan backend server URL:",
+      validate: (val) => {
+        if (val.length === 0) return "This field is required";
+        try {
+          new URL(val);
+          return true;
+        } catch {
+          return "Please enter a valid URL";
+        }
+      }
+    });
+    const enableEncryption = await context.prompt({
+      type: "confirm",
+      message: "Enable message encryption?",
+      default: true
+    });
+    await context.updateConfig("channels.feihan.appId", appId);
+    await context.updateConfig("channels.feihan.appSecret", appSecret);
+    await context.updateConfig("channels.feihan.backendUrl", backendUrl);
+    await context.updateConfig("channels.feihan.enableEncryption", enableEncryption);
+    await context.updateConfig("channels.feihan.enabled", true);
+    console.log("\u2705 Feihan channel configuration saved successfully!");
+    console.log("\u{1F4C4} Config file: ~/.openclaw/openclaw.json");
+    console.log("\u{1F4D6} Deploy docs: https://feihanim.cn/docs/admin/bots/openclaw");
+  }
+});
+export {
+  setup_entry_default as default
+};
+//# sourceMappingURL=setup-entry.js.map

package/dist/setup-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup-entry.ts"],"sourcesContent":["// Copyright (c) 2026 上海飞函安全科技有限公司 (Shanghai Feihan Security Technology Co., Ltd.)\n// SPDX-License-Identifier: Apache-2.0\n\nimport { defineSetupPluginEntry } from \"openclaw/plugin-sdk/core\";\n\nexport default defineSetupPluginEntry({\n  async onSetup(context) {\n    const appId = await context.prompt({\n      type: \"text\",\n      message: \"Enter your Feihan App ID:\",\n      validate: (val: string) => val.length > 0 || \"This field is required\",\n    });\n\n    const appSecret = await context.prompt({\n      type: \"password\",\n      message: \"Enter your Feihan App Secret:\",\n      validate: (val: string) => val.length > 0 || \"This field is required\",\n    });\n\n    const backendUrl = await context.prompt({\n      type: \"text\",\n      message: \"Enter Feihan backend server URL:\",\n      validate: (val: string) => {\n        if (val.length === 0) return \"This field is required\";\n        try {\n          new URL(val);\n          return true;\n        } catch {\n          return \"Please enter a valid URL\";\n        }\n      },\n    });\n\n    const enableEncryption = await context.prompt({\n      type: \"confirm\",\n      message: \"Enable message encryption?\",\n      default: true,\n    });\n\n    // Write config to ~/.openclaw/openclaw.json\n    await context.updateConfig(\"channels.feihan.appId\", appId);\n    await context.updateConfig(\"channels.feihan.appSecret\", appSecret);\n    await context.updateConfig(\"channels.feihan.backendUrl\", backendUrl);\n    await context.updateConfig(\"channels.feihan.enableEncryption\", enableEncryption);\n    await context.updateConfig(\"channels.feihan.enabled\", true);\n\n    console.log(\"✅ Feihan channel configuration saved successfully!\");\n    console.log(\"📄 Config file: ~/.openclaw/openclaw.json\");\n    console.log(\"📖 Deploy docs: https://feihanim.cn/docs/admin/bots/openclaw\");\n  },\n});\n"],"mappings":";AAGA,SAAS,8BAA8B;AAEvC,IAAO,sBAAQ,uBAAuB;AAAA,EACpC,MAAM,QAAQ,SAAS;AACrB,UAAM,QAAQ,MAAM,QAAQ,OAAO;AAAA,MACjC,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU,CAAC,QAAgB,IAAI,SAAS,KAAK;AAAA,IAC/C,CAAC;AAED,UAAM,YAAY,MAAM,QAAQ,OAAO;AAAA,MACrC,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU,CAAC,QAAgB,IAAI,SAAS,KAAK;AAAA,IAC/C,CAAC;AAED,UAAM,aAAa,MAAM,QAAQ,OAAO;AAAA,MACtC,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU,CAAC,QAAgB;AACzB,YAAI,IAAI,WAAW,EAAG,QAAO;AAC7B,YAAI;AACF,cAAI,IAAI,GAAG;AACX,iBAAO;AAAA,QACT,QAAQ;AACN,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,mBAAmB,MAAM,QAAQ,OAAO;AAAA,MAC5C,MAAM;AAAA,MACN,SAAS;AAAA,MACT,SAAS;AAAA,IACX,CAAC;AAGD,UAAM,QAAQ,aAAa,yBAAyB,KAAK;AACzD,UAAM,QAAQ,aAAa,6BAA6B,SAAS;AACjE,UAAM,QAAQ,aAAa,8BAA8B,UAAU;AACnE,UAAM,QAAQ,aAAa,oCAAoC,gBAAgB;AAC/E,UAAM,QAAQ,aAAa,2BAA2B,IAAI;AAE1D,YAAQ,IAAI,yDAAoD;AAChE,YAAQ,IAAI,kDAA2C;AACvD,YAAQ,IAAI,qEAA8D;AAAA,EAC5E;AACF,CAAC;","names":[]}

package/openclaw.plugin.json

@@ -0,0 +1,69 @@
+{
+  "id": "feihan",
+  "name": "Feihan Channel",
+  "description": "Connect OpenClaw with Feihan",
+  "version": "0.1.0",
+  "kind": "channel",
+  "channels": ["feihan"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["appId", "appSecret", "backendUrl"],
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "description": "Enable this channel",
+        "default": true
+      },
+      "appId": {
+        "type": "string",
+        "description": "Feihan application ID"
+      },
+      "appSecret": {
+        "type": "string",
+        "description": "Feihan application secret"
+      },
+      "backendUrl": {
+        "type": "string",
+        "description": "Feihan backend URL (e.g., https://your-backend-url.com)"
+      },
+      "enableEncryption": {
+        "type": "boolean",
+        "description": "Enable message encryption",
+        "default": true
+      },
+      "requestTimeout": {
+        "type": "number",
+        "description": "Request timeout in milliseconds",
+        "default": 30000
+      },
+      "requireMention": {
+        "type": "boolean",
+        "description": "Require @mention in group chats before responding",
+        "default": true
+      },
+      "accounts": {
+        "type": "object",
+        "description": "Multi-account configuration",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "appId": { "type": "string" },
+            "appSecret": { "type": "string" },
+            "backendUrl": { "type": "string" },
+            "enableEncryption": { "type": "boolean" },
+            "requestTimeout": { "type": "number" },
+            "requireMention": { "type": "boolean" }
+          },
+          "required": ["appId", "appSecret", "backendUrl"]
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "appId": { "label": "App ID" },
+    "appSecret": { "label": "App Secret", "sensitive": true },
+    "backendUrl": { "label": "Backend URL", "placeholder": "https://your-backend-url.com" }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@feihan-im/openclaw-plugin",
-  "version": "0.1.0",
-  "description": "飞函 IM OpenClaw 频道插件",
+  "version": "0.1.2",
+  "description": "Feihan IM OpenClaw channel plugin",
   "author": "上海飞函安全科技有限公司",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,9 +22,11 @@
   "sideEffects": false,
   "files": [
     "dist",
-    "src"
+    "src",
+    "openclaw.plugin.json"
   ],
   "openclaw": {
+    "setup": "./dist/src/setup-entry.js",
     "extensions": [
       "./dist/index.js"
     ],
@@ -44,7 +46,7 @@
     "test:watch": "vitest",
     "clean": "rm -rf dist"
   },
-  "keywords": ["openclaw", "channel", "plugin", "feihan", "飞函", "im"],
+  "keywords": ["openclaw", "channel", "plugin", "feihan", "im"],
   "engines": {
     "node": ">=18.0.0"
   },
@@ -58,7 +60,12 @@
     "url": "https://github.com/feihan-im/openclaw-feihan/issues"
   },
   "peerDependencies": {
-    "openclaw": "*"
+    "openclaw": ">=2026.3.22"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@feihan-im/sdk": "0.28.108",

package/src/config.test.ts

@@ -54,7 +54,7 @@ describe("resolveAccountConfig", () => {
         feihan: {
           appId: "app_1",
           appSecret: "secret_1",
-          backendUrl: "https://api.feihan.im",
+          backendUrl: "https://your-backend-url.com",
         },
       },
     };
@@ -64,7 +64,7 @@ describe("resolveAccountConfig", () => {
       enabled: true,
       appId: "app_1",
       appSecret: "secret_1",
-      backendUrl: "https://api.feihan.im",
+      backendUrl: "https://your-backend-url.com",
       enableEncryption: true,
       requestTimeout: 30_000,
       requireMention: true,
@@ -102,13 +102,13 @@ describe("resolveAccountConfig", () => {
 
     process.env.FEIHAN_APP_ID = "env_app";
     process.env.FEIHAN_APP_SECRET = "env_secret";
-    process.env.FEIHAN_BACKEND_URL = "http://env.feihan.im";
+    process.env.FEIHAN_BACKEND_URL = "https://your-backend-url.com";
 
     try {
       const account = resolveAccountConfig({});
       expect(account.appId).toBe("env_app");
       expect(account.appSecret).toBe("env_secret");
-      expect(account.backendUrl).toBe("http://env.feihan.im");
+      expect(account.backendUrl).toBe("https://your-backend-url.com");
     } finally {
       if (origId === undefined) delete process.env.FEIHAN_APP_ID;
       else process.env.FEIHAN_APP_ID = origId;
@@ -213,7 +213,7 @@ describe("resolveAndValidateAccountConfig", () => {
         feihan: {
           appId: "app_1",
           appSecret: "secret_1",
-          backendUrl: "https://api.feihan.im",
+          backendUrl: "https://your-backend-url.com",
         },
       },
     };

package/src/messaging/inbound.test.ts

@@ -29,7 +29,7 @@ function makeAccount(
     enabled: true,
     appId: "app_test",
     appSecret: "secret",
-    backendUrl: "https://api.feihan.test",
+    backendUrl: "https://your-backend-url.com",
     enableEncryption: true,
     requestTimeout: 30_000,
     requireMention: true,

package/src/setup-entry.ts

@@ -0,0 +1,51 @@
+// Copyright (c) 2026 上海飞函安全科技有限公司 (Shanghai Feihan Security Technology Co., Ltd.)
+// SPDX-License-Identifier: Apache-2.0
+
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";
+
+export default defineSetupPluginEntry({
+  async onSetup(context) {
+    const appId = await context.prompt({
+      type: "text",
+      message: "Enter your Feihan App ID:",
+      validate: (val: string) => val.length > 0 || "This field is required",
+    });
+
+    const appSecret = await context.prompt({
+      type: "password",
+      message: "Enter your Feihan App Secret:",
+      validate: (val: string) => val.length > 0 || "This field is required",
+    });
+
+    const backendUrl = await context.prompt({
+      type: "text",
+      message: "Enter Feihan backend server URL:",
+      validate: (val: string) => {
+        if (val.length === 0) return "This field is required";
+        try {
+          new URL(val);
+          return true;
+        } catch {
+          return "Please enter a valid URL";
+        }
+      },
+    });
+
+    const enableEncryption = await context.prompt({
+      type: "confirm",
+      message: "Enable message encryption?",
+      default: true,
+    });
+
+    // Write config to ~/.openclaw/openclaw.json
+    await context.updateConfig("channels.feihan.appId", appId);
+    await context.updateConfig("channels.feihan.appSecret", appSecret);
+    await context.updateConfig("channels.feihan.backendUrl", backendUrl);
+    await context.updateConfig("channels.feihan.enableEncryption", enableEncryption);
+    await context.updateConfig("channels.feihan.enabled", true);
+
+    console.log("✅ Feihan channel configuration saved successfully!");
+    console.log("📄 Config file: ~/.openclaw/openclaw.json");
+    console.log("📖 Deploy docs: https://feihanim.cn/docs/admin/bots/openclaw");
+  },
+});

package/src/typings/openclaw-plugin-sdk.d.ts

@@ -0,0 +1,29 @@
+// Copyright (c) 2026 上海飞函安全科技有限公司 (Shanghai Feihan Security Technology Co., Ltd.)
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Type declarations for openclaw/plugin-sdk/core.
+ *
+ * These types provide the minimal interface needed for the setup entry point.
+ * The actual implementation is provided by the OpenClaw runtime at plugin load time.
+ */
+
+declare module "openclaw/plugin-sdk/core" {
+  export interface PromptOptions {
+    type: "text" | "password" | "confirm" | "select";
+    message: string;
+    default?: string | boolean;
+    validate?: (value: string) => boolean | string;
+  }
+
+  export interface SetupContext {
+    prompt: (options: PromptOptions) => Promise<string>;
+    updateConfig: (key: string, value: string | boolean | number) => Promise<void>;
+  }
+
+  export interface SetupPluginEntry {
+    onSetup: (context: SetupContext) => Promise<void>;
+  }
+
+  export function defineSetupPluginEntry(entry: SetupPluginEntry): SetupPluginEntry;
+}

package/src/typings/feihan-sdk.d.ts

@@ -1,23 +0,0 @@
-// Copyright (c) 2026 上海飞函安全科技有限公司 (Shanghai Feihan Security Technology Co., Ltd.)
-// SPDX-License-Identifier: Apache-2.0
-
-/**
- * Re-export types from @feihan-im/sdk used across the plugin.
- *
- * The published SDK ships its own type declarations. This file exists
- * only to keep the rest of the plugin importing from a single local
- * barrel, making future SDK swaps cheaper.
- */
-export type {
-  FeihanClient,
-  FeihanClientOptions,
-} from "@feihan-im/sdk";
-
-export {
-  LoggerLevel,
-} from "@feihan-im/sdk";
-
-export type {
-  Logger,
-  EventHeader,
-} from "@feihan-im/sdk";