typeclaw 0.39.7 → 0.41.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.
Files changed (72) hide show
  1. package/package.json +1 -1
  2. package/scripts/dump-system-prompt.ts +4 -50
  3. package/src/agent/auth-reloadable.ts +24 -0
  4. package/src/agent/auth.ts +12 -0
  5. package/src/agent/index.ts +18 -58
  6. package/src/agent/multimodal/look-at.ts +87 -0
  7. package/src/bundled-plugins/guard/policies/non-workspace-write.ts +0 -2
  8. package/src/bundled-plugins/guard/policy.ts +0 -5
  9. package/src/bundled-plugins/memory/README.md +26 -37
  10. package/src/bundled-plugins/memory/index.ts +32 -147
  11. package/src/bundled-plugins/memory/load-memory.ts +7 -121
  12. package/src/bundled-plugins/memory/memory-logger.ts +8 -2
  13. package/src/bundled-plugins/memory/search-command.ts +2 -11
  14. package/src/bundled-plugins/memory/vector/doctor.ts +1 -1
  15. package/src/bundled-plugins/memory/vector/embedder.ts +4 -5
  16. package/src/bundled-plugins/memory/vector/hybrid.ts +47 -5
  17. package/src/bundled-plugins/memory/vector/index-on-write.ts +25 -20
  18. package/src/bundled-plugins/memory/vector/reference-index-on-write.ts +28 -23
  19. package/src/bundled-plugins/memory/vector/relevance-gate.ts +11 -7
  20. package/src/bundled-plugins/memory/vector/script.ts +87 -0
  21. package/src/bundled-plugins/memory/vector/store.ts +2 -0
  22. package/src/bundled-plugins/planner/planner.ts +4 -2
  23. package/src/bundled-plugins/reviewer/reviewer.ts +9 -1
  24. package/src/channels/adapters/describe-error.ts +40 -0
  25. package/src/channels/adapters/discord.ts +9 -12
  26. package/src/channels/adapters/kakaotalk-classify.ts +31 -6
  27. package/src/channels/adapters/kakaotalk.ts +15 -18
  28. package/src/channels/adapters/line.ts +11 -14
  29. package/src/channels/adapters/slack-bot.ts +15 -18
  30. package/src/channels/adapters/slack.ts +45 -21
  31. package/src/channels/adapters/telegram-bot.ts +15 -18
  32. package/src/channels/adapters/webex-bot.ts +13 -14
  33. package/src/channels/adapters/webex.ts +14 -15
  34. package/src/cli/compose.ts +20 -0
  35. package/src/cli/docker-preflight.ts +42 -0
  36. package/src/cli/hostd.ts +12 -3
  37. package/src/cli/init.ts +24 -22
  38. package/src/cli/logs.ts +7 -0
  39. package/src/cli/provider.ts +8 -1
  40. package/src/cli/reload.ts +6 -0
  41. package/src/cli/restart.ts +7 -0
  42. package/src/cli/shell.ts +7 -0
  43. package/src/cli/start.ts +7 -0
  44. package/src/cli/status.ts +9 -0
  45. package/src/cli/stop.ts +7 -0
  46. package/src/cli/tui.ts +6 -0
  47. package/src/config/config.ts +31 -8
  48. package/src/container/docker-app.ts +253 -0
  49. package/src/container/index.ts +11 -0
  50. package/src/container/start.ts +85 -41
  51. package/src/hostd/current-host-daemon.ts +21 -0
  52. package/src/hostd/daemon.ts +75 -15
  53. package/src/hostd/kakao-renewal-manager.ts +35 -10
  54. package/src/hostd/supervisor.ts +18 -3
  55. package/src/hostd/tailscale.ts +41 -5
  56. package/src/hostd/webex-renewal-manager.ts +13 -4
  57. package/src/plugin/hooks.ts +3 -4
  58. package/src/plugin/index.ts +1 -0
  59. package/src/plugin/manager.ts +14 -0
  60. package/src/plugin/registry.ts +12 -0
  61. package/src/plugin/types.ts +5 -1
  62. package/src/run/channel-session-factory.ts +3 -5
  63. package/src/run/index.ts +63 -36
  64. package/src/server/command-runner.ts +2 -11
  65. package/src/skills/typeclaw-memory/SKILL.md +2 -2
  66. package/src/skills/typeclaw-plugins/SKILL.md +1 -1
  67. package/src/test-helpers/rm-temp-dir.ts +24 -0
  68. package/typeclaw.schema.json +1 -23
  69. package/src/bundled-plugins/guard/policies/memory-retrieval-cache-write.ts +0 -43
  70. package/src/bundled-plugins/memory/memory-retrieval.ts +0 -111
  71. package/src/bundled-plugins/memory/vector/cache-write.ts +0 -19
  72. package/src/bundled-plugins/memory/vector/config.ts +0 -28
@@ -51,7 +51,15 @@ export const REVIEWER_SKILLS: readonly LoadableSkill[] = [
51
51
  // liveness for the parent, not hard cancellation: pi's `session.prompt` takes no
52
52
  // AbortSignal, so the LLM stream may run until the OS reaps it. See
53
53
  // src/agent/subagents.ts `timeoutMs`.
54
- export const REVIEWER_SPAWN_TIMEOUT_MS = 600_000
54
+ //
55
+ // 30m, not the prior 10m: the `deep` profile trades speed for quality, and a
56
+ // real review of a large PR (many changed files + nested scout fan-out + a few
57
+ // web lookups + careful synthesis) routinely exceeds 10m. A 10m ceiling killed
58
+ // both the first and retry reviews of a 27-file PR mid-analysis, leaving the PR
59
+ // with no posted verdict — the exact "stranded review" failure the guards exist
60
+ // to prevent. Matches RESEARCHER_SPAWN_TIMEOUT_MS, the other deep-profile
61
+ // subagent that hit the same nested-fan-out wall.
62
+ export const REVIEWER_SPAWN_TIMEOUT_MS = 1_800_000
55
63
 
56
64
  // The reviewer's read-only contract is enforced in depth: this system prompt
57
65
  // states it, the global bash guards (`secret-exfil-bash`, `git-exfil`) catch
@@ -0,0 +1,40 @@
1
+ // A WebSocket 'error' fires with an `ErrorEvent`, NOT an `Error`, so
2
+ // `String(err)` yields the useless `[object ErrorEvent]`. Dig the real reason
3
+ // out of `.message`/nested `.error` (same trap as `describeWsErrorEvent` in
4
+ // `src/cli/tunnel.ts`), unwrapping `AggregateError` and `.cause` chains.
5
+
6
+ const MAX_DEPTH = 4
7
+
8
+ export function describeError(err: unknown): string {
9
+ const message = extract(err, 0)
10
+ return message ?? String(err)
11
+ }
12
+
13
+ function extract(err: unknown, depth: number): string | null {
14
+ if (depth > MAX_DEPTH) return null
15
+
16
+ if (err instanceof Error) {
17
+ if (err instanceof AggregateError && err.errors.length > 0) {
18
+ const inner = err.errors.map((e) => extract(e, depth + 1) ?? String(e)).join('; ')
19
+ if (err.message !== '') return `${err.message}: ${inner}`
20
+ return inner
21
+ }
22
+ if (err.message !== '') return err.message
23
+ if (err.cause !== undefined) return extract(err.cause, depth + 1)
24
+ return err.name
25
+ }
26
+
27
+ if (typeof err === 'string') return err === '' ? null : err
28
+
29
+ if (typeof err === 'object' && err !== null) {
30
+ const { message, error } = err as { message?: unknown; error?: unknown }
31
+ if (typeof message === 'string' && message !== '') return message
32
+ if (error !== undefined && error !== err) {
33
+ const nested = extract(error, depth + 1)
34
+ if (nested !== null) return nested
35
+ }
36
+ return null
37
+ }
38
+
39
+ return null
40
+ }
@@ -24,6 +24,7 @@ import type {
24
24
  import { chunkMarkdown } from '@/markdown'
25
25
  import type { DiscordAccountRecord } from '@/secrets/schema'
26
26
 
27
+ import { describeError } from './describe-error'
27
28
  import { createDiscordAuthorResolver } from './discord-author-resolver'
28
29
  import { createDiscordChannelResolver } from './discord-channel-resolver'
29
30
  import { classifyInbound, type InboundDropReason } from './discord-classify'
@@ -84,7 +85,7 @@ export function createDiscordOutboundCallback(deps: {
84
85
  }
85
86
  return { ok: true }
86
87
  } catch (err) {
87
- const message = describe(err)
88
+ const message = describeError(err)
88
89
  deps.logger.error(`[discord] outbound failed: ${message}`)
89
90
  return { ok: false, error: message }
90
91
  }
@@ -100,7 +101,7 @@ export function createDiscordHistoryCallback(deps: {
100
101
  const messages = await deps.client.getMessages(args.chat, clampLimit(args.limit, 100))
101
102
  return { ok: true, messages: messages.map(mapDiscordHistoryMessage).reverse() }
102
103
  } catch (err) {
103
- const message = describe(err)
104
+ const message = describeError(err)
104
105
  deps.logger.warn(`[discord] history fetch failed: ${message}`)
105
106
  return { ok: false, error: message }
106
107
  }
@@ -159,7 +160,7 @@ export function createDiscordFetchAttachmentCallback(deps: {
159
160
  size: buffer.length,
160
161
  }
161
162
  } catch (err) {
162
- const message = describe(err)
163
+ const message = describeError(err)
163
164
  deps.logger.error(`[discord] fetchAttachment failed for ${url.toString()}: ${message}`)
164
165
  return { ok: false, error: message }
165
166
  }
@@ -232,7 +233,7 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
232
233
  logger.info(`[discord] routed id=${event.id} ${tag} mention=${payload.isBotMention}`)
233
234
  await options.router.route(payload)
234
235
  } catch (err) {
235
- logger.error(`[discord] handleInbound failed: ${describe(err)}`)
236
+ logger.error(`[discord] handleInbound failed: ${describeError(err)}`)
236
237
  } finally {
237
238
  inflightInbounds--
238
239
  if (inflightInbounds === 0 && stopWaiters.length > 0) {
@@ -262,7 +263,7 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
262
263
  started = false
263
264
  selfUserId = null
264
265
  token = null
265
- logger.error(`[discord] login failed: ${describe(err)}`)
266
+ logger.error(`[discord] login failed: ${describeError(err)}`)
266
267
  throw err
267
268
  }
268
269
 
@@ -281,7 +282,7 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
281
282
  })
282
283
  listener.on('error', (err) => {
283
284
  if (!listenerConnected && listenerStartupError === null) listenerStartupError = err
284
- logger.error(`[discord] listener error: ${describe(err)}`)
285
+ logger.error(`[discord] listener error: ${describeError(err)}`)
285
286
  })
286
287
  listener.on('message_create', (event) => void handleMessage(event))
287
288
  listener.on('message_reaction_add', (event) =>
@@ -305,14 +306,14 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
305
306
  token = null
306
307
  connected = false
307
308
  started = false
308
- logger.error(`[discord] ${reason}: ${describe(cause)}`)
309
+ logger.error(`[discord] ${reason}: ${describeError(cause)}`)
309
310
  throw cause
310
311
  }
311
312
 
312
313
  try {
313
314
  await listener.start()
314
315
  } catch (err) {
315
- rollbackStart('listener start threw', err instanceof Error ? err : new Error(String(err)))
316
+ rollbackStart('listener start threw', err instanceof Error ? err : new Error(describeError(err)))
316
317
  }
317
318
  if (!listenerConnected) {
318
319
  rollbackStart(
@@ -400,10 +401,6 @@ function clampLimit(requested: number, max: number): number {
400
401
  return Math.min(Math.floor(requested), max)
401
402
  }
402
403
 
403
- function describe(err: unknown): string {
404
- return err instanceof Error ? err.message : String(err)
405
- }
406
-
407
404
  function dropHint(reason: InboundDropReason): string {
408
405
  switch (reason) {
409
406
  case 'empty_content':
@@ -109,11 +109,10 @@ function parseReplyContext(event: KakaoTalkPushMessageEvent, selfUserId: string)
109
109
  if (event.message_type !== KAKAO_MESSAGE_TYPE.REPLY) return null
110
110
  if (event.attachment === null) return null
111
111
 
112
- const logId = stringField(event.attachment, 'src_logId')
113
- const sourceUserId = numericField(event.attachment, 'src_userId')
114
- if (logId === null || sourceUserId === null) return null
112
+ const logId = scalarIdField(event.attachment, 'src_logId')
113
+ const sourceAuthorId = decimalIdField(event.attachment, 'src_userId')
114
+ if (logId === null || sourceAuthorId === null) return null
115
115
 
116
- const sourceAuthorId = String(sourceUserId)
117
116
  const quotedText = stringField(event.attachment, 'src_message')
118
117
  return {
119
118
  logId,
@@ -150,7 +149,33 @@ function stringField(record: Record<string, unknown>, key: string): string | nul
150
149
  return typeof value === 'string' && value.length > 0 ? value : null
151
150
  }
152
151
 
153
- function numericField(record: Record<string, unknown>, key: string): number | null {
152
+ // LOCO reply attachments are unvalidated `JSON.parse` output: `src_userId` arrives
153
+ // as a string in production despite the SDK annotating it `number`, so a number-only
154
+ // reader dropped every reply-to-bot. `src_userId` gates the bot-vs-other identity
155
+ // check, so require digits and keep it as an opaque string — never `Number()` a
156
+ // 64-bit id (lossy past 2^53).
157
+ function decimalIdField(record: Record<string, unknown>, key: string): string | null {
154
158
  const value = record[key]
155
- return typeof value === 'number' && Number.isFinite(value) ? value : null
159
+ if (typeof value === 'string') {
160
+ const trimmed = value.trim()
161
+ return /^\d+$/.test(trimmed) ? trimmed : null
162
+ }
163
+ if (typeof value === 'number') {
164
+ return Number.isInteger(value) && value >= 0 ? String(value) : null
165
+ }
166
+ return null
167
+ }
168
+
169
+ // `src_logId` is an opaque message reference we only echo back, never compare for
170
+ // identity, so accept any non-empty scalar (string or integer) without digit-gating.
171
+ function scalarIdField(record: Record<string, unknown>, key: string): string | null {
172
+ const value = record[key]
173
+ if (typeof value === 'string') {
174
+ const trimmed = value.trim()
175
+ return trimmed.length > 0 ? trimmed : null
176
+ }
177
+ if (typeof value === 'number') {
178
+ return Number.isInteger(value) && value >= 0 ? String(value) : null
179
+ }
180
+ return null
156
181
  }
@@ -32,6 +32,7 @@ import type {
32
32
  InboundAttachment,
33
33
  } from '@/channels/types'
34
34
 
35
+ import { describeError } from './describe-error'
35
36
  import {
36
37
  emoticonEventToMessageEvent,
37
38
  splitEmoticonInbound,
@@ -215,7 +216,7 @@ export function createOutboundCallback(deps: {
215
216
  }),
216
217
  )
217
218
  } catch (err) {
218
- const message = describe(err)
219
+ const message = describeError(err)
219
220
  logger.error(`[kakaotalk] readFile failed: ${message}`)
220
221
  return { ok: false, error: `readFile failed: ${message}` }
221
222
  }
@@ -228,7 +229,7 @@ export function createOutboundCallback(deps: {
228
229
  logIds.push(result.log_id)
229
230
  logger.info(`[kakaotalk] uploaded log_id=${result.log_id} attachments=${items.length} ${tag}`)
230
231
  } catch (err) {
231
- const message = describe(err)
232
+ const message = describeError(err)
232
233
  logger.error(`[kakaotalk] sendAttachment failed: ${message}`)
233
234
  return { ok: false, error: message }
234
235
  }
@@ -262,7 +263,7 @@ export function createOutboundCallback(deps: {
262
263
  logIds.push(result.log_id)
263
264
  logger.info(`[kakaotalk] sent log_id=${result.log_id} ${tag}`)
264
265
  } catch (err) {
265
- const message = describe(err)
266
+ const message = describeError(err)
266
267
  logger.error(`[kakaotalk] sendMessage failed: ${message}`)
267
268
  return { ok: false, error: message }
268
269
  }
@@ -295,7 +296,7 @@ async function resolveKakaoReplyTarget(
295
296
  }
296
297
  return { log_id: target.log_id, author_id: target.author_id, message: target.message, type: target.type }
297
298
  } catch (err) {
298
- logger.warn(`[kakaotalk] reply target lookup failed: ${describe(err)}`)
299
+ logger.warn(`[kakaotalk] reply target lookup failed: ${describeError(err)}`)
299
300
  return undefined
300
301
  }
301
302
  }
@@ -334,7 +335,7 @@ export function createKakaoHistoryCallback(deps: {
334
335
  )
335
336
  return { ok: true, messages: mapped }
336
337
  } catch (err) {
337
- const message = describe(err)
338
+ const message = describeError(err)
338
339
  logger.warn(`[kakaotalk] history fetch failed: ${message}`)
339
340
  return { ok: false, error: message }
340
341
  }
@@ -479,11 +480,11 @@ export function createKakaotalkAdapter(options: KakaotalkAdapterOptions): Kakaot
479
480
  authorName: resolvedName ?? verdict.payload.authorId,
480
481
  }
481
482
  logger.info(
482
- `[kakaotalk] routed log_id=${event.log_id} ${inboundTag} mention=${enriched.isBotMention} dm=${enriched.isDm}`,
483
+ `[kakaotalk] routed log_id=${event.log_id} ${inboundTag} mention=${enriched.isBotMention} reply=${enriched.replyToBotMessageId !== null} dm=${enriched.isDm}`,
483
484
  )
484
485
  await options.router.route(enriched)
485
486
  } catch (err) {
486
- logger.error(`[kakaotalk] handleInbound failed: ${describe(err)}`)
487
+ logger.error(`[kakaotalk] handleInbound failed: ${describeError(err)}`)
487
488
  } finally {
488
489
  inflightInbounds--
489
490
  if (inflightInbounds === 0 && stopWaiters.length > 0) {
@@ -527,7 +528,7 @@ export function createKakaotalkAdapter(options: KakaotalkAdapterOptions): Kakaot
527
528
  }
528
529
  } catch (err) {
529
530
  started = false
530
- logger.error(`[kakaotalk] login failed: ${describe(err)}`)
531
+ logger.error(`[kakaotalk] login failed: ${describeError(err)}`)
531
532
  throw err
532
533
  }
533
534
 
@@ -546,14 +547,14 @@ export function createKakaotalkAdapter(options: KakaotalkAdapterOptions): Kakaot
546
547
  logger.error(`[kakaotalk] ${message}`)
547
548
  throw new Error(message)
548
549
  }
549
- logger.error(`[kakaotalk] getProfile failed: ${describe(err)}`)
550
+ logger.error(`[kakaotalk] getProfile failed: ${describeError(err)}`)
550
551
  throw err
551
552
  }
552
553
 
553
554
  try {
554
555
  await channelResolver.refresh()
555
556
  } catch (err) {
556
- logger.warn(`[kakaotalk] initial chat list fetch failed: ${describe(err)}`)
557
+ logger.warn(`[kakaotalk] initial chat list fetch failed: ${describeError(err)}`)
557
558
  }
558
559
 
559
560
  listener = options.listenerFactory ? options.listenerFactory(client) : new KakaoTalkListener(client)
@@ -585,7 +586,7 @@ export function createKakaotalkAdapter(options: KakaotalkAdapterOptions): Kakaot
585
586
  logger.warn('[kakaotalk] disconnected; SDK will reconnect with backoff')
586
587
  })
587
588
  listener.on('error', (err) => {
588
- logger.error(`[kakaotalk] listener error: ${describe(err)}`)
589
+ logger.error(`[kakaotalk] listener error: ${describeError(err)}`)
589
590
  if (!isKickoutError(err)) return
590
591
  // KICKOUT closes the SDK session and skips scheduleReconnect, so
591
592
  // without intervention the adapter goes silent. We must either
@@ -624,7 +625,7 @@ export function createKakaotalkAdapter(options: KakaotalkAdapterOptions): Kakaot
624
625
  if (recoveryEpisode !== episode) return
625
626
  activeListener.start().catch((retryErr) => {
626
627
  logger.error(
627
- `[kakaotalk] KICKOUT auto-recovery failed: ${describe(retryErr)}. Run \`typeclaw restart\` to retry.`,
628
+ `[kakaotalk] KICKOUT auto-recovery failed: ${describeError(retryErr)}. Run \`typeclaw restart\` to retry.`,
628
629
  )
629
630
  })
630
631
  }, delayMs)
@@ -658,7 +659,7 @@ export function createKakaotalkAdapter(options: KakaotalkAdapterOptions): Kakaot
658
659
  }
659
660
  listener = null
660
661
  started = false
661
- logger.error(`[kakaotalk] listener start failed: ${describe(err)}`)
662
+ logger.error(`[kakaotalk] listener start failed: ${describeError(err)}`)
662
663
  throw err
663
664
  }
664
665
 
@@ -707,10 +708,6 @@ export function createKakaotalkAdapter(options: KakaotalkAdapterOptions): Kakaot
707
708
  }
708
709
  }
709
710
 
710
- function describe(err: unknown): string {
711
- return err instanceof Error ? err.message : String(err)
712
- }
713
-
714
711
  function markReadIfSupported(deps: {
715
712
  client: Pick<KakaoTalkClient, 'markRead'>
716
713
  event: KakaoTalkPushMessageEvent
@@ -738,7 +735,7 @@ function markReadIfSupported(deps: {
738
735
  }
739
736
  },
740
737
  (err) => {
741
- logger.warn(`[kakaotalk] mark-read failed: ${describe(err)} chat=${event.chat_id} log=${event.log_id}`)
738
+ logger.warn(`[kakaotalk] mark-read failed: ${describeError(err)} chat=${event.chat_id} log=${event.log_id}`)
742
739
  },
743
740
  )
744
741
  }
@@ -25,6 +25,7 @@ import type {
25
25
  SendResult,
26
26
  } from '@/channels/types'
27
27
 
28
+ import { describeError } from './describe-error'
28
29
  import { splitInboundLine } from './line-attachment'
29
30
  import { createLineChannelResolver } from './line-channel-resolver'
30
31
  import { classifyInbound } from './line-classify'
@@ -128,7 +129,7 @@ export function createOutboundCallback(deps: {
128
129
  logger.info(`[line] sent message_id=${result.message_id} ${tag}`)
129
130
  return { ok: true, messageId: result.message_id, messageIds: [result.message_id] }
130
131
  } catch (err) {
131
- const message = describe(err)
132
+ const message = describeError(err)
132
133
  logger.error(`[line] sendMessage failed: ${message}`)
133
134
  return { ok: false, error: message }
134
135
  }
@@ -160,7 +161,7 @@ export function createLineHistoryCallback(deps: {
160
161
  })
161
162
  return { ok: true, messages: mapped }
162
163
  } catch (err) {
163
- const message = describe(err)
164
+ const message = describeError(err)
164
165
  logger.warn(`[line] history fetch failed: ${message}`)
165
166
  return { ok: false, error: message }
166
167
  }
@@ -231,7 +232,7 @@ export function createLineAdapter(options: LineAdapterOptions): LineAdapter {
231
232
  lastPersistedToken = authToken
232
233
  logger.info('[line] persisted refreshed auth token to secrets')
233
234
  } catch (err) {
234
- logger.warn(`[line] failed to persist refreshed auth token: ${describe(err)}`)
235
+ logger.warn(`[line] failed to persist refreshed auth token: ${describeError(err)}`)
235
236
  }
236
237
  }
237
238
 
@@ -241,7 +242,7 @@ export function createLineAdapter(options: LineAdapterOptions): LineAdapter {
241
242
  const token = await client.ensureFreshAuthToken({ skewMs: LINE_TOKEN_REFRESH_SKEW_MS })
242
243
  if (token) await persistAuthToken(token)
243
244
  } catch (err) {
244
- logger.warn(`[line] token refresh failed: ${describe(err)}`)
245
+ logger.warn(`[line] token refresh failed: ${describeError(err)}`)
245
246
  }
246
247
  }
247
248
 
@@ -301,7 +302,7 @@ export function createLineAdapter(options: LineAdapterOptions): LineAdapter {
301
302
  )
302
303
  await options.router.route(verdict.payload)
303
304
  } catch (err) {
304
- logger.error(`[line] handleInbound failed: ${describe(err)}`)
305
+ logger.error(`[line] handleInbound failed: ${describeError(err)}`)
305
306
  } finally {
306
307
  inflightInbounds--
307
308
  if (inflightInbounds === 0 && stopWaiters.length > 0) {
@@ -335,7 +336,7 @@ export function createLineAdapter(options: LineAdapterOptions): LineAdapter {
335
336
  }
336
337
  } catch (err) {
337
338
  started = false
338
- logger.error(`[line] login failed: ${describe(err)}`)
339
+ logger.error(`[line] login failed: ${describeError(err)}`)
339
340
  throw err
340
341
  }
341
342
 
@@ -348,14 +349,14 @@ export function createLineAdapter(options: LineAdapterOptions): LineAdapter {
348
349
  logger.info(`[line] authenticated as ${profile.display_name || profile.mid} (${profile.mid})`)
349
350
  } catch (err) {
350
351
  started = false
351
- logger.error(`[line] getProfile failed: ${describe(err)}`)
352
+ logger.error(`[line] getProfile failed: ${describeError(err)}`)
352
353
  throw err
353
354
  }
354
355
 
355
356
  try {
356
357
  await channelResolver.refresh()
357
358
  } catch (err) {
358
- logger.warn(`[line] initial chat list fetch failed: ${describe(err)}`)
359
+ logger.warn(`[line] initial chat list fetch failed: ${describeError(err)}`)
359
360
  }
360
361
 
361
362
  listener = options.listenerFactory ? options.listenerFactory(client) : new LineListener(client)
@@ -368,7 +369,7 @@ export function createLineAdapter(options: LineAdapterOptions): LineAdapter {
368
369
  logger.warn('[line] disconnected; SDK will reconnect with backoff')
369
370
  })
370
371
  listener.on('error', (err) => {
371
- logger.error(`[line] listener error: ${describe(err)}`)
372
+ logger.error(`[line] listener error: ${describeError(err)}`)
372
373
  })
373
374
  listener.on('message', (event) => {
374
375
  void processInbound(event)
@@ -384,7 +385,7 @@ export function createLineAdapter(options: LineAdapterOptions): LineAdapter {
384
385
  }
385
386
  listener = null
386
387
  started = false
387
- logger.error(`[line] listener start failed: ${describe(err)}`)
388
+ logger.error(`[line] listener start failed: ${describeError(err)}`)
388
389
  throw err
389
390
  }
390
391
 
@@ -432,7 +433,3 @@ function formatLabel(name: string | undefined, id: string): string {
432
433
  if (name === undefined || name === '' || name === id) return id
433
434
  return `${name}(${id})`
434
435
  }
435
-
436
- function describe(err: unknown): string {
437
- return err instanceof Error ? err.message : String(err)
438
- }
@@ -32,6 +32,7 @@ import type {
32
32
  } from '@/channels/types'
33
33
  import { chunkMarkdown } from '@/markdown'
34
34
 
35
+ import { describeError } from './describe-error'
35
36
  import { addSlackMentionHints } from './mention-hints'
36
37
  import { createSlackAuthorResolver, type SlackAuthorResolver } from './slack-bot-author-resolver'
37
38
  import { createSlackChannelResolver } from './slack-bot-channel-resolver'
@@ -110,7 +111,7 @@ export function createSlashCommandHandler(
110
111
  try {
111
112
  ack(buildSlashAckPayload(SLACK_SLASH_REPLY_FAILED))
112
113
  } catch (err) {
113
- deps.logger.warn(`[slack-bot] slash command ack (drop path) failed: ${describe(err)}`)
114
+ deps.logger.warn(`[slack-bot] slash command ack (drop path) failed: ${describeError(err)}`)
114
115
  }
115
116
  return
116
117
  }
@@ -128,11 +129,11 @@ export function createSlashCommandHandler(
128
129
  invokerId: command.invokerId,
129
130
  })
130
131
  } catch (err) {
131
- deps.logger.error(`[slack-bot] slash command handler failed: ${describe(err)}`)
132
+ deps.logger.error(`[slack-bot] slash command handler failed: ${describeError(err)}`)
132
133
  try {
133
134
  ack(buildSlashAckPayload(SLACK_SLASH_REPLY_FAILED))
134
135
  } catch (ackErr) {
135
- deps.logger.warn(`[slack-bot] slash command error-ack failed: ${describe(ackErr)}`)
136
+ deps.logger.warn(`[slack-bot] slash command error-ack failed: ${describeError(ackErr)}`)
136
137
  }
137
138
  return
138
139
  }
@@ -146,7 +147,7 @@ export function createSlashCommandHandler(
146
147
  try {
147
148
  ack(buildSlashAckPayload(replyContent))
148
149
  } catch (err) {
149
- deps.logger.warn(`[slack-bot] slash command ack failed: ${describe(err)}`)
150
+ deps.logger.warn(`[slack-bot] slash command ack failed: ${describeError(err)}`)
150
151
  }
151
152
 
152
153
  // Decorative post-ack logging: resolve channel names now that the 3s
@@ -156,7 +157,7 @@ export function createSlashCommandHandler(
156
157
  deps.logger.info(`[slack-bot] slash /${command.name} result=${result.kind} ${inboundTag}`)
157
158
  } catch (err) {
158
159
  deps.logger.info(
159
- `[slack-bot] slash /${command.name} result=${result.kind} (channel-tag resolution failed: ${describe(err)})`,
160
+ `[slack-bot] slash /${command.name} result=${result.kind} (channel-tag resolution failed: ${describeError(err)})`,
160
161
  )
161
162
  }
162
163
  }
@@ -210,14 +211,14 @@ export function createThreadCommandHandler(
210
211
  reply = commandResultReply(result)
211
212
  deps.logger.info(`[slack-bot] thread-command !${command.name} result=${result.kind}`)
212
213
  } catch (err) {
213
- deps.logger.error(`[slack-bot] thread-command !${command.name} failed: ${describe(err)}`)
214
+ deps.logger.error(`[slack-bot] thread-command !${command.name} failed: ${describeError(err)}`)
214
215
  reply = SLACK_SLASH_REPLY_FAILED
215
216
  }
216
217
 
217
218
  try {
218
219
  await deps.postReply({ chat: input.channel, thread: input.threadTs, text: reply })
219
220
  } catch (err) {
220
- deps.logger.warn(`[slack-bot] thread-command reply post failed: ${describe(err)}`)
221
+ deps.logger.warn(`[slack-bot] thread-command reply post failed: ${describeError(err)}`)
221
222
  }
222
223
  return { kind: 'executed' }
223
224
  }
@@ -329,7 +330,7 @@ export function createSlackTypingTracker(deps: {
329
330
  })
330
331
  .catch((err: unknown) => {
331
332
  logger.warn(
332
- `[slack-bot] typing call=${callId} chat=${chat} thread=${threadTs} status="${status}" failed: ${describe(err)}`,
333
+ `[slack-bot] typing call=${callId} chat=${chat} thread=${threadTs} status="${status}" failed: ${describeError(err)}`,
333
334
  )
334
335
  })
335
336
  queues.set(key, next)
@@ -575,7 +576,7 @@ async function slackApi<T>(
575
576
  })
576
577
  raw = (await response.json()) as { ok?: boolean; error?: string }
577
578
  } catch (err) {
578
- return { ok: false, reason: describe(err), failure: { kind: 'transient' } }
579
+ return { ok: false, reason: describeError(err), failure: { kind: 'transient' } }
579
580
  }
580
581
  if (raw.ok !== true) {
581
582
  const reason = raw.error ?? 'unknown slack error'
@@ -1162,7 +1163,7 @@ export function createSlackBotAdapter(options: SlackBotAdapterOptions): SlackBot
1162
1163
  )
1163
1164
  await options.router.route(enriched)
1164
1165
  } catch (err) {
1165
- logger.error(`[slack-bot] handleInbound failed: ${describe(err)}`)
1166
+ logger.error(`[slack-bot] handleInbound failed: ${describeError(err)}`)
1166
1167
  } finally {
1167
1168
  inflightInbounds--
1168
1169
  if (inflightInbounds === 0 && stopWaiters.length > 0) {
@@ -1181,7 +1182,7 @@ export function createSlackBotAdapter(options: SlackBotAdapterOptions): SlackBot
1181
1182
  await client.login({ token: options.token })
1182
1183
  } catch (err) {
1183
1184
  started = false
1184
- logger.error(`[slack-bot] login failed: ${describe(err)}`)
1185
+ logger.error(`[slack-bot] login failed: ${describeError(err)}`)
1185
1186
  throw err
1186
1187
  }
1187
1188
 
@@ -1196,7 +1197,7 @@ export function createSlackBotAdapter(options: SlackBotAdapterOptions): SlackBot
1196
1197
  logger.info(`[slack-bot] authenticated as ${auth.user ?? auth.user_id} in team ${auth.team ?? auth.team_id}`)
1197
1198
  } catch (err) {
1198
1199
  started = false
1199
- logger.error(`[slack-bot] auth.test failed: ${describe(err)}`)
1200
+ logger.error(`[slack-bot] auth.test failed: ${describeError(err)}`)
1200
1201
  throw err
1201
1202
  }
1202
1203
 
@@ -1208,7 +1209,7 @@ export function createSlackBotAdapter(options: SlackBotAdapterOptions): SlackBot
1208
1209
  logger.warn('[slack-bot] disconnected; SDK will reconnect with backoff')
1209
1210
  })
1210
1211
  listener.on('error', (err) => {
1211
- logger.error(`[slack-bot] socket-mode error: ${describe(err)}`)
1212
+ logger.error(`[slack-bot] socket-mode error: ${describeError(err)}`)
1212
1213
  })
1213
1214
  listener.on('message', ({ ack, event }) => {
1214
1215
  // Ack first so Slack stops retrying; failure to ack causes duplicate
@@ -1280,7 +1281,7 @@ export function createSlackBotAdapter(options: SlackBotAdapterOptions): SlackBot
1280
1281
  botUserId = null
1281
1282
  teamId = null
1282
1283
  started = false
1283
- logger.error(`[slack-bot] listener start failed: ${describe(err)}`)
1284
+ logger.error(`[slack-bot] listener start failed: ${describeError(err)}`)
1284
1285
  throw err
1285
1286
  }
1286
1287
  },
@@ -1315,10 +1316,6 @@ export function createSlackBotAdapter(options: SlackBotAdapterOptions): SlackBot
1315
1316
  }
1316
1317
  }
1317
1318
 
1318
- function describe(err: unknown): string {
1319
- return err instanceof Error ? err.message : String(err)
1320
- }
1321
-
1322
1319
  function dropHint(reason: InboundDropReason): string {
1323
1320
  switch (reason) {
1324
1321
  case 'empty_text':