@cuongtran001/kanna 1.63.2 → 1.63.3

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 (199) hide show
  1. package/README.md +5 -9
  2. package/dist/client/assets/{BoardsPage-BJalB-bc.js → BoardsPage-AckCuswi.js} +1 -1
  3. package/dist/client/assets/BoardsRoutePage-DzKwKy3f.js +1 -0
  4. package/dist/client/assets/ChatPage-DsaH8CTz.js +93 -0
  5. package/dist/client/assets/{CronJobRow-CPbO_jwU.js → CronJobRow-Bx9gRqKW.js} +1 -1
  6. package/dist/client/assets/{CronJobsPage-Ck3SNgGi.js → CronJobsPage-v0-2X1oX.js} +1 -1
  7. package/dist/client/assets/{FilePreviewSheet-XEuUtDPn.js → FilePreviewSheet-B6SDxSD0.js} +2 -2
  8. package/dist/client/assets/{FlowSurface-BCbeMTJe.js → FlowSurface-CLC-ZFar.js} +1 -1
  9. package/dist/client/assets/{GenUIBlock-BJy_dfs-.js → GenUIBlock-CC79Ujro.js} +2 -2
  10. package/dist/client/assets/{KannaSocketProvider-D7Lzlt35.js → KannaSocketProvider-B2sHsWP5.js} +1 -1
  11. package/dist/client/assets/{LocalProjectsPage-9LJkQjhT.js → LocalProjectsPage-DYBkcEAm.js} +1 -1
  12. package/dist/client/assets/SettingsPage-CZqMkMRW.js +9 -0
  13. package/dist/client/assets/{StackBoardsRoutePage-t_EaFNG4.js → StackBoardsRoutePage-Clviz0hX.js} +1 -1
  14. package/dist/client/assets/{ToolCallMessage-RbF9XT2B.js → ToolCallMessage-BfNbWGmc.js} +1 -1
  15. package/dist/client/assets/{VChartSurface-CKuPelsn.js → VChartSurface-CUbxyBo3.js} +1 -1
  16. package/dist/client/assets/{WorkflowsPage-B6qUmQA3.js → WorkflowsPage-rengzb97.js} +1 -1
  17. package/dist/client/assets/{WorkflowsSection-DxO0S4An.js → WorkflowsSection-DuXdLsMO.js} +1 -1
  18. package/dist/client/assets/{chart-renderer-DjYZvNxh.js → chart-renderer-D7ukB2wg.js} +1 -1
  19. package/dist/client/assets/{chatSounds-FD2DQzF6.js → chatSounds-BLg2xPDZ.js} +1 -1
  20. package/dist/client/assets/chevron-left-RbFvmeyK.js +1 -0
  21. package/dist/client/assets/{clipboard.adapter-GN9nnYak.js → clipboard.adapter-CgdNwn-1.js} +1 -1
  22. package/dist/client/assets/{columnStyle-DjA7hA9k.js → columnStyle-CMCF0ds6.js} +1 -1
  23. package/dist/client/assets/{createScopedStore-BoLB9Rhc.js → createScopedStore-BrD5NHWx.js} +1 -1
  24. package/dist/client/assets/{dist-CimtOoGK.js → dist-DNSTHlSo.js} +1 -1
  25. package/dist/client/assets/editor-icons-DY4uKeEY.js +1 -0
  26. package/dist/client/assets/{ellipsis-Cd7sO0LO.js → ellipsis-OHg0x_x1.js} +1 -1
  27. package/dist/client/assets/{flow-kinds-CW2TU_83.js → flow-kinds-Ki2DP9nP.js} +1 -1
  28. package/dist/client/assets/{folder-C7sXCaHj.js → folder-CnWzWIG5.js} +1 -1
  29. package/dist/client/assets/{formatters-wSVyvDFZ.js → formatters-BGORekd-.js} +1 -1
  30. package/dist/client/assets/{genui-EzBIAYFE.js → genui-C9i6j0XZ.js} +1 -1
  31. package/dist/client/assets/{globe-xmRpmpma.js → globe-BjR1tyE4.js} +1 -1
  32. package/dist/client/assets/{host-DCaA9W-Z.js → host-D9tJwZXl.js} +1 -1
  33. package/dist/client/assets/{index-CDqjh7nt.js → index-CesRxZ0X.js} +7 -7
  34. package/dist/client/assets/index-CxDE9VOy.css +1 -0
  35. package/dist/client/assets/{info-D4MMvZFe.js → info-DNYekoE-.js} +1 -1
  36. package/dist/client/assets/{input-C4fvDiQ4.js → input-DgW9uRZN.js} +1 -1
  37. package/dist/client/assets/{lexicalToReact-sPUyOWk6.js → lexicalToReact-CZvp9Pgz.js} +3 -3
  38. package/dist/client/assets/{log-aTaDVF_e.js → log-DnEvbp3E.js} +1 -1
  39. package/dist/client/assets/{monitor-_CRKcV1h.js → monitor-qbWfUdBG.js} +1 -1
  40. package/dist/client/assets/{pencil-fNBeUUCf.js → pencil-C965rrpd.js} +1 -1
  41. package/dist/client/assets/{pendingActionsStore-COTh4Ztq.js → pendingActionsStore-CxhI19V9.js} +1 -1
  42. package/dist/client/assets/{play-BAmkJfn6.js → play-uofLR7yT.js} +1 -1
  43. package/dist/client/assets/{plus-c75CkNEO.js → plus-D4CI6rj1.js} +1 -1
  44. package/dist/client/assets/{popover-CHM4skzh.js → popover-Bc646hKn.js} +1 -1
  45. package/dist/client/assets/{pushClient-BJH_ITRB.js → pushClient-CxnHu9h4.js} +1 -1
  46. package/dist/client/assets/runDetached-DfQXHAaY.js +1 -0
  47. package/dist/client/assets/{segmented-control-DNOwRupT.js → segmented-control-CKGX29Kl.js} +1 -1
  48. package/dist/client/assets/{select-dLHiAls6.js → select-BjeajpVt.js} +1 -1
  49. package/dist/client/assets/{settings-header-button-CGKCzFyk.js → settings-header-button-BYvHR6Xl.js} +1 -1
  50. package/dist/client/assets/{sidebarPendingActions-Dyp80Lv_.js → sidebarPendingActions-xgMTnfRY.js} +1 -1
  51. package/dist/client/assets/{square-pen-B1IxmScM.js → square-pen-DmppQdTd.js} +1 -1
  52. package/dist/client/assets/{state-mark-BhTZfcYe.js → state-mark-C3kEL1hX.js} +1 -1
  53. package/dist/client/assets/{status-pill-CwhJhaMy.js → status-pill-Bo1Nb6HX.js} +1 -1
  54. package/dist/client/assets/{terminal-Bnj7qFGw.js → terminal-DfCF-J4p.js} +1 -1
  55. package/dist/client/assets/{timer.adapter-DHt2zwsL.js → timer.adapter-C2RhP4d6.js} +1 -1
  56. package/dist/client/assets/{tools-3gJcj3hK.js → tools-t5T_3UBg.js} +1 -1
  57. package/dist/client/assets/{triangle-alert-CWrc0CIO.js → triangle-alert-CYQhobyY.js} +1 -1
  58. package/dist/client/assets/useAppGlobalState-DUa3pkCF.js +1 -0
  59. package/dist/client/assets/useKannaState-FcieR5qb.js +5 -0
  60. package/dist/client/assets/useTheme-D9sKDPEm.js +1 -0
  61. package/dist/client/index.html +35 -35
  62. package/package.json +2 -2
  63. package/src/server/agent-coordinator-types.ts +0 -6
  64. package/src/server/agent-coordinator.ts +6 -45
  65. package/src/server/agent.compaction.test.ts +1 -13
  66. package/src/server/agent.oauth-account-info.test.ts +0 -3
  67. package/src/server/agent.oauth-release.test.ts +0 -2
  68. package/src/server/agent.oauth-rotation.test.ts +0 -9
  69. package/src/server/agent.oauth-token-share-cap.test.ts +0 -1
  70. package/src/server/agent.openrouter-model.test.ts +0 -2
  71. package/src/server/agent.openrouter-watchdog.test.ts +0 -3
  72. package/src/server/agent.sdk-workflow-register.test.ts +2 -64
  73. package/src/server/agent.test.ts +1 -319
  74. package/src/server/app-settings.test.ts +14 -17
  75. package/src/server/app-settings.ts +22 -37
  76. package/src/server/auto-continue/e2e.test.ts +0 -1
  77. package/src/server/background-task-output-registry.test.ts +1 -1
  78. package/src/server/background-task-output-registry.ts +1 -1
  79. package/src/server/claude-cancel-handler.test.ts +0 -58
  80. package/src/server/claude-cancel-handler.ts +1 -17
  81. package/src/server/claude-harness-stream.test.ts +134 -0
  82. package/src/server/{claude-pty/jsonl-path.test.ts → claude-projects-path.adapter.test.ts} +1 -19
  83. package/src/server/{claude-pty/jsonl-path.adapter.ts → claude-projects-path.adapter.ts} +0 -11
  84. package/src/server/claude-send-command.test.ts +0 -1
  85. package/src/server/claude-session-config-helpers.test.ts +1 -90
  86. package/src/server/claude-session-config-helpers.ts +1 -38
  87. package/src/server/claude-session-error-handler.test.ts +0 -1
  88. package/src/server/claude-session-lifecycle.test.ts +2 -36
  89. package/src/server/claude-session-lifecycle.ts +2 -8
  90. package/src/server/claude-session-runner.test.ts +8 -36
  91. package/src/server/claude-session-runner.ts +1 -26
  92. package/src/server/claude-session-spawner.test.ts +5 -64
  93. package/src/server/claude-session-spawner.ts +49 -115
  94. package/src/server/claude-session-start.test.ts +1 -14
  95. package/src/server/claude-session-start.ts +0 -8
  96. package/src/server/claude-session-state-queries.test.ts +1 -2
  97. package/src/server/claude-session-state.test.ts +0 -1
  98. package/src/server/claude-session-state.ts +0 -4
  99. package/src/server/claude-subagent-wiring.test.ts +2 -68
  100. package/src/server/claude-subagent-wiring.ts +3 -50
  101. package/src/server/claude-turn-starter-types.ts +0 -3
  102. package/src/server/claude-turn-starter.test.ts +0 -28
  103. package/src/server/claude-turn-starter.ts +0 -5
  104. package/src/server/event-store.test.ts +0 -2
  105. package/src/server/events.ts +1 -2
  106. package/src/server/harness-types.ts +1 -2
  107. package/src/server/import-subagent-drill.e2e.test.ts +1 -1
  108. package/src/server/imported-subagents-dir.test.ts +1 -1
  109. package/src/server/imported-subagents-dir.ts +1 -1
  110. package/src/server/kanna-mcp.test.ts +0 -75
  111. package/src/server/kanna-mcp.ts +1 -47
  112. package/src/server/server.test.ts +5 -7
  113. package/src/server/server.ts +2 -18
  114. package/src/server/subagent-orchestrator.test.ts +0 -1
  115. package/src/server/subagent-provider-run.test.ts +48 -10
  116. package/src/server/subagent-provider-run.ts +12 -3
  117. package/src/server/tool-callback.test.ts +1 -1
  118. package/src/server/ws-router-agent-ctrl.test.ts +0 -45
  119. package/src/server/ws-router-agent-ctrl.ts +1 -31
  120. package/src/server/ws-router-broadcast.ts +0 -27
  121. package/src/server/ws-router-defaults.test.ts +2 -3
  122. package/src/server/ws-router-defaults.ts +2 -3
  123. package/src/server/ws-router-envelope.ts +0 -15
  124. package/src/server/ws-router-observability.test.ts +1 -1
  125. package/src/server/ws-router-settings.test.ts +2 -2
  126. package/src/server/ws-router.test.ts +2 -2
  127. package/src/server/ws-router.ts +0 -8
  128. package/src/shared/app-settings-types.ts +9 -20
  129. package/src/shared/claude-api-error-classification.ts +1 -1
  130. package/src/shared/protocol.ts +1 -11
  131. package/dist/client/assets/BoardsRoutePage-BTTjJX-Y.js +0 -1
  132. package/dist/client/assets/ChatPage-DH8wtQyD.js +0 -93
  133. package/dist/client/assets/SettingsPage-CKrZ6dGQ.js +0 -9
  134. package/dist/client/assets/chevron-left-CJ0qv9kF.js +0 -1
  135. package/dist/client/assets/editor-icons-CONDQZof.js +0 -1
  136. package/dist/client/assets/index-C-UYaDk6.css +0 -1
  137. package/dist/client/assets/runDetached-DqQ3k2ji.js +0 -1
  138. package/dist/client/assets/useAppGlobalState-DKOGrO5l.js +0 -1
  139. package/dist/client/assets/useKannaState-D7R_-dM6.js +0 -5
  140. package/dist/client/assets/useTheme-B57LIKyx.js +0 -1
  141. package/src/server/agent.pty-rotation.test.ts +0 -322
  142. package/src/server/claude-pty/auth.test.ts +0 -38
  143. package/src/server/claude-pty/auth.ts +0 -17
  144. package/src/server/claude-pty/claude-session-registry.adapter.ts +0 -68
  145. package/src/server/claude-pty/claude-session-registry.test.ts +0 -149
  146. package/src/server/claude-pty/driver.test.ts +0 -1153
  147. package/src/server/claude-pty/driver.ts +0 -829
  148. package/src/server/claude-pty/env.test.ts +0 -79
  149. package/src/server/claude-pty/env.ts +0 -20
  150. package/src/server/claude-pty/jsonl-to-event.test.ts +0 -882
  151. package/src/server/claude-pty/jsonl-to-event.ts +0 -357
  152. package/src/server/claude-pty/parity-matrix.test.ts +0 -437
  153. package/src/server/claude-pty/pid-registry.adapter.ts +0 -164
  154. package/src/server/claude-pty/pid-registry.test.ts +0 -178
  155. package/src/server/claude-pty/preflight/binary-fingerprint.adapter.ts +0 -20
  156. package/src/server/claude-pty/preflight/binary-fingerprint.test.ts +0 -32
  157. package/src/server/claude-pty/pty-instance-registry.test.ts +0 -208
  158. package/src/server/claude-pty/pty-instance-registry.ts +0 -172
  159. package/src/server/claude-pty/pty-memory-sampler.adapter.test.ts +0 -103
  160. package/src/server/claude-pty/pty-memory-sampler.adapter.ts +0 -86
  161. package/src/server/claude-pty/pty-process.adapter.ts +0 -60
  162. package/src/server/claude-pty/pty-process.test.ts +0 -49
  163. package/src/server/claude-pty/resolve-binary.adapter.ts +0 -106
  164. package/src/server/claude-pty/resolve-binary.test.ts +0 -118
  165. package/src/server/claude-pty/runtime-dir.adapter.ts +0 -19
  166. package/src/server/claude-pty/sandbox/detect.adapter.ts +0 -17
  167. package/src/server/claude-pty/sandbox/detect.test.ts +0 -17
  168. package/src/server/claude-pty/sandbox/platform.test.ts +0 -35
  169. package/src/server/claude-pty/sandbox/platform.ts +0 -27
  170. package/src/server/claude-pty/sandbox/preflight-io.adapter.ts +0 -14
  171. package/src/server/claude-pty/sandbox/preflight.test.ts +0 -69
  172. package/src/server/claude-pty/sandbox/preflight.ts +0 -44
  173. package/src/server/claude-pty/sandbox/profile-linux.adapter.ts +0 -63
  174. package/src/server/claude-pty/sandbox/profile-linux.test.ts +0 -90
  175. package/src/server/claude-pty/sandbox/profile-macos.adapter.ts +0 -72
  176. package/src/server/claude-pty/sandbox/profile-macos.test.ts +0 -68
  177. package/src/server/claude-pty/sandbox/wrap.adapter.ts +0 -58
  178. package/src/server/claude-pty/sandbox/wrap.test.ts +0 -82
  179. package/src/server/claude-pty/settings-writer.adapter.ts +0 -23
  180. package/src/server/claude-pty/settings-writer.test.ts +0 -22
  181. package/src/server/claude-pty/smoke-test-io.adapter.ts +0 -28
  182. package/src/server/claude-pty/smoke-test.test.ts +0 -199
  183. package/src/server/claude-pty/smoke-test.ts +0 -182
  184. package/src/server/claude-pty/tui-control.test.ts +0 -300
  185. package/src/server/claude-pty/tui-control.ts +0 -174
  186. package/src/server/claude-pty/tui-source.adapter.test.ts +0 -374
  187. package/src/server/claude-pty/tui-source.adapter.ts +0 -294
  188. package/src/server/http-server.adapter.test.ts +0 -18
  189. package/src/server/http-server.adapter.ts +0 -39
  190. package/src/server/kanna-mcp-http.test.ts +0 -274
  191. package/src/server/kanna-mcp-http.ts +0 -194
  192. package/src/server/kanna-mcp-tools/ask-user-question.test.ts +0 -108
  193. package/src/server/kanna-mcp-tools/ask-user-question.ts +0 -55
  194. package/src/server/kanna-mcp-tools/exit-plan-mode.test.ts +0 -61
  195. package/src/server/kanna-mcp-tools/exit-plan-mode.ts +0 -49
  196. package/src/server/mcp-zod-compat.adapter.ts +0 -20
  197. package/src/shared/pty-instance.ts +0 -43
  198. /package/src/server/{claude-pty/output-ring.test.ts → output-ring.test.ts} +0 -0
  199. /package/src/server/{claude-pty/output-ring.ts → output-ring.ts} +0 -0
@@ -1,1153 +0,0 @@
1
- import { describe, expect, test } from "bun:test"
2
- import { mkdtemp, readdir, readFile, rm } from "node:fs/promises"
3
- import { tmpdir } from "node:os"
4
- import path from "node:path"
5
- import { startClaudeSessionPTY, buildPtyCliArgs, resolveSpawnSessionId, OutputRing, PTY_STDERR_RING_BYTES, PTY_DISALLOWED_NATIVE_TOOLS, deriveAccountInfoFromOauth, PLAN_MODE_EXIT_UNSUPPORTED, SHIFT_TAB_KEY, buildChannelPromptFraming } from "./driver"
6
- import type { TranscriptStream } from "./tui-source.adapter"
7
- import type { PtyProcess, SpawnPtyProcessArgs } from "./pty-process.adapter"
8
- import { KANNA_SYSTEM_PROMPT_APPEND } from "../../shared/kanna-system-prompt"
9
- import type { HarnessEvent } from "../harness-types"
10
- import { readAppSettingsSnapshot } from "../app-settings"
11
- import type { McpServerConfig } from "../../shared/types"
12
-
13
-
14
-
15
- describe("resolveSpawnSessionId", () => {
16
- test("resume reuses the session token as the session id", () => {
17
- expect(resolveSpawnSessionId({ sessionToken: "tok-abc", forkSession: false }, () => "fresh")).toBe("tok-abc")
18
- })
19
-
20
- test("new session (no token) gets a fresh id", () => {
21
- expect(resolveSpawnSessionId({ sessionToken: null, forkSession: false }, () => "fresh")).toBe("fresh")
22
- })
23
-
24
- test("fork gets a fresh id distinct from the source token (collision would make claude refuse the fork)", () => {
25
- expect(resolveSpawnSessionId({ sessionToken: "old-tok", forkSession: true }, () => "fresh")).toBe("fresh")
26
- expect(resolveSpawnSessionId({ sessionToken: "old-tok", forkSession: true }, () => "fresh")).not.toBe("old-tok")
27
- })
28
- })
29
-
30
- describe("startClaudeSessionPTY", () => {
31
- test("auth precheck fails when credentials missing", async () => {
32
- if (process.platform === "win32") return
33
- const homeDir = await mkdtemp(path.join(tmpdir(), "kanna-pty-driver-"))
34
- try {
35
- let err: unknown
36
- try {
37
- await startClaudeSessionPTY({
38
- chatId: "c",
39
- projectId: "p",
40
- localPath: "/tmp",
41
- model: "claude-sonnet-4-6",
42
- planMode: false,
43
- forkSession: false,
44
- oauthToken: null,
45
- sessionToken: null,
46
- onToolRequest: async () => null,
47
- homeDir,
48
- env: {},
49
- })
50
- } catch (e) {
51
- err = e
52
- }
53
- expect(err).toBeInstanceOf(Error)
54
- expect((err as Error).message).toMatch(/OAuth pool token/)
55
- } finally {
56
- await rm(homeDir, { recursive: true, force: true })
57
- }
58
- })
59
-
60
-
61
-
62
- test.skipIf(process.env.KANNA_PTY_E2E !== "1")(
63
- "E2E: spawn claude, send one prompt, observe one transcript event",
64
- async () => {
65
- const dir = await mkdtemp(path.join(tmpdir(), "kanna-pty-e2e-"))
66
- try {
67
- const handle = await startClaudeSessionPTY({
68
- chatId: "e2e",
69
- projectId: "e2e",
70
- localPath: dir,
71
- model: "claude-haiku-4-5-20251001",
72
- planMode: false,
73
- forkSession: false,
74
- oauthToken: null,
75
- sessionToken: null,
76
- onToolRequest: async () => null,
77
- })
78
- await handle.sendPrompt("Reply with exactly the word: ok")
79
- const it = handle.stream[Symbol.asyncIterator]()
80
- const start = Date.now()
81
- let sawTranscript = false
82
- while (Date.now() - start < 30_000) {
83
- const next = await Promise.race([
84
- it.next(),
85
- new Promise<IteratorResult<HarnessEvent>>((r) =>
86
- setTimeout(() => r({ value: undefined as unknown as HarnessEvent, done: false }), 500),
87
- ),
88
- ])
89
- if (next.value?.type === "transcript") {
90
- sawTranscript = true
91
- break
92
- }
93
- }
94
- expect(sawTranscript).toBe(true)
95
- handle.close()
96
- } finally {
97
- await rm(dir, { recursive: true, force: true })
98
- }
99
- },
100
- 60_000,
101
- )
102
-
103
- test.skipIf(process.env.KANNA_PTY_E2E !== "1")(
104
- "E2E: setPermissionMode(true/false) — plan mode enter via /plan, exit via Shift+Tab",
105
- async () => {
106
- if (process.platform === "win32") return
107
- const settings = await readAppSettingsSnapshot()
108
- const activeEntry = settings.claudeAuth.tokens.find((t) => t.status === "active")
109
- if (!activeEntry) {
110
- console.warn("[e2e] no active OAuth token in Kanna settings — skipping plan-mode E2E")
111
- return
112
- }
113
- const dir = await mkdtemp(path.join(tmpdir(), "kanna-pty-pm-e2e-"))
114
- try {
115
- const handle = await startClaudeSessionPTY({
116
- chatId: "e2e-pm", projectId: "e2e-pm", localPath: dir,
117
- model: "claude-haiku-4-5-20251001",
118
- planMode: false, forkSession: false,
119
- oauthToken: activeEntry.token,
120
- sessionToken: null,
121
- onToolRequest: async () => null,
122
- })
123
- try {
124
- const iter = handle.stream[Symbol.asyncIterator]()
125
-
126
- async function awaitResult(label: string, timeoutMs = 30_000) {
127
- const deadline = Date.now() + timeoutMs
128
- while (Date.now() < deadline) {
129
- const next = await Promise.race([
130
- iter.next(),
131
- new Promise<IteratorResult<HarnessEvent>>((r) =>
132
- setTimeout(() => r({ value: undefined as unknown as HarnessEvent, done: false }), 500),
133
- ),
134
- ])
135
- const ev = next.value as HarnessEvent | undefined
136
- if (ev?.type === "transcript"
137
- && (ev.entry as { kind?: string } | undefined)?.kind === "result") {
138
- return true
139
- }
140
- }
141
- throw new Error(`${label}: timed out waiting for result entry`)
142
- }
143
-
144
- await handle.setPermissionMode(true)
145
- await new Promise((r) => setTimeout(r, 800))
146
-
147
- await handle.sendPrompt("Reply with exactly the word: plantest")
148
- await awaitResult("plan-mode prompt")
149
-
150
- await handle.setPermissionMode(false)
151
- await new Promise((r) => setTimeout(r, 800))
152
-
153
- await handle.sendPrompt("Reply with exactly the word: normaltest")
154
- await awaitResult("post-shift-tab prompt")
155
- } finally {
156
- handle.close()
157
- }
158
- } finally {
159
- await rm(dir, { recursive: true, force: true })
160
- }
161
- },
162
- 90_000,
163
- )
164
-
165
- })
166
-
167
- describe("startClaudeSessionPTY smoke-test gate", () => {
168
- test("refuses spawn when gate returns ok:false", async () => {
169
- const failingGate: import("./smoke-test").SmokeTestGate = {
170
- async canSpawn() { return { ok: false, reason: "disallowedTools regression" } },
171
- }
172
- await expect(startClaudeSessionPTY({
173
- chatId: "c1", projectId: "p1", localPath: "/tmp",
174
- model: "claude-opus-4-7", planMode: false, forkSession: false,
175
- oauthToken: "test-token", sessionToken: null,
176
- onToolRequest: async () => null,
177
- smokeTestGate: failingGate,
178
- env: { HOME: "/tmp", CLAUDE_CODE_OAUTH_TOKEN: "test-token" },
179
- })).rejects.toThrow(/smoke-test refused/i)
180
- })
181
- })
182
-
183
-
184
- describe("buildPtyCliArgs TUI mode", () => {
185
- test("does NOT include --print", () => {
186
- const args = buildPtyCliArgs({
187
- sessionId: "s1", model: "m", planMode: false,
188
- sessionToken: null, forkSession: false,
189
- })
190
- expect(args).not.toContain("--print")
191
- })
192
-
193
- test("does NOT include --output-format / --input-format / --verbose", () => {
194
- const args = buildPtyCliArgs({
195
- sessionId: "s1", model: "m", planMode: false,
196
- sessionToken: null, forkSession: false,
197
- })
198
- expect(args.find((a) => a.startsWith("--output-format"))).toBeUndefined()
199
- expect(args.find((a) => a.startsWith("--input-format"))).toBeUndefined()
200
- expect(args).not.toContain("--verbose")
201
- })
202
-
203
- test("includes core TUI args", () => {
204
- const args = buildPtyCliArgs({
205
- sessionId: "s1", model: "claude-opus-4-7", planMode: false,
206
- sessionToken: null, forkSession: false,
207
- })
208
- expect(args).toContain("--model")
209
- expect(args).toContain("claude-opus-4-7")
210
- expect(args).toContain("--permission-mode")
211
- expect(args).toContain("acceptEdits")
212
- expect(args).toContain("--dangerously-skip-permissions")
213
- })
214
-
215
- test("new sessions omit --session-id (interactive TUI ignores it; mtime filter handles JSONL discovery)", () => {
216
- const args = buildPtyCliArgs({
217
- sessionId: "s1", model: "m", planMode: false,
218
- sessionToken: null, forkSession: false,
219
- })
220
- expect(args).not.toContain("--session-id")
221
- expect(args).not.toContain("--resume")
222
- })
223
-
224
- test("resume passes --resume <token> without --session-id", () => {
225
- const args = buildPtyCliArgs({
226
- sessionId: "s1", model: "m", planMode: false,
227
- sessionToken: "tok-abc", forkSession: false,
228
- })
229
- expect(args).toContain("--resume")
230
- expect(args).toContain("tok-abc")
231
- expect(args).not.toContain("--session-id")
232
- expect(args).not.toContain("--fork-session")
233
- })
234
-
235
- test("fork passes --session-id + --resume + --fork-session", () => {
236
- const args = buildPtyCliArgs({
237
- sessionId: "fork-uuid", model: "m", planMode: false,
238
- sessionToken: "old-tok", forkSession: true,
239
- })
240
- expect(args).toContain("--session-id")
241
- expect(args).toContain("fork-uuid")
242
- expect(args).toContain("--resume")
243
- expect(args).toContain("old-tok")
244
- expect(args).toContain("--fork-session")
245
- })
246
-
247
- test("plan mode uses plan permission mode", () => {
248
- const args = buildPtyCliArgs({
249
- sessionId: "s1", model: "m", planMode: true,
250
- sessionToken: null, forkSession: false,
251
- })
252
- expect(args).toContain("plan")
253
- })
254
- })
255
-
256
- describe("buildPtyCliArgs", () => {
257
- const baseInput = {
258
- sessionId: "sess-123",
259
- model: "claude-sonnet-4-6",
260
- planMode: false,
261
- sessionToken: null,
262
- forkSession: false,
263
- }
264
-
265
- test("emits required base flags", () => {
266
- const args = buildPtyCliArgs(baseInput)
267
- expect(args).toContain("--model")
268
- expect(args).toContain("claude-sonnet-4-6")
269
- expect(args).not.toContain("--no-update")
270
- expect(args).toContain("--permission-mode")
271
- expect(args).toContain("acceptEdits")
272
- })
273
-
274
- test("does NOT restrict tools — model uses claude built-ins", () => {
275
- const args = buildPtyCliArgs(baseInput)
276
- expect(args).not.toContain("--tools")
277
- expect(args).not.toContain("mcp__kanna__*")
278
- })
279
-
280
- test("loads user/project/local setting sources (no --settings override)", () => {
281
- const args = buildPtyCliArgs(baseInput)
282
- expect(args).not.toContain("--settings")
283
- const idx = args.indexOf("--setting-sources")
284
- expect(idx).toBeGreaterThan(-1)
285
- expect(args[idx + 1]).toBe("user,project,local")
286
- })
287
-
288
- test("emits --dangerously-skip-permissions (personal-use bypass)", () => {
289
- const args = buildPtyCliArgs(baseInput)
290
- expect(args).toContain("--dangerously-skip-permissions")
291
- })
292
-
293
- test("plan mode picks 'plan' permission", () => {
294
- const args = buildPtyCliArgs({ ...baseInput, planMode: true })
295
- const idx = args.indexOf("--permission-mode")
296
- expect(args[idx + 1]).toBe("plan")
297
- })
298
-
299
- test("--effort omitted when undefined", () => {
300
- const args = buildPtyCliArgs(baseInput)
301
- expect(args).not.toContain("--effort")
302
- })
303
-
304
- test("--effort omitted when empty string", () => {
305
- const args = buildPtyCliArgs({ ...baseInput, effort: "" })
306
- expect(args).not.toContain("--effort")
307
- })
308
-
309
- test("--effort appended when provided", () => {
310
- const args = buildPtyCliArgs({ ...baseInput, effort: "high" })
311
- const idx = args.indexOf("--effort")
312
- expect(idx).toBeGreaterThan(-1)
313
- expect(args[idx + 1]).toBe("high")
314
- })
315
-
316
- test("resume mode: --resume only, no --session-id (claude rejects both together)", () => {
317
- const args = buildPtyCliArgs({ ...baseInput, sessionToken: "tok-abc" })
318
- expect(args).not.toContain("--session-id")
319
- expect(args).not.toContain("--fork-session")
320
- const idx = args.indexOf("--resume")
321
- expect(idx).toBeGreaterThan(-1)
322
- expect(args[idx + 1]).toBe("tok-abc")
323
- })
324
-
325
- test("new-session mode (no token, no fork): no --session-id, no --resume, no --fork-session", () => {
326
- const args = buildPtyCliArgs(baseInput)
327
- expect(args).not.toContain("--resume")
328
- expect(args).not.toContain("--fork-session")
329
- expect(args).not.toContain("--session-id")
330
- })
331
-
332
- test("fork mode: --session-id + --resume + --fork-session all three", () => {
333
- const args = buildPtyCliArgs({ ...baseInput, sessionToken: "tok-abc", forkSession: true })
334
- expect(args).toContain("--fork-session")
335
- const sid = args.indexOf("--session-id")
336
- expect(sid).toBeGreaterThan(-1)
337
- expect(args[sid + 1]).toBe("sess-123")
338
- const resume = args.indexOf("--resume")
339
- expect(resume).toBeGreaterThan(-1)
340
- expect(args[resume + 1]).toBe("tok-abc")
341
- })
342
-
343
- test("--add-dir per additional directory", () => {
344
- const args = buildPtyCliArgs({ ...baseInput, additionalDirectories: ["/a", "/b"] })
345
- const addDirs = args.reduce<string[]>((acc, val, i) => {
346
- if (val === "--add-dir") acc.push(args[i + 1])
347
- return acc
348
- }, [])
349
- expect(addDirs).toEqual(["/a", "/b"])
350
- })
351
-
352
- test("default appended kanna system prompt when no override", () => {
353
- const args = buildPtyCliArgs(baseInput)
354
- const idx = args.indexOf("--append-system-prompt")
355
- expect(idx).toBeGreaterThan(-1)
356
- expect(args[idx + 1]).toContain("Kanna coding agent")
357
- })
358
-
359
- test("D8: appended prompt is the shared KANNA_SYSTEM_PROMPT_APPEND when no override is supplied", () => {
360
- const args = buildPtyCliArgs(baseInput)
361
- const idx = args.indexOf("--append-system-prompt")
362
- expect(args[idx + 1]).toBe(KANNA_SYSTEM_PROMPT_APPEND)
363
- expect(args[idx + 1]).toContain("Reverse-engineering, security research")
364
- })
365
-
366
- test("D8b: systemPromptAppend overrides the static default (dynamic subagent roster path)", () => {
367
- const dynamic = `${KANNA_SYSTEM_PROMPT_APPEND}\n\n## Available subagents\n\n- codereview [id=sa-1]: review PR diffs`
368
- const args = buildPtyCliArgs({ ...baseInput, systemPromptAppend: dynamic })
369
- const idx = args.indexOf("--append-system-prompt")
370
- expect(args[idx + 1]).toBe(dynamic)
371
- expect(args[idx + 1]).toContain("Available subagents")
372
- expect(args[idx + 1]).toContain("codereview [id=sa-1]")
373
- })
374
-
375
- test("--system-prompt override replaces default append", () => {
376
- const args = buildPtyCliArgs({ ...baseInput, systemPromptOverride: "custom prompt body" })
377
- expect(args).not.toContain("--append-system-prompt")
378
- const idx = args.indexOf("--system-prompt")
379
- expect(args[idx + 1]).toBe("custom prompt body")
380
- })
381
-
382
- test("--mcp-config appended WITH --strict-mcp-config (TUI mode: strict so CLI ignores user MCP config)", () => {
383
- const args = buildPtyCliArgs({ ...baseInput, mcpConfigPath: "/tmp/mcp-config.json" })
384
- const idx = args.indexOf("--mcp-config")
385
- expect(idx).toBeGreaterThan(-1)
386
- expect(args[idx + 1]).toBe("/tmp/mcp-config.json")
387
- expect(args).toContain("--strict-mcp-config")
388
- })
389
-
390
- test("--mcp-config omitted when path absent", () => {
391
- const args = buildPtyCliArgs(baseInput)
392
- expect(args).not.toContain("--mcp-config")
393
- })
394
-
395
-
396
- test("disallows native AskUserQuestion + ExitPlanMode + ScheduleWakeup (shims for AQ/EPM; no shim for ScheduleWakeup — hard-break per adr-20260711-notification-driven-loop-orchestration)", () => {
397
- const args = buildPtyCliArgs(baseInput)
398
- const idx = args.indexOf("--disallowedTools")
399
- expect(idx).toBeGreaterThan(-1)
400
- expect(args.slice(idx + 1)).toEqual(["AskUserQuestion", "ExitPlanMode", "ScheduleWakeup"])
401
- expect(PTY_DISALLOWED_NATIVE_TOOLS).toEqual(["AskUserQuestion", "ExitPlanMode", "ScheduleWakeup"])
402
- expect(args).not.toContain("EnterPlanMode")
403
- })
404
-
405
- test("--disallowedTools is last so its variadic args cannot swallow another flag", () => {
406
- const args = buildPtyCliArgs({ ...baseInput, mcpConfigPath: "/tmp/mcp-config.json" })
407
- const idx = args.indexOf("--disallowedTools")
408
- expect(idx).toBe(args.length - PTY_DISALLOWED_NATIVE_TOOLS.length - 1)
409
- })
410
-
411
- test("loopArmed adds Edit/Write/MultiEdit/NotebookEdit/Task to --disallowedTools", () => {
412
- const args = buildPtyCliArgs({ ...baseInput, loopArmed: true })
413
- const idx = args.indexOf("--disallowedTools")
414
- const disallowed = args.slice(idx + 1)
415
- for (const t of ["Edit", "Write", "MultiEdit", "NotebookEdit", "Task"]) {
416
- expect(disallowed).toContain(t)
417
- }
418
- expect(disallowed).toContain("AskUserQuestion")
419
- })
420
-
421
- test("loopArmed=false leaves the base disallow list untouched", () => {
422
- const args = buildPtyCliArgs({ ...baseInput, loopArmed: false })
423
- const idx = args.indexOf("--disallowedTools")
424
- expect(args.slice(idx + 1)).toEqual(["AskUserQuestion", "ExitPlanMode", "ScheduleWakeup"])
425
- })
426
-
427
- test("--disallowedTools coexists with --append-system-prompt (index assertion still holds)", () => {
428
- const args = buildPtyCliArgs(baseInput)
429
- const idx = args.indexOf("--append-system-prompt")
430
- expect(idx).toBeGreaterThan(-1)
431
- expect(args[idx + 1]).toBe(KANNA_SYSTEM_PROMPT_APPEND)
432
- expect(args).toContain("--disallowedTools")
433
- })
434
-
435
- test("adds --dangerously-load-development-channels server:<name> when channelServerName set", () => {
436
- const args = buildPtyCliArgs({ ...baseInput, channelServerName: "kanna" })
437
- const i = args.indexOf("--dangerously-load-development-channels")
438
- expect(i).toBeGreaterThan(-1)
439
- expect(args[i + 1]).toBe("server:kanna")
440
- })
441
-
442
- test("omits the dev-channels flag when channelServerName absent", () => {
443
- const args = buildPtyCliArgs(baseInput)
444
- expect(args).not.toContain("--dangerously-load-development-channels")
445
- })
446
- })
447
-
448
- describe("OutputRing (B4 stderr ring buffer)", () => {
449
- test("retains short content verbatim", () => {
450
- const ring = new OutputRing()
451
- ring.append("hello ")
452
- ring.append("world")
453
- expect(ring.tail()).toBe("hello world")
454
- })
455
-
456
- test("caps at PTY_STDERR_RING_BYTES, keeping the most recent tail", () => {
457
- const ring = new OutputRing()
458
- const big = "A".repeat(PTY_STDERR_RING_BYTES)
459
- ring.append(big)
460
- ring.append("TAIL_MARKER")
461
- const tail = ring.tail()
462
- expect(tail.length).toBe(PTY_STDERR_RING_BYTES)
463
- expect(tail.endsWith("TAIL_MARKER")).toBe(true)
464
- expect(tail.startsWith("A")).toBe(true)
465
- expect(tail).not.toBe(big)
466
- })
467
-
468
- test("ring size constant is 256 KB", () => {
469
- expect(PTY_STDERR_RING_BYTES).toBe(256 * 1024)
470
- })
471
-
472
- test("empty ring tail is empty string", () => {
473
- expect(new OutputRing().tail()).toBe("")
474
- })
475
- })
476
-
477
- describe("deriveAccountInfoFromOauth (C1)", () => {
478
- test("no label and no masked key → null (UI falls back, no bogus chip)", () => {
479
- expect(deriveAccountInfoFromOauth({})).toBeNull()
480
- })
481
-
482
- test("empty label and empty masked → null", () => {
483
- expect(deriveAccountInfoFromOauth({ label: "", oauthKeyMasked: "" })).toBeNull()
484
- })
485
-
486
- test("label only → AccountInfo with organization + kanna-oauth-pool source", () => {
487
- expect(deriveAccountInfoFromOauth({ label: "work-account" })).toEqual({
488
- organization: "work-account",
489
- tokenSource: "kanna-oauth-pool",
490
- })
491
- })
492
-
493
- test("masked key only → AccountInfo with oauthKeyMasked + kanna-oauth-pool source", () => {
494
- expect(deriveAccountInfoFromOauth({ oauthKeyMasked: "sk-ant-oat01...1234" })).toEqual({
495
- oauthKeyMasked: "sk-ant-oat01...1234",
496
- tokenSource: "kanna-oauth-pool",
497
- })
498
- })
499
-
500
- test("label + masked → AccountInfo with both fields", () => {
501
- expect(deriveAccountInfoFromOauth({ label: "work-account", oauthKeyMasked: "sk-ant-oat01...1234" })).toEqual({
502
- organization: "work-account",
503
- oauthKeyMasked: "sk-ant-oat01...1234",
504
- tokenSource: "kanna-oauth-pool",
505
- })
506
- })
507
- })
508
-
509
- describe("PLAN_MODE_EXIT_UNSUPPORTED (state-unknown warning)", () => {
510
- test("PLAN_MODE_EXIT_UNSUPPORTED references plan mode and acceptEdits", () => {
511
- expect(PLAN_MODE_EXIT_UNSUPPORTED).toContain("plan mode")
512
- expect(PLAN_MODE_EXIT_UNSUPPORTED).toContain("acceptEdits")
513
- })
514
- })
515
-
516
- describe("SHIFT_TAB_KEY constant", () => {
517
- test("is the VT100 Shift+Tab sequence", () => {
518
- expect(SHIFT_TAB_KEY).toBe("\x1b[Z")
519
- })
520
- })
521
-
522
-
523
- async function makeTestHandle(opts?: { planMode?: boolean; additionalDirectories?: string[] }) {
524
- const homeDir = await mkdtemp(path.join(tmpdir(), "kanna-pm-"))
525
- const sentInputs: string[] = []
526
- const spawnEnvs: NodeJS.ProcessEnv[] = []
527
- let exitResolve!: (code: number) => void
528
- const exited = new Promise<number>((r) => { exitResolve = r })
529
-
530
- const fakePty: PtyProcess = {
531
- pid: 99999,
532
- async sendInput(data) { sentInputs.push(data) },
533
- resize() {},
534
- exited,
535
- close() { exitResolve(0) },
536
- kill() { exitResolve(137) },
537
- }
538
-
539
- const fakeSpawn = async (spawnArgs: SpawnPtyProcessArgs): Promise<PtyProcess> => {
540
- spawnEnvs.push(spawnArgs.env)
541
- spawnArgs.onOutput?.("❯ ")
542
- return fakePty
543
- }
544
-
545
- const fakeSmoke: import("./smoke-test").SmokeTestGate = {
546
- async canSpawn() { return { ok: true } },
547
- }
548
-
549
- const neverStream: TranscriptStream = {
550
- lines: {
551
- [Symbol.asyncIterator]() {
552
- return { next(): Promise<IteratorResult<string, undefined>> { return new Promise(() => {}) } }
553
- },
554
- },
555
- filePath: new Promise<string>(() => {}),
556
- close() {},
557
- }
558
-
559
- const handle = await startClaudeSessionPTY({
560
- chatId: "test", projectId: "test", localPath: homeDir,
561
- model: "claude-haiku-4-5-20251001",
562
- planMode: opts?.planMode ?? false,
563
- forkSession: false,
564
- oauthToken: "test-token",
565
- sessionToken: null,
566
- onToolRequest: async () => null,
567
- homeDir,
568
- ...(opts?.additionalDirectories ? { additionalDirectories: opts.additionalDirectories } : {}),
569
- env: {
570
- HOME: homeDir,
571
- CLAUDE_CODE_OAUTH_TOKEN: "test-token",
572
- KANNA_PTY_TRUST_DISMISS: "disabled",
573
- CLAUDE_EXECUTABLE: "/bin/sh",
574
- },
575
- spawnPtyProcess: fakeSpawn,
576
- startKannaMcpHttpServer: async () => ({ url: "http://127.0.0.1:0/mcp", bearerToken: "test", close: async () => {}, channelClientReady: Promise.resolve(), pushChannelPrompt: async () => {} }),
577
- startTranscriptStreamFn: async () => neverStream,
578
- smokeTestGate: fakeSmoke,
579
- })
580
-
581
- return {
582
- handle,
583
- sentInputs,
584
- spawnEnvs,
585
- async cleanup() {
586
- exitResolve(0)
587
- handle.close()
588
- await rm(homeDir, { recursive: true, force: true })
589
- },
590
- }
591
- }
592
-
593
- describe("multi-root memory switch on the PTY spawn", () => {
594
- test("set when the spawn has additional roots", async () => {
595
- if (process.platform === "win32") return
596
- const { spawnEnvs, cleanup } = await makeTestHandle({ additionalDirectories: ["/repo-b"] })
597
- try {
598
- expect(spawnEnvs[0]?.CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD).toBe("1")
599
- } finally {
600
- await cleanup()
601
- }
602
- })
603
-
604
- test("absent on a solo spawn", async () => {
605
- if (process.platform === "win32") return
606
- const { spawnEnvs, cleanup } = await makeTestHandle()
607
- try {
608
- expect(spawnEnvs[0]?.CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD).toBeUndefined()
609
- } finally {
610
- await cleanup()
611
- }
612
- })
613
- })
614
-
615
- describe("setPermissionMode (F1 — plan mode exit)", () => {
616
- test("setPermissionMode(true) sends /plan\\r and tracks state", async () => {
617
- if (process.platform === "win32") return
618
- const { handle, sentInputs, cleanup } = await makeTestHandle()
619
- try {
620
- await handle.setPermissionMode(true)
621
- expect(sentInputs).toContain("/plan\r")
622
- } finally {
623
- await cleanup()
624
- }
625
- }, 30_000)
626
-
627
- test("setPermissionMode(false) after true sends Shift+Tab \\x1b[Z", async () => {
628
- if (process.platform === "win32") return
629
- const { handle, sentInputs, cleanup } = await makeTestHandle()
630
- try {
631
- await handle.setPermissionMode(true)
632
- sentInputs.length = 0
633
- await handle.setPermissionMode(false)
634
- expect(sentInputs).toContain(SHIFT_TAB_KEY)
635
- } finally {
636
- await cleanup()
637
- }
638
- }, 30_000)
639
-
640
- test("setPermissionMode(false) when started with planMode:true sends Shift+Tab", async () => {
641
- if (process.platform === "win32") return
642
- const { handle, sentInputs, cleanup } = await makeTestHandle({ planMode: true })
643
- try {
644
- await handle.setPermissionMode(false)
645
- expect(sentInputs).toContain(SHIFT_TAB_KEY)
646
- } finally {
647
- await cleanup()
648
- }
649
- }, 30_000)
650
-
651
- test("setPermissionMode(false) without prior entry does NOT send Shift+Tab", async () => {
652
- if (process.platform === "win32") return
653
- const { handle, sentInputs, cleanup } = await makeTestHandle()
654
- try {
655
- await handle.setPermissionMode(false)
656
- expect(sentInputs).not.toContain(SHIFT_TAB_KEY)
657
- } finally {
658
- await cleanup()
659
- }
660
- }, 30_000)
661
- })
662
-
663
-
664
- async function spawnAndReadMcpConfig(opts: {
665
- sessionToken: string
666
- customMcpServers?: readonly McpServerConfig[]
667
- }): Promise<{ parsed: { mcpServers: Record<string, unknown> }; cleanup: () => Promise<void> }> {
668
- const homeDir = await mkdtemp(path.join(tmpdir(), "kanna-t6-mcp-"))
669
- let exitResolve!: (code: number) => void
670
- const exited = new Promise<number>((r) => { exitResolve = r })
671
-
672
- const fakePty: PtyProcess = {
673
- pid: 88888,
674
- async sendInput() { },
675
- resize() {},
676
- exited,
677
- close() { exitResolve(0) },
678
- kill() { exitResolve(137) },
679
- }
680
- const fakeSpawn = async (spawnArgs: SpawnPtyProcessArgs): Promise<PtyProcess> => {
681
- spawnArgs.onOutput?.("❯ ")
682
- return fakePty
683
- }
684
- const fakeSmoke: import("./smoke-test").SmokeTestGate = {
685
- async canSpawn() { return { ok: true } },
686
- }
687
- const neverStream: TranscriptStream = {
688
- lines: {
689
- [Symbol.asyncIterator]() {
690
- return { next(): Promise<IteratorResult<string, undefined>> { return new Promise(() => {}) } }
691
- },
692
- },
693
- filePath: new Promise<string>(() => {}),
694
- close() {},
695
- }
696
-
697
- const handle = await startClaudeSessionPTY({
698
- chatId: "t6-test", projectId: "test", localPath: homeDir,
699
- model: "claude-haiku-4-5-20251001",
700
- planMode: false, forkSession: false,
701
- oauthToken: "test-token", sessionToken: opts.sessionToken,
702
- onToolRequest: async () => null,
703
- homeDir,
704
- env: {
705
- HOME: homeDir,
706
- CLAUDE_CODE_OAUTH_TOKEN: "test-token",
707
- KANNA_PTY_TRUST_DISMISS: "disabled",
708
- CLAUDE_EXECUTABLE: "/bin/sh",
709
- },
710
- customMcpServers: opts.customMcpServers,
711
- spawnPtyProcess: fakeSpawn,
712
- startKannaMcpHttpServer: async () => ({ url: "http://127.0.0.1:0/mcp", bearerToken: "test", close: async () => {}, channelClientReady: Promise.resolve(), pushChannelPrompt: async () => {} }),
713
- startTranscriptStreamFn: async () => neverStream,
714
- smokeTestGate: fakeSmoke,
715
- })
716
-
717
- const prefix = `kanna-pty-${opts.sessionToken.slice(0, 8)}-`
718
- const osTmp = tmpdir()
719
- const entries = await readdir(osTmp)
720
- const runtimeDirName = entries.find((e) => e.startsWith(prefix))
721
- if (!runtimeDirName) {
722
- throw new Error(`Could not find runtimeDir with prefix ${prefix} in ${osTmp}`)
723
- }
724
- const mcpConfigPath = path.join(osTmp, runtimeDirName, "mcp-config.json")
725
- const raw = await readFile(mcpConfigPath, "utf8")
726
- const parsed = JSON.parse(raw) as { mcpServers: Record<string, unknown> }
727
-
728
- return {
729
- parsed,
730
- async cleanup() {
731
- exitResolve(0)
732
- handle.close()
733
- await rm(homeDir, { recursive: true, force: true })
734
- await rm(path.join(osTmp, runtimeDirName), { recursive: true, force: true })
735
- },
736
- }
737
- }
738
-
739
- describe("PTY customMcpServers wiring (Task 6)", () => {
740
- test("mcp-config.json includes enabled user customMcpServers", async () => {
741
- if (process.platform === "win32") return
742
- const userServer: McpServerConfig = {
743
- id: "u1", name: "fs-tool", enabled: true,
744
- createdAt: "", updatedAt: "", lastTest: { status: "untested" },
745
- transport: "stdio", command: "/bin/ls", args: [], env: {},
746
- }
747
- const { parsed, cleanup } = await spawnAndReadMcpConfig({
748
- sessionToken: "t6-inc-001",
749
- customMcpServers: [userServer],
750
- })
751
- try {
752
- expect(parsed.mcpServers["fs-tool"]).toBeDefined()
753
- expect((parsed.mcpServers["fs-tool"] as { type: string }).type).toBe("stdio")
754
- } finally {
755
- await cleanup()
756
- }
757
- }, 30_000)
758
-
759
- test("mcp-config.json omits disabled customMcpServers", async () => {
760
- if (process.platform === "win32") return
761
- const enabled: McpServerConfig = {
762
- id: "u2", name: "enabled-srv", enabled: true,
763
- createdAt: "", updatedAt: "", lastTest: { status: "untested" },
764
- transport: "stdio", command: "/bin/echo", args: [], env: {},
765
- }
766
- const disabled: McpServerConfig = {
767
- id: "u3", name: "disabled-srv", enabled: false,
768
- createdAt: "", updatedAt: "", lastTest: { status: "untested" },
769
- transport: "stdio", command: "/bin/false", args: [], env: {},
770
- }
771
- const { parsed, cleanup } = await spawnAndReadMcpConfig({
772
- sessionToken: "t6-omit-001",
773
- customMcpServers: [enabled, disabled],
774
- })
775
- try {
776
- expect(parsed.mcpServers["enabled-srv"]).toBeDefined()
777
- expect(parsed.mcpServers["disabled-srv"]).toBeUndefined()
778
- } finally {
779
- await cleanup()
780
- }
781
- }, 30_000)
782
- })
783
-
784
- describe("session close escalation (graceful → SIGTERM → SIGKILL)", () => {
785
- test("close() escalates to SIGKILL when SIGTERM does not terminate within the grace window", async () => {
786
- if (process.platform === "win32") return
787
- let killSignal: NodeJS.Signals | number | undefined
788
- let exitResolve!: (code: number) => void
789
- const exited = new Promise<number>((r) => { exitResolve = r })
790
- const stubbornPty: PtyProcess = {
791
- pid: 99998,
792
- async sendInput() { },
793
- resize() {},
794
- exited,
795
- close() { },
796
- kill(signal) { killSignal = signal; exitResolve(137) },
797
- }
798
- const tmp = await mkdtemp(path.join(tmpdir(), "kanna-pty-close-"))
799
- try {
800
- const handle = await startClaudeSessionPTY({
801
- chatId: "test-close", projectId: "p", localPath: tmp,
802
- model: "claude-haiku-4-5-20251001",
803
- planMode: false, forkSession: false,
804
- oauthToken: "test-token", sessionToken: null,
805
- onToolRequest: async () => null,
806
- homeDir: tmp,
807
- env: { HOME: tmp, CLAUDE_CODE_OAUTH_TOKEN: "test-token", KANNA_PTY_TRUST_DISMISS: "disabled", CLAUDE_EXECUTABLE: "/bin/sh", KANNA_PTY_SESSION_END_GRACE_MS: "200" },
808
- spawnPtyProcess: async (s) => { s.onOutput?.("❯ "); return stubbornPty },
809
- startKannaMcpHttpServer: async () => ({ url: "http://127.0.0.1:0/mcp", bearerToken: "t", close: async () => {}, channelClientReady: Promise.resolve(), pushChannelPrompt: async () => {} }),
810
- startTranscriptStreamFn: async () => ({
811
- lines: { [Symbol.asyncIterator]() { return { next(): Promise<IteratorResult<string, undefined>> { return new Promise(() => {}) } } } },
812
- filePath: new Promise<string>(() => {}),
813
- close() {},
814
- }),
815
- smokeTestGate: { async canSpawn() { return { ok: true } } },
816
- })
817
- handle.close()
818
- const code = await Promise.race([
819
- exited,
820
- new Promise<number>((_, reject) => setTimeout(() => reject(new Error("escalation timed out")), 8_000)),
821
- ])
822
- expect(code).toBe(137)
823
- expect(killSignal).toBe("SIGKILL")
824
- } finally {
825
- await rm(tmp, { recursive: true, force: true })
826
- }
827
- }, 30_000)
828
-
829
- test("close() does not send SIGTERM when process exits within the grace window (SessionEnd hook completes)", async () => {
830
- if (process.platform === "win32") return
831
- let sigTermSent = false
832
- let sigKillSent = false
833
- let exitResolve!: (code: number) => void
834
- const exited = new Promise<number>((r) => { exitResolve = r })
835
- const cooperativePty: PtyProcess = {
836
- pid: 99997,
837
- async sendInput(text) {
838
- if (text === "/exit\r") setTimeout(() => exitResolve(0), 50)
839
- },
840
- resize() {},
841
- exited,
842
- close() { sigTermSent = true },
843
- kill() { sigKillSent = true },
844
- }
845
- const tmp = await mkdtemp(path.join(tmpdir(), "kanna-pty-close-grace-"))
846
- try {
847
- const handle = await startClaudeSessionPTY({
848
- chatId: "test-close-grace", projectId: "p", localPath: tmp,
849
- model: "claude-haiku-4-5-20251001",
850
- planMode: false, forkSession: false,
851
- oauthToken: "test-token", sessionToken: null,
852
- onToolRequest: async () => null,
853
- homeDir: tmp,
854
- env: { HOME: tmp, CLAUDE_CODE_OAUTH_TOKEN: "test-token", KANNA_PTY_TRUST_DISMISS: "disabled", CLAUDE_EXECUTABLE: "/bin/sh", KANNA_PTY_SESSION_END_GRACE_MS: "500" },
855
- spawnPtyProcess: async (s) => { s.onOutput?.("❯ "); return cooperativePty },
856
- startKannaMcpHttpServer: async () => ({ url: "http://127.0.0.1:0/mcp", bearerToken: "t", close: async () => {}, channelClientReady: Promise.resolve(), pushChannelPrompt: async () => {} }),
857
- startTranscriptStreamFn: async () => ({
858
- lines: { [Symbol.asyncIterator]() { return { next(): Promise<IteratorResult<string, undefined>> { return new Promise(() => {}) } } } },
859
- filePath: new Promise<string>(() => {}),
860
- close() {},
861
- }),
862
- smokeTestGate: { async canSpawn() { return { ok: true } } },
863
- })
864
- handle.close()
865
- await Promise.race([
866
- exited,
867
- new Promise<number>((_, reject) => setTimeout(() => reject(new Error("exit timed out")), 3_000)),
868
- ])
869
- expect(sigTermSent).toBe(false)
870
- expect(sigKillSent).toBe(false)
871
- } finally {
872
- await rm(tmp, { recursive: true, force: true })
873
- }
874
- }, 30_000)
875
- })
876
-
877
- describe("keep-alive (Task 1)", () => {
878
- test("keepAlive: does NOT send /exit on first result, exposes pushChannelPrompt", async () => {
879
- if (process.platform === "win32") return
880
- const exitCalls: string[] = []
881
- const pushed: string[] = []
882
-
883
- const lineQueue: string[] = []
884
- const lineWaiters: Array<(r: IteratorResult<string>) => void> = []
885
- function notifyLine(line: string) {
886
- const w = lineWaiters.shift()
887
- if (w) w({ value: line, done: false })
888
- else lineQueue.push(line)
889
- }
890
- const emitLine: (line: string) => void = notifyLine
891
- const controlledStream: TranscriptStream = {
892
- lines: {
893
- [Symbol.asyncIterator]() {
894
- return {
895
- next(): Promise<IteratorResult<string>> {
896
- if (lineQueue.length > 0) {
897
- const line = lineQueue.shift()!
898
- return Promise.resolve({ value: line, done: false })
899
- }
900
- return new Promise((resolve) => { lineWaiters.push(resolve) })
901
- },
902
- }
903
- },
904
- },
905
- filePath: Promise.resolve("/tmp/x.jsonl"),
906
- close: () => {
907
- const w = lineWaiters.shift()
908
- if (w) w({ value: undefined as unknown as string, done: true })
909
- },
910
- }
911
-
912
- const fakePty = {
913
- pid: 33333,
914
- sendInput: async (d: string) => { if (d.includes("/exit")) exitCalls.push(d) },
915
- resize() {},
916
- exited: new Promise<number>(() => {}),
917
- close: () => {},
918
- kill: () => {},
919
- } as unknown as PtyProcess
920
-
921
- const fakeHandle = {
922
- url: "http://127.0.0.1:1/mcp",
923
- bearerToken: "t",
924
- close: async () => {},
925
- channelClientReady: Promise.resolve(),
926
- pushChannelPrompt: async (c: string) => { pushed.push(c) },
927
- }
928
-
929
- const handle = await startClaudeSessionPTY({
930
- chatId: "ka-test", projectId: "p1", localPath: "/tmp",
931
- model: "claude-sonnet-4-6", planMode: false, forkSession: false,
932
- oauthToken: "sk-ant-oat01-x", sessionToken: null,
933
- systemPromptOverride: "You are a subagent.",
934
- initialPrompt: "turn one",
935
- oneShot: true,
936
- keepAlive: true,
937
- onToolRequest: async () => null,
938
- env: { ...process.env, KANNA_PTY_TRUST_DISMISS: "disabled", KANNA_PTY_CHANNEL_DELIVERY: "enabled", KANNA_PTY_TUI_BOOT_MS: "10" },
939
- startKannaMcpHttpServer: (async () => fakeHandle) as never,
940
- spawnPtyProcess: (async () => fakePty) as never,
941
- startTranscriptStreamFn: (async () => controlledStream) as never,
942
- smokeTestGate: { canSpawn: async () => ({ ok: true }) },
943
- })
944
-
945
- emitLine(JSON.stringify({ type: "user", message: { role: "user", content: [{ type: "text", text: "turn one" }] }, isMeta: false }))
946
- emitLine(JSON.stringify({ type: "result", subtype: "success", result: "done", durationMs: 100, durationApiMs: 100, isError: false, totalCostUSD: 0 }))
947
-
948
- await new Promise((r) => setTimeout(r, 150))
949
-
950
- expect(exitCalls).toHaveLength(0)
951
-
952
- expect(pushed).toEqual(["turn one"])
953
-
954
- expect(typeof handle.pushChannelPrompt).toBe("function")
955
-
956
- await handle.pushChannelPrompt!("turn two")
957
- expect(pushed).toEqual(["turn one", "turn two"])
958
-
959
- handle.close()
960
- }, 30_000)
961
-
962
- test("keepAlive omitted on oneShot: handle.pushChannelPrompt is undefined", async () => {
963
- if (process.platform === "win32") return
964
- const fakePty = {
965
- pid: 44444,
966
- sendInput: async () => {},
967
- resize() {},
968
- exited: new Promise<number>(() => {}),
969
- close: () => {},
970
- kill: () => {},
971
- } as unknown as PtyProcess
972
- const fakeHandle = {
973
- url: "http://127.0.0.1:1/mcp", bearerToken: "t", close: async () => {},
974
- channelClientReady: Promise.resolve(),
975
- pushChannelPrompt: async () => {},
976
- }
977
- const handle = await startClaudeSessionPTY({
978
- chatId: "ka-neg", projectId: "p1", localPath: "/tmp",
979
- model: "claude-sonnet-4-6", planMode: false, forkSession: false,
980
- oauthToken: "sk-ant-oat01-x", sessionToken: null,
981
- systemPromptOverride: "You are a subagent.",
982
- initialPrompt: "hello",
983
- oneShot: true,
984
- onToolRequest: async () => null,
985
- env: { ...process.env, KANNA_PTY_TRUST_DISMISS: "disabled", KANNA_PTY_CHANNEL_DELIVERY: "enabled", KANNA_PTY_TUI_BOOT_MS: "10" },
986
- startKannaMcpHttpServer: (async () => fakeHandle) as never,
987
- spawnPtyProcess: (async () => fakePty) as never,
988
- startTranscriptStreamFn: (async () => ({ lines: (async function* () {})(), filePath: Promise.resolve("/tmp/x.jsonl"), close: () => {} })) as never,
989
- smokeTestGate: { canSpawn: async () => ({ ok: true }) },
990
- })
991
- expect(handle.pushChannelPrompt).toBeUndefined()
992
- handle.close()
993
- }, 30_000)
994
- })
995
-
996
- describe("channel-delivery (Task 5)", () => {
997
- test("oneShot channel delivery pushes initialPrompt via channel, not paste", async () => {
998
- if (process.platform === "win32") return
999
- const pushed: string[] = []
1000
- const ptyWrites: string[] = []
1001
- const fakeHandle = {
1002
- url: "http://127.0.0.1:1/mcp", bearerToken: "t", close: async () => {},
1003
- channelClientReady: Promise.resolve(),
1004
- pushChannelPrompt: async (c: string) => { pushed.push(c) },
1005
- }
1006
- const fakePty = { pid: 11111, sendInput: async (d: string) => { ptyWrites.push(d) }, resize() {}, exited: new Promise<number>(() => {}), close: () => {}, kill: () => {} } as unknown as PtyProcess
1007
- const handle = await startClaudeSessionPTY({
1008
- chatId: "c1", projectId: "p1", localPath: "/tmp",
1009
- model: "claude-sonnet-4-6", planMode: false, forkSession: false,
1010
- oauthToken: "sk-ant-oat01-x", sessionToken: null,
1011
- systemPromptOverride: "You are a subagent.",
1012
- initialPrompt: "FULL MULTILINE PROMPT\nline2\nline3",
1013
- oneShot: true,
1014
- onToolRequest: async () => null,
1015
- env: { ...process.env, KANNA_PTY_TRUST_DISMISS: "disabled", KANNA_PTY_CHANNEL_DELIVERY: "enabled", KANNA_PTY_TUI_BOOT_MS: "10" },
1016
- startKannaMcpHttpServer: (async () => fakeHandle) as never,
1017
- spawnPtyProcess: (async () => fakePty) as never,
1018
- startTranscriptStreamFn: (async () => ({ lines: (async function* () {})(), filePath: Promise.resolve("/tmp/x.jsonl"), close: () => {} })) as never,
1019
- smokeTestGate: { canSpawn: async () => ({ ok: true }) },
1020
- })
1021
- await new Promise((r) => setTimeout(r, 100))
1022
- expect(pushed).toEqual(["FULL MULTILINE PROMPT\nline2\nline3"])
1023
- expect(ptyWrites.join("")).not.toContain("FULL MULTILINE PROMPT")
1024
- try { if (handle.interrupt) await handle.interrupt() } catch { }
1025
- }, 30_000)
1026
-
1027
- test("oneShot channel delivery fails fast when client never ready (no paste fallback)", async () => {
1028
- if (process.platform === "win32") return
1029
- const ptyWrites: string[] = []
1030
- let closed = false
1031
- const fakeHandle = {
1032
- url: "http://127.0.0.1:1/mcp", bearerToken: "t", close: async () => {},
1033
- channelClientReady: new Promise<void>(() => {}),
1034
- pushChannelPrompt: async () => {},
1035
- }
1036
- const fakePty = { pid: 22222, sendInput: async (d: string) => { ptyWrites.push(d) }, resize() {}, exited: new Promise<number>(() => {}), close: () => { closed = true }, kill: () => {} } as unknown as PtyProcess
1037
- const promise = startClaudeSessionPTY({
1038
- chatId: "c1", projectId: "p1", localPath: "/tmp",
1039
- model: "claude-sonnet-4-6", planMode: false, forkSession: false,
1040
- oauthToken: "sk-ant-oat01-x", sessionToken: null,
1041
- systemPromptOverride: "You are a subagent.",
1042
- initialPrompt: "FULL MULTILINE PROMPT\nline2",
1043
- oneShot: true,
1044
- onToolRequest: async () => null,
1045
- env: { ...process.env, KANNA_PTY_TRUST_DISMISS: "disabled", KANNA_PTY_CHANNEL_DELIVERY: "enabled", KANNA_PTY_TUI_BOOT_MS: "10", KANNA_PTY_CHANNEL_READY_TIMEOUT_MS: "30" },
1046
- startKannaMcpHttpServer: (async () => fakeHandle) as never,
1047
- spawnPtyProcess: (async () => fakePty) as never,
1048
- startTranscriptStreamFn: (async () => ({ lines: (async function* () {})(), filePath: Promise.resolve("/tmp/x.jsonl"), close: () => {} })) as never,
1049
- smokeTestGate: { canSpawn: async () => ({ ok: true }) },
1050
- })
1051
- await expect(promise).rejects.toThrow(/channel/i)
1052
- expect(ptyWrites.join("")).not.toContain("FULL MULTILINE PROMPT")
1053
- expect(closed).toBe(true)
1054
- }, 30_000)
1055
- })
1056
-
1057
- describe("follow-up sendPrompt TUI-ready gate (silent-hang fix)", () => {
1058
- const fakeHandle = {
1059
- url: "http://127.0.0.1:1/mcp", bearerToken: "t", close: async () => {},
1060
- channelClientReady: Promise.resolve(),
1061
- pushChannelPrompt: async () => {},
1062
- }
1063
- const idleStream = (async () => ({
1064
- lines: { [Symbol.asyncIterator]() { return { next(): Promise<IteratorResult<string>> { return new Promise(() => {}) } } } },
1065
- filePath: Promise.resolve("/tmp/x.jsonl"),
1066
- close: () => {},
1067
- })) as never
1068
-
1069
- test("waits for ❯ marker + ring-quiet before pasting a follow-up prompt", async () => {
1070
- if (process.platform === "win32") return
1071
- const sentInputs: string[] = []
1072
- let pushOutput: (chunk: string) => void = () => {}
1073
- const fakePty = {
1074
- pid: 55555,
1075
- sendInput: async (d: string) => { sentInputs.push(d) },
1076
- resize() {}, exited: new Promise<number>(() => {}), close: () => {}, kill: () => {},
1077
- } as unknown as PtyProcess
1078
- const handle = await startClaudeSessionPTY({
1079
- chatId: "followup-1", projectId: "p1", localPath: "/tmp",
1080
- model: "claude-sonnet-4-6", planMode: false, forkSession: false,
1081
- oauthToken: "sk-ant-oat01-x", sessionToken: null,
1082
- systemPromptOverride: "You are a coding agent.",
1083
- onToolRequest: async () => null,
1084
- env: { ...process.env,
1085
- KANNA_PTY_TRUST_DISMISS: "disabled",
1086
- KANNA_PTY_CHANNEL_DELIVERY: "disabled",
1087
- KANNA_PTY_TUI_BOOT_MS: "10",
1088
- KANNA_PTY_TUI_READY_QUIET_MS: "20",
1089
- KANNA_PTY_FOLLOWUP_READY_MS: "3000",
1090
- },
1091
- startKannaMcpHttpServer: (async () => fakeHandle) as never,
1092
- spawnPtyProcess: (async (a: SpawnPtyProcessArgs) => { pushOutput = a.onOutput ?? (() => {}); return fakePty }) as never,
1093
- startTranscriptStreamFn: idleStream,
1094
- smokeTestGate: { canSpawn: async () => ({ ok: true }) },
1095
- })
1096
-
1097
- const sendDone = handle.sendPrompt!("Ok")
1098
- await new Promise((r) => setTimeout(r, 150))
1099
- expect(sentInputs.some((d) => d.includes("\x1b[200~"))).toBe(false)
1100
-
1101
- pushOutput("❯ ")
1102
- await sendDone
1103
- expect(sentInputs.some((d) => d.includes("\x1b[200~Ok\x1b[201~"))).toBe(true)
1104
- expect(sentInputs.some((d) => d === "\r")).toBe(true)
1105
- handle.close()
1106
- }, 30_000)
1107
-
1108
- test("never-ready REPL: warns and still sends after the cap (never worse than today)", async () => {
1109
- if (process.platform === "win32") return
1110
- const sentInputs: string[] = []
1111
- const fakePty = {
1112
- pid: 55556,
1113
- sendInput: async (d: string) => { sentInputs.push(d) },
1114
- resize() {}, exited: new Promise<number>(() => {}), close: () => {}, kill: () => {},
1115
- } as unknown as PtyProcess
1116
- const handle = await startClaudeSessionPTY({
1117
- chatId: "followup-2", projectId: "p1", localPath: "/tmp",
1118
- model: "claude-sonnet-4-6", planMode: false, forkSession: false,
1119
- oauthToken: "sk-ant-oat01-x", sessionToken: null,
1120
- systemPromptOverride: "You are a coding agent.",
1121
- onToolRequest: async () => null,
1122
- env: { ...process.env,
1123
- KANNA_PTY_TRUST_DISMISS: "disabled",
1124
- KANNA_PTY_CHANNEL_DELIVERY: "disabled",
1125
- KANNA_PTY_TUI_BOOT_MS: "10",
1126
- KANNA_PTY_TUI_READY_QUIET_MS: "20",
1127
- KANNA_PTY_FOLLOWUP_READY_MS: "40",
1128
- },
1129
- startKannaMcpHttpServer: (async () => fakeHandle) as never,
1130
- spawnPtyProcess: (async () => fakePty) as never,
1131
- startTranscriptStreamFn: idleStream,
1132
- smokeTestGate: { canSpawn: async () => ({ ok: true }) },
1133
- })
1134
-
1135
- await handle.sendPrompt!("Ok")
1136
- expect(sentInputs.some((d) => d.includes("\x1b[200~Ok\x1b[201~"))).toBe(true)
1137
- handle.close()
1138
- }, 30_000)
1139
- })
1140
-
1141
- describe("buildChannelPromptFraming", () => {
1142
- test("keep-alive subagent framing tells the model to expect multiple channel turns", () => {
1143
- const framing = buildChannelPromptFraming(true)
1144
- expect(framing).toMatch(/multiple/i)
1145
- expect(framing).toMatch(/channel/i)
1146
- })
1147
-
1148
- test("one-shot framing stays single-turn (no multiple-message language)", () => {
1149
- const framing = buildChannelPromptFraming(false)
1150
- expect(framing).toMatch(/channel/i)
1151
- expect(framing).not.toMatch(/multiple/i)
1152
- })
1153
- })