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
|
@@ -0,0 +1,517 @@
|
|
|
1
|
+
// Mod do Busybits (Claude Code 2.1.287+): liga cada sessão ao escritório sem ler a conversa.
|
|
2
|
+
//
|
|
3
|
+
// Faz três coisas pequenas, e `claude plugin validate` lista exatamente o que o módulo chama (a saída
|
|
4
|
+
// está no mod/README.md):
|
|
5
|
+
//
|
|
6
|
+
// 1. Uso do plano (substitui o tap de statusline): em `session.start` e a cada `session.measure`
|
|
7
|
+
// (depois de cada turno e quando um limite anda um ponto inteiro) grava
|
|
8
|
+
// <HABBLAUD_USAGE_DIR ou ~/.habblaud/usage>/<conta>.json no MESMO formato do scripts/statusline-tap.mjs
|
|
9
|
+
// ({accountId, configDir, fetchedAt, five_hour, seven_day}, `resets_at` em segundos) mais
|
|
10
|
+
// `source: "mod"`. O servidor lê esses arquivos em server/accounts/statusline.ts.
|
|
11
|
+
// 2. Uma linha embaixo do prompt quando OUTRA sessão precisa de você: a cada 5 s pergunta ao Busybits
|
|
12
|
+
// local (GET /api/mod/summary, que já tira da lista esta sessão e os subagentes dela). Fora do ar, a
|
|
13
|
+
// linha some e as perguntas passam a ser a cada 30 s até ele voltar. Só onde a sessão desenha
|
|
14
|
+
// (`$.session.surfaces()` vazia = `claude -p`/SDK: nada a mostrar, nada a perguntar).
|
|
15
|
+
// 3. /busybits: resumo do escritório, respondido pelo próprio mod (não chama o modelo, não gasta uso).
|
|
16
|
+
//
|
|
17
|
+
// Idioma: tudo que o mod escreve para você sai em inglês, espanhol, português ou francês, escolhido pelo ambiente da
|
|
18
|
+
// sessão (HABBLAUD_LANG, depois LC_ALL, LC_MESSAGES, LANG e LANGUAGE; ver langOf); sem nenhum deles, inglês. O `$`
|
|
19
|
+
// não expõe a configuração `language` do Claude Code, por isso o ambiente.
|
|
20
|
+
//
|
|
21
|
+
// Regras: nenhum hook lança (um hook que lança é pulado, mas o que ele deixou pela metade fica): cada
|
|
22
|
+
// passo tem seu try/catch e falha = silêncio. Nada de $.process, $.model, $.prompt, decisão de
|
|
23
|
+
// ferramenta nem leitura da conversa; a rede é só 127.0.0.1. O estado fica em variáveis do módulo: um
|
|
24
|
+
// hot reload recomeça do zero, o que aqui custa no máximo uma regravação a mais do arquivo de uso.
|
|
25
|
+
//
|
|
26
|
+
// Análise estática do Claude Code: cada chamada é escrita por extenso ($.noun.método), o nome do evento é
|
|
27
|
+
// sempre uma string literal e `$` só é passado para funções declaradas no topo deste arquivo.
|
|
28
|
+
import type { EngineInterface, Register, SessionRateLimit } from 'claude-code'
|
|
29
|
+
|
|
30
|
+
/** Porta padrão do Busybits (a mesma do servidor, do hook de permissão e do docker-compose). */
|
|
31
|
+
export const DEFAULT_PORT = 4747
|
|
32
|
+
/** Intervalo das perguntas ao Busybits; fora do ar, recua para o segundo até ele voltar. */
|
|
33
|
+
export const POLL_MS = 5_000
|
|
34
|
+
export const OFFLINE_POLL_MS = 30_000
|
|
35
|
+
/** Quanto esperar o Busybits local responder (`$.http.fetch` não aceita AbortSignal: a corrida é com um timer). */
|
|
36
|
+
export const FETCH_TIMEOUT_MS = 2_000
|
|
37
|
+
/** Valores idênticos gravados há menos que isto não são regravados (a mesma regra do tap). */
|
|
38
|
+
export const MIN_REWRITE_MS = 10_000
|
|
39
|
+
/** Nomes na linha embaixo do prompt antes do "e mais N". */
|
|
40
|
+
const MAX_NAMES = 3
|
|
41
|
+
|
|
42
|
+
/** Idiomas do mod; o inglês é o padrão. */
|
|
43
|
+
export type Lang = 'en' | 'es' | 'pt' | 'fr'
|
|
44
|
+
|
|
45
|
+
/** Uma janela no formato do tap: percentual 0–100 e reinício em SEGUNDOS desde a época. */
|
|
46
|
+
export interface UsageWindow {
|
|
47
|
+
utilization: number
|
|
48
|
+
resets_at?: number
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** O arquivo de uso: o formato do tap mais `source`, para saber quem gravou. */
|
|
52
|
+
export interface UsageRecord {
|
|
53
|
+
accountId: string
|
|
54
|
+
configDir: string
|
|
55
|
+
fetchedAt: number
|
|
56
|
+
five_hour?: UsageWindow
|
|
57
|
+
seven_day?: UsageWindow
|
|
58
|
+
source: 'mod'
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** Quem precisa de você, como GET /api/mod/summary devolve (sem demo e sem esta sessão). */
|
|
62
|
+
export interface WaitingAgent {
|
|
63
|
+
id: string
|
|
64
|
+
name: string
|
|
65
|
+
room: string
|
|
66
|
+
account: string
|
|
67
|
+
waitingFor: string
|
|
68
|
+
since?: number
|
|
69
|
+
/** Há pedido de permissão para responder pelo escritório. */
|
|
70
|
+
answerable: boolean
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export interface Summary {
|
|
74
|
+
version: string
|
|
75
|
+
agents: number
|
|
76
|
+
working: number
|
|
77
|
+
waiting: WaitingAgent[]
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/** Resultado de uma pergunta ao Busybits: resposta, fora do ar ou uma versão antiga, sem a rota do mod. */
|
|
81
|
+
type Asked = { kind: 'ok'; summary: Summary } | { kind: 'offline' } | { kind: 'outdated' }
|
|
82
|
+
|
|
83
|
+
interface ModEnv {
|
|
84
|
+
/** Config dir da conta e o id dela (basename), como o tap calcula; sem HOME (ou USERPROFILE) nem CLAUDE_CONFIG_DIR, ausentes. */
|
|
85
|
+
configDir?: string
|
|
86
|
+
accountId?: string
|
|
87
|
+
/** Pasta do uso; ausente sem HOME (ou USERPROFILE) nem HABBLAUD_USAGE_DIR. */
|
|
88
|
+
usageDir?: string
|
|
89
|
+
port: number
|
|
90
|
+
lang: Lang
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
// ---------------------------------------------------------------------------------------------
|
|
94
|
+
// Funções puras (testadas em tests/habblaud.test.ts)
|
|
95
|
+
// ---------------------------------------------------------------------------------------------
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* Normaliza um caminho (barras repetidas, `.`, `..` e a barra do fim): o ambiente do mod não tem node:path.
|
|
99
|
+
* Caminhos do Windows (com drive ou UNC) saem com `/`, que o Windows também aceita, e a letra do drive (`C:`) conta
|
|
100
|
+
* como raiz: assim o servidor no Docker, que é Linux, ainda acha o nome da pasta da conta no configDir gravado. Nos
|
|
101
|
+
* outros, `\` é parte do nome (Linux e macOS) e fica como está.
|
|
102
|
+
*/
|
|
103
|
+
export function normalizePath(p: string): string {
|
|
104
|
+
const win = /^(?:[A-Za-z]:|\\\\)/.test(p)
|
|
105
|
+
const slashed = win ? p.replace(/\\/g, '/') : p
|
|
106
|
+
// Raiz: o drive, ou uma das duas barras do UNC (`\\nas\share` vira `//nas/share`, que precisa das duas).
|
|
107
|
+
const drive = /^[A-Za-z]:(?=\/|$)/.exec(slashed)?.[0] ?? (win && slashed.startsWith('//') ? '/' : '')
|
|
108
|
+
const rest = slashed.slice(drive.length)
|
|
109
|
+
const abs = rest.startsWith('/')
|
|
110
|
+
const out: string[] = []
|
|
111
|
+
for (const seg of rest.split('/')) {
|
|
112
|
+
if (!seg || seg === '.') continue
|
|
113
|
+
if (seg === '..') {
|
|
114
|
+
if (out.length && out[out.length - 1] !== '..') out.pop()
|
|
115
|
+
else if (!abs) out.push(seg)
|
|
116
|
+
continue
|
|
117
|
+
}
|
|
118
|
+
out.push(seg)
|
|
119
|
+
}
|
|
120
|
+
const joined = out.join('/')
|
|
121
|
+
return drive + (abs ? `/${joined}` : joined || (drive ? '' : '.'))
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** `~` no começo vira o HOME (como o tap faz com CLAUDE_CONFIG_DIR e HABBLAUD_USAGE_DIR). */
|
|
125
|
+
function expandHome(p: string, home: string | undefined): string {
|
|
126
|
+
return home && /^~(?=[\\/]|$)/.test(p) ? home + p.slice(1) : p
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** Config dir da conta: o primeiro item de CLAUDE_CONFIG_DIR (com `~` expandido) ou ~/.claude. */
|
|
130
|
+
export function configDirOf(claudeConfigDir: string | undefined, home: string | undefined): string | undefined {
|
|
131
|
+
const first = (claudeConfigDir ?? '').split(',')[0]?.trim() ?? ''
|
|
132
|
+
if (first) return normalizePath(expandHome(first, home))
|
|
133
|
+
return home ? normalizePath(`${home}/.claude`) : undefined
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** Id da conta = nome da pasta (AccountInfo.id do servidor, ex.: ".claude-conta2"). */
|
|
137
|
+
export function accountIdOf(configDir: string): string | undefined {
|
|
138
|
+
const name = configDir.split('/').filter(Boolean).pop()
|
|
139
|
+
return name && name !== '.' && name !== '..' ? name : undefined
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
export function usageDirOf(habblaudUsageDir: string | undefined, home: string | undefined): string | undefined {
|
|
143
|
+
const d = (habblaudUsageDir ?? '').trim()
|
|
144
|
+
if (d) return normalizePath(expandHome(d, home))
|
|
145
|
+
return home ? normalizePath(`${home}/.habblaud/usage`) : undefined
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
export function portOf(raw: string | undefined): number {
|
|
149
|
+
const n = Number.parseInt(raw ?? '', 10)
|
|
150
|
+
return Number.isInteger(n) && n > 0 && n < 65_536 ? n : DEFAULT_PORT
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* Uma janela de `$.session.usage().rateLimits` no formato do tap. `percentUsed` vem de 0 a 100 (passa de
|
|
155
|
+
* 100 só num spend limit estourado, que não gravamos); `resetsAt` vem em ISO 8601 e o tap grava SEGUNDOS.
|
|
156
|
+
*/
|
|
157
|
+
export function windowOf(rl: SessionRateLimit | undefined): UsageWindow | undefined {
|
|
158
|
+
if (!rl || typeof rl.percentUsed !== 'number' || !Number.isFinite(rl.percentUsed)) return undefined
|
|
159
|
+
const w: UsageWindow = { utilization: Math.min(100, Math.max(0, rl.percentUsed)) }
|
|
160
|
+
const ms = typeof rl.resetsAt === 'string' ? Date.parse(rl.resetsAt) : Number.NaN
|
|
161
|
+
if (Number.isFinite(ms)) w.resets_at = Math.round(ms / 1_000)
|
|
162
|
+
return w
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* O registro gravado, ou undefined sem janela utilizável (fora de uma assinatura, ou antes da primeira
|
|
167
|
+
* resposta da API, `rateLimits` vem vazia). Só `five_hour` e `seven_day`: o `spend_limit` de um gateway
|
|
168
|
+
* não é limite do plano.
|
|
169
|
+
*/
|
|
170
|
+
export function usageRecord(rateLimits: readonly SessionRateLimit[], configDir: string, now: number): UsageRecord | undefined {
|
|
171
|
+
const accountId = accountIdOf(configDir)
|
|
172
|
+
if (!accountId) return undefined
|
|
173
|
+
const five = windowOf(rateLimits.find((r) => r.kind === 'five_hour'))
|
|
174
|
+
const week = windowOf(rateLimits.find((r) => r.kind === 'seven_day'))
|
|
175
|
+
if (!five && !week) return undefined
|
|
176
|
+
const rec: UsageRecord = { accountId, configDir, fetchedAt: now, source: 'mod' }
|
|
177
|
+
if (five) rec.five_hour = five
|
|
178
|
+
if (week) rec.seven_day = week
|
|
179
|
+
return rec
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/** Texto numa linha só (nomes e salas vêm do servidor; uma quebra de linha estragaria a linha de status). */
|
|
183
|
+
function oneLine(s: string): string {
|
|
184
|
+
return s.replace(/[\u0000-\u001f\u007f]+/g, ' ').trim()
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
function str(v: unknown): string | undefined {
|
|
188
|
+
return typeof v === 'string' && v.trim() ? oneLine(v) : undefined
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
function count(v: unknown): number {
|
|
192
|
+
return typeof v === 'number' && Number.isFinite(v) && v >= 0 ? Math.floor(v) : 0
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/** Lê a resposta de GET /api/mod/summary; qualquer coisa fora do formato = undefined (vale "fora do ar"). */
|
|
196
|
+
export function parseSummary(text: string): Summary | undefined {
|
|
197
|
+
let j: unknown
|
|
198
|
+
try {
|
|
199
|
+
j = JSON.parse(text)
|
|
200
|
+
} catch {
|
|
201
|
+
return undefined
|
|
202
|
+
}
|
|
203
|
+
if (!j || typeof j !== 'object' || Array.isArray(j)) return undefined
|
|
204
|
+
const r = j as Record<string, unknown>
|
|
205
|
+
if (!Array.isArray(r.waiting)) return undefined
|
|
206
|
+
const waiting: WaitingAgent[] = []
|
|
207
|
+
for (const item of r.waiting) {
|
|
208
|
+
if (!item || typeof item !== 'object') continue
|
|
209
|
+
const w = item as Record<string, unknown>
|
|
210
|
+
const name = str(w.name)
|
|
211
|
+
if (!name) continue
|
|
212
|
+
const agent: WaitingAgent = {
|
|
213
|
+
id: str(w.id) ?? name,
|
|
214
|
+
name,
|
|
215
|
+
room: str(w.room) ?? '?',
|
|
216
|
+
account: str(w.account) ?? '',
|
|
217
|
+
// Vazio = sem motivo: summaryText escolhe a frase no idioma do mod.
|
|
218
|
+
waitingFor: str(w.waitingFor) ?? '',
|
|
219
|
+
answerable: w.answerable === true,
|
|
220
|
+
}
|
|
221
|
+
if (typeof w.since === 'number' && Number.isFinite(w.since)) agent.since = w.since
|
|
222
|
+
waiting.push(agent)
|
|
223
|
+
}
|
|
224
|
+
return { version: str(r.version) ?? '?', agents: count(r.agents), working: count(r.working), waiting }
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
/** "es_CO.UTF-8", "pt-BR", "fr"... -> idioma do mod; undefined para "C", "POSIX", "de_DE" e o que o mod não traduz. */
|
|
228
|
+
function normalizeLang(v: string | undefined): Lang | undefined {
|
|
229
|
+
const code = (v ?? '').trim().toLowerCase().replace(/[._@].*$/, '').split('-')[0]
|
|
230
|
+
return code === 'en' || code === 'es' || code === 'pt' || code === 'fr' ? code : undefined
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Idioma do mod a partir do ambiente da sessão. HABBLAUD_LANG (o mesmo ajuste do servidor) vale para qualquer
|
|
235
|
+
* idioma; depois valem, nesta ordem, LC_ALL, LC_MESSAGES, LANG e LANGUAGE (lista separada por `:`), pulando o que
|
|
236
|
+
* não é um idioma traduzido (C, POSIX, de_DE). Sem nada que sirva, inglês.
|
|
237
|
+
*/
|
|
238
|
+
export function langOf(env: Readonly<Record<string, string | undefined>>): Lang {
|
|
239
|
+
const own = normalizeLang(env.HABBLAUD_LANG)
|
|
240
|
+
if (own) return own
|
|
241
|
+
for (const v of [env.LC_ALL, env.LC_MESSAGES, env.LANG, ...(env.LANGUAGE ?? '').split(':')]) {
|
|
242
|
+
const l = normalizeLang(v)
|
|
243
|
+
if (l) return l
|
|
244
|
+
}
|
|
245
|
+
return 'en'
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/** Os textos do mod: frases com singular e plural resolvidos por funções que recebem o que entra na frase. */
|
|
249
|
+
interface Texts {
|
|
250
|
+
needsYou: (name: string, room: string) => string
|
|
251
|
+
manyNeedYou: (n: number, names: string, more: number) => string
|
|
252
|
+
agents: (n: number) => string
|
|
253
|
+
working: (n: number) => string
|
|
254
|
+
waiting: (n: number) => string
|
|
255
|
+
summaryHead: (version: string, url: string) => string
|
|
256
|
+
answerable: string
|
|
257
|
+
noReason: string
|
|
258
|
+
offline: (url: string) => string
|
|
259
|
+
outdated: (url: string) => string
|
|
260
|
+
commandDescription: string
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
const TEXTS: Record<Lang, Texts> = {
|
|
264
|
+
en: {
|
|
265
|
+
needsYou: (name, room) => `🏢 ${name} needs you in ${room}`,
|
|
266
|
+
manyNeedYou: (n, names, more) => `🏢 ${n} need you: ${names}${more > 0 ? ` and ${more} more` : ''}`,
|
|
267
|
+
agents: (n) => (n === 1 ? '1 agent' : `${n} agents`),
|
|
268
|
+
working: (n) => `${n} working`,
|
|
269
|
+
waiting: (n) => (n === 0 ? 'nobody needs you' : n === 1 ? '1 needs you' : `${n} need you`),
|
|
270
|
+
summaryHead: (version, url) => `Busybits ${version} at ${url}`,
|
|
271
|
+
answerable: ' · you can answer from the office',
|
|
272
|
+
noReason: 'answer in the terminal',
|
|
273
|
+
offline: (url) => `Busybits did not answer at ${url}. To start it: npm run docker:up in the Busybits folder.`,
|
|
274
|
+
outdated: (url) => `Busybits at ${url} is an older version without the mod route. To update: git pull and npm run docker:up in the Busybits folder.`,
|
|
275
|
+
commandDescription: 'Busybits summary: how many agents, who is working and who needs you',
|
|
276
|
+
},
|
|
277
|
+
es: {
|
|
278
|
+
needsYou: (name, room) => `🏢 ${name} te necesita en ${room}`,
|
|
279
|
+
manyNeedYou: (n, names, more) => `🏢 ${n} te necesitan: ${names}${more > 0 ? ` y ${more} más` : ''}`,
|
|
280
|
+
agents: (n) => (n === 1 ? '1 agente' : `${n} agentes`),
|
|
281
|
+
working: (n) => `${n} trabajando`,
|
|
282
|
+
waiting: (n) => (n === 0 ? 'nadie te necesita' : n === 1 ? '1 te necesita' : `${n} te necesitan`),
|
|
283
|
+
summaryHead: (version, url) => `Busybits ${version} en ${url}`,
|
|
284
|
+
answerable: ' · puedes responder desde la oficina',
|
|
285
|
+
noReason: 'responder en el terminal',
|
|
286
|
+
offline: (url) => `Busybits no respondió en ${url}. Para iniciarlo: npm run docker:up en la carpeta de Busybits.`,
|
|
287
|
+
outdated: (url) => `Busybits en ${url} es una versión anterior, sin la ruta del mod. Para actualizar: git pull y npm run docker:up en la carpeta de Busybits.`,
|
|
288
|
+
commandDescription: 'Resumen de Busybits: cuántos agentes hay, quién trabaja y quién te necesita',
|
|
289
|
+
},
|
|
290
|
+
pt: {
|
|
291
|
+
needsYou: (name, room) => `🏢 ${name} precisa de você em ${room}`,
|
|
292
|
+
manyNeedYou: (n, names, more) => `🏢 ${n} precisam de você: ${names}${more > 0 ? ` e mais ${more}` : ''}`,
|
|
293
|
+
agents: (n) => (n === 1 ? '1 agente' : `${n} agentes`),
|
|
294
|
+
working: (n) => `${n} trabalhando`,
|
|
295
|
+
waiting: (n) => (n === 0 ? 'ninguém precisa de você' : n === 1 ? '1 precisa de você' : `${n} precisam de você`),
|
|
296
|
+
summaryHead: (version, url) => `Busybits ${version} em ${url}`,
|
|
297
|
+
answerable: ' · dá para responder pelo escritório',
|
|
298
|
+
noReason: 'responder no terminal',
|
|
299
|
+
offline: (url) => `O Busybits não respondeu em ${url}. Para subir: npm run docker:up na pasta do Busybits.`,
|
|
300
|
+
outdated: (url) => `O Busybits em ${url} está numa versão sem a rota do mod. Para atualizar: git pull e npm run docker:up na pasta do Busybits.`,
|
|
301
|
+
commandDescription: 'Resumo do Busybits: quantos agentes, quem trabalha e quem precisa de você',
|
|
302
|
+
},
|
|
303
|
+
fr: {
|
|
304
|
+
needsYou: (name, room) => `🏢 ${name} a besoin de vous dans ${room}`,
|
|
305
|
+
manyNeedYou: (n, names, more) => `🏢 ${n} ont besoin de vous : ${names}${more > 0 ? ` et ${more} de plus` : ''}`,
|
|
306
|
+
agents: (n) => (n === 1 ? '1 agent' : `${n} agents`),
|
|
307
|
+
working: (n) => (n === 1 ? '1 au travail' : `${n} au travail`),
|
|
308
|
+
waiting: (n) => (n === 0 ? 'personne n’a besoin de vous' : n === 1 ? '1 a besoin de vous' : `${n} ont besoin de vous`),
|
|
309
|
+
summaryHead: (version, url) => `Busybits ${version} sur ${url}`,
|
|
310
|
+
answerable: ' · vous pouvez répondre depuis le bureau',
|
|
311
|
+
noReason: 'répondre dans le terminal',
|
|
312
|
+
offline: (url) => `Busybits n’a pas répondu sur ${url}. Pour le lancer : npm run docker:up dans le dossier de Busybits.`,
|
|
313
|
+
outdated: (url) => `Busybits sur ${url} est une ancienne version, sans la route du mod. Pour mettre à jour : git pull et npm run docker:up dans le dossier de Busybits.`,
|
|
314
|
+
commandDescription: 'Résumé de Busybits : combien d’agents, qui travaille et qui a besoin de vous',
|
|
315
|
+
},
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
/** A linha embaixo do prompt: undefined quando ninguém (além desta sessão) precisa de você. */
|
|
319
|
+
export function statusText(waiting: readonly WaitingAgent[], lang: Lang = 'en'): string | undefined {
|
|
320
|
+
const first = waiting[0]
|
|
321
|
+
if (!first) return undefined
|
|
322
|
+
const t = TEXTS[lang]
|
|
323
|
+
if (waiting.length === 1) return t.needsYou(first.name, first.room)
|
|
324
|
+
const shown = waiting.slice(0, MAX_NAMES).map((w) => `${w.name} (${w.room})`)
|
|
325
|
+
return t.manyNeedYou(waiting.length, shown.join(', '), waiting.length - shown.length)
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
/** A resposta do /busybits com o Busybits no ar. */
|
|
329
|
+
export function summaryText(s: Summary, url: string, lang: Lang = 'en'): string {
|
|
330
|
+
const t = TEXTS[lang]
|
|
331
|
+
const lines = [t.summaryHead(s.version, url), `${t.agents(s.agents)} · ${t.working(s.working)} · ${t.waiting(s.waiting.length)}`]
|
|
332
|
+
for (const w of s.waiting) lines.push(`✋ ${w.name} (${w.room}): ${w.waitingFor || t.noReason}${w.answerable ? t.answerable : ''}`)
|
|
333
|
+
return lines.join('\n')
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
export function offlineText(url: string, lang: Lang = 'en'): string {
|
|
337
|
+
return TEXTS[lang].offline(url)
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
export function outdatedText(url: string, lang: Lang = 'en'): string {
|
|
341
|
+
return TEXTS[lang].outdated(url)
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
// ---------------------------------------------------------------------------------------------
|
|
345
|
+
// Estado do módulo (some num hot reload) e o que fala com o Claude Code
|
|
346
|
+
// ---------------------------------------------------------------------------------------------
|
|
347
|
+
|
|
348
|
+
let env: ModEnv | undefined
|
|
349
|
+
/** Última gravação do arquivo de uso (chave = arquivo + valores), para não regravar o mesmo em menos de 10 s. */
|
|
350
|
+
let lastWrite: { key: string; at: number } | undefined
|
|
351
|
+
/** Texto da linha de status; null = ainda não mexemos nela nesta carga (a primeira chamada sempre passa). */
|
|
352
|
+
let lastStatus: string | undefined | null = null
|
|
353
|
+
let timer: { cancel: () => void } | undefined
|
|
354
|
+
let timerMs = 0
|
|
355
|
+
/** Uma pergunta por vez: um Busybits lento não acumula perguntas. */
|
|
356
|
+
let polling = false
|
|
357
|
+
|
|
358
|
+
/** O ambiente da sessão, lido uma vez por carga (cada nome escrito por extenso, como a análise exige). */
|
|
359
|
+
async function readEnv($: EngineInterface): Promise<ModEnv> {
|
|
360
|
+
if (env) return env
|
|
361
|
+
// No Windows, HOME só existe se alguém o definir: vale o USERPROFILE (a mesma ordem do servidor, HOME e depois homedir()).
|
|
362
|
+
const home = (await $.env.get('HOME'))?.trim() || (await $.env.get('USERPROFILE'))?.trim() || undefined
|
|
363
|
+
const configDir = configDirOf(await $.env.get('CLAUDE_CONFIG_DIR'), home)
|
|
364
|
+
const lang = langOf({
|
|
365
|
+
HABBLAUD_LANG: await $.env.get('HABBLAUD_LANG'),
|
|
366
|
+
LC_ALL: await $.env.get('LC_ALL'),
|
|
367
|
+
LC_MESSAGES: await $.env.get('LC_MESSAGES'),
|
|
368
|
+
LANG: await $.env.get('LANG'),
|
|
369
|
+
LANGUAGE: await $.env.get('LANGUAGE'),
|
|
370
|
+
})
|
|
371
|
+
const next: ModEnv = {
|
|
372
|
+
lang,
|
|
373
|
+
port: portOf(await $.env.get('HABBLAUD_PORT')),
|
|
374
|
+
usageDir: usageDirOf(await $.env.get('HABBLAUD_USAGE_DIR'), home),
|
|
375
|
+
}
|
|
376
|
+
if (configDir) {
|
|
377
|
+
next.configDir = configDir
|
|
378
|
+
const accountId = accountIdOf(configDir)
|
|
379
|
+
if (accountId) next.accountId = accountId
|
|
380
|
+
}
|
|
381
|
+
env = next
|
|
382
|
+
return next
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
/** Grava o uso desta conta (se houver janelas e algo mudou ou já passou o intervalo). Pode lançar: quem chama engole. */
|
|
386
|
+
async function writeUsage($: EngineInterface, rateLimits: readonly SessionRateLimit[]): Promise<void> {
|
|
387
|
+
if (!rateLimits.length) return
|
|
388
|
+
const e = await readEnv($)
|
|
389
|
+
if (!e.configDir || !e.usageDir) return
|
|
390
|
+
const now = await $.clock.now()
|
|
391
|
+
const rec = usageRecord(rateLimits, e.configDir, now)
|
|
392
|
+
if (!rec) return
|
|
393
|
+
const file = `${e.usageDir}/${rec.accountId}.json`
|
|
394
|
+
const key = JSON.stringify([file, rec.configDir, rec.five_hour, rec.seven_day])
|
|
395
|
+
if (lastWrite && lastWrite.key === key && now - lastWrite.at >= 0 && now - lastWrite.at < MIN_REWRITE_MS) return
|
|
396
|
+
// $.fs.write cria a pasta se faltar e NÃO é atômico: o leitor do servidor ignora uma leitura pela
|
|
397
|
+
// metade e fica com o último registro bom (server/accounts/statusline.ts).
|
|
398
|
+
await $.fs.write(file, `${JSON.stringify(rec)}\n`)
|
|
399
|
+
lastWrite = { key, at: now }
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
/** GET /api/mod/summary com prazo de 2 s; nunca lança. */
|
|
403
|
+
async function askBusybits($: EngineInterface, port: number, query: string): Promise<Asked> {
|
|
404
|
+
let wait: { cancel: () => void } | undefined
|
|
405
|
+
const timeout = new Promise<undefined>((resolve) => {
|
|
406
|
+
wait = $.clock.after(FETCH_TIMEOUT_MS, () => resolve(undefined))
|
|
407
|
+
})
|
|
408
|
+
try {
|
|
409
|
+
const res = await Promise.race([$.http.fetch(`http://127.0.0.1:${port}/api/mod/summary${query}`, { headers: { accept: 'application/json' } }), timeout])
|
|
410
|
+
if (!res) return { kind: 'offline' }
|
|
411
|
+
// 404 JSON = um Busybits de antes do mod (rota desconhecida); outro 404 qualquer = não é o Busybits.
|
|
412
|
+
if (res.status === 404 && res.text.includes('rota desconhecida')) return { kind: 'outdated' }
|
|
413
|
+
const summary = res.ok ? parseSummary(res.text) : undefined
|
|
414
|
+
return summary ? { kind: 'ok', summary } : { kind: 'offline' }
|
|
415
|
+
} catch {
|
|
416
|
+
return { kind: 'offline' }
|
|
417
|
+
} finally {
|
|
418
|
+
wait?.cancel()
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
/** Troca a linha de status só quando o texto muda. */
|
|
423
|
+
function setStatus($: EngineInterface, text: string | undefined): void {
|
|
424
|
+
if (text === lastStatus) return
|
|
425
|
+
lastStatus = text
|
|
426
|
+
$.ui.status(text)
|
|
427
|
+
}
|
|
428
|
+
|
|
429
|
+
/** (Re)agenda as perguntas: 5 s com o Busybits no ar, 30 s fora do ar. */
|
|
430
|
+
function schedule($: EngineInterface, ms: number): void {
|
|
431
|
+
if (timer && timerMs === ms) return
|
|
432
|
+
timer?.cancel()
|
|
433
|
+
timerMs = ms
|
|
434
|
+
timer = $.clock.every(ms, () => {
|
|
435
|
+
void poll($)
|
|
436
|
+
})
|
|
437
|
+
}
|
|
438
|
+
|
|
439
|
+
/** Uma rodada do aviso embaixo do prompt. Nunca lança. */
|
|
440
|
+
async function poll($: EngineInterface): Promise<void> {
|
|
441
|
+
if (polling) return
|
|
442
|
+
polling = true
|
|
443
|
+
try {
|
|
444
|
+
const surfaces = await $.session.surfaces()
|
|
445
|
+
if (!surfaces.length) {
|
|
446
|
+
setStatus($, undefined)
|
|
447
|
+
return
|
|
448
|
+
}
|
|
449
|
+
const e = await readEnv($)
|
|
450
|
+
const params = new URLSearchParams()
|
|
451
|
+
if (e.accountId) params.set('account', e.accountId)
|
|
452
|
+
params.set('session', await $.session.id())
|
|
453
|
+
const asked = await askBusybits($, e.port, `?${params.toString()}`)
|
|
454
|
+
if (asked.kind !== 'ok') {
|
|
455
|
+
setStatus($, undefined)
|
|
456
|
+
schedule($, OFFLINE_POLL_MS)
|
|
457
|
+
return
|
|
458
|
+
}
|
|
459
|
+
schedule($, POLL_MS)
|
|
460
|
+
setStatus($, statusText(asked.summary.waiting, e.lang))
|
|
461
|
+
} catch {
|
|
462
|
+
// silêncio: a próxima rodada tenta de novo
|
|
463
|
+
} finally {
|
|
464
|
+
polling = false
|
|
465
|
+
}
|
|
466
|
+
}
|
|
467
|
+
|
|
468
|
+
/** O texto do /busybits: o escritório inteiro (sem filtrar esta sessão, para os números baterem com a tela). */
|
|
469
|
+
async function busybitsText($: EngineInterface): Promise<string> {
|
|
470
|
+
const e = await readEnv($)
|
|
471
|
+
const url = `http://localhost:${e.port}`
|
|
472
|
+
const asked = await askBusybits($, e.port, '')
|
|
473
|
+
if (asked.kind === 'outdated') return outdatedText(url, e.lang)
|
|
474
|
+
if (asked.kind === 'offline') return offlineText(url, e.lang)
|
|
475
|
+
return summaryText(asked.summary, url, e.lang)
|
|
476
|
+
}
|
|
477
|
+
|
|
478
|
+
export const register: Register = (on) => {
|
|
479
|
+
on('session.start', async ($, e, next) => {
|
|
480
|
+
try {
|
|
481
|
+
await $.command.register({ name: 'busybits', description: TEXTS[(await readEnv($)).lang].commandDescription })
|
|
482
|
+
} catch {
|
|
483
|
+
// sem o comando, o resto segue
|
|
484
|
+
}
|
|
485
|
+
try {
|
|
486
|
+
const usage = await $.session.usage()
|
|
487
|
+
await writeUsage($, usage.rateLimits)
|
|
488
|
+
} catch {
|
|
489
|
+
// falha ao gravar = silêncio (o Busybits continua com o último número que tinha)
|
|
490
|
+
}
|
|
491
|
+
try {
|
|
492
|
+
schedule($, POLL_MS)
|
|
493
|
+
} catch {
|
|
494
|
+
// sem o aviso embaixo do prompt, o resto segue
|
|
495
|
+
}
|
|
496
|
+
return next(e)
|
|
497
|
+
})
|
|
498
|
+
|
|
499
|
+
// Depois de cada turno e quando um limite anda um ponto. `e` traz os mesmos números de
|
|
500
|
+
// `$.session.usage()` naquele instante, então não há por que perguntar de novo.
|
|
501
|
+
on('session.measure', async ($, e, next) => {
|
|
502
|
+
try {
|
|
503
|
+
await writeUsage($, e.rateLimits)
|
|
504
|
+
} catch {
|
|
505
|
+
// falha ao gravar = silêncio
|
|
506
|
+
}
|
|
507
|
+
return next(e)
|
|
508
|
+
})
|
|
509
|
+
|
|
510
|
+
on('command.run', { command: 'busybits' }, async ($) => {
|
|
511
|
+
try {
|
|
512
|
+
return { text: await busybitsText($) }
|
|
513
|
+
} catch {
|
|
514
|
+
return { text: offlineText(`http://localhost:${env?.port ?? DEFAULT_PORT}`, env?.lang) }
|
|
515
|
+
}
|
|
516
|
+
})
|
|
517
|
+
}
|