busybits 0.0.0-stage → 2.0.0
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/.claude-plugin/marketplace.json +26 -0
- package/CHANGELOG.md +675 -0
- package/LICENSE +21 -0
- package/README.es.md +1457 -0
- package/README.fr.md +1435 -0
- package/README.md +1605 -2
- package/README.pt-BR.md +1373 -0
- package/dist/build.json +5 -0
- package/dist/cli/busybits.js +14708 -0
- package/dist/client/assets/art/framed/painting-abstract.png +0 -0
- package/dist/client/assets/art/framed/painting-beach.png +0 -0
- package/dist/client/assets/art/framed/painting-cat.png +0 -0
- package/dist/client/assets/art/framed/painting-city-night.png +0 -0
- package/dist/client/assets/art/framed/painting-mountains.png +0 -0
- package/dist/client/assets/art/framed/painting-rio.png +0 -0
- package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/framed/painting-wave.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/painting-abstract.png +0 -0
- package/dist/client/assets/art/painting-beach.png +0 -0
- package/dist/client/assets/art/painting-cat.png +0 -0
- package/dist/client/assets/art/painting-city-night.png +0 -0
- package/dist/client/assets/art/painting-mountains.png +0 -0
- package/dist/client/assets/art/painting-rio.png +0 -0
- package/dist/client/assets/art/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/painting-wave.png +0 -0
- package/dist/client/assets/art/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/poster-bug.png +0 -0
- package/dist/client/assets/art/poster-cat.png +0 -0
- package/dist/client/assets/art/poster-code.png +0 -0
- package/dist/client/assets/art/poster-coffee.png +0 -0
- package/dist/client/assets/art/poster-rocket.png +0 -0
- package/dist/client/assets/art/poster-ship-it.png +0 -0
- package/dist/client/assets/brand/apple-touch-icon.png +0 -0
- package/dist/client/assets/brand/favicon-16.png +0 -0
- package/dist/client/assets/brand/favicon-32.png +0 -0
- package/dist/client/assets/brand/icon-192.png +0 -0
- package/dist/client/assets/brand/icon-512.png +0 -0
- package/dist/client/assets/brand/logo-detailed.png +0 -0
- package/dist/client/assets/brand/logo-mark.png +0 -0
- package/dist/client/assets/brand/logo-mark@4x.png +0 -0
- package/dist/client/assets/brand/signage.png +0 -0
- package/dist/client/assets/brand/signage@4x.png +0 -0
- package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
- package/dist/client/assets/emoji/sheet.png +0 -0
- package/dist/client/assets/illustrations/empty-office.png +0 -0
- package/dist/client/assets/manifest.json +260 -0
- package/dist/client/assets/og-image.png +0 -0
- package/dist/client/bundle/app-AwZeKIeu.js +24 -0
- package/dist/client/bundle/app-CoDOLwxe.css +1 -0
- package/dist/client/bundle/city-DPTwQLdi.css +1 -0
- package/dist/client/bundle/city-YoIG0FsX.js +1 -0
- package/dist/client/bundle/daystats-DGzYOP8l.js +1 -0
- package/dist/client/bundle/dom-D2vx0KTo.js +1 -0
- package/dist/client/bundle/en-DBfNt5uV.js +169 -0
- package/dist/client/bundle/es-pnWdszTE.js +169 -0
- package/dist/client/bundle/format-C7qb6Cn-.js +1 -0
- package/dist/client/bundle/fr-CY8q9pj4.js +169 -0
- package/dist/client/bundle/main-DktU0GfB.js +2 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
- package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
- package/dist/client/bundle/ptypane-NIZ2Y8QM.js +16 -0
- package/dist/client/bundle/room-name-CFJfHE5L.js +1 -0
- package/dist/client/bundle/simulator-BnBPS_Ws.js +7 -0
- package/dist/client/bundle/world-model-BIYmgAWC.js +1 -0
- package/dist/client/bundle/world-stream-BRkL9Eme.js +1 -0
- package/dist/client/index.html +41 -0
- package/dist/client/manifest.webmanifest +17 -0
- package/dist/server/index.js +40327 -0
- package/mod/README.md +193 -0
- package/mod/habblaud/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud/hooks/hooks.json +4 -0
- package/mod/habblaud/hooks/register.ts +517 -0
- package/mod/habblaud-codex/hook.mjs +274 -0
- package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
- package/mod/habblaud-mensagens/hooks/register.ts +384 -0
- package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
- package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
- package/mod/habblaud-pi/core.ts +325 -0
- package/mod/habblaud-pi/extension.ts +119 -0
- package/mod/habblaud-pi/package.json +12 -0
- package/package.json +96 -4
package/mod/README.md
ADDED
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
# Plugins do Claude Code do Busybits
|
|
2
|
+
|
|
3
|
+
O repositório é também um marketplace de plugins do Claude Code: `.claude-plugin/marketplace.json` (na raiz)
|
|
4
|
+
lista o marketplace `habblaud` com três plugins, um em cada pasta daqui: o mod `busybits` (só observa; mora na pasta `mod/habblaud`),
|
|
5
|
+
`busybits-permissions` (responder permissões pelo escritório) e `busybits-messages` (mandar mensagens pelo
|
|
6
|
+
escritório). O `npm run mod:install` instala os três; `--sem-permissoes` e `--sem-mensagens` deixam o seu de fora.
|
|
7
|
+
As versões acompanham o `package.json` (o teste `server/test/mod.test.ts` falha se divergirem).
|
|
8
|
+
|
|
9
|
+
Testado com o **Claude Code 2.1.293** (o `busybits-messages`, por enquanto só pelo `claude plugin test` do
|
|
10
|
+
2.1.295). Mods (hooks em TypeScript carregados pelo próprio Claude Code) existem a partir da 2.1.287; a API ainda é
|
|
11
|
+
"early access" e pode mudar entre versões. Em versões anteriores, use os instaladores de sempre
|
|
12
|
+
(`npm run usage:install` e `npm run hooks:install`); mandar mensagens pelo escritório só existe com o mod. A
|
|
13
|
+
instalação está no README principal.
|
|
14
|
+
|
|
15
|
+
## `busybits` — o mod
|
|
16
|
+
|
|
17
|
+
`habblaud/hooks/register.ts`, um módulo só, sem build. Liga cada sessão ao escritório sem ler a conversa:
|
|
18
|
+
|
|
19
|
+
- **Uso do plano (5h e semanal):** no início da sessão e a cada `session.measure` (depois de cada turno e quando
|
|
20
|
+
um limite anda um ponto) lê `$.session.usage().rateLimits` e grava `~/.habblaud/usage/<conta>.json` (ou em
|
|
21
|
+
`HABBLAUD_USAGE_DIR`) no mesmo formato do tap de statusline, mais `"source": "mod"`. Substitui o
|
|
22
|
+
`npm run usage:install`: o seu statusline fica intocado. A conta é a pasta de `CLAUDE_CONFIG_DIR` (o primeiro
|
|
23
|
+
item) ou `~/.claude` (`~` é o `HOME`; no Windows sem ele, o `USERPROFILE`). Valores iguais gravados há menos de
|
|
24
|
+
10 s não são regravados; falha ao gravar = silêncio.
|
|
25
|
+
- **"Precisa de você" embaixo do prompt:** a cada 5 s pergunta ao Busybits local
|
|
26
|
+
(`GET http://127.0.0.1:<HABBLAUD_PORT ou 4747>/api/mod/summary`) quem está esperando, já sem esta sessão e os
|
|
27
|
+
subagentes dela, e mostra `🏢 Valentina precisa de você em loja-virtual` ou
|
|
28
|
+
`🏢 2 precisam de você: Valentina (loja-virtual), Elias (app-mobile)` (até 3 nomes, depois "e mais N").
|
|
29
|
+
Ninguém esperando ou Busybits fora do ar: a linha some; fora do ar, as perguntas passam a ser a cada 30 s até
|
|
30
|
+
ele voltar. Só em sessões que desenham (no `claude -p` não pergunta nada).
|
|
31
|
+
- **`/busybits`:** resumo do escritório inteiro, respondido pelo próprio mod (não chama o modelo, não gasta uso):
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
Busybits 0.3.0 em http://localhost:4747
|
|
35
|
+
7 agentes · 3 trabalhando · 2 precisam de você
|
|
36
|
+
✋ Valentina (loja-virtual): aprovar uma permissão · dá para responder pelo escritório
|
|
37
|
+
✋ Elias (app-mobile): responder no terminal
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Fora do ar: `O Busybits não respondeu em http://localhost:4747. Para subir: npm run docker:up na pasta do Busybits.`
|
|
41
|
+
|
|
42
|
+
### Language
|
|
43
|
+
|
|
44
|
+
Everything the mod writes (the line under the prompt, the `/busybits` answer and its description, the offline and
|
|
45
|
+
outdated messages) comes out in English, Spanish, Portuguese or French, with singular and plural forms. The mod picks
|
|
46
|
+
the language from the session environment, because the engine interface (`$`) does not expose Claude Code's own
|
|
47
|
+
`language` setting: `HABBLAUD_LANG` first (the same override the server uses), then `LC_ALL`, `LC_MESSAGES`, `LANG`
|
|
48
|
+
and `LANGUAGE`, skipping values it does not translate (`C`, `POSIX`, `de_DE`). With none of them set, it is English.
|
|
49
|
+
Text that comes from the server (the reason an agent is waiting) keeps the server's own language.
|
|
50
|
+
|
|
51
|
+
### Renamed from `habblaud` (up to 1.0.3)
|
|
52
|
+
|
|
53
|
+
The plugin id is now `busybits@busybits`, in a marketplace named `busybits` (it was `habblaud`). `npm run mod:install`
|
|
54
|
+
removes every `*@habblaud` plugin and the `habblaud` marketplace in each account before adding `busybits`, and
|
|
55
|
+
`npm run mod:uninstall` removes both generations. A packaged install (`busybits setup`) does the same switch, pointing the marketplace at `~/.busybits/marketplace`; until then `npm run mod:status` and `docker:up` report the old name.
|
|
56
|
+
|
|
57
|
+
### O que ele acessa
|
|
58
|
+
|
|
59
|
+
Saída de `claude plugin validate --strict mod/habblaud` (a análise estática que o Claude Code faz antes de
|
|
60
|
+
carregar o módulo; nada fora desta lista é chamado):
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
❯ ./register.ts hooks: session.start, session.measure, command.run{command=busybits}
|
|
64
|
+
❯ ./register.ts answers its own command: command.run{command=busybits}
|
|
65
|
+
❯ ./register.ts calls: $.clock.after (via askBusybits), $.clock.every (via schedule), $.clock.now (via writeUsage), $.command.register, $.env.get (via readEnv), $.fs.write (via writeUsage), $.http.fetch (via askBusybits), $.session.id (via poll), $.session.surfaces (via poll), $.session.usage, $.ui.status (via setStatus)
|
|
66
|
+
❯ ./register.ts env writes: nothing
|
|
67
|
+
❯ ./register.ts env reads: CLAUDE_CONFIG_DIR, HABBLAUD_LANG, HABBLAUD_PORT, HABBLAUD_USAGE_DIR, HOME, LANG, LANGUAGE, LC_ALL, LC_MESSAGES, USERPROFILE
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Em palavras: só observa (nenhum hook decide nada: não aprova ferramentas, não muda prompts, não lê mensagens),
|
|
71
|
+
grava um único arquivo (o de uso), fala só com `127.0.0.1` e lê dez variáveis de ambiente. `$.clock.after` é o
|
|
72
|
+
prazo de 2 s de cada pergunta ao Busybits (`$.http.fetch` não aceita AbortSignal).
|
|
73
|
+
|
|
74
|
+
## `busybits-permissions` — responder permissões pelo escritório
|
|
75
|
+
|
|
76
|
+
Um hook `PermissionRequest` comum (sem mod), em `habblaud-permissoes/hooks/hooks.json`:
|
|
77
|
+
|
|
78
|
+
```json
|
|
79
|
+
{ "matcher": "*", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/permission-hook.mjs\"", "timeout": 86430, "statusMessage": "Aguardando resposta no Busybits" }] }
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
O script `hooks/permission-hook.mjs` é o mesmo que o `npm run hooks:install` instala (fonte única; Node puro, só
|
|
83
|
+
`node:*`, porque o Claude Code copia apenas a pasta do plugin para o cache). Ele manda o pedido ao Busybits local
|
|
84
|
+
e espera a resposta por até 5 min; o diálogo continua no terminal e vale o que você responder primeiro. Sem o
|
|
85
|
+
Busybits no ar ou sem nenhuma página aberta, sai na hora. Porta: `HABBLAUD_PORT` (padrão 4747); espera:
|
|
86
|
+
`HABBLAUD_PERMISSION_TIMEOUT` (padrão 300 s, até 86400 s = 24 h; o tempo limite do hook no plugin é 86430 s). Para aprovar
|
|
87
|
+
pelo celular longe do computador, ponha `"env": { "HABBLAUD_PERMISSION_TIMEOUT": "86400" }` no `settings.json` da
|
|
88
|
+
conta: vale para as sessões abertas depois. Subagentes em segundo plano só mostram o diálogo quando o hook termina,
|
|
89
|
+
por isso o padrão continua 5 min. Precisa de `node` 22+ no `PATH` da sessão.
|
|
90
|
+
|
|
91
|
+
`claude plugin validate --strict mod/habblaud-permissoes`: `✔ Validation passed` (o validador também confere o
|
|
92
|
+
esquema do `hooks.json`).
|
|
93
|
+
|
|
94
|
+
## `busybits-messages` — mensagens pelo escritório
|
|
95
|
+
|
|
96
|
+
`habblaud-mensagens/hooks/register.ts`, um módulo só, sem build. Leva para a sessão o que você digita no escritório
|
|
97
|
+
(no painel do agente ou no terminal da tecla T), como se você tivesse digitado no terminal:
|
|
98
|
+
|
|
99
|
+
- **Busca:** a cada 2 s, só em sessões que desenham (no `claude -p` não pergunta nada),
|
|
100
|
+
`POST http://127.0.0.1:<HABBLAUD_PORT ou 4747>/api/mod/inbox` com `{session, account}`. A pergunta também marca a
|
|
101
|
+
sessão como presente: é ela que mostra, na página, a caixa de mensagem do agente (sem o plugin, a página dá a dica
|
|
102
|
+
de instalar). Fora do ar, ou respondendo outra coisa (403 com as mensagens desligadas, 404 numa versão sem a
|
|
103
|
+
rota), passa a perguntar a cada 30 s até ele voltar.
|
|
104
|
+
- **Entrega:** cada mensagem, na ordem, vai por `$.prompt.submit({ text, asUser: true })`. O modelo lê o texto como
|
|
105
|
+
seu, sem o "The busybits-messages plugin sent a message" (o registro da sessão ainda diz que veio do plugin), e o
|
|
106
|
+
texto vai exatamente como foi digitado. Com a sessão no meio de um turno, o Claude Code guarda o prompt e o roda
|
|
107
|
+
num turno só dele quando o atual terminar (um prompt de plugin nunca entra no meio do turno, como um digitado
|
|
108
|
+
pode entrar). Um hook que recuse a mensagem (`{drop}`) ou uma exceção viram falha, com o motivo, na página.
|
|
109
|
+
- **Comandos de barra:** a mensagem que começa por `/nome argumentos`, com `nome` na lista de `$.command.list()`,
|
|
110
|
+
roda por `$.command.run({ command, args })` em vez de `$.prompt.submit` (o Claude Code recusa em `$.prompt.submit`
|
|
111
|
+
todo texto que comece por `/`), e o desfecho (ok ou o erro) segue na confirmação. Com a lista fora do ar, quem
|
|
112
|
+
decide é o `$.command.run`, que rejeita nome desconhecido. Texto que começa por `/` e não é comando da sessão
|
|
113
|
+
(`/etc/hosts`, erro de digitação) falha com o motivo, sem ir à sessão. A mesma lista vai ao Busybits em
|
|
114
|
+
`POST /api/mod/commands` com `{session, account, commands: [{name, description, source, plugin?}]}`, só quando muda
|
|
115
|
+
e de minuto em minuto (o Busybits pode ter reiniciado): é ela que alimenta o autocompletar da caixa. Comandos que
|
|
116
|
+
abrem um menu interativo (`/model` sem argumento, `/config`) não têm o que mostrar no escritório: dê argumentos ou
|
|
117
|
+
use o terminal. O texto que o comando imprime não volta para a página.
|
|
118
|
+
- **Confirmação:** um `POST /api/mod/inbox/ack` com o resultado de cada uma (`{session, results: [{id, ok, error?}]}`).
|
|
119
|
+
A espera por mensagem (ou comando) é de no máximo 2 s: passou disso, a sessão está ocupada, a mensagem está na fila dela e
|
|
120
|
+
conta como entregue (as seguintes vão em seguida, na ordem). Assim uma rodada nunca passa de uns poucos segundos e
|
|
121
|
+
a presença (10 s) e a confirmação (30 s) do servidor não vencem com a sessão ocupada; o preço é que uma recusa
|
|
122
|
+
depois desses 2 s não chega à página.
|
|
123
|
+
|
|
124
|
+
Fica separado do mod `habblaud` de propósito: aquele só observa; este age, digitando na sessão em seu nome. Para
|
|
125
|
+
ficar sem ele: `npm run mod:install -- --sem-mensagens` (um já instalado continua; para tirar:
|
|
126
|
+
`claude plugin uninstall busybits-messages@busybits`). O `npm run docker:up` atualiza o plugin de quem já o tem,
|
|
127
|
+
mas não o instala sozinho: numa conta com o mod e sem ele, só dá a dica de rodar o `npm run mod:install`.
|
|
128
|
+
|
|
129
|
+
### O que ele acessa
|
|
130
|
+
|
|
131
|
+
Saída de `claude plugin validate --strict mod/habblaud-mensagens`:
|
|
132
|
+
|
|
133
|
+
```
|
|
134
|
+
❯ ./register.ts hooks: session.start
|
|
135
|
+
❯ ./register.ts calls: $.clock.after (via waitAtMost), $.clock.every (via schedule), $.clock.now (via publishCommands), $.command.list (via listCommands), $.command.run (via runOne), $.env.get (via readEnv), $.http.fetch (via postJson), $.prompt.submit (via submitOne), $.session.id (via round), $.session.surfaces (via round)
|
|
136
|
+
❯ ./register.ts env writes: nothing
|
|
137
|
+
❯ ./register.ts env reads: CLAUDE_CODE_ENTRYPOINT, CLAUDE_CONFIG_DIR, HABBLAUD_PORT, HOME, USERPROFILE
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
Em palavras: um hook só (`session.start`, que liga o relógio das rodadas); as únicas ações na sessão são o
|
|
141
|
+
`$.prompt.submit` das mensagens e o `$.command.run` dos comandos de barra que você manda (`$.command.list` só lê os
|
|
142
|
+
nomes e as descrições dos comandos para publicá-los); não lê a conversa, não grava arquivo nenhum, fala só com `127.0.0.1` e lê quatro
|
|
143
|
+
variáveis de ambiente (a conta sai do `CLAUDE_CONFIG_DIR`, como no mod). `$.clock.after` é o prazo de 2 s de cada
|
|
144
|
+
pedido ao Busybits, de cada `$.prompt.submit`, `$.command.run` e `$.command.list`.
|
|
145
|
+
|
|
146
|
+
Porta: `HABBLAUD_PORT` (padrão 4747). Precisa do Claude Code 2.1.287+ e de um Busybits com as mensagens ligadas: a
|
|
147
|
+
mesma trava do terminal e das permissões (porta presa ao `127.0.0.1` e cabeçalho Host local) e `HABBLAUD_MENSAGENS`
|
|
148
|
+
não desligado (`0`, `false`, `off` ou `no` desligam). Qualquer processo desta máquina que fale com o Busybits
|
|
149
|
+
consegue mandar uma mensagem às sessões com o plugin: por isso a trava local.
|
|
150
|
+
|
|
151
|
+
## `habblaud-pi` — Gentle Shell e Pi
|
|
152
|
+
|
|
153
|
+
Não é um plugin do Claude Code: é uma extensão do Pi (`habblaud-pi/extension.ts`, TypeScript carregado pelo próprio Pi, sem
|
|
154
|
+
build; a lógica testável está em `core.ts`, sem dependência do Pi). Instalação: `npm run pi:install` (ou `npm run setup`),
|
|
155
|
+
que põe a pasta `mod/habblaud-pi` em `packages` do `settings.json` de `~/.gentle-shell/agent` e de `~/.pi/agent`
|
|
156
|
+
(o que o `pi install <pasta>` faz; com backup, idempotente, sem tocar em `auth.json` nem em `mcp*.json`);
|
|
157
|
+
`npm run pi:status` e `npm run pi:uninstall` completam. Sessões abertas precisam ser reabertas (ou `/reload` no Pi).
|
|
158
|
+
|
|
159
|
+
- **Mensagens:** o mesmo protocolo do `busybits-messages` (`/api/mod/inbox`, `/ack` e `/commands`), só em sessões com tela
|
|
160
|
+
(`ctx.mode === "tui"`; subagentes, `-p` e RPC não buscam nada). Entrega com `pi.sendUserMessage`: a sessão ociosa recebe
|
|
161
|
+
na hora e, no meio de um turno, a mensagem entra como `followUp`. `/comando` da lista de `pi.getCommands()` (extensões,
|
|
162
|
+
prompt templates e skills) roda com `expandPromptTemplates`; o resto de `/...` falha com o motivo (os comandos embutidos
|
|
163
|
+
do Pi só rodam no terminal).
|
|
164
|
+
- **Precisa de você:** o Pi emite `ui_prompt_start` / `ui_prompt_end` (tipo e título) quando uma extensão abre uma caixa
|
|
165
|
+
bloqueante. O guard do gentle-pi pergunta com `ctx.ui.confirm("Allow guarded git push?", <prévia do comando>)`
|
|
166
|
+
(`extensions/gentle-ai.ts`, `confirmCommand`) e emite também `pi-permission-system:permission-request` (sem o
|
|
167
|
+
comando). Com o agente trabalhando, a extensão avisa o Busybits (`POST /api/permissions` com `answerable: false`, o
|
|
168
|
+
comando vindo da chamada de ferramenta em aberto) e libera o aviso quando a caixa fecha.
|
|
169
|
+
**Responder pelo escritório não é possível com segurança:** os eventos só observam, o `confirm` é resolvido pela
|
|
170
|
+
interface do terminal e o Pi não expõe como responder a caixa de outra extensão; a única saída seria substituir o
|
|
171
|
+
`ctx.ui.confirm` por dentro, o que muda a semântica do guard (a decisão sairia de outro lugar que não a caixa do
|
|
172
|
+
terminal). Por isso o escritório mostra que o agente espera, com o comando, e a resposta continua no terminal.
|
|
173
|
+
- **O que acessa:** `127.0.0.1:<HABBLAUD_PORT ou 4747>` (nenhum outro destino), as variáveis `HABBLAUD_PORT`, `HABBLAUD_PI`
|
|
174
|
+
(`0`, `false`, `off` ou `no` desligam) e `GENTLE_PI_AGENTS_CHILD`; não lê a conversa, não grava arquivo, não bloqueia nem
|
|
175
|
+
decide nenhuma chamada de ferramenta (o handler de `tool_call` só observa).
|
|
176
|
+
- Testes: `server/sources/gentle-shell/pi-extension.test.ts` (núcleo e extensão contra o Busybits de verdade, com um Pi
|
|
177
|
+
falso), `pi-install.test.ts` e `setup.test.ts` (HOME falso).
|
|
178
|
+
|
|
179
|
+
## Desenvolver
|
|
180
|
+
|
|
181
|
+
```bash
|
|
182
|
+
claude --plugin-dir mod/habblaud # carrega o mod numa sessão, sem instalar (recarrega ao salvar)
|
|
183
|
+
claude -p "/busybits" --plugin-dir mod/habblaud # testa o comando sem sessão interativa (não chama o modelo)
|
|
184
|
+
cd mod/habblaud && claude plugin test # testes do mod (tests/*.test.ts), sem sessão, login nem rede
|
|
185
|
+
cd mod/habblaud-mensagens && claude plugin test # idem para o plugin de mensagens
|
|
186
|
+
claude plugin validate --strict mod/habblaud # análise estática + manifesto (idem para as outras pastas e .)
|
|
187
|
+
npx tsc -p mod/habblaud # tipos (depois de carregar o mod uma vez com --plugin-dir)
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
Ao carregar um mod, o Claude Code grava os tipos da versão instalada em `<pasta>/.claude-plugin/types/` e um
|
|
191
|
+
`<pasta>/tsconfig.json` que os estende; os dois são gerados e ficam fora do git (`mod/.gitignore`). Os testes dos
|
|
192
|
+
mods importam `claude-code/testing` e só rodam pelo `claude plugin test`: o `npm test` (vitest) e o
|
|
193
|
+
`npm run typecheck` não olham esta pasta.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "busybits",
|
|
3
|
+
"displayName": "Busybits",
|
|
4
|
+
"version": "2.0.0",
|
|
5
|
+
"description": "Connects the session to Busybits: records plan usage (5h and weekly) for the office, shows a line under the prompt when another session needs you, and adds the /busybits command.",
|
|
6
|
+
"author": { "name": "Márcio Junior", "url": "https://github.com/marmottajr" },
|
|
7
|
+
"homepage": "https://github.com/marmottajr/habblaud#readme",
|
|
8
|
+
"repository": "https://github.com/marmottajr/habblaud",
|
|
9
|
+
"license": "MIT",
|
|
10
|
+
"keywords": ["busybits", "habblaud", "escritorio", "uso", "rate-limits", "status"]
|
|
11
|
+
}
|