busybits 0.0.0-stage → 2.0.1

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 (111) hide show
  1. package/.claude-plugin/marketplace.json +26 -0
  2. package/CHANGELOG.md +692 -0
  3. package/LICENSE +21 -0
  4. package/README.es.md +1457 -0
  5. package/README.fr.md +1435 -0
  6. package/README.md +1623 -2
  7. package/README.pt-BR.md +1373 -0
  8. package/dist/build.json +5 -0
  9. package/dist/cli/busybits.js +14724 -0
  10. package/dist/client/assets/art/framed/painting-abstract.png +0 -0
  11. package/dist/client/assets/art/framed/painting-beach.png +0 -0
  12. package/dist/client/assets/art/framed/painting-cat.png +0 -0
  13. package/dist/client/assets/art/framed/painting-city-night.png +0 -0
  14. package/dist/client/assets/art/framed/painting-mountains.png +0 -0
  15. package/dist/client/assets/art/framed/painting-rio.png +0 -0
  16. package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
  17. package/dist/client/assets/art/framed/painting-wave.png +0 -0
  18. package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
  19. package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
  20. package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
  21. package/dist/client/assets/art/painting-abstract.png +0 -0
  22. package/dist/client/assets/art/painting-beach.png +0 -0
  23. package/dist/client/assets/art/painting-cat.png +0 -0
  24. package/dist/client/assets/art/painting-city-night.png +0 -0
  25. package/dist/client/assets/art/painting-mountains.png +0 -0
  26. package/dist/client/assets/art/painting-rio.png +0 -0
  27. package/dist/client/assets/art/painting-sunflowers.png +0 -0
  28. package/dist/client/assets/art/painting-wave.png +0 -0
  29. package/dist/client/assets/art/painting-wide-aurora.png +0 -0
  30. package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
  31. package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
  32. package/dist/client/assets/art/poster-bug.png +0 -0
  33. package/dist/client/assets/art/poster-cat.png +0 -0
  34. package/dist/client/assets/art/poster-code.png +0 -0
  35. package/dist/client/assets/art/poster-coffee.png +0 -0
  36. package/dist/client/assets/art/poster-rocket.png +0 -0
  37. package/dist/client/assets/art/poster-ship-it.png +0 -0
  38. package/dist/client/assets/brand/apple-touch-icon.png +0 -0
  39. package/dist/client/assets/brand/favicon-16.png +0 -0
  40. package/dist/client/assets/brand/favicon-32.png +0 -0
  41. package/dist/client/assets/brand/icon-192.png +0 -0
  42. package/dist/client/assets/brand/icon-512.png +0 -0
  43. package/dist/client/assets/brand/logo-detailed.png +0 -0
  44. package/dist/client/assets/brand/logo-mark.png +0 -0
  45. package/dist/client/assets/brand/logo-mark@4x.png +0 -0
  46. package/dist/client/assets/brand/signage.png +0 -0
  47. package/dist/client/assets/brand/signage@4x.png +0 -0
  48. package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
  49. package/dist/client/assets/emoji/sheet.png +0 -0
  50. package/dist/client/assets/illustrations/empty-office.png +0 -0
  51. package/dist/client/assets/manifest.json +260 -0
  52. package/dist/client/assets/og-image.png +0 -0
  53. package/dist/client/bundle/app-CoDOLwxe.css +1 -0
  54. package/dist/client/bundle/app-QYGBa260.js +24 -0
  55. package/dist/client/bundle/city-DPTwQLdi.css +1 -0
  56. package/dist/client/bundle/city-UYDbxWIy.js +1 -0
  57. package/dist/client/bundle/daystats-CJyNq6hu.js +1 -0
  58. package/dist/client/bundle/dom-slmnBOjx.js +1 -0
  59. package/dist/client/bundle/en-BQQEHqmG.js +169 -0
  60. package/dist/client/bundle/es-BgBoKwEe.js +169 -0
  61. package/dist/client/bundle/format-CvlPqloO.js +1 -0
  62. package/dist/client/bundle/fr-PI_gjIFq.js +169 -0
  63. package/dist/client/bundle/main-DTHUta25.js +2 -0
  64. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
  65. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
  66. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
  67. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
  68. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
  69. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
  70. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
  71. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
  72. package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
  73. package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
  74. package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
  75. package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
  76. package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
  77. package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
  78. package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
  79. package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
  80. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
  81. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
  82. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
  83. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
  84. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
  85. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
  86. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
  87. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
  88. package/dist/client/bundle/ptypane-9pL54zR0.js +16 -0
  89. package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
  90. package/dist/client/bundle/room-name-Bv6N672f.js +1 -0
  91. package/dist/client/bundle/simulator-B45JPgSp.js +7 -0
  92. package/dist/client/bundle/world-model-BgjMjmrp.js +1 -0
  93. package/dist/client/bundle/world-stream-CUfry7aL.js +1 -0
  94. package/dist/client/index.html +41 -0
  95. package/dist/client/manifest.webmanifest +17 -0
  96. package/dist/server/index.js +40342 -0
  97. package/mod/README.md +193 -0
  98. package/mod/habblaud/.claude-plugin/plugin.json +11 -0
  99. package/mod/habblaud/hooks/hooks.json +4 -0
  100. package/mod/habblaud/hooks/register.ts +517 -0
  101. package/mod/habblaud-codex/hook.mjs +274 -0
  102. package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
  103. package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
  104. package/mod/habblaud-mensagens/hooks/register.ts +384 -0
  105. package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
  106. package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
  107. package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
  108. package/mod/habblaud-pi/core.ts +325 -0
  109. package/mod/habblaud-pi/extension.ts +119 -0
  110. package/mod/habblaud-pi/package.json +12 -0
  111. package/package.json +100 -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
+ }