kimaki 0.31.0 → 1.1.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/dist/agent-ui.d.ts +33 -0
- package/dist/agent-ui.e2e.test.d.ts +1 -0
- package/dist/agent-ui.e2e.test.js +140 -0
- package/dist/agent-ui.e2e.test.js.map +1 -0
- package/dist/agent-ui.js +199 -0
- package/dist/agent-ui.js.map +1 -0
- package/dist/analytics.d.ts +42 -0
- package/dist/analytics.e2e.test.d.ts +1 -0
- package/dist/analytics.e2e.test.js +112 -0
- package/dist/analytics.e2e.test.js.map +1 -0
- package/dist/analytics.js +162 -223
- package/dist/analytics.js.map +1 -0
- package/dist/analytics.test.d.ts +1 -0
- package/dist/analytics.test.js +121 -157
- package/dist/analytics.test.js.map +1 -0
- package/dist/autostart.d.ts +7 -0
- package/dist/autostart.js +87 -0
- package/dist/autostart.js.map +1 -0
- package/dist/bot.d.ts +91 -0
- package/dist/bot.js +120 -0
- package/dist/bot.js.map +1 -0
- package/dist/btw.e2e.test.d.ts +1 -0
- package/dist/btw.e2e.test.js +102 -0
- package/dist/btw.e2e.test.js.map +1 -0
- package/dist/builtin-skills.d.ts +18 -0
- package/dist/builtin-skills.js +51 -0
- package/dist/builtin-skills.js.map +1 -0
- package/dist/builtin-skills.test.d.ts +1 -0
- package/dist/builtin-skills.test.js +28 -0
- package/dist/builtin-skills.test.js.map +1 -0
- package/dist/catalog-refresh.e2e.test.d.ts +1 -0
- package/dist/catalog-refresh.e2e.test.js +90 -0
- package/dist/catalog-refresh.e2e.test.js.map +1 -0
- package/dist/cli/bot.d.ts +5 -0
- package/dist/cli/bot.js +434 -0
- package/dist/cli/bot.js.map +1 -0
- package/dist/cli/discord.d.ts +3 -0
- package/dist/cli/discord.js +118 -0
- package/dist/cli/discord.js.map +1 -0
- package/dist/cli/project.d.ts +5 -0
- package/dist/cli/project.js +143 -0
- package/dist/cli/project.js.map +1 -0
- package/dist/cli/schedule.d.ts +3 -0
- package/dist/cli/schedule.js +156 -0
- package/dist/cli/schedule.js.map +1 -0
- package/dist/cli/session.d.ts +4 -0
- package/dist/cli/session.js +245 -0
- package/dist/cli/session.js.map +1 -0
- package/dist/cli/shared.d.ts +55 -0
- package/dist/cli/shared.js +138 -0
- package/dist/cli/shared.js.map +1 -0
- package/dist/cli-discord.e2e.test.d.ts +1 -0
- package/dist/cli-discord.e2e.test.js +82 -0
- package/dist/cli-discord.e2e.test.js.map +1 -0
- package/dist/cli-lock.e2e.test.d.ts +1 -0
- package/dist/cli-lock.e2e.test.js +520 -0
- package/dist/cli-lock.e2e.test.js.map +1 -0
- package/dist/cli-read.e2e.test.d.ts +1 -0
- package/dist/cli-read.e2e.test.js +86 -0
- package/dist/cli-read.e2e.test.js.map +1 -0
- package/dist/cli-sessions.e2e.test.d.ts +1 -0
- package/dist/cli-sessions.e2e.test.js +116 -0
- package/dist/cli-sessions.e2e.test.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +34 -263
- package/dist/cli.js.map +1 -0
- package/dist/commands/login-commands.d.ts +59 -0
- package/dist/commands/login-commands.js +341 -0
- package/dist/commands/login-commands.js.map +1 -0
- package/dist/commands/preference-commands.d.ts +44 -0
- package/dist/commands/preference-commands.js +565 -0
- package/dist/commands/preference-commands.js.map +1 -0
- package/dist/commands/session-commands.d.ts +8 -0
- package/dist/commands/session-commands.js +267 -0
- package/dist/commands/session-commands.js.map +1 -0
- package/dist/commands/thread-commands.d.ts +16 -0
- package/dist/commands/thread-commands.js +285 -0
- package/dist/commands/thread-commands.js.map +1 -0
- package/dist/commands/worktree-commands.d.ts +41 -0
- package/dist/commands/worktree-commands.js +279 -0
- package/dist/commands/worktree-commands.js.map +1 -0
- package/dist/commands.e2e.test.d.ts +1 -0
- package/dist/commands.e2e.test.js +255 -0
- package/dist/commands.e2e.test.js.map +1 -0
- package/dist/credentials.d.ts +84 -0
- package/dist/credentials.js +320 -0
- package/dist/credentials.js.map +1 -0
- package/dist/db.d.ts +1532 -0
- package/dist/db.js +57 -245
- package/dist/db.js.map +1 -0
- package/dist/db.test.d.ts +1 -0
- package/dist/db.test.js +351 -682
- package/dist/db.test.js.map +1 -0
- package/dist/duration.d.ts +2 -0
- package/dist/duration.js +18 -0
- package/dist/duration.js.map +1 -0
- package/dist/effects.d.ts +15 -0
- package/dist/effects.js +315 -0
- package/dist/effects.js.map +1 -0
- package/dist/errors.d.ts +38 -0
- package/dist/errors.js +40 -175
- package/dist/errors.js.map +1 -0
- package/dist/event-loop.d.ts +41 -0
- package/dist/event-loop.js +418 -0
- package/dist/event-loop.js.map +1 -0
- package/dist/file-edit-log.d.ts +41 -0
- package/dist/file-edit-log.js +122 -164
- package/dist/file-edit-log.js.map +1 -0
- package/dist/file-edit-log.test.d.ts +1 -0
- package/dist/file-edit-log.test.js +68 -244
- package/dist/file-edit-log.test.js.map +1 -0
- package/dist/format-parts.d.ts +137 -0
- package/dist/format-parts.js +300 -0
- package/dist/format-parts.js.map +1 -0
- package/dist/format-parts.test.d.ts +1 -0
- package/dist/format-parts.test.js +144 -0
- package/dist/format-parts.test.js.map +1 -0
- package/dist/gateway-replay.e2e.test.d.ts +1 -0
- package/dist/gateway-replay.e2e.test.js +95 -0
- package/dist/gateway-replay.e2e.test.js.map +1 -0
- package/dist/harness.e2e.test.d.ts +1 -0
- package/dist/harness.e2e.test.js +107 -0
- package/dist/harness.e2e.test.js.map +1 -0
- package/dist/hello-thread.e2e.test.d.ts +1 -0
- package/dist/hello-thread.e2e.test.js +194 -0
- package/dist/hello-thread.e2e.test.js.map +1 -0
- package/dist/ingress.d.ts +7 -0
- package/dist/ingress.js +337 -0
- package/dist/ingress.js.map +1 -0
- package/dist/interaction-context.d.ts +45 -0
- package/dist/interaction-context.js +77 -0
- package/dist/interaction-context.js.map +1 -0
- package/dist/interrupt.e2e.test.d.ts +1 -0
- package/dist/interrupt.e2e.test.js +124 -0
- package/dist/interrupt.e2e.test.js.map +1 -0
- package/dist/legacy.e2e.test.d.ts +1 -0
- package/dist/legacy.e2e.test.js +85 -0
- package/dist/legacy.e2e.test.js.map +1 -0
- package/dist/live-call.d.ts +51 -0
- package/dist/live-call.js +207 -0
- package/dist/live-call.js.map +1 -0
- package/dist/lock-routes.d.ts +812 -0
- package/dist/lock-routes.js +635 -0
- package/dist/lock-routes.js.map +1 -0
- package/dist/lock-server.d.ts +36 -0
- package/dist/lock-server.js +223 -0
- package/dist/lock-server.js.map +1 -0
- package/dist/logger.d.ts +13 -0
- package/dist/logger.js +112 -162
- package/dist/logger.js.map +1 -0
- package/dist/login.e2e.test.d.ts +1 -0
- package/dist/login.e2e.test.js +83 -0
- package/dist/login.e2e.test.js.map +1 -0
- package/dist/main.d.ts +33 -0
- package/dist/main.js +261 -0
- package/dist/main.js.map +1 -0
- package/dist/markdown/components.d.ts +10 -0
- package/dist/markdown/components.js +77 -0
- package/dist/markdown/components.js.map +1 -0
- package/dist/markdown/markdown.test.d.ts +1 -0
- package/dist/markdown/markdown.test.js +393 -0
- package/dist/markdown/markdown.test.js.map +1 -0
- package/dist/markdown/render-markdown.d.ts +30 -0
- package/dist/markdown/render-markdown.js +265 -0
- package/dist/markdown/render-markdown.js.map +1 -0
- package/dist/message-tool.e2e.test.d.ts +1 -0
- package/dist/message-tool.e2e.test.js +39 -0
- package/dist/message-tool.e2e.test.js.map +1 -0
- package/dist/migrations.d.ts +8 -0
- package/dist/migrations.js +187 -0
- package/dist/migrations.js.map +1 -0
- package/dist/onboarding-cli.e2e.test.d.ts +1 -0
- package/dist/onboarding-cli.e2e.test.js +178 -0
- package/dist/onboarding-cli.e2e.test.js.map +1 -0
- package/dist/onboarding.d.ts +36 -0
- package/dist/onboarding.e2e.test.d.ts +1 -0
- package/dist/onboarding.e2e.test.js +148 -0
- package/dist/onboarding.e2e.test.js.map +1 -0
- package/dist/onboarding.js +261 -0
- package/dist/onboarding.js.map +1 -0
- package/dist/opencode-server.d.ts +54 -0
- package/dist/opencode-server.js +417 -0
- package/dist/opencode-server.js.map +1 -0
- package/dist/opencode-server.test.d.ts +1 -0
- package/dist/opencode-server.test.js +21 -0
- package/dist/opencode-server.test.js.map +1 -0
- package/dist/permissions.d.ts +31 -0
- package/dist/permissions.e2e.test.d.ts +1 -0
- package/dist/permissions.e2e.test.js +166 -0
- package/dist/permissions.e2e.test.js.map +1 -0
- package/dist/permissions.js +95 -0
- package/dist/permissions.js.map +1 -0
- package/dist/plugin/anthropic/index.d.ts +13 -0
- package/dist/plugin/anthropic/index.js +201 -0
- package/dist/plugin/anthropic/index.js.map +1 -0
- package/dist/plugin/anthropic/index.test.d.ts +1 -0
- package/dist/plugin/anthropic/index.test.js +39 -0
- package/dist/plugin/anthropic/index.test.js.map +1 -0
- package/dist/plugin/index.d.ts +3 -0
- package/dist/plugin/index.js +124 -0
- package/dist/plugin/index.js.map +1 -0
- package/dist/plugin/read-media.d.ts +23 -0
- package/dist/plugin/read-media.js +72 -0
- package/dist/plugin/read-media.js.map +1 -0
- package/dist/plugin/session-id/index.d.ts +3 -0
- package/dist/plugin/session-id/index.js +18 -0
- package/dist/plugin/session-id/index.js.map +1 -0
- package/dist/plugin.e2e.test.d.ts +1 -0
- package/dist/plugin.e2e.test.js +92 -0
- package/dist/plugin.e2e.test.js.map +1 -0
- package/dist/preference-commands.e2e.test.d.ts +1 -0
- package/dist/preference-commands.e2e.test.js +555 -0
- package/dist/preference-commands.e2e.test.js.map +1 -0
- package/dist/probe-live.tmp.d.ts +1 -0
- package/dist/probe-live.tmp.js +82 -0
- package/dist/probe-live.tmp.js.map +1 -0
- package/dist/project.d.ts +58 -0
- package/dist/project.js +169 -0
- package/dist/project.js.map +1 -0
- package/dist/prompt.d.ts +112 -0
- package/dist/prompt.js +577 -0
- package/dist/prompt.js.map +1 -0
- package/dist/questions.d.ts +59 -0
- package/dist/questions.e2e.test.d.ts +1 -0
- package/dist/questions.e2e.test.js +290 -0
- package/dist/questions.e2e.test.js.map +1 -0
- package/dist/questions.js +231 -0
- package/dist/questions.js.map +1 -0
- package/dist/queue.d.ts +45 -0
- package/dist/queue.e2e.test.d.ts +1 -0
- package/dist/queue.e2e.test.js +220 -0
- package/dist/queue.e2e.test.js.map +1 -0
- package/dist/queue.js +132 -0
- package/dist/queue.js.map +1 -0
- package/dist/remote-send.d.ts +32 -0
- package/dist/remote-send.e2e.test.d.ts +1 -0
- package/dist/remote-send.e2e.test.js +89 -0
- package/dist/remote-send.e2e.test.js.map +1 -0
- package/dist/remote-send.js +105 -0
- package/dist/remote-send.js.map +1 -0
- package/dist/renderer.e2e.test.d.ts +1 -0
- package/dist/renderer.e2e.test.js +357 -0
- package/dist/renderer.e2e.test.js.map +1 -0
- package/dist/restart.e2e.test.d.ts +1 -0
- package/dist/restart.e2e.test.js +68 -0
- package/dist/restart.e2e.test.js.map +1 -0
- package/dist/routes.d.ts +24 -0
- package/dist/routes.js +42 -0
- package/dist/routes.js.map +1 -0
- package/dist/routes.test.d.ts +1 -0
- package/dist/routes.test.js +79 -0
- package/dist/routes.test.js.map +1 -0
- package/dist/routines.e2e.test.d.ts +1 -0
- package/dist/routines.e2e.test.js +188 -0
- package/dist/routines.e2e.test.js.map +1 -0
- package/dist/scheduler.d.ts +116 -0
- package/dist/scheduler.e2e.test.d.ts +1 -0
- package/dist/scheduler.e2e.test.js +163 -0
- package/dist/scheduler.e2e.test.js.map +1 -0
- package/dist/scheduler.js +602 -0
- package/dist/scheduler.js.map +1 -0
- package/dist/scheduler.test.d.ts +1 -0
- package/dist/scheduler.test.js +180 -0
- package/dist/scheduler.test.js.map +1 -0
- package/dist/schema-sql.d.ts +1 -0
- package/dist/schema-sql.js +3 -0
- package/dist/schema-sql.js.map +1 -0
- package/dist/schema.d.ts +2968 -0
- package/dist/schema.js +95 -252
- package/dist/schema.js.map +1 -0
- package/dist/session-commands.e2e.test.d.ts +1 -0
- package/dist/session-commands.e2e.test.js +285 -0
- package/dist/session-commands.e2e.test.js.map +1 -0
- package/dist/session-events.d.ts +83 -0
- package/dist/session-events.js +260 -0
- package/dist/session-events.js.map +1 -0
- package/dist/session-ops.e2e.test.d.ts +1 -0
- package/dist/session-ops.e2e.test.js +114 -0
- package/dist/session-ops.e2e.test.js.map +1 -0
- package/dist/sessions.d.ts +121 -0
- package/dist/sessions.js +663 -0
- package/dist/sessions.js.map +1 -0
- package/dist/shell.e2e.test.d.ts +1 -0
- package/dist/shell.e2e.test.js +147 -0
- package/dist/shell.e2e.test.js.map +1 -0
- package/dist/slash-commands.d.ts +62 -0
- package/dist/slash-commands.js +476 -0
- package/dist/slash-commands.js.map +1 -0
- package/dist/slash-commands.test.d.ts +1 -0
- package/dist/slash-commands.test.js +87 -0
- package/dist/slash-commands.test.js.map +1 -0
- package/dist/sleep.e2e.test.d.ts +1 -0
- package/dist/sleep.e2e.test.js +115 -487
- package/dist/sleep.e2e.test.js.map +1 -0
- package/dist/sleeps.d.ts +37 -0
- package/dist/sleeps.js +220 -0
- package/dist/sleeps.js.map +1 -0
- package/dist/store.d.ts +10 -0
- package/dist/store.js +8 -28
- package/dist/store.js.map +1 -0
- package/dist/system-prompt.d.ts +76 -0
- package/dist/system-prompt.js +852 -0
- package/dist/system-prompt.js.map +1 -0
- package/dist/tasks.e2e.test.d.ts +1 -0
- package/dist/tasks.e2e.test.js +173 -0
- package/dist/tasks.e2e.test.js.map +1 -0
- package/dist/test/auth-plugin/index.d.ts +3 -0
- package/dist/test/auth-plugin/index.js +18 -0
- package/dist/test/auth-plugin/index.js.map +1 -0
- package/dist/test/fake-mcp-server.d.ts +1 -0
- package/dist/test/fake-mcp-server.js +45 -0
- package/dist/test/fake-mcp-server.js.map +1 -0
- package/dist/test/harness.d.ts +246 -0
- package/dist/test/harness.js +704 -0
- package/dist/test/harness.js.map +1 -0
- package/dist/test/replay.d.ts +14 -0
- package/dist/test/replay.js +75 -0
- package/dist/test/replay.js.map +1 -0
- package/dist/thread-reducer.d.ts +172 -0
- package/dist/thread-reducer.fixtures.test.d.ts +1 -0
- package/dist/thread-reducer.fixtures.test.js +360 -0
- package/dist/thread-reducer.fixtures.test.js.map +1 -0
- package/dist/thread-reducer.js +497 -0
- package/dist/thread-reducer.js.map +1 -0
- package/dist/thread-reducer.test.d.ts +1 -0
- package/dist/thread-reducer.test.js +369 -0
- package/dist/thread-reducer.test.js.map +1 -0
- package/dist/tts.test.d.ts +1 -0
- package/dist/tts.test.js +147 -0
- package/dist/tts.test.js.map +1 -0
- package/dist/voice-agent.d.ts +33 -0
- package/dist/voice-agent.js +159 -0
- package/dist/voice-agent.js.map +1 -0
- package/dist/voice-attachments.e2e.test.d.ts +1 -0
- package/dist/voice-attachments.e2e.test.js +256 -0
- package/dist/voice-attachments.e2e.test.js.map +1 -0
- package/dist/voice-call.d.ts +59 -0
- package/dist/voice-call.e2e.test.d.ts +1 -0
- package/dist/voice-call.e2e.test.js +259 -0
- package/dist/voice-call.e2e.test.js.map +1 -0
- package/dist/voice-call.js +760 -0
- package/dist/voice-call.js.map +1 -0
- package/dist/voice-openai.e2e.test.d.ts +1 -0
- package/dist/voice-openai.e2e.test.js +161 -0
- package/dist/voice-openai.e2e.test.js.map +1 -0
- package/dist/voice.d.ts +116 -0
- package/dist/voice.js +619 -717
- package/dist/voice.js.map +1 -0
- package/dist/working-directory.e2e.test.d.ts +1 -0
- package/dist/working-directory.e2e.test.js +231 -0
- package/dist/working-directory.e2e.test.js.map +1 -0
- package/dist/worktrees.d.ts +54 -0
- package/dist/worktrees.js +247 -709
- package/dist/worktrees.js.map +1 -0
- package/dist/worktrees.test.d.ts +1 -0
- package/dist/worktrees.test.js +97 -952
- package/dist/worktrees.test.js.map +1 -0
- package/package.json +38 -73
- package/skills/kimaki-debug/SKILL.md +44 -0
- package/skills/kimaki-tunnel/SKILL.md +34 -0
- package/src/agent-ui.e2e.test.ts +134 -0
- package/src/agent-ui.ts +216 -0
- package/src/analytics.e2e.test.ts +138 -0
- package/src/analytics.test.ts +122 -182
- package/src/analytics.ts +206 -258
- package/src/autostart.ts +90 -0
- package/src/bot.ts +196 -0
- package/src/btw.e2e.test.ts +130 -0
- package/src/builtin-skills.test.ts +29 -0
- package/src/builtin-skills.ts +59 -0
- package/src/catalog-refresh.e2e.test.ts +112 -0
- package/src/cli/bot.ts +425 -0
- package/src/cli/discord.ts +116 -0
- package/src/cli/project.ts +147 -0
- package/src/cli/schedule.ts +151 -0
- package/src/cli/session.ts +252 -0
- package/src/cli/shared.ts +139 -0
- package/src/cli-discord.e2e.test.ts +79 -0
- package/src/cli-lock.e2e.test.ts +530 -0
- package/src/cli-read.e2e.test.ts +83 -0
- package/src/cli-sessions.e2e.test.ts +120 -0
- package/src/cli.ts +35 -418
- package/src/commands/login-commands.ts +360 -0
- package/src/commands/preference-commands.ts +599 -0
- package/src/commands/session-commands.ts +289 -0
- package/src/commands/thread-commands.ts +324 -0
- package/src/commands/worktree-commands.ts +288 -0
- package/src/commands.e2e.test.ts +290 -0
- package/src/credentials.ts +425 -0
- package/src/db.test.ts +344 -759
- package/src/db.ts +66 -284
- package/src/duration.ts +18 -0
- package/src/effects.ts +337 -0
- package/src/errors.ts +39 -228
- package/src/event-loop.ts +471 -0
- package/src/file-edit-log.test.ts +68 -272
- package/src/file-edit-log.ts +108 -231
- package/src/fixtures/v1-schema.sql +241 -0
- package/src/fixtures/voice.ogg +0 -0
- package/src/format-parts.test.ts +150 -0
- package/src/format-parts.ts +405 -0
- package/src/gateway-replay.e2e.test.ts +116 -0
- package/src/harness.e2e.test.ts +124 -0
- package/src/hello-thread.e2e.test.ts +223 -0
- package/src/ingress.ts +334 -0
- package/src/interaction-context.ts +131 -0
- package/src/interrupt.e2e.test.ts +151 -0
- package/src/legacy.e2e.test.ts +105 -0
- package/src/live-call.ts +249 -0
- package/src/lock-routes.ts +625 -0
- package/src/lock-server.ts +233 -0
- package/src/logger.ts +120 -207
- package/src/login.e2e.test.ts +86 -0
- package/src/main.ts +238 -0
- package/src/markdown/components.ts +102 -0
- package/src/markdown/markdown.test.ts +414 -0
- package/src/markdown/render-markdown.ts +288 -0
- package/src/migrations.ts +198 -0
- package/src/onboarding-cli.e2e.test.ts +215 -0
- package/src/onboarding.e2e.test.ts +171 -0
- package/src/onboarding.ts +297 -0
- package/src/opencode-server.test.ts +24 -0
- package/src/opencode-server.ts +464 -0
- package/src/permissions.e2e.test.ts +191 -0
- package/src/permissions.ts +121 -0
- package/src/plugin/anthropic/index.test.ts +39 -0
- package/src/plugin/anthropic/index.ts +213 -0
- package/src/plugin/index.ts +112 -0
- package/src/plugin.e2e.test.ts +117 -0
- package/src/preference-commands.e2e.test.ts +597 -0
- package/src/project.ts +216 -0
- package/src/prompt.ts +664 -0
- package/src/questions.e2e.test.ts +328 -0
- package/src/questions.ts +322 -0
- package/src/queue.e2e.test.ts +253 -0
- package/src/queue.ts +158 -0
- package/src/remote-send.e2e.test.ts +91 -0
- package/src/remote-send.ts +110 -0
- package/src/renderer.e2e.test.ts +390 -0
- package/src/restart.e2e.test.ts +90 -0
- package/src/routes.test.ts +81 -0
- package/src/routes.ts +48 -0
- package/src/routines.e2e.test.ts +210 -0
- package/src/scheduler.e2e.test.ts +182 -0
- package/src/scheduler.test.ts +183 -0
- package/src/scheduler.ts +648 -0
- package/src/schema-sql.ts +3 -0
- package/src/schema.ts +95 -271
- package/src/session-commands.e2e.test.ts +326 -0
- package/src/session-events.ts +301 -0
- package/src/session-ops.e2e.test.ts +141 -0
- package/src/sessions.ts +804 -0
- package/src/shell.e2e.test.ts +173 -0
- package/src/slash-commands.test.ts +89 -0
- package/src/slash-commands.ts +540 -0
- package/src/sleep.e2e.test.ts +135 -552
- package/src/sleeps.ts +230 -0
- package/src/store.ts +19 -217
- package/src/system-prompt.ts +923 -0
- package/src/test/auth-plugin/index.ts +17 -0
- package/src/test/fake-mcp-server.ts +49 -0
- package/src/test/harness.ts +957 -0
- package/src/test/replay.ts +90 -0
- package/src/thread-reducer.fixtures.test.ts +374 -0
- package/src/thread-reducer.test.ts +380 -0
- package/src/thread-reducer.ts +671 -0
- package/src/tts.test.ts +150 -0
- package/src/voice-agent.ts +196 -0
- package/src/voice-attachments.e2e.test.ts +301 -0
- package/src/voice-call.e2e.test.ts +293 -0
- package/src/voice-call.ts +764 -0
- package/src/voice-openai.e2e.test.ts +191 -0
- package/src/voice.ts +668 -988
- package/src/working-directory.e2e.test.ts +226 -0
- package/src/worktrees.test.ts +89 -1115
- package/src/worktrees.ts +195 -957
- package/bin.js +0 -2
- package/dist/agent-model.e2e.test.js +0 -1223
- package/dist/ai-tool-to-genai.js +0 -233
- package/dist/ai-tool-to-genai.test.js +0 -267
- package/dist/ai-tool.js +0 -6
- package/dist/anthropic-account-identity.js +0 -70
- package/dist/anthropic-account-identity.test.js +0 -38
- package/dist/anthropic-auth-plugin.js +0 -958
- package/dist/anthropic-auth-plugin.test.js +0 -115
- package/dist/anthropic-auth-state.js +0 -186
- package/dist/anthropic-auth-state.test.js +0 -203
- package/dist/bash-tool-schema-plugin.js +0 -50
- package/dist/bash-tool-schema-plugin.test.js +0 -68
- package/dist/bin.js +0 -151
- package/dist/bot-lifecycle.test.js +0 -206
- package/dist/btw-prefix-detection.js +0 -24
- package/dist/btw-prefix-detection.test.js +0 -130
- package/dist/cache-drift-plugin.js +0 -183
- package/dist/cache-rewrite.js +0 -39
- package/dist/cache-rewrite.test.js +0 -41
- package/dist/channel-management.js +0 -347
- package/dist/cli-commands/bot.js +0 -254
- package/dist/cli-commands/maintenance.js +0 -171
- package/dist/cli-commands/misc.js +0 -153
- package/dist/cli-commands/project.js +0 -510
- package/dist/cli-commands/send.js +0 -659
- package/dist/cli-commands/session.js +0 -889
- package/dist/cli-commands/task.js +0 -277
- package/dist/cli-commands/thread.js +0 -63
- package/dist/cli-commands/user.js +0 -145
- package/dist/cli-parsing.test.js +0 -226
- package/dist/cli-runner.js +0 -1591
- package/dist/cli-runner.test.js +0 -119
- package/dist/cli-send-thread.e2e.test.js +0 -470
- package/dist/cloudflare-transcription.js +0 -56
- package/dist/commands/abort.js +0 -84
- package/dist/commands/action-buttons.js +0 -248
- package/dist/commands/add-project.js +0 -111
- package/dist/commands/agent.js +0 -658
- package/dist/commands/ask-question.js +0 -371
- package/dist/commands/ask-question.test.js +0 -150
- package/dist/commands/btw.js +0 -275
- package/dist/commands/compact.js +0 -117
- package/dist/commands/context-usage.js +0 -194
- package/dist/commands/context-usage.test.js +0 -49
- package/dist/commands/create-new-project.js +0 -138
- package/dist/commands/diff.js +0 -63
- package/dist/commands/file-upload.js +0 -280
- package/dist/commands/fork-subagent.js +0 -175
- package/dist/commands/fork.js +0 -291
- package/dist/commands/gemini-apikey.js +0 -123
- package/dist/commands/last-sessions.js +0 -129
- package/dist/commands/login.js +0 -893
- package/dist/commands/mcp.js +0 -239
- package/dist/commands/memory-snapshot.js +0 -24
- package/dist/commands/mention-mode.js +0 -42
- package/dist/commands/merge-worktree.js +0 -205
- package/dist/commands/model-variant.js +0 -390
- package/dist/commands/model.js +0 -1012
- package/dist/commands/multioauth.js +0 -425
- package/dist/commands/new-worktree.js +0 -625
- package/dist/commands/paginated-select.js +0 -57
- package/dist/commands/permissions.js +0 -327
- package/dist/commands/queue.js +0 -347
- package/dist/commands/queue.test.js +0 -15
- package/dist/commands/remove-project.js +0 -111
- package/dist/commands/restart-opencode-server.js +0 -133
- package/dist/commands/resume.js +0 -148
- package/dist/commands/run-command.js +0 -79
- package/dist/commands/screenshare.js +0 -307
- package/dist/commands/screenshare.test.js +0 -20
- package/dist/commands/session-id.js +0 -78
- package/dist/commands/session.js +0 -248
- package/dist/commands/share.js +0 -80
- package/dist/commands/tasks.js +0 -296
- package/dist/commands/types.js +0 -2
- package/dist/commands/undo-redo.js +0 -313
- package/dist/commands/unset-model.js +0 -116
- package/dist/commands/upgrade.js +0 -41
- package/dist/commands/user-command.js +0 -196
- package/dist/commands/verbosity.js +0 -124
- package/dist/commands/vscode.js +0 -295
- package/dist/commands/worktrees.js +0 -548
- package/dist/condense-memory.js +0 -33
- package/dist/config.js +0 -126
- package/dist/context-awareness-plugin.js +0 -357
- package/dist/context-awareness-plugin.test.js +0 -126
- package/dist/cpu-profiler.js +0 -211
- package/dist/cpu-profiler.test.js +0 -160
- package/dist/critique-utils.js +0 -95
- package/dist/database.js +0 -1074
- package/dist/debounce-timeout.js +0 -28
- package/dist/debounced-process-flush.js +0 -77
- package/dist/default-channel-provisioning.test.js +0 -149
- package/dist/discord-bot.js +0 -1432
- package/dist/discord-command-registration.js +0 -519
- package/dist/discord-command-registration.test.js +0 -17
- package/dist/discord-urls.js +0 -81
- package/dist/discord-utils.js +0 -789
- package/dist/discord-utils.test.js +0 -400
- package/dist/escape-backticks.test.js +0 -429
- package/dist/event-stream-real-capture.e2e.test.js +0 -533
- package/dist/eventsource-parser.test.js +0 -327
- package/dist/exec-async.js +0 -38
- package/dist/external-directory-permissions.e2e.test.js +0 -86
- package/dist/external-directory-project-deny.e2e.test.js +0 -70
- package/dist/external-opencode-sync.js +0 -620
- package/dist/external-opencode-sync.test.js +0 -206
- package/dist/extract-sdk-error-message.test.js +0 -13
- package/dist/format-tables.js +0 -728
- package/dist/format-tables.test.js +0 -915
- package/dist/forum-sync/config.js +0 -79
- package/dist/forum-sync/discord-operations.js +0 -157
- package/dist/forum-sync/index.js +0 -5
- package/dist/forum-sync/markdown.js +0 -110
- package/dist/forum-sync/sync-to-discord.js +0 -417
- package/dist/forum-sync/sync-to-files.js +0 -190
- package/dist/forum-sync/types.js +0 -53
- package/dist/forum-sync/watchers.js +0 -322
- package/dist/gateway-proxy-reconnect.e2e.test.js +0 -414
- package/dist/gateway-proxy.e2e.test.js +0 -488
- package/dist/genai-worker-wrapper.js +0 -111
- package/dist/genai-worker.js +0 -309
- package/dist/genai.js +0 -232
- package/dist/git-worktree-core.js +0 -461
- package/dist/guild-categories.test.js +0 -225
- package/dist/heap-monitor.js +0 -122
- package/dist/hrana-server.js +0 -322
- package/dist/hrana-server.test.js +0 -99
- package/dist/html-actions.js +0 -123
- package/dist/html-actions.test.js +0 -70
- package/dist/html-components.js +0 -115
- package/dist/html-components.test.js +0 -34
- package/dist/image-optimizer-plugin.js +0 -153
- package/dist/image-utils.js +0 -112
- package/dist/interaction-handler.js +0 -578
- package/dist/ipc-polling.js +0 -245
- package/dist/ipc-tools-plugin.js +0 -251
- package/dist/kimaki-digital-twin.e2e.test.js +0 -161
- package/dist/kimaki-opencode-plugin-loading.e2e.test.js +0 -158
- package/dist/kimaki-opencode-plugin.js +0 -33
- package/dist/kimaki-opencode-plugin.test.js +0 -126
- package/dist/kimaki-workspace-adaptor.js +0 -118
- package/dist/limit-heading-depth.js +0 -25
- package/dist/limit-heading-depth.test.js +0 -105
- package/dist/list-channel-threads.js +0 -163
- package/dist/list-channel-threads.test.js +0 -80
- package/dist/markdown.js +0 -455
- package/dist/markdown.test.js +0 -411
- package/dist/memory-overview-plugin.js +0 -123
- package/dist/message-formatting.js +0 -788
- package/dist/message-formatting.test.js +0 -1132
- package/dist/message-preprocessing.js +0 -419
- package/dist/oauth-rotation-shared.js +0 -253
- package/dist/onboarding-tutorial.js +0 -163
- package/dist/onboarding-welcome.js +0 -37
- package/dist/openai-auth-plugin.js +0 -125
- package/dist/openai-auth-state.js +0 -237
- package/dist/openai-realtime.js +0 -224
- package/dist/opencode-command-detection.js +0 -65
- package/dist/opencode-command-detection.test.js +0 -240
- package/dist/opencode-command.js +0 -181
- package/dist/opencode-command.test.js +0 -218
- package/dist/opencode-interrupt-plugin.js +0 -253
- package/dist/opencode-interrupt-plugin.test.js +0 -293
- package/dist/opencode.js +0 -1217
- package/dist/parse-permission-rules.test.js +0 -117
- package/dist/patch-text-parser.js +0 -97
- package/dist/plugin-logger.js +0 -105
- package/dist/plugin-opencode-client.js +0 -54
- package/dist/privacy-sanitizer.js +0 -105
- package/dist/project-add.test.js +0 -62
- package/dist/question-abort-clears-dropdown.e2e.test.js +0 -89
- package/dist/question-abort-resume.e2e.test.js +0 -100
- package/dist/question-abort-retry-text-before-dropdown.e2e.test.js +0 -150
- package/dist/question-text-before-dropdown.e2e.test.js +0 -52
- package/dist/queue-advanced-abort.e2e.test.js +0 -348
- package/dist/queue-advanced-action-buttons.e2e.test.js +0 -209
- package/dist/queue-advanced-e2e-setup.js +0 -1043
- package/dist/queue-advanced-footer.e2e.test.js +0 -286
- package/dist/queue-advanced-model-switch.e2e.test.js +0 -297
- package/dist/queue-advanced-permissions-typing.e2e.test.js +0 -189
- package/dist/queue-advanced-question.e2e.test.js +0 -266
- package/dist/queue-advanced-typing-interrupt.e2e.test.js +0 -113
- package/dist/queue-advanced-typing.e2e.test.js +0 -151
- package/dist/queue-delete-message.e2e.test.js +0 -216
- package/dist/queue-drain-after-interactive-ui.e2e.test.js +0 -120
- package/dist/queue-interrupt-drain.e2e.test.js +0 -256
- package/dist/queue-question-select-drain.e2e.test.js +0 -162
- package/dist/runtime-idle-sweeper.js +0 -52
- package/dist/runtime-lifecycle.e2e.test.js +0 -570
- package/dist/sentry.js +0 -23
- package/dist/session-handler/agent-utils.js +0 -65
- package/dist/session-handler/event-stream-state.js +0 -1225
- package/dist/session-handler/event-stream-state.test.js +0 -3160
- package/dist/session-handler/global-event-listener.js +0 -212
- package/dist/session-handler/model-utils.js +0 -311
- package/dist/session-handler/model-utils.test.js +0 -445
- package/dist/session-handler/opencode-session-event-log.js +0 -121
- package/dist/session-handler/thread-ingress.test.js +0 -41
- package/dist/session-handler/thread-runtime-state.js +0 -209
- package/dist/session-handler/thread-session-runtime-summary.test.js +0 -121
- package/dist/session-handler/thread-session-runtime.js +0 -4320
- package/dist/session-handler.js +0 -9
- package/dist/session-search.js +0 -219
- package/dist/session-search.test.js +0 -287
- package/dist/session-sleep.test.js +0 -224
- package/dist/session-title-rename.test.js +0 -128
- package/dist/skill-filter.js +0 -43
- package/dist/skill-filter.test.js +0 -86
- package/dist/startup-service.js +0 -153
- package/dist/startup-time.e2e.test.js +0 -297
- package/dist/system-message.js +0 -806
- package/dist/system-message.test.js +0 -917
- package/dist/task-id-plugin.js +0 -16
- package/dist/task-runner.js +0 -554
- package/dist/task-schedule.js +0 -298
- package/dist/task-schedule.test.js +0 -366
- package/dist/test-utils.js +0 -385
- package/dist/thinking-utils.js +0 -45
- package/dist/thinking-utils.test.js +0 -35
- package/dist/thread-message-queue.e2e.test.js +0 -1227
- package/dist/tools.js +0 -357
- package/dist/undo-redo.e2e.test.js +0 -171
- package/dist/unnest-code-blocks.js +0 -146
- package/dist/unnest-code-blocks.test.js +0 -673
- package/dist/upgrade.js +0 -114
- package/dist/utils.js +0 -148
- package/dist/voice-attachment.js +0 -56
- package/dist/voice-handler.js +0 -727
- package/dist/voice-message.e2e.test.js +0 -1254
- package/dist/voice-routing-input.e2e.test.js +0 -195
- package/dist/voice-routing-question.e2e.test.js +0 -182
- package/dist/voice.test.js +0 -500
- package/dist/wait-session.js +0 -193
- package/dist/websockify.js +0 -69
- package/dist/worker-types.js +0 -4
- package/dist/worktree-clone-isolation.e2e.test.js +0 -188
- package/dist/worktree-lifecycle.e2e.test.js +0 -735
- package/dist/worktree-utils.js +0 -3
- package/dist/xai-auth-plugin.js +0 -238
- package/dist/xai-auth-state.js +0 -234
- package/dist/xai-auth-state.test.js +0 -183
- package/dist/xml.js +0 -92
- package/dist/xml.test.js +0 -32
- package/skills/bump-holocron-consumers/SKILL.md +0 -137
- package/skills/critique/SKILL.md +0 -116
- package/skills/egaki/SKILL.md +0 -86
- package/skills/errore/SKILL.md +0 -501
- package/skills/goke/SKILL.md +0 -695
- package/skills/holocron/SKILL.md +0 -942
- package/skills/lintcn/SKILL.md +0 -873
- package/skills/new-skill/SKILL.md +0 -339
- package/skills/npm-package/SKILL.md +0 -692
- package/skills/opensrc/SKILL.md +0 -102
- package/skills/playwriter/SKILL.md +0 -35
- package/skills/profano/SKILL.md +0 -33
- package/skills/readme.md +0 -20
- package/skills/sigillo/SKILL.md +0 -370
- package/skills/spiceflow/SKILL.md +0 -80
- package/skills/strada/SKILL.md +0 -104
- package/skills/termcast/SKILL.md +0 -133
- package/skills/tuistory/SKILL.md +0 -237
- package/skills/usecomputer/SKILL.md +0 -264
- package/skills/zele/SKILL.md +0 -81
- package/src/agent-model.e2e.test.ts +0 -1557
- package/src/ai-tool-to-genai.test.ts +0 -296
- package/src/ai-tool-to-genai.ts +0 -283
- package/src/ai-tool.ts +0 -39
- package/src/anthropic-account-identity.test.ts +0 -52
- package/src/anthropic-account-identity.ts +0 -96
- package/src/anthropic-auth-plugin.test.ts +0 -135
- package/src/anthropic-auth-plugin.ts +0 -1180
- package/src/anthropic-auth-state.test.ts +0 -259
- package/src/anthropic-auth-state.ts +0 -272
- package/src/bash-tool-schema-plugin.test.ts +0 -84
- package/src/bash-tool-schema-plugin.ts +0 -77
- package/src/bin.ts +0 -173
- package/src/bot-lifecycle.test.ts +0 -252
- package/src/btw-prefix-detection.test.ts +0 -142
- package/src/btw-prefix-detection.ts +0 -30
- package/src/cache-drift-plugin.ts +0 -249
- package/src/cache-rewrite.test.ts +0 -49
- package/src/cache-rewrite.ts +0 -96
- package/src/channel-management.ts +0 -494
- package/src/cli-commands/bot.ts +0 -374
- package/src/cli-commands/maintenance.ts +0 -237
- package/src/cli-commands/misc.ts +0 -208
- package/src/cli-commands/project.ts +0 -680
- package/src/cli-commands/send.ts +0 -885
- package/src/cli-commands/session.ts +0 -1181
- package/src/cli-commands/task.ts +0 -358
- package/src/cli-commands/thread.ts +0 -86
- package/src/cli-commands/user.ts +0 -195
- package/src/cli-parsing.test.ts +0 -305
- package/src/cli-runner.test.ts +0 -166
- package/src/cli-runner.ts +0 -2157
- package/src/cli-send-thread.e2e.test.ts +0 -609
- package/src/cloudflare-transcription.ts +0 -76
- package/src/commands/abort.ts +0 -113
- package/src/commands/action-buttons.ts +0 -371
- package/src/commands/add-project.ts +0 -146
- package/src/commands/agent.ts +0 -911
- package/src/commands/ask-question.test.ts +0 -177
- package/src/commands/ask-question.ts +0 -532
- package/src/commands/btw.ts +0 -356
- package/src/commands/compact.ts +0 -154
- package/src/commands/context-usage.test.ts +0 -57
- package/src/commands/context-usage.ts +0 -267
- package/src/commands/create-new-project.ts +0 -203
- package/src/commands/diff.ts +0 -91
- package/src/commands/file-upload.ts +0 -398
- package/src/commands/fork-subagent.ts +0 -262
- package/src/commands/fork.ts +0 -421
- package/src/commands/gemini-apikey.ts +0 -205
- package/src/commands/last-sessions.ts +0 -176
- package/src/commands/login.ts +0 -1182
- package/src/commands/mcp.ts +0 -307
- package/src/commands/memory-snapshot.ts +0 -30
- package/src/commands/mention-mode.ts +0 -66
- package/src/commands/merge-worktree.ts +0 -282
- package/src/commands/model-variant.ts +0 -522
- package/src/commands/model.ts +0 -1377
- package/src/commands/multioauth.ts +0 -508
- package/src/commands/new-worktree.ts +0 -835
- package/src/commands/paginated-select.ts +0 -81
- package/src/commands/permissions.ts +0 -458
- package/src/commands/queue.test.ts +0 -19
- package/src/commands/queue.ts +0 -471
- package/src/commands/remove-project.ts +0 -152
- package/src/commands/restart-opencode-server.ts +0 -173
- package/src/commands/resume.ts +0 -229
- package/src/commands/run-command.ts +0 -123
- package/src/commands/screenshare.test.ts +0 -30
- package/src/commands/screenshare.ts +0 -388
- package/src/commands/session-id.ts +0 -109
- package/src/commands/session.ts +0 -319
- package/src/commands/share.ts +0 -106
- package/src/commands/tasks.ts +0 -399
- package/src/commands/types.ts +0 -25
- package/src/commands/undo-redo.ts +0 -394
- package/src/commands/unset-model.ts +0 -152
- package/src/commands/upgrade.ts +0 -51
- package/src/commands/user-command.ts +0 -260
- package/src/commands/verbosity.ts +0 -172
- package/src/commands/vscode.ts +0 -378
- package/src/commands/worktrees.ts +0 -762
- package/src/condense-memory.ts +0 -36
- package/src/config.ts +0 -147
- package/src/context-awareness-plugin.test.ts +0 -144
- package/src/context-awareness-plugin.ts +0 -508
- package/src/cpu-profiler.test.ts +0 -183
- package/src/cpu-profiler.ts +0 -293
- package/src/critique-utils.ts +0 -139
- package/src/database.ts +0 -1484
- package/src/debounce-timeout.ts +0 -43
- package/src/debounced-process-flush.ts +0 -104
- package/src/default-channel-provisioning.test.ts +0 -156
- package/src/discord-bot.ts +0 -1852
- package/src/discord-command-registration.test.ts +0 -20
- package/src/discord-command-registration.ts +0 -704
- package/src/discord-urls.ts +0 -88
- package/src/discord-utils.test.ts +0 -470
- package/src/discord-utils.ts +0 -1079
- package/src/escape-backticks.test.ts +0 -469
- package/src/event-stream-real-capture.e2e.test.ts +0 -692
- package/src/eventsource-parser.test.ts +0 -351
- package/src/exec-async.ts +0 -44
- package/src/external-directory-permissions.e2e.test.ts +0 -103
- package/src/external-directory-project-deny.e2e.test.ts +0 -84
- package/src/external-opencode-sync.test.ts +0 -248
- package/src/external-opencode-sync.ts +0 -867
- package/src/extract-sdk-error-message.test.ts +0 -18
- package/src/format-tables.test.ts +0 -988
- package/src/format-tables.ts +0 -1031
- package/src/forum-sync/config.ts +0 -92
- package/src/forum-sync/discord-operations.ts +0 -245
- package/src/forum-sync/index.ts +0 -9
- package/src/forum-sync/markdown.ts +0 -172
- package/src/forum-sync/sync-to-discord.ts +0 -595
- package/src/forum-sync/sync-to-files.ts +0 -294
- package/src/forum-sync/types.ts +0 -175
- package/src/forum-sync/watchers.ts +0 -474
- package/src/gateway-proxy-reconnect.e2e.test.ts +0 -553
- package/src/gateway-proxy.e2e.test.ts +0 -648
- package/src/genai-worker-wrapper.ts +0 -164
- package/src/genai-worker.ts +0 -385
- package/src/genai.ts +0 -318
- package/src/git-worktree-core.ts +0 -616
- package/src/guild-categories.test.ts +0 -260
- package/src/heap-monitor.ts +0 -152
- package/src/hrana-server.test.ts +0 -130
- package/src/hrana-server.ts +0 -399
- package/src/html-actions.test.ts +0 -87
- package/src/html-actions.ts +0 -174
- package/src/html-components.test.ts +0 -38
- package/src/html-components.ts +0 -177
- package/src/image-optimizer-plugin.ts +0 -194
- package/src/image-utils.ts +0 -150
- package/src/interaction-handler.ts +0 -775
- package/src/ipc-polling.ts +0 -325
- package/src/ipc-tools-plugin.ts +0 -306
- package/src/kimaki-digital-twin.e2e.test.ts +0 -199
- package/src/kimaki-opencode-plugin-loading.e2e.test.ts +0 -208
- package/src/kimaki-opencode-plugin.test.ts +0 -142
- package/src/kimaki-opencode-plugin.ts +0 -34
- package/src/kimaki-workspace-adaptor.ts +0 -144
- package/src/limit-heading-depth.test.ts +0 -116
- package/src/limit-heading-depth.ts +0 -26
- package/src/list-channel-threads.test.ts +0 -90
- package/src/list-channel-threads.ts +0 -252
- package/src/markdown.test.ts +0 -498
- package/src/markdown.ts +0 -577
- package/src/memory-overview-plugin.ts +0 -159
- package/src/message-formatting.test.ts +0 -1401
- package/src/message-formatting.ts +0 -999
- package/src/message-preprocessing.ts +0 -557
- package/src/oauth-rotation-shared.ts +0 -332
- package/src/onboarding-tutorial.ts +0 -167
- package/src/onboarding-welcome.ts +0 -49
- package/src/openai-auth-plugin.ts +0 -158
- package/src/openai-auth-state.ts +0 -297
- package/src/openai-realtime.ts +0 -358
- package/src/opencode-command-detection.test.ts +0 -307
- package/src/opencode-command-detection.ts +0 -76
- package/src/opencode-command.test.ts +0 -290
- package/src/opencode-command.ts +0 -251
- package/src/opencode-interrupt-plugin.test.ts +0 -419
- package/src/opencode-interrupt-plugin.ts +0 -306
- package/src/opencode.ts +0 -1590
- package/src/parse-permission-rules.test.ts +0 -127
- package/src/patch-text-parser.ts +0 -107
- package/src/plugin-logger.ts +0 -139
- package/src/plugin-opencode-client.ts +0 -71
- package/src/privacy-sanitizer.ts +0 -142
- package/src/project-add.test.ts +0 -80
- package/src/question-abort-clears-dropdown.e2e.test.ts +0 -109
- package/src/question-abort-resume.e2e.test.ts +0 -121
- package/src/question-abort-retry-text-before-dropdown.e2e.test.ts +0 -172
- package/src/question-text-before-dropdown.e2e.test.ts +0 -67
- package/src/queue-advanced-abort.e2e.test.ts +0 -449
- package/src/queue-advanced-action-buttons.e2e.test.ts +0 -271
- package/src/queue-advanced-e2e-setup.ts +0 -1164
- package/src/queue-advanced-footer.e2e.test.ts +0 -357
- package/src/queue-advanced-model-switch.e2e.test.ts +0 -382
- package/src/queue-advanced-permissions-typing.e2e.test.ts +0 -256
- package/src/queue-advanced-question.e2e.test.ts +0 -322
- package/src/queue-advanced-typing-interrupt.e2e.test.ts +0 -147
- package/src/queue-advanced-typing.e2e.test.ts +0 -199
- package/src/queue-delete-message.e2e.test.ts +0 -262
- package/src/queue-drain-after-interactive-ui.e2e.test.ts +0 -152
- package/src/queue-interrupt-drain.e2e.test.ts +0 -299
- package/src/queue-question-select-drain.e2e.test.ts +0 -209
- package/src/runtime-idle-sweeper.ts +0 -76
- package/src/runtime-lifecycle.e2e.test.ts +0 -714
- package/src/schema.sql +0 -251
- package/src/sentry.ts +0 -26
- package/src/session-handler/agent-utils.ts +0 -104
- package/src/session-handler/event-stream-fixtures/real-session-action-buttons.jsonl +0 -45
- package/src/session-handler/event-stream-fixtures/real-session-footer-suppressed-on-pre-idle-interrupt.jsonl +0 -40
- package/src/session-handler/event-stream-fixtures/real-session-permission-external-file.jsonl +0 -23
- package/src/session-handler/event-stream-fixtures/real-session-task-normal.jsonl +0 -22
- package/src/session-handler/event-stream-fixtures/real-session-task-three-parallel-sleeps.jsonl +0 -277
- package/src/session-handler/event-stream-fixtures/real-session-task-user-interruption.jsonl +0 -46
- package/src/session-handler/event-stream-fixtures/session-abort-after-idle-race.jsonl +0 -21
- package/src/session-handler/event-stream-fixtures/session-concurrent-messages-serialized.jsonl +0 -56
- package/src/session-handler/event-stream-fixtures/session-explicit-abort.jsonl +0 -44
- package/src/session-handler/event-stream-fixtures/session-normal-completion.jsonl +0 -29
- package/src/session-handler/event-stream-fixtures/session-tool-call-noisy-stream.jsonl +0 -29
- package/src/session-handler/event-stream-fixtures/session-two-completions-same-session.jsonl +0 -50
- package/src/session-handler/event-stream-fixtures/session-user-interruption.jsonl +0 -59
- package/src/session-handler/event-stream-fixtures/session-voice-queued-followup.jsonl +0 -52
- package/src/session-handler/event-stream-state.test.ts +0 -3431
- package/src/session-handler/event-stream-state.ts +0 -1792
- package/src/session-handler/global-event-listener.ts +0 -258
- package/src/session-handler/model-utils.test.ts +0 -537
- package/src/session-handler/model-utils.ts +0 -489
- package/src/session-handler/opencode-session-event-log.ts +0 -159
- package/src/session-handler/thread-ingress.test.ts +0 -54
- package/src/session-handler/thread-runtime-state.ts +0 -358
- package/src/session-handler/thread-session-runtime-summary.test.ts +0 -169
- package/src/session-handler/thread-session-runtime.ts +0 -5696
- package/src/session-handler.ts +0 -15
- package/src/session-search.test.ts +0 -331
- package/src/session-search.ts +0 -382
- package/src/session-sleep.test.ts +0 -294
- package/src/session-title-rename.test.ts +0 -186
- package/src/skill-filter.test.ts +0 -110
- package/src/skill-filter.ts +0 -63
- package/src/startup-service.ts +0 -200
- package/src/startup-time.e2e.test.ts +0 -377
- package/src/system-message.test.ts +0 -1013
- package/src/system-message.ts +0 -1043
- package/src/task-id-plugin.ts +0 -17
- package/src/task-runner.ts +0 -768
- package/src/task-schedule.test.ts +0 -424
- package/src/task-schedule.ts +0 -470
- package/src/test-utils.ts +0 -549
- package/src/thinking-utils.test.ts +0 -46
- package/src/thinking-utils.ts +0 -82
- package/src/thread-message-queue.e2e.test.ts +0 -1468
- package/src/tools.ts +0 -430
- package/src/undici.d.ts +0 -12
- package/src/undo-redo.e2e.test.ts +0 -219
- package/src/unnest-code-blocks.test.ts +0 -713
- package/src/unnest-code-blocks.ts +0 -185
- package/src/upgrade.ts +0 -127
- package/src/utils.ts +0 -216
- package/src/voice-attachment.ts +0 -79
- package/src/voice-handler.ts +0 -1000
- package/src/voice-message.e2e.test.ts +0 -1513
- package/src/voice-routing-input.e2e.test.ts +0 -203
- package/src/voice-routing-question.e2e.test.ts +0 -188
- package/src/voice.test.ts +0 -565
- package/src/wait-session.ts +0 -291
- package/src/websockify.ts +0 -101
- package/src/worker-types.ts +0 -64
- package/src/worktree-clone-isolation.e2e.test.ts +0 -213
- package/src/worktree-lifecycle.e2e.test.ts +0 -900
- package/src/worktree-utils.ts +0 -4
- package/src/xai-auth-plugin.ts +0 -303
- package/src/xai-auth-state.test.ts +0 -224
- package/src/xai-auth-state.ts +0 -294
- package/src/xml.test.ts +0 -38
- package/src/xml.ts +0 -121
package/skills/errore/SKILL.md
DELETED
|
@@ -1,501 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: errore
|
|
3
|
-
description: |
|
|
4
|
-
Go-style error handling for TypeScript: return errors as a plain `Error | T` union
|
|
5
|
-
instead of throwing. `instanceof Error` narrows the type — no Result wrapper. The gist:
|
|
6
|
-
|
|
7
|
-
```ts
|
|
8
|
-
class NotFoundError extends errore.createTaggedError({
|
|
9
|
-
name: 'NotFoundError',
|
|
10
|
-
message: 'User $id not found',
|
|
11
|
-
}) {}
|
|
12
|
-
|
|
13
|
-
async function getUser(id: string) {
|
|
14
|
-
const user = await db.findUser(id).catch((e) => new DbError({ cause: e }))
|
|
15
|
-
if (user instanceof Error) return user // early return, like Go's err != nil
|
|
16
|
-
if (!user) return new NotFoundError({ id })
|
|
17
|
-
return user // caller narrows the same way
|
|
18
|
-
}
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
ALWAYS read this skill when a repo uses the errore convention (errore.org).
|
|
22
|
-
ALWAYS use errore for new TypeScript projects.
|
|
23
|
-
version: 0.11.0
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
# errore
|
|
27
|
-
|
|
28
|
-
Go-style error handling for TypeScript. Functions return errors instead of throwing them — but instead of Go's two-value tuple (`val, err`), you return a single `Error | T` union. Instead of checking `err != nil`, you check `instanceof Error`. TypeScript narrows the type automatically. No wrapper types, no Result monads, just unions and `instanceof`.
|
|
29
|
-
|
|
30
|
-
```ts
|
|
31
|
-
const user = await getUser(id)
|
|
32
|
-
if (user instanceof Error) return user // early return, like Go
|
|
33
|
-
console.log(user.name) // TypeScript knows: User
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Rules
|
|
37
|
-
|
|
38
|
-
Each rule is one line; the details live once in the pattern sections below.
|
|
39
|
-
|
|
40
|
-
1. Always `import * as errore from 'errore'` — namespace import, never destructure
|
|
41
|
-
2. Never throw for expected failures — return errors as values
|
|
42
|
-
3. Never return `unknown | Error` — the union collapses to `unknown`, breaks narrowing. Common trap: `res.json()` returns `unknown`, so `return await res.json()` makes the return type `MyError | unknown` → `unknown`. Fix: cast with `as` → `return (await res.json()) as User`
|
|
43
|
-
4. Convert exceptions to values only at boundaries — `.catch()` for async, `errore.try` for sync (see [Boundaries](#boundaries-catch-for-async-erroretry-for-sync)). Never `try-catch` for control flow
|
|
44
|
-
5. Always wrap boundary catches in a tagged domain error with `cause` — `.catch((e) => new MyError({ cause: e }))`. Never `.catch((e) => e as Error)`, never omit `cause` (it preserves the chain for debugging and abort detection)
|
|
45
|
-
6. Use `createTaggedError` for domain errors (see [Defining Errors](#defining-errors)); use `cause` to wrap errors
|
|
46
|
-
7. Use `| null` for optional values, not `| undefined` — three-way narrowing: `instanceof Error`, `=== null`, then value
|
|
47
|
-
8. Use `const` + expressions, never `let` + try-catch (see [Expressions over Statements](#expressions-over-statements))
|
|
48
|
-
9. Handle errors inside `if` branches with early exits, keep the happy path at root indentation (see [Flat Control Flow](#flat-control-flow))
|
|
49
|
-
10. Always include `Error` handler in `matchError` — required fallback for plain Error instances
|
|
50
|
-
11. Always prefer `errore.try` over `errore.tryFn` — same function, `errore.try` is the canonical name
|
|
51
|
-
12. Abort: custom abort errors MUST extend `errore.AbortError`, detect with `errore.isAbortError` (never `error.name === 'AbortError'`), and check `isAbortError(result)` as its own early return before `instanceof Error` (see [Abort & Cancellation](#abort--cancellation))
|
|
52
|
-
13. Don't reassign after error early returns — TypeScript narrows the original variable; a `const narrowed = result` alias is redundant
|
|
53
|
-
14. Write `instanceof Error` early returns on one line — `if (result instanceof Error) return result`. Use a `{` block only when the branch has more than one statement
|
|
54
|
-
15. Always log errors that are not propagated — when an error branch doesn't `return` or `throw` (loops with `continue`, fallback branches, fire-and-forget calls), add a `console.warn`/`console.error` so the failure leaves a trace. Propagated errors don't need logging — the caller handles them:
|
|
55
|
-
|
|
56
|
-
```ts
|
|
57
|
-
const emailResult = await sendEmail(user.email).catch(
|
|
58
|
-
(e) => new EmailError({ email: user.email, cause: e }),
|
|
59
|
-
)
|
|
60
|
-
if (emailResult instanceof Error) {
|
|
61
|
-
console.warn('Failed to send email:', emailResult.message)
|
|
62
|
-
}
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
16. Always hint a **solution** in user-facing error messages — include a login URL, CLI command, or missing flag so agents and users can self-correct instead of guessing. Applies to HTTP responses and CLI output; internal errors (DB failures, parse errors) can stay technical:
|
|
66
|
-
|
|
67
|
-
```ts
|
|
68
|
-
class UnauthorizedError extends errore.createTaggedError({
|
|
69
|
-
name: 'UnauthorizedError',
|
|
70
|
-
message: 'Not logged in. Sign in at $loginUrl or run: $loginCommand',
|
|
71
|
-
}) {}
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
## TypeScript Rules
|
|
75
|
-
|
|
76
|
-
- **Object args over positional** — `({id, retries})` not `(id, retries)` for functions with 2+ params
|
|
77
|
-
- **Expressions over statements** — use IIFEs, ternaries, `.map`/`.filter` instead of `let` + mutation
|
|
78
|
-
- **Early returns** — check and return at top, don't nest. Combine conditions: `if (a && b)` not `if (a) { if (b) }`
|
|
79
|
-
- **No `any`** — search for proper types, use `as unknown as T` only as last resort
|
|
80
|
-
- **`cause` not template strings** — `new Error("msg", { cause: e })` not ``new Error(`msg ${e}`)``
|
|
81
|
-
- **No uninitialized `let`** — use IIFE with returns instead of `let x; if (...) { x = ... }`
|
|
82
|
-
- **Type empty arrays** — `const items: string[] = []` not `const items = []`
|
|
83
|
-
- **Module imports for node builtins** — `import fs from 'node:fs'` then `fs.readFileSync(...)`, not named imports
|
|
84
|
-
- **Let TypeScript infer return types** — inferred types are always correct. Annotate only when it genuinely improves readability (complex unions, public API boundaries) or when inference produces a wider type than intended
|
|
85
|
-
- **`.filter(isTruthy)` not `.filter(Boolean)`** — `Boolean` doesn't narrow types, so `(T | null)[]` stays `(T | null)[]` after filtering. Use a type guard:
|
|
86
|
-
|
|
87
|
-
```ts
|
|
88
|
-
function isTruthy<T>(value: T): value is NonNullable<T> {
|
|
89
|
-
return Boolean(value)
|
|
90
|
-
}
|
|
91
|
-
const items = results.filter(isTruthy)
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
## Flat Control Flow
|
|
95
|
-
|
|
96
|
-
Keep block nesting minimal. Every level of indentation is cognitive load. The ideal function reads top to bottom at root level — checks and early returns, no `else`, no nested `if`, no `try-catch`.
|
|
97
|
-
|
|
98
|
-
**Core pattern** — call → check error → exit if error → continue at root. This is the single most important structural rule. Identical structure to Go's `if err != nil { return err }` blocks — speed bumps the reader skips over while scanning the left edge:
|
|
99
|
-
|
|
100
|
-
```ts
|
|
101
|
-
const user = await getUser(id)
|
|
102
|
-
if (user instanceof Error) return user
|
|
103
|
-
|
|
104
|
-
const posts = await getPosts(user.id)
|
|
105
|
-
if (posts instanceof Error) return posts
|
|
106
|
-
|
|
107
|
-
return render(user, posts)
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
**No `else`** — early return eliminates it: `if (x) return 'A'; return 'B'`
|
|
111
|
-
|
|
112
|
-
**No `else if` chains** — sequence of early-return `if` blocks:
|
|
113
|
-
|
|
114
|
-
```ts
|
|
115
|
-
function getStatus(code: number): string {
|
|
116
|
-
if (code === 200) return 'ok'
|
|
117
|
-
if (code === 404) return 'not found'
|
|
118
|
-
if (code >= 500) return 'server error'
|
|
119
|
-
return 'unknown'
|
|
120
|
-
}
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
**Flatten nested `if`** — invert conditions and return early. `if (A) { if (B) { ... } }` becomes `if (!A) return; if (!B) return; ...`. Take the outermost `if` condition, negate it, return the failure case, then continue at root level. Repeat for each nested `if`. The happy path falls through to the end.
|
|
124
|
-
|
|
125
|
-
**Avoid `try-catch` for control flow** — `try-catch` is the worst offender for nesting. It forces a two-branch structure (`try` + `catch`) and hides which line threw. Convert exceptions to values at boundaries:
|
|
126
|
-
|
|
127
|
-
```ts
|
|
128
|
-
async function loadConfig(): Promise<Config> {
|
|
129
|
-
const raw = await fs
|
|
130
|
-
.readFile('config.json', 'utf-8')
|
|
131
|
-
.catch((e) => new ConfigError({ reason: 'Read failed', cause: e }))
|
|
132
|
-
if (raw instanceof Error) return { port: 3000 }
|
|
133
|
-
|
|
134
|
-
const parsed = errore.try(
|
|
135
|
-
() => JSON.parse(raw) as Config,
|
|
136
|
-
(e) => new ConfigError({ reason: 'Invalid JSON', cause: e }),
|
|
137
|
-
)
|
|
138
|
-
if (parsed instanceof Error) return { port: 3000 }
|
|
139
|
-
|
|
140
|
-
if (!parsed.port) return { port: 3000 }
|
|
141
|
-
|
|
142
|
-
return parsed
|
|
143
|
-
}
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
**Errors in branches, happy path at root** — always handle errors inside `if` blocks, never success logic. Error handling goes in branches with early exits. Putting success logic inside `if` blocks inverts the flow and buries the happy path. **If you see `!(x instanceof Error)` in a condition, you've inverted the pattern — flip it.**
|
|
147
|
-
|
|
148
|
-
Same in loops — error in `if` + `continue`, happy path flat:
|
|
149
|
-
|
|
150
|
-
```ts
|
|
151
|
-
for (const id of ids) {
|
|
152
|
-
const item = await fetchItem(id)
|
|
153
|
-
if (item instanceof Error) {
|
|
154
|
-
console.warn('Skipping', id, item.message)
|
|
155
|
-
continue
|
|
156
|
-
}
|
|
157
|
-
await processItem(item)
|
|
158
|
-
results.push(item)
|
|
159
|
-
}
|
|
160
|
-
```
|
|
161
|
-
|
|
162
|
-
## Patterns
|
|
163
|
-
|
|
164
|
-
### Expressions over Statements
|
|
165
|
-
|
|
166
|
-
Always prefer `const` with an expression over `let` assigned later. This eliminates mutable state and makes control flow explicit. Escalate by complexity:
|
|
167
|
-
|
|
168
|
-
**Simple: ternary**
|
|
169
|
-
|
|
170
|
-
```ts
|
|
171
|
-
const user = fetchResult instanceof Error ? fallbackUser : fetchResult
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
**Medium: IIFE with early returns** — when a ternary gets too nested or involves multiple checks, use an IIFE. It scopes all intermediate variables and uses early returns for clarity:
|
|
175
|
-
|
|
176
|
-
```ts
|
|
177
|
-
const config: Config = (() => {
|
|
178
|
-
const envResult = loadFromEnv()
|
|
179
|
-
if (!(envResult instanceof Error)) return envResult
|
|
180
|
-
const fileResult = loadFromFile()
|
|
181
|
-
if (!(fileResult instanceof Error)) return fileResult
|
|
182
|
-
return defaultConfig
|
|
183
|
-
})()
|
|
184
|
-
```
|
|
185
|
-
|
|
186
|
-
> Every `let x; if (...) { x = ... }` can be rewritten as `const x = ternary` or `const x: T = (() => { ... })()`. The IIFE pattern is idiomatic in errore code — it keeps error handling flat with early returns while producing a single immutable binding.
|
|
187
|
-
|
|
188
|
-
### Defining Errors
|
|
189
|
-
|
|
190
|
-
```ts
|
|
191
|
-
import * as errore from 'errore'
|
|
192
|
-
|
|
193
|
-
class NotFoundError extends errore.createTaggedError({
|
|
194
|
-
name: 'NotFoundError',
|
|
195
|
-
message: 'User $id not found in $database',
|
|
196
|
-
}) {}
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
> `createTaggedError` gives you `_tag`, typed `$variable` properties, `cause`, `findCause`, `toJSON`, fingerprinting, and a static `.is()` type guard — all for free.
|
|
200
|
-
> Omit `message` to let the caller provide it at construction time: `new MyError({ message: 'details' })`. The fingerprint stays stable.
|
|
201
|
-
> Reserved variable names that cannot be used in templates: `$_tag`, `$name`, `$stack`, `$cause`.
|
|
202
|
-
|
|
203
|
-
**Instance properties:**
|
|
204
|
-
|
|
205
|
-
```ts
|
|
206
|
-
err._tag // 'NotFoundError'
|
|
207
|
-
err.id // 'abc' (from $id)
|
|
208
|
-
err.database // 'users' (from $database)
|
|
209
|
-
err.message // 'User abc not found in users'
|
|
210
|
-
err.messageTemplate // 'User $id not found in $database'
|
|
211
|
-
err.fingerprint // ['NotFoundError', 'User $id not found in $database']
|
|
212
|
-
err.cause // original error if wrapped
|
|
213
|
-
err.toJSON() // structured JSON with all properties
|
|
214
|
-
err.findCause(DbError) // walks .cause chain, returns typed match or undefined
|
|
215
|
-
NotFoundError.is(val) // static type guard
|
|
216
|
-
```
|
|
217
|
-
|
|
218
|
-
### Returning Errors
|
|
219
|
-
|
|
220
|
-
```ts
|
|
221
|
-
async function getUser(id: string) {
|
|
222
|
-
const user = await db.findUser(id)
|
|
223
|
-
if (!user) return new NotFoundError({ id, database: 'users' })
|
|
224
|
-
return user
|
|
225
|
-
}
|
|
226
|
-
```
|
|
227
|
-
|
|
228
|
-
> Return the error, don't throw it. The return type tells callers exactly what can go wrong.
|
|
229
|
-
|
|
230
|
-
### Boundaries (.catch for async, errore.try for sync)
|
|
231
|
-
|
|
232
|
-
`.catch()` and `errore.try` should only appear at the **lowest level** of your call stack — right at the boundary with code you don't control (third-party libraries, `JSON.parse`, `fetch`, file I/O, etc.). Your own functions return errors as values, so they never need `.catch()` or `try`.
|
|
233
|
-
|
|
234
|
-
For **async** boundaries: `.catch((e) => new MyError({ cause: e }))` directly on the promise. For **sync** boundaries: `errore.try(() => ..., (e) => ...)`. The `.catch()` callback receives `any` (Promise rejections are untyped), but wrapping in a typed error gives the union a concrete type — no `as` assertions needed. TypeScript infers the union automatically:
|
|
235
|
-
|
|
236
|
-
```ts
|
|
237
|
-
async function getUser(id: string) {
|
|
238
|
-
const res = await fetch(`/users/${id}`).catch(
|
|
239
|
-
(e) => new NetworkError({ url: `/users/${id}`, cause: e }),
|
|
240
|
-
)
|
|
241
|
-
if (res instanceof Error) return res
|
|
242
|
-
|
|
243
|
-
if (!res.ok) return new NetworkError({ url: `/users/${id}`, reason: `HTTP ${res.status}` })
|
|
244
|
-
|
|
245
|
-
const data = await (res.json() as Promise<UserPayload>).catch(
|
|
246
|
-
(e) => new NetworkError({ url: `/users/${id}`, cause: e }),
|
|
247
|
-
)
|
|
248
|
-
if (data instanceof Error) return data
|
|
249
|
-
|
|
250
|
-
if (!data.active) return new InactiveUserError({ id })
|
|
251
|
-
return { ...data, displayName: `${data.first} ${data.last}` }
|
|
252
|
-
}
|
|
253
|
-
```
|
|
254
|
-
|
|
255
|
-
> Think of `.catch()` and `errore.try` as the **adapter** between the throwing world (external code) and the errore world (errors as values). Once you've converted exceptions to values at the boundary, everything above is plain `instanceof` checks.
|
|
256
|
-
|
|
257
|
-
### Optional Values (| null)
|
|
258
|
-
|
|
259
|
-
```ts
|
|
260
|
-
async function findUser(email: string): Promise<DbError | User | null> {
|
|
261
|
-
const result = await db
|
|
262
|
-
.query(email)
|
|
263
|
-
.catch((e) => new DbError({ message: 'Query failed', cause: e }))
|
|
264
|
-
if (result instanceof Error) return result
|
|
265
|
-
return result ?? null
|
|
266
|
-
}
|
|
267
|
-
|
|
268
|
-
// Caller: three-way narrowing
|
|
269
|
-
const user = await findUser('alice@example.com')
|
|
270
|
-
if (user instanceof Error) return user
|
|
271
|
-
if (user === null) return
|
|
272
|
-
console.log(user.name) // User
|
|
273
|
-
```
|
|
274
|
-
|
|
275
|
-
> `Error | T | null` gives you three distinct states without nesting Result and Option types.
|
|
276
|
-
|
|
277
|
-
### Parallel Operations
|
|
278
|
-
|
|
279
|
-
```ts
|
|
280
|
-
const [userResult, postsResult, statsResult] = await Promise.all([
|
|
281
|
-
getUser(id),
|
|
282
|
-
getPosts(id),
|
|
283
|
-
getStats(id),
|
|
284
|
-
])
|
|
285
|
-
|
|
286
|
-
if (userResult instanceof Error) return userResult
|
|
287
|
-
if (postsResult instanceof Error) return postsResult
|
|
288
|
-
if (statsResult instanceof Error) return statsResult
|
|
289
|
-
|
|
290
|
-
return { user: userResult, posts: postsResult, stats: statsResult }
|
|
291
|
-
```
|
|
292
|
-
|
|
293
|
-
> Each result is checked individually. You know exactly which operation failed.
|
|
294
|
-
|
|
295
|
-
### Exhaustive Matching (matchError)
|
|
296
|
-
|
|
297
|
-
```ts
|
|
298
|
-
const response = errore.matchError(error, {
|
|
299
|
-
NotFoundError: (e) => ({
|
|
300
|
-
status: 404,
|
|
301
|
-
body: { error: `${e.table} ${e.id} not found` },
|
|
302
|
-
}),
|
|
303
|
-
DbError: (e) => ({ status: 500, body: { error: 'Database error' } }),
|
|
304
|
-
Error: (e) => ({ status: 500, body: { error: 'Unexpected error' } }),
|
|
305
|
-
})
|
|
306
|
-
return res.status(response.status).json(response.body)
|
|
307
|
-
```
|
|
308
|
-
|
|
309
|
-
> `matchError` routes by `_tag` and requires an `Error` fallback for plain Error instances. Use `matchErrorPartial` when you only need to handle some cases.
|
|
310
|
-
|
|
311
|
-
### Resource Cleanup (defer) — Replacing try/finally with `using`
|
|
312
|
-
|
|
313
|
-
`try/finally` has a structural problem: **every resource adds a nesting level**. Two resources = two levels of indentation, and cleanup is split across `finally` blocks far from where the resource was acquired. `await using` + `DisposableStack` keeps the function flat — one `cleanup.defer()` per resource, same indentation whether you have one resource or ten. Cleanup runs automatically in reverse (LIFO) order on every exit path — normal return, early error return, or exception.
|
|
314
|
-
|
|
315
|
-
**tsconfig requirement:** add `"ESNext.Disposable"` to `lib`:
|
|
316
|
-
|
|
317
|
-
```jsonc
|
|
318
|
-
{
|
|
319
|
-
"compilerOptions": {
|
|
320
|
-
"lib": ["ES2022", "ESNext.Disposable"],
|
|
321
|
-
},
|
|
322
|
-
}
|
|
323
|
-
```
|
|
324
|
-
|
|
325
|
-
```ts
|
|
326
|
-
async function importData(url: string, dbUrl: string): Promise<ImportError | { rows: number }> {
|
|
327
|
-
await using cleanup = new errore.AsyncDisposableStack()
|
|
328
|
-
|
|
329
|
-
const db = await connectDb(dbUrl).catch((e) => new ImportError({ reason: 'db connect', cause: e }))
|
|
330
|
-
if (db instanceof Error) return db
|
|
331
|
-
cleanup.defer(() => db.close())
|
|
332
|
-
|
|
333
|
-
const tmpFile = await createTempFile()
|
|
334
|
-
cleanup.defer(() => tmpFile.delete())
|
|
335
|
-
|
|
336
|
-
const response = await fetch(url).catch((e) => new ImportError({ reason: 'fetch', cause: e }))
|
|
337
|
-
if (response instanceof Error) return response
|
|
338
|
-
|
|
339
|
-
await tmpFile.write(await response.text())
|
|
340
|
-
await db.import(tmpFile.path)
|
|
341
|
-
return { rows: await db.count() }
|
|
342
|
-
// cleanup: tmpFile.delete() → db.close()
|
|
343
|
-
}
|
|
344
|
-
```
|
|
345
|
-
|
|
346
|
-
> Adding a resource is one line (`cleanup.defer()`), not another nesting level. The errore polyfill handles the runtime; the tsconfig `lib` entry handles the types.
|
|
347
|
-
|
|
348
|
-
### Fallback Values
|
|
349
|
-
|
|
350
|
-
```ts
|
|
351
|
-
const result = errore.try(() =>
|
|
352
|
-
JSON.parse(fs.readFileSync('config.json', 'utf-8')),
|
|
353
|
-
)
|
|
354
|
-
const config = result instanceof Error ? { port: 3000, debug: false } : result
|
|
355
|
-
```
|
|
356
|
-
|
|
357
|
-
> Ternary on `instanceof Error` replaces `let` + try-catch. Single expression, no mutation, no intermediate state.
|
|
358
|
-
|
|
359
|
-
### Walking the Cause Chain (findCause)
|
|
360
|
-
|
|
361
|
-
```ts
|
|
362
|
-
const dbErr = error.findCause(DbError)
|
|
363
|
-
if (dbErr) {
|
|
364
|
-
console.log(dbErr.host) // type-safe access
|
|
365
|
-
}
|
|
366
|
-
|
|
367
|
-
// Or standalone function for any Error
|
|
368
|
-
const dbErr = errore.findCause(error, DbError)
|
|
369
|
-
```
|
|
370
|
-
|
|
371
|
-
> `findCause` checks the error itself first, then walks `.cause` recursively. Returns the matched error with full type inference, or `undefined`. Safe against circular references.
|
|
372
|
-
|
|
373
|
-
### Custom Base Classes
|
|
374
|
-
|
|
375
|
-
```ts
|
|
376
|
-
class AppError extends Error {
|
|
377
|
-
statusCode = 500
|
|
378
|
-
toResponse() {
|
|
379
|
-
return { error: this.message, code: this.statusCode }
|
|
380
|
-
}
|
|
381
|
-
}
|
|
382
|
-
|
|
383
|
-
class NotFoundError extends errore.createTaggedError({
|
|
384
|
-
name: 'NotFoundError',
|
|
385
|
-
message: 'Resource $id not found',
|
|
386
|
-
extends: AppError,
|
|
387
|
-
}) {
|
|
388
|
-
statusCode = 404
|
|
389
|
-
}
|
|
390
|
-
|
|
391
|
-
const err = new NotFoundError({ id: '123' })
|
|
392
|
-
err.toResponse() // { error: 'Resource 123 not found', code: 404 }
|
|
393
|
-
err instanceof AppError // true
|
|
394
|
-
err instanceof Error // true
|
|
395
|
-
```
|
|
396
|
-
|
|
397
|
-
> Use `extends` to inherit shared functionality (HTTP status codes, logging methods, response formatting) across all your domain errors.
|
|
398
|
-
|
|
399
|
-
### Boundary with Legacy Code
|
|
400
|
-
|
|
401
|
-
```ts
|
|
402
|
-
async function legacyHandler(id: string) {
|
|
403
|
-
const user = await getUser(id)
|
|
404
|
-
if (user instanceof Error) throw new Error('Failed to get user', { cause: user })
|
|
405
|
-
return user
|
|
406
|
-
}
|
|
407
|
-
```
|
|
408
|
-
|
|
409
|
-
> At boundaries where legacy code expects exceptions, check `instanceof Error` and throw with `cause`. This preserves the error chain and keeps the pattern consistent.
|
|
410
|
-
|
|
411
|
-
### Converting `{ data, error }` Returns
|
|
412
|
-
|
|
413
|
-
Some SDKs (Supabase, Stripe, etc.) return `{ data, error }` instead of throwing. Destructure inline, check `error` first with a truthy check (not `instanceof` — most SDKs return plain objects), wrap in a tagged error, then continue with `data`:
|
|
414
|
-
|
|
415
|
-
```ts
|
|
416
|
-
const { data, error } = await supabase.from('users').select('*').eq('id', id)
|
|
417
|
-
if (error) return new SupabaseError({ cause: error })
|
|
418
|
-
if (data === null) return new NotFoundError({ id })
|
|
419
|
-
// data is narrowed here
|
|
420
|
-
```
|
|
421
|
-
|
|
422
|
-
> Wrapping in a domain error is better than returning the SDK's error directly — gives you `_tag`, typed properties, and the `cause` chain.
|
|
423
|
-
|
|
424
|
-
### Partition: Splitting Successes and Failures
|
|
425
|
-
|
|
426
|
-
```ts
|
|
427
|
-
const allResults = await Promise.all(ids.map((id) => fetchItem(id)))
|
|
428
|
-
const [items, errors] = errore.partition(allResults)
|
|
429
|
-
|
|
430
|
-
errors.forEach((e) => console.warn('Failed:', e.message))
|
|
431
|
-
// items contains only successful results, fully typed
|
|
432
|
-
```
|
|
433
|
-
|
|
434
|
-
> `partition` splits an array of `(Error | T)[]` into `[T[], Error[]]`. No manual accumulation.
|
|
435
|
-
|
|
436
|
-
### Abort & Cancellation
|
|
437
|
-
|
|
438
|
-
`controller.abort(reason)` throws `reason` as-is — whatever you pass is what `.catch()` receives. This means you MUST pass a typed error extending `errore.AbortError`, never a plain `Error` or string — otherwise `isAbortError` can't detect it.
|
|
439
|
-
|
|
440
|
-
Always use `errore.isAbortError(error)` to detect abort errors — never check `error.name === 'AbortError'` manually, because tagged abort errors have their tag as `.name`. `isAbortError` walks the entire `.cause` chain, so it works even when the abort error is wrapped by `.catch()`.
|
|
441
|
-
|
|
442
|
-
Keep abort checks flat: `isAbortError(result)` first as its own early return, then `result instanceof Error` as a separate early return. Never nest one inside the other.
|
|
443
|
-
|
|
444
|
-
```ts
|
|
445
|
-
import * as errore from 'errore'
|
|
446
|
-
|
|
447
|
-
class TimeoutError extends errore.createTaggedError({
|
|
448
|
-
name: 'TimeoutError',
|
|
449
|
-
message: 'Request timed out for $operation',
|
|
450
|
-
extends: errore.AbortError,
|
|
451
|
-
}) {}
|
|
452
|
-
|
|
453
|
-
const controller = new AbortController()
|
|
454
|
-
const timer = setTimeout(
|
|
455
|
-
() => controller.abort(new TimeoutError({ operation: 'fetch' })),
|
|
456
|
-
5000,
|
|
457
|
-
)
|
|
458
|
-
|
|
459
|
-
const res = await fetch(url, { signal: controller.signal }).catch(
|
|
460
|
-
(e) => new NetworkError({ url, cause: e }),
|
|
461
|
-
)
|
|
462
|
-
clearTimeout(timer)
|
|
463
|
-
|
|
464
|
-
if (errore.isAbortError(res)) return res
|
|
465
|
-
if (res instanceof Error) return res
|
|
466
|
-
```
|
|
467
|
-
|
|
468
|
-
> `isAbortError` detects three kinds of abort: (1) native `DOMException` from bare `controller.abort()`, (2) direct `errore.AbortError` instances, (3) tagged errors that extend `errore.AbortError` — even when wrapped in another error's `.cause` chain.
|
|
469
|
-
|
|
470
|
-
#### Early Return on Abort (signal.aborted checks)
|
|
471
|
-
|
|
472
|
-
Check `signal.aborted` before side effects or async operations — same early-return pattern as errors but for cancellation. Without these, cancelled work keeps running.
|
|
473
|
-
|
|
474
|
-
```ts
|
|
475
|
-
for (const item of items) {
|
|
476
|
-
if (signal.aborted) return // before work
|
|
477
|
-
const data = await fetchData(item.id, { signal })
|
|
478
|
-
.catch((e) => new FetchError({ id: item.id, cause: e }))
|
|
479
|
-
if (errore.isAbortError(data)) return // after async
|
|
480
|
-
if (data instanceof Error) { console.warn(data.message); continue }
|
|
481
|
-
if (signal.aborted) return // before write
|
|
482
|
-
await db.save(data)
|
|
483
|
-
}
|
|
484
|
-
```
|
|
485
|
-
|
|
486
|
-
> Place `signal.aborted` checks **before** expensive operations (network, db writes, file I/O). Check `isAbortError` **after** async calls that received the signal. Both keep the function responsive to cancellation.
|
|
487
|
-
|
|
488
|
-
## Linting
|
|
489
|
-
|
|
490
|
-
If the project uses [lintcn](https://github.com/remorses/lintcn), read `docs/lintcn.md` for the `no-unhandled-error` rule that catches discarded `Error | T` return values.
|
|
491
|
-
|
|
492
|
-
## Pitfalls
|
|
493
|
-
|
|
494
|
-
### CustomError | Error is ambiguous when CustomError extends Error
|
|
495
|
-
|
|
496
|
-
```ts
|
|
497
|
-
// BAD: both sides of the union are Error instances
|
|
498
|
-
type Result = MyCustomError | Error
|
|
499
|
-
// instanceof Error matches BOTH — can't distinguish success from failure
|
|
500
|
-
// Success types must never extend Error
|
|
501
|
-
```
|