@poolzin/pool-bot 2026.3.10 → 2026.3.11
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.
- package/CHANGELOG.md +11 -0
- package/dist/build-info.json +3 -3
- package/extensions/bluebubbles/package.json +1 -1
- package/extensions/copilot-proxy/package.json +1 -1
- package/extensions/diagnostics-otel/package.json +1 -1
- package/extensions/discord/package.json +1 -1
- package/extensions/feishu/package.json +1 -1
- package/extensions/google-antigravity-auth/package.json +1 -1
- package/extensions/google-gemini-cli-auth/package.json +1 -1
- package/extensions/googlechat/package.json +1 -1
- package/extensions/hexstrike-bridge/package.json +1 -1
- package/extensions/imessage/package.json +1 -1
- package/extensions/irc/package.json +1 -1
- package/extensions/line/package.json +1 -1
- package/extensions/llm-task/package.json +1 -1
- package/extensions/lobster/package.json +1 -1
- package/extensions/matrix/CHANGELOG.md +5 -0
- package/extensions/matrix/package.json +1 -1
- package/extensions/mattermost/package.json +1 -1
- package/extensions/mavalie/README.md +97 -0
- package/extensions/mavalie/package.json +15 -0
- package/extensions/mavalie/src/index.ts +62 -0
- package/extensions/mcp-server/package.json +1 -1
- package/extensions/memory-core/package.json +1 -1
- package/extensions/memory-lancedb/package.json +1 -1
- package/extensions/minimax-portal-auth/package.json +1 -1
- package/extensions/msteams/CHANGELOG.md +5 -0
- package/extensions/msteams/package.json +1 -1
- package/extensions/nextcloud-talk/package.json +1 -1
- package/extensions/nostr/CHANGELOG.md +5 -0
- package/extensions/nostr/package.json +1 -1
- package/extensions/open-prose/package.json +1 -1
- package/extensions/openai-codex-auth/package.json +1 -1
- package/extensions/signal/package.json +1 -1
- package/extensions/slack/package.json +1 -1
- package/extensions/telegram/package.json +1 -1
- package/extensions/tlon/package.json +1 -1
- package/extensions/twitch/CHANGELOG.md +5 -0
- package/extensions/twitch/package.json +1 -1
- package/extensions/voice-call/CHANGELOG.md +5 -0
- package/extensions/voice-call/package.json +1 -1
- package/extensions/whatsapp/package.json +1 -1
- package/extensions/zalo/CHANGELOG.md +5 -0
- package/extensions/zalo/package.json +1 -1
- package/extensions/zalouser/CHANGELOG.md +5 -0
- package/extensions/zalouser/package.json +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,14 @@
|
|
|
1
|
+
## v2026.3.11 (2026-03-11)
|
|
2
|
+
|
|
3
|
+
### Features
|
|
4
|
+
- **Mavalie Plugin Template:** new example plugin `extensions/mavalie/` demonstrating proper PoolBot plugin structure
|
|
5
|
+
- Minimal valid plugin using `poolbot/plugin-sdk` with `emptyPluginConfigSchema()`
|
|
6
|
+
- TypeScript entry point with jiti transpilation support
|
|
7
|
+
- Provider registration example with API key authentication pattern
|
|
8
|
+
- Comprehensive README with plugin development guidelines
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
1
12
|
## v2026.3.10 (2026-03-10)
|
|
2
13
|
|
|
3
14
|
### Features
|
package/dist/build-info.json
CHANGED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Mavalie Plugin for PoolBot
|
|
2
|
+
|
|
3
|
+
Plugin template válido para PoolBot.
|
|
4
|
+
|
|
5
|
+
## Estrutura
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
extensions/mavalie/
|
|
9
|
+
├── package.json # Manifest do plugin
|
|
10
|
+
├── src/
|
|
11
|
+
│ └── index.ts # Entry point
|
|
12
|
+
└── README.md # Esta documentação
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Instalação
|
|
16
|
+
|
|
17
|
+
1. **Build do plugin:**
|
|
18
|
+
```bash
|
|
19
|
+
cd extensions/mavalie
|
|
20
|
+
npm install
|
|
21
|
+
npm run build # ou pnpm build
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
2. **Ativação no PoolBot:**
|
|
25
|
+
O plugin é carregado automaticamente pelo PoolBot quando:
|
|
26
|
+
- O diretório está em `extensions/mavalie/`
|
|
27
|
+
- O `package.json` tem a seção `poolbot.extensions` configurada
|
|
28
|
+
- O entry point (`dist/index.js`) existe
|
|
29
|
+
|
|
30
|
+
## Configuração
|
|
31
|
+
|
|
32
|
+
O plugin usa `emptyPluginConfigSchema()`, ou seja, não requer configuração.
|
|
33
|
+
|
|
34
|
+
Para adicionar configurações, substitua por:
|
|
35
|
+
|
|
36
|
+
```typescript
|
|
37
|
+
import { z } from "zod";
|
|
38
|
+
|
|
39
|
+
const configSchema = z.object({
|
|
40
|
+
apiKey: z.string().optional(),
|
|
41
|
+
endpoint: z.string().url().default("https://api.mavalie.com"),
|
|
42
|
+
});
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Desenvolvimento
|
|
46
|
+
|
|
47
|
+
### Padrões de Plugin
|
|
48
|
+
|
|
49
|
+
O PoolBot suporta 4 tipos de extensões:
|
|
50
|
+
|
|
51
|
+
1. **Provider** - Adiciona novos modelos LLM
|
|
52
|
+
2. **Channel** - Adiciona canais de comunicação (Discord, Slack, etc)
|
|
53
|
+
3. **Tool** - Adiciona ferramentas para agentes
|
|
54
|
+
4. **Hook** - Intercepta eventos do ciclo de vida
|
|
55
|
+
|
|
56
|
+
### Exemplo: Registrando um Provider
|
|
57
|
+
|
|
58
|
+
```typescript
|
|
59
|
+
api.registerProvider({
|
|
60
|
+
id: "mavalie",
|
|
61
|
+
label: "Mavalie AI",
|
|
62
|
+
auth: [{
|
|
63
|
+
id: "api-key",
|
|
64
|
+
kind: "apiKey",
|
|
65
|
+
run: async (ctx) => {
|
|
66
|
+
const key = await ctx.prompter.password({
|
|
67
|
+
message: "Mavalie API Key:"
|
|
68
|
+
});
|
|
69
|
+
return {
|
|
70
|
+
profiles: [{
|
|
71
|
+
profileId: "mavalie:default",
|
|
72
|
+
credential: { type: "apiKey", key: String(key) }
|
|
73
|
+
}]
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
}]
|
|
77
|
+
});
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Troubleshooting
|
|
81
|
+
|
|
82
|
+
### "plugin manifest not found"
|
|
83
|
+
- Verifique se `package.json` existe e tem `poolbot.extensions`
|
|
84
|
+
- Verifique se o caminho em `extensions` aponta para o arquivo correto
|
|
85
|
+
|
|
86
|
+
### "extension entry escapes package directory"
|
|
87
|
+
- O entry point deve estar dentro do diretório do plugin
|
|
88
|
+
- Use `./dist/index.js` (não `./src/index.ts` para produção)
|
|
89
|
+
|
|
90
|
+
### Erros de TypeScript "Cannot find module 'poolbot/plugin-sdk'"
|
|
91
|
+
- Normal durante desenvolvimento - o alias só resolve após build
|
|
92
|
+
- O build do PoolBot principal resolve essas dependências
|
|
93
|
+
|
|
94
|
+
## Referências
|
|
95
|
+
|
|
96
|
+
- [Plugin SDK Documentation](../../docs/refactor/plugin-sdk.md)
|
|
97
|
+
- [Exemplos de Plugins](../discord/, ../slack/, etc.)
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@poolbot/mavalie",
|
|
3
|
+
"version": "2026.3.11",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "Mavalie plugin for PoolBot - custom integration",
|
|
6
|
+
"poolbot": {
|
|
7
|
+
"extensions": [
|
|
8
|
+
"./src/index.ts"
|
|
9
|
+
]
|
|
10
|
+
},
|
|
11
|
+
"dependencies": {},
|
|
12
|
+
"devDependencies": {
|
|
13
|
+
"poolbot": "workspace:*"
|
|
14
|
+
}
|
|
15
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { emptyPluginConfigSchema } from "poolbot/plugin-sdk";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Mavalie Plugin for PoolBot
|
|
5
|
+
*
|
|
6
|
+
* Template mínimo válido de plugin para PoolBot.
|
|
7
|
+
* Este plugin registra um provider customizado que pode ser expandido
|
|
8
|
+
* conforme necessidades específicas.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
const mavaliePlugin = {
|
|
12
|
+
id: "mavalie",
|
|
13
|
+
name: "Mavalie",
|
|
14
|
+
description: "Custom Mavalie integration for PoolBot",
|
|
15
|
+
configSchema: emptyPluginConfigSchema(),
|
|
16
|
+
|
|
17
|
+
register(api) {
|
|
18
|
+
// Log de registro do plugin
|
|
19
|
+
api.runtime?.log?.("Mavalie plugin registered");
|
|
20
|
+
|
|
21
|
+
// TODO: Adicione aqui o registro de:
|
|
22
|
+
// - Providers (modelos customizados)
|
|
23
|
+
// - Canais (integrações de mensageria)
|
|
24
|
+
// - Ferramentas (tools para agentes)
|
|
25
|
+
// - Hooks (eventos do ciclo de vida)
|
|
26
|
+
|
|
27
|
+
// Exemplo de registro de provider (descomente e adapte):
|
|
28
|
+
/*
|
|
29
|
+
api.registerProvider({
|
|
30
|
+
id: "mavalie",
|
|
31
|
+
label: "Mavalie Provider",
|
|
32
|
+
docsPath: "/providers/models",
|
|
33
|
+
auth: [
|
|
34
|
+
{
|
|
35
|
+
id: "api-key",
|
|
36
|
+
label: "API Key",
|
|
37
|
+
kind: "apiKey",
|
|
38
|
+
run: async (ctx) => {
|
|
39
|
+
const key = await ctx.prompter.password({
|
|
40
|
+
message: "Enter your Mavalie API key:",
|
|
41
|
+
});
|
|
42
|
+
return {
|
|
43
|
+
profiles: [
|
|
44
|
+
{
|
|
45
|
+
profileId: "mavalie:default",
|
|
46
|
+
credential: {
|
|
47
|
+
type: "apiKey",
|
|
48
|
+
provider: "mavalie",
|
|
49
|
+
key: String(key),
|
|
50
|
+
},
|
|
51
|
+
},
|
|
52
|
+
],
|
|
53
|
+
};
|
|
54
|
+
},
|
|
55
|
+
},
|
|
56
|
+
],
|
|
57
|
+
});
|
|
58
|
+
*/
|
|
59
|
+
},
|
|
60
|
+
};
|
|
61
|
+
|
|
62
|
+
export default mavaliePlugin;
|