@zhin.js/adapter-telegram 5.0.1 → 5.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/CHANGELOG.md +56 -0
  2. package/README.md +65 -139
  3. package/adapters/telegram.ts +27 -0
  4. package/agent/tools/create_invite.ts +20 -0
  5. package/agent/tools/list_admins.ts +26 -0
  6. package/agent/tools/member_count.ts +18 -0
  7. package/agent/tools/pin_message.ts +21 -0
  8. package/agent/tools/react.ts +20 -0
  9. package/agent/tools/send_poll.ts +34 -0
  10. package/agent/tools/send_sticker.ts +19 -0
  11. package/agent/tools/set_description.ts +19 -0
  12. package/agent/tools/set_permissions.ts +33 -0
  13. package/agent/tools/unpin_message.ts +21 -0
  14. package/lib/endpoint.d.ts +58 -148
  15. package/lib/endpoint.js +273 -987
  16. package/lib/index.d.ts +4 -18
  17. package/lib/index.js +4 -462
  18. package/lib/platform-permit.d.ts +1 -2
  19. package/lib/platform-permit.js +4 -2
  20. package/lib/polling.d.ts +9 -0
  21. package/lib/polling.js +52 -0
  22. package/lib/protocol.d.ts +250 -0
  23. package/lib/protocol.js +324 -0
  24. package/lib/telegram-agent-deps.d.ts +28 -0
  25. package/lib/telegram-agent-deps.js +30 -0
  26. package/lib/webhook.d.ts +13 -0
  27. package/lib/webhook.js +45 -0
  28. package/package.json +46 -33
  29. package/plugin.ts +13 -0
  30. package/schema.json +39 -0
  31. package/src/endpoint.ts +339 -1103
  32. package/src/index.ts +39 -435
  33. package/src/platform-permit.ts +1 -2
  34. package/src/polling.ts +71 -0
  35. package/src/protocol.ts +573 -0
  36. package/src/telegram-agent-deps.ts +63 -0
  37. package/src/webhook.ts +67 -0
  38. package/client/Dashboard.tsx +0 -295
  39. package/client/index.tsx +0 -11
  40. package/client/tsconfig.json +0 -7
  41. package/client/utils/api.ts +0 -30
  42. package/dist/index.js +0 -32
  43. package/lib/adapter.d.ts +0 -21
  44. package/lib/adapter.d.ts.map +0 -1
  45. package/lib/adapter.js +0 -58
  46. package/lib/adapter.js.map +0 -1
  47. package/lib/endpoint.d.ts.map +0 -1
  48. package/lib/endpoint.js.map +0 -1
  49. package/lib/index.d.ts.map +0 -1
  50. package/lib/index.js.map +0 -1
  51. package/lib/platform-permit.d.ts.map +0 -1
  52. package/lib/platform-permit.js.map +0 -1
  53. package/lib/segment-mapper.d.ts +0 -2
  54. package/lib/segment-mapper.d.ts.map +0 -1
  55. package/lib/segment-mapper.js +0 -2
  56. package/lib/segment-mapper.js.map +0 -1
  57. package/lib/types.d.ts +0 -29
  58. package/lib/types.d.ts.map +0 -1
  59. package/lib/types.js +0 -2
  60. package/lib/types.js.map +0 -1
  61. package/plugin.yml +0 -3
  62. package/src/adapter.ts +0 -66
  63. package/src/segment-mapper.ts +0 -1
  64. package/src/types.ts +0 -32
  65. /package/{skills/telegram → agent}/PERMITS.md +0 -0
  66. /package/{skills/telegram/SKILL.md → agent/skills/telegram.md} +0 -0
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@zhin.js/adapter-telegram",
3
- "version": "5.0.1",
4
- "description": "Zhin.js adapter for Telegram",
3
+ "version": "5.0.3",
4
+ "description": "Zhin.js Telegram Bot API adapter for Plugin Runtime (long-poll getUpdates)",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",
7
7
  "types": "./lib/index.d.ts",
@@ -32,48 +32,47 @@
32
32
  "directory": "plugins/adapters/telegram"
33
33
  },
34
34
  "dependencies": {
35
- "telegraf": "^4.16.3"
36
- },
37
- "devDependencies": {
38
- "@types/node": "^26.1.0",
39
- "@types/react": "^19.2.17",
40
- "@types/react-dom": "^19.2.3",
41
- "lucide-react": "^1.22.0",
42
- "typescript": "^6.0.3",
43
- "@zhin.js/cli": "1.0.92",
44
- "@zhin.js/client": "2.0.4",
45
- "@zhin.js/contract": "1.0.2",
46
- "@zhin.js/host-api": "2.0.4",
47
- "@zhin.js/host-router": "2.0.2",
48
- "zhin.js": "4.1.1",
49
- "@zhin.js/logger": "1.0.73"
35
+ "@zhin.js/adapter": "1.0.1",
36
+ "@zhin.js/core": "1.3.5",
37
+ "@zhin.js/host-http": "1.0.1",
38
+ "@zhin.js/logger": "1.0.75",
39
+ "@zhin.js/plugin-runtime": "1.0.1"
50
40
  },
51
41
  "peerDependencies": {
52
- "@zhin.js/client": "2.0.4",
53
- "@zhin.js/host-api": "2.0.4",
54
- "@zhin.js/host-router": "2.0.2",
55
- "@zhin.js/contract": "1.0.2",
56
- "@zhin.js/logger": "1.0.73",
57
- "zhin.js": "4.1.1"
42
+ "zod": "^4.0.0",
43
+ "@zhin.js/adapter": "1.0.1",
44
+ "@zhin.js/agent": "1.0.4",
45
+ "@zhin.js/core": "1.3.5",
46
+ "@zhin.js/plugin-runtime": "1.0.1",
47
+ "zhin.js": "4.1.3"
58
48
  },
59
49
  "peerDependenciesMeta": {
60
- "@zhin.js/client": {
50
+ "zhin.js": {
61
51
  "optional": true
62
52
  },
63
- "@zhin.js/host-router": {
53
+ "@zhin.js/agent": {
64
54
  "optional": true
65
55
  },
66
- "@zhin.js/host-api": {
56
+ "zod": {
67
57
  "optional": true
68
58
  }
69
59
  },
60
+ "devDependencies": {
61
+ "@types/node": "^26.1.0",
62
+ "typescript": "^6.0.3",
63
+ "vitest": "^4.1.10",
64
+ "zod": "^4.4.3",
65
+ "@zhin.js/agent": "1.0.4",
66
+ "@zhin.js/host-http": "1.0.1",
67
+ "zhin.js": "4.1.3"
68
+ },
70
69
  "files": [
70
+ "adapters",
71
+ "plugin.ts",
72
+ "schema.json",
71
73
  "src",
72
74
  "lib",
73
- "client",
74
- "dist",
75
- "skills",
76
- "plugin.yml",
75
+ "agent",
77
76
  "README.md",
78
77
  "CHANGELOG.md"
79
78
  ],
@@ -84,9 +83,23 @@
84
83
  "engines": {
85
84
  "node": "^20.19.0 || >=22.12.0"
86
85
  },
86
+ "zhin": {
87
+ "protocol": 1,
88
+ "type": "plugin",
89
+ "entry": "./plugin.ts",
90
+ "engine": "^1.0.0",
91
+ "runtime": "trusted",
92
+ "features": [
93
+ {
94
+ "package": "@zhin.js/adapter",
95
+ "api": "^1.0.0"
96
+ }
97
+ ],
98
+ "plugins": []
99
+ },
87
100
  "scripts": {
88
- "build": "zhin build",
89
- "clean": "rimraf lib dist",
90
- "build:node": "tsc"
101
+ "build": "tsc",
102
+ "clean": "rimraf lib",
103
+ "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/telegram/tests"
91
104
  }
92
105
  }
package/plugin.ts ADDED
@@ -0,0 +1,13 @@
1
+ import { definePlugin } from '@zhin.js/plugin-runtime';
2
+ import { registerTelegramPlatformPermitChecker } from './src/platform-permit.js';
3
+
4
+ export default definePlugin({
5
+ name: 'telegram',
6
+ metadata: {
7
+ displayName: 'Telegram Bot API Adapter',
8
+ },
9
+ setup() {
10
+ // 平台权限门禁：chat_creator / chat_administrator / pin_messages 等（agent 工具 platformPermit）
11
+ return registerTelegramPlatformPermitChecker();
12
+ },
13
+ });
package/schema.json ADDED
@@ -0,0 +1,39 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "additionalProperties": false,
5
+ "properties": {
6
+ "name": {
7
+ "type": "string",
8
+ "default": "telegram-bot"
9
+ },
10
+ "token": {
11
+ "type": "string"
12
+ },
13
+ "polling": {
14
+ "type": "boolean",
15
+ "default": true,
16
+ "description": "Long-poll getUpdates (default). Set false for webhook via httpHostToken."
17
+ },
18
+ "webhook": {
19
+ "type": "object",
20
+ "additionalProperties": false,
21
+ "description": "Webhook settings when polling is false.",
22
+ "properties": {
23
+ "domain": { "type": "string" },
24
+ "path": { "type": "string", "default": "/telegram/webhook" },
25
+ "secretToken": { "type": "string", "description": "Verified via X-Telegram-Bot-Api-Secret-Token." }
26
+ }
27
+ },
28
+ "allowedUpdates": {
29
+ "type": "array",
30
+ "items": { "type": "string" },
31
+ "default": ["message", "callback_query"]
32
+ },
33
+ "apiBaseUrl": {
34
+ "type": "string",
35
+ "default": "https://api.telegram.org"
36
+ }
37
+ },
38
+ "required": ["token"]
39
+ }