@nightloom/isy 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (223) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +69 -0
  3. package/dist/agents/claude.d.ts +6 -0
  4. package/dist/agents/claude.js +66 -0
  5. package/dist/agents/claude.js.map +1 -0
  6. package/dist/agents/codex-records.d.ts +34 -0
  7. package/dist/agents/codex-records.js +492 -0
  8. package/dist/agents/codex-records.js.map +1 -0
  9. package/dist/agents/codex.d.ts +5 -0
  10. package/dist/agents/codex.js +205 -0
  11. package/dist/agents/codex.js.map +1 -0
  12. package/dist/agents/index.d.ts +25 -0
  13. package/dist/agents/index.js +50 -0
  14. package/dist/agents/index.js.map +1 -0
  15. package/dist/agents/kimi-records.d.ts +24 -0
  16. package/dist/agents/kimi-records.js +252 -0
  17. package/dist/agents/kimi-records.js.map +1 -0
  18. package/dist/agents/kimi-wire.d.ts +8 -0
  19. package/dist/agents/kimi-wire.js +158 -0
  20. package/dist/agents/kimi-wire.js.map +1 -0
  21. package/dist/agents/kimi.d.ts +6 -0
  22. package/dist/agents/kimi.js +332 -0
  23. package/dist/agents/kimi.js.map +1 -0
  24. package/dist/agents/types.d.ts +83 -0
  25. package/dist/agents/types.js +2 -0
  26. package/dist/agents/types.js.map +1 -0
  27. package/dist/alert.d.ts +24 -0
  28. package/dist/alert.js +68 -0
  29. package/dist/alert.js.map +1 -0
  30. package/dist/api.d.ts +103 -0
  31. package/dist/api.js +171 -0
  32. package/dist/api.js.map +1 -0
  33. package/dist/commands/analyze.d.ts +61 -0
  34. package/dist/commands/analyze.js +198 -0
  35. package/dist/commands/analyze.js.map +1 -0
  36. package/dist/commands/check.d.ts +55 -0
  37. package/dist/commands/check.js +180 -0
  38. package/dist/commands/check.js.map +1 -0
  39. package/dist/commands/commit.d.ts +26 -0
  40. package/dist/commands/commit.js +130 -0
  41. package/dist/commands/commit.js.map +1 -0
  42. package/dist/commands/health.d.ts +47 -0
  43. package/dist/commands/health.js +366 -0
  44. package/dist/commands/health.js.map +1 -0
  45. package/dist/commands/init.d.ts +3 -0
  46. package/dist/commands/init.js +173 -0
  47. package/dist/commands/init.js.map +1 -0
  48. package/dist/commands/logout.d.ts +1 -0
  49. package/dist/commands/logout.js +30 -0
  50. package/dist/commands/logout.js.map +1 -0
  51. package/dist/commands/notes.d.ts +11 -0
  52. package/dist/commands/notes.js +49 -0
  53. package/dist/commands/notes.js.map +1 -0
  54. package/dist/commands/scan.d.ts +47 -0
  55. package/dist/commands/scan.js +199 -0
  56. package/dist/commands/scan.js.map +1 -0
  57. package/dist/commands/settings.d.ts +15 -0
  58. package/dist/commands/settings.js +94 -0
  59. package/dist/commands/settings.js.map +1 -0
  60. package/dist/commands/status.d.ts +61 -0
  61. package/dist/commands/status.js +151 -0
  62. package/dist/commands/status.js.map +1 -0
  63. package/dist/commands/upload.d.ts +42 -0
  64. package/dist/commands/upload.js +429 -0
  65. package/dist/commands/upload.js.map +1 -0
  66. package/dist/config.d.ts +4 -0
  67. package/dist/config.js +32 -0
  68. package/dist/config.js.map +1 -0
  69. package/dist/detectors.d.ts +43 -0
  70. package/dist/detectors.js +1026 -0
  71. package/dist/detectors.js.map +1 -0
  72. package/dist/git.d.ts +22 -0
  73. package/dist/git.js +68 -0
  74. package/dist/git.js.map +1 -0
  75. package/dist/githook.d.ts +71 -0
  76. package/dist/githook.js +238 -0
  77. package/dist/githook.js.map +1 -0
  78. package/dist/hook.d.ts +39 -0
  79. package/dist/hook.js +173 -0
  80. package/dist/hook.js.map +1 -0
  81. package/dist/index.d.ts +2 -0
  82. package/dist/index.js +205 -0
  83. package/dist/index.js.map +1 -0
  84. package/dist/log.d.ts +19 -0
  85. package/dist/log.js +97 -0
  86. package/dist/log.js.map +1 -0
  87. package/dist/mask-paths.d.ts +75 -0
  88. package/dist/mask-paths.js +364 -0
  89. package/dist/mask-paths.js.map +1 -0
  90. package/dist/pairing.d.ts +60 -0
  91. package/dist/pairing.js +137 -0
  92. package/dist/pairing.js.map +1 -0
  93. package/dist/parser.d.ts +48 -0
  94. package/dist/parser.js +516 -0
  95. package/dist/parser.js.map +1 -0
  96. package/dist/paths.d.ts +41 -0
  97. package/dist/paths.js +181 -0
  98. package/dist/paths.js.map +1 -0
  99. package/dist/plan.d.ts +25 -0
  100. package/dist/plan.js +39 -0
  101. package/dist/plan.js.map +1 -0
  102. package/dist/queue.d.ts +26 -0
  103. package/dist/queue.js +120 -0
  104. package/dist/queue.js.map +1 -0
  105. package/dist/redact.d.ts +29 -0
  106. package/dist/redact.js +254 -0
  107. package/dist/redact.js.map +1 -0
  108. package/dist/spawn.d.ts +13 -0
  109. package/dist/spawn.js +32 -0
  110. package/dist/spawn.js.map +1 -0
  111. package/dist/stage0.d.ts +20 -0
  112. package/dist/stage0.js +90 -0
  113. package/dist/stage0.js.map +1 -0
  114. package/dist/state.d.ts +84 -0
  115. package/dist/state.js +150 -0
  116. package/dist/state.js.map +1 -0
  117. package/dist/test/analyze.test.d.ts +1 -0
  118. package/dist/test/analyze.test.js +408 -0
  119. package/dist/test/analyze.test.js.map +1 -0
  120. package/dist/test/check.test.d.ts +1 -0
  121. package/dist/test/check.test.js +193 -0
  122. package/dist/test/check.test.js.map +1 -0
  123. package/dist/test/cli.test.d.ts +1 -0
  124. package/dist/test/cli.test.js +132 -0
  125. package/dist/test/cli.test.js.map +1 -0
  126. package/dist/test/codex.test.d.ts +1 -0
  127. package/dist/test/codex.test.js +585 -0
  128. package/dist/test/codex.test.js.map +1 -0
  129. package/dist/test/commit.test.d.ts +1 -0
  130. package/dist/test/commit.test.js +430 -0
  131. package/dist/test/commit.test.js.map +1 -0
  132. package/dist/test/git.test.d.ts +1 -0
  133. package/dist/test/git.test.js +75 -0
  134. package/dist/test/git.test.js.map +1 -0
  135. package/dist/test/health.test.d.ts +1 -0
  136. package/dist/test/health.test.js +156 -0
  137. package/dist/test/health.test.js.map +1 -0
  138. package/dist/test/hook.test.d.ts +1 -0
  139. package/dist/test/hook.test.js +144 -0
  140. package/dist/test/hook.test.js.map +1 -0
  141. package/dist/test/kimi.test.d.ts +1 -0
  142. package/dist/test/kimi.test.js +349 -0
  143. package/dist/test/kimi.test.js.map +1 -0
  144. package/dist/test/mask-paths.test.d.ts +1 -0
  145. package/dist/test/mask-paths.test.js +230 -0
  146. package/dist/test/mask-paths.test.js.map +1 -0
  147. package/dist/test/notes.test.d.ts +1 -0
  148. package/dist/test/notes.test.js +41 -0
  149. package/dist/test/notes.test.js.map +1 -0
  150. package/dist/test/pairing.test.d.ts +1 -0
  151. package/dist/test/pairing.test.js +138 -0
  152. package/dist/test/pairing.test.js.map +1 -0
  153. package/dist/test/parser.test.d.ts +1 -0
  154. package/dist/test/parser.test.js +312 -0
  155. package/dist/test/parser.test.js.map +1 -0
  156. package/dist/test/plan.test.d.ts +1 -0
  157. package/dist/test/plan.test.js +34 -0
  158. package/dist/test/plan.test.js.map +1 -0
  159. package/dist/test/redact.test.d.ts +1 -0
  160. package/dist/test/redact.test.js +303 -0
  161. package/dist/test/redact.test.js.map +1 -0
  162. package/dist/test/settings.test.d.ts +1 -0
  163. package/dist/test/settings.test.js +32 -0
  164. package/dist/test/settings.test.js.map +1 -0
  165. package/dist/test/stage0.test.d.ts +1 -0
  166. package/dist/test/stage0.test.js +607 -0
  167. package/dist/test/stage0.test.js.map +1 -0
  168. package/dist/test/sweep.test.d.ts +1 -0
  169. package/dist/test/sweep.test.js +298 -0
  170. package/dist/test/sweep.test.js.map +1 -0
  171. package/dist/test/update.test.d.ts +1 -0
  172. package/dist/test/update.test.js +26 -0
  173. package/dist/test/update.test.js.map +1 -0
  174. package/dist/test/upload.test.d.ts +1 -0
  175. package/dist/test/upload.test.js +331 -0
  176. package/dist/test/upload.test.js.map +1 -0
  177. package/dist/types.d.ts +142 -0
  178. package/dist/types.js +2 -0
  179. package/dist/types.js.map +1 -0
  180. package/dist/update.d.ts +17 -0
  181. package/dist/update.js +46 -0
  182. package/dist/update.js.map +1 -0
  183. package/package.json +60 -0
  184. package/src/agents/claude.ts +89 -0
  185. package/src/agents/codex-records.ts +533 -0
  186. package/src/agents/codex.ts +238 -0
  187. package/src/agents/index.ts +58 -0
  188. package/src/agents/kimi-records.ts +274 -0
  189. package/src/agents/kimi-wire.ts +179 -0
  190. package/src/agents/kimi.ts +390 -0
  191. package/src/agents/types.ts +92 -0
  192. package/src/alert.ts +68 -0
  193. package/src/api.ts +269 -0
  194. package/src/commands/analyze.ts +308 -0
  195. package/src/commands/check.ts +239 -0
  196. package/src/commands/commit.ts +179 -0
  197. package/src/commands/health.ts +444 -0
  198. package/src/commands/init.ts +186 -0
  199. package/src/commands/logout.ts +33 -0
  200. package/src/commands/notes.ts +57 -0
  201. package/src/commands/scan.ts +278 -0
  202. package/src/commands/settings.ts +107 -0
  203. package/src/commands/status.ts +236 -0
  204. package/src/commands/upload.ts +524 -0
  205. package/src/config.ts +33 -0
  206. package/src/detectors.ts +1138 -0
  207. package/src/git.ts +86 -0
  208. package/src/githook.ts +269 -0
  209. package/src/hook.ts +237 -0
  210. package/src/index.ts +229 -0
  211. package/src/log.ts +113 -0
  212. package/src/mask-paths.ts +434 -0
  213. package/src/pairing.ts +190 -0
  214. package/src/parser.ts +581 -0
  215. package/src/paths.ts +191 -0
  216. package/src/plan.ts +56 -0
  217. package/src/queue.ts +145 -0
  218. package/src/redact.ts +335 -0
  219. package/src/spawn.ts +33 -0
  220. package/src/stage0.ts +121 -0
  221. package/src/state.ts +208 -0
  222. package/src/types.ts +165 -0
  223. package/src/update.ts +46 -0
@@ -0,0 +1,158 @@
1
+ import { renameArgs } from "./kimi-records.js";
2
+ /**
3
+ * The second shape a Kimi session can take on disk. Newer builds keep no
4
+ * `context.jsonl` at all: the whole session is one append-only event log at
5
+ * `agents/<name>/wire.jsonl`, whose records are wrapper events rather than
6
+ * messages.
7
+ *
8
+ * Kept apart from the `context.jsonl` reader rather than folded into it: the
9
+ * two formats share no field, and a reader that tried to serve both would
10
+ * guess. Which one a session uses is decided by sniffing its first line.
11
+ *
12
+ * ponytail: a rewind has no representation here that this corpus shows, so the
13
+ * output is one linear chain and `onAbandonedBranch` finds nothing — the
14
+ * content-revert detectors still fire. Graft the branch once a real rewound
15
+ * session shows what marks the fork.
16
+ */
17
+ const CONTENT_EVENTS = new Set(["content.part", "tool.call", "tool.result"]);
18
+ function isObject(value) {
19
+ return typeof value === "object" && value !== null && !Array.isArray(value);
20
+ }
21
+ function asString(value) {
22
+ return typeof value === "string" && value.length > 0 ? value : undefined;
23
+ }
24
+ /** A wire log opens with its own protocol metadata. */
25
+ export function isKimiWireTranscript(firstLine) {
26
+ try {
27
+ const parsed = JSON.parse(firstLine);
28
+ return isObject(parsed) && parsed.type === "metadata" && "protocol_version" in parsed;
29
+ }
30
+ catch {
31
+ return false;
32
+ }
33
+ }
34
+ function stamp(time) {
35
+ if (typeof time !== "number" || !Number.isFinite(time))
36
+ return undefined;
37
+ return new Date(time).toISOString();
38
+ }
39
+ /** Text out of a tool result, which carries `output` and an optional `note`. */
40
+ function resultText(result) {
41
+ if (typeof result === "string")
42
+ return result;
43
+ if (!isObject(result))
44
+ return "";
45
+ return asString(result.output) ?? asString(result.note) ?? "";
46
+ }
47
+ export function wireToClaudeRecords(lines, options) {
48
+ const out = [];
49
+ let index = 0;
50
+ let parent = null;
51
+ const emit = (record) => {
52
+ const uuid = `kimi-${index}`;
53
+ out.push(JSON.stringify({
54
+ ...record,
55
+ uuid,
56
+ parentUuid: parent,
57
+ sessionId: options.sessionId,
58
+ cwd: options.cwd,
59
+ version: options.version ?? "kimi",
60
+ isSidechain: false,
61
+ }));
62
+ parent = uuid;
63
+ index += 1;
64
+ };
65
+ for (const line of lines) {
66
+ const text = line.trim();
67
+ if (!text)
68
+ continue;
69
+ let event;
70
+ try {
71
+ event = JSON.parse(text);
72
+ }
73
+ catch {
74
+ // A half-written last line while the session is still running.
75
+ continue;
76
+ }
77
+ if (!isObject(event))
78
+ continue;
79
+ const timestamp = stamp(event.time);
80
+ // A whole user or assistant message, appended outside the agent loop.
81
+ if (event.type === "context.append_message" && isObject(event.message)) {
82
+ const message = event.message;
83
+ const role = asString(message.role);
84
+ if (role !== "user" && role !== "assistant")
85
+ continue;
86
+ const content = Array.isArray(message.content)
87
+ ? message.content
88
+ .filter((part) => isObject(part) && part.type === "text")
89
+ .map((part) => ({ type: "text", text: asString(part.text) ?? "" }))
90
+ .filter((part) => part.text.length > 0)
91
+ : typeof message.content === "string" && message.content.length > 0
92
+ ? [{ type: "text", text: message.content }]
93
+ : [];
94
+ if (content.length === 0)
95
+ continue;
96
+ emit({ type: role, timestamp, message: { role, content } });
97
+ continue;
98
+ }
99
+ if (event.type !== "context.append_loop_event" || !isObject(event.event))
100
+ continue;
101
+ const inner = event.event;
102
+ const kind = asString(inner.type);
103
+ if (!kind || !CONTENT_EVENTS.has(kind))
104
+ continue;
105
+ if (kind === "content.part" && isObject(inner.part)) {
106
+ const part = inner.part;
107
+ // Kimi calls reasoning "think"; the detectors look for Claude's "thinking".
108
+ const thinking = asString(part.think) ?? asString(part.thinking);
109
+ const said = asString(part.text);
110
+ const block = part.type === "think" && thinking
111
+ ? { type: "thinking", thinking }
112
+ : said
113
+ ? { type: "text", text: said }
114
+ : undefined;
115
+ if (!block)
116
+ continue;
117
+ emit({ type: "assistant", timestamp, message: { role: "assistant", content: [block] } });
118
+ continue;
119
+ }
120
+ if (kind === "tool.call") {
121
+ const name = asString(inner.name);
122
+ const id = asString(inner.toolCallId);
123
+ if (!name || !id)
124
+ continue;
125
+ const args = isObject(inner.args) ? inner.args : {};
126
+ emit({
127
+ type: "assistant",
128
+ timestamp,
129
+ message: {
130
+ role: "assistant",
131
+ // Kimi names the file argument `path`; every downstream detector
132
+ // reads `file_path`, so the rename happens once, here.
133
+ content: [{ type: "tool_use", id, name, input: renameArgs(name, args) }],
134
+ },
135
+ });
136
+ continue;
137
+ }
138
+ const id = asString(inner.toolCallId);
139
+ if (!id)
140
+ continue;
141
+ const output = resultText(inner.result);
142
+ // Kimi 0.38 flags a failed call with `isError`.
143
+ const failed = isObject(inner.result) && (inner.result.isError === true || inner.result.error !== undefined);
144
+ emit({
145
+ type: "user",
146
+ timestamp,
147
+ message: {
148
+ role: "user",
149
+ content: [
150
+ { type: "tool_result", tool_use_id: id, content: output, ...(failed ? { is_error: true } : {}) },
151
+ ],
152
+ },
153
+ toolUseResult: { stdout: output },
154
+ });
155
+ }
156
+ return out;
157
+ }
158
+ //# sourceMappingURL=kimi-wire.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kimi-wire.js","sourceRoot":"","sources":["../../src/agents/kimi-wire.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { Agent } from "./types.js";
2
+ export declare function kimiHome(): string;
3
+ export declare function kimiConfigPath(): string;
4
+ /** Every workspace's sessions, whatever Kimi decides to name the folders. */
5
+ export declare function kimiSessionsRoot(): string;
6
+ export declare const kimiAgent: Agent;
@@ -0,0 +1,332 @@
1
+ import { existsSync } from "node:fs";
2
+ import { access, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
3
+ import { homedir } from "node:os";
4
+ import { basename, dirname, join } from "node:path";
5
+ import { parkAlert } from "../alert.js";
6
+ import { parseLines } from "../parser.js";
7
+ import { pendingAlertPath } from "../paths.js";
8
+ import { redactLines } from "../redact.js";
9
+ import { toClaudeRecords } from "./kimi-records.js";
10
+ import { isKimiWireTranscript, wireToClaudeRecords } from "./kimi-wire.js";
11
+ /** Builds have shipped under both names; take whichever this machine has. */
12
+ const HOME_CANDIDATES = [".kimi", ".kimi-code"];
13
+ export function kimiHome() {
14
+ const override = process.env.KIMI_HOME;
15
+ if (override)
16
+ return override;
17
+ for (const name of HOME_CANDIDATES) {
18
+ const candidate = join(homedir(), name);
19
+ if (existsSync(candidate))
20
+ return candidate;
21
+ }
22
+ return join(homedir(), HOME_CANDIDATES[0]);
23
+ }
24
+ export function kimiConfigPath() {
25
+ return join(kimiHome(), "config.toml");
26
+ }
27
+ /** Every workspace's sessions, whatever Kimi decides to name the folders. */
28
+ export function kimiSessionsRoot() {
29
+ return join(kimiHome(), "sessions");
30
+ }
31
+ function isObject(value) {
32
+ return typeof value === "object" && value !== null && !Array.isArray(value);
33
+ }
34
+ async function subdirectories(dir) {
35
+ try {
36
+ const entries = await readdir(dir, { withFileTypes: true });
37
+ return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
38
+ }
39
+ catch {
40
+ return [];
41
+ }
42
+ }
43
+ /** The transcript inside a session folder, whichever layout this build uses. */
44
+ async function transcriptIn(dir, state) {
45
+ const agents = isObject(state.agents) ? state.agents : {};
46
+ // `main` is the session's own agent; the rest are sub-agents, whose logs are
47
+ // sidechains and not this session's transcript.
48
+ const home = isObject(agents.main) && typeof agents.main.homedir === "string"
49
+ ? agents.main.homedir
50
+ : join(dir, "agents", "main");
51
+ for (const candidate of [join(home, "wire.jsonl"), join(dir, "context.jsonl")]) {
52
+ try {
53
+ if ((await stat(candidate)).isFile())
54
+ return candidate;
55
+ }
56
+ catch {
57
+ continue;
58
+ }
59
+ }
60
+ return undefined;
61
+ }
62
+ /** Everything Kimi records about a session outside its transcript. */
63
+ async function readState(dir) {
64
+ try {
65
+ const parsed = JSON.parse(await readFile(join(dir, "state.json"), "utf8"));
66
+ return isObject(parsed) ? parsed : undefined;
67
+ }
68
+ catch {
69
+ return undefined;
70
+ }
71
+ }
72
+ /**
73
+ * What the session calls itself: `state.json` first, the folder it sits in
74
+ * second. One rule, because a session listed under one name and parsed under
75
+ * another is a session nothing can match up.
76
+ */
77
+ function sessionIdOf(state, dir) {
78
+ const id = state?.id;
79
+ return typeof id === "string" && id.length > 0 ? id : basename(dir);
80
+ }
81
+ /** Where the session ran, which is the root every path in it is relative to. */
82
+ function recordedCwd(state) {
83
+ return typeof state?.cwd === "string" ? state.cwd : undefined;
84
+ }
85
+ async function readSession(dir) {
86
+ const state = await readState(dir);
87
+ if (!state)
88
+ return undefined;
89
+ const transcript = await transcriptIn(dir, state);
90
+ if (!transcript)
91
+ return undefined;
92
+ return { sessionId: sessionIdOf(state, dir), transcript, cwd: recordedCwd(state) };
93
+ }
94
+ /**
95
+ * Kimi sessions as the rest of isy sees one: newest first, with the working
96
+ * directory `state.json` recorded already attached, because reading it is what
97
+ * listing a Kimi session costs anyway.
98
+ *
99
+ * Takes the sessions rather than finding them, so a caller that only wants one
100
+ * directory filters first and pays no `stat` for the rest.
101
+ */
102
+ async function discovered(sessions) {
103
+ const found = [];
104
+ for (const session of sessions) {
105
+ try {
106
+ const info = await stat(session.transcript);
107
+ found.push({
108
+ sessionId: session.sessionId,
109
+ path: session.transcript,
110
+ sizeBytes: info.size,
111
+ modifiedAt: info.mtime,
112
+ cwd: session.cwd,
113
+ });
114
+ }
115
+ catch {
116
+ continue;
117
+ }
118
+ }
119
+ found.sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
120
+ return found;
121
+ }
122
+ /** Every session on this machine, in no particular order. */
123
+ async function allSessions() {
124
+ const root = kimiSessionsRoot();
125
+ const found = [];
126
+ for (const workspace of await subdirectories(root)) {
127
+ const dir = join(root, workspace);
128
+ for (const name of await subdirectories(dir)) {
129
+ const session = await readSession(join(dir, name));
130
+ if (session)
131
+ found.push(session);
132
+ }
133
+ }
134
+ return found;
135
+ }
136
+ const BEGIN = "# isy:begin — managed by isy, do not edit inside this block";
137
+ const END = "# isy:end";
138
+ function drainCommand() {
139
+ const path = pendingAlertPath();
140
+ return `if [ -s "${path}" ]; then cat "${path}"; : > "${path}"; fi`;
141
+ }
142
+ function kimiHooks() {
143
+ return [
144
+ {
145
+ event: "SessionStart",
146
+ command: "npx @nightloom/isy check --hook --agent kimi",
147
+ superseded: ["npx isy check --hook --agent kimi"],
148
+ },
149
+ // Kimi 0.38 sends no `client_type`, so the hook says who fired it.
150
+ {
151
+ event: "SessionEnd",
152
+ command: "npx @nightloom/isy upload --hook --agent kimi",
153
+ superseded: ["npx isy upload --hook", "npx isy upload --hook --agent kimi"],
154
+ },
155
+ // SessionStart and SessionEnd are observation-only in Kimi and their stdout
156
+ // is discarded, so an alert that could not reach the terminal directly is
157
+ // parked in a file. UserPromptSubmit *is* blockable, so its stdout is shown:
158
+ // this drains the backlog. Kept as shell — it runs on every prompt, and
159
+ // `npx @nightloom/isy` would add ~380ms of node startup to each one.
160
+ { event: "UserPromptSubmit", command: drainCommand() },
161
+ ];
162
+ }
163
+ function managedBlock() {
164
+ const entries = kimiHooks()
165
+ .map((hook) => `[[hooks]]\nevent = "${hook.event}"\ncommand = '${hook.command}'\ntimeout = 30`)
166
+ .join("\n\n");
167
+ return `${BEGIN}\n${entries}\n${END}`;
168
+ }
169
+ async function readConfigToml() {
170
+ try {
171
+ return await readFile(kimiConfigPath(), "utf8");
172
+ }
173
+ catch {
174
+ return "";
175
+ }
176
+ }
177
+ /**
178
+ * One session as Claude-shaped record lines. context.jsonl is the surviving
179
+ * conversation; wire.jsonl, when present, still holds turns a rewind discarded.
180
+ */
181
+ /**
182
+ * The session id for a transcript path. `wire.jsonl` sits two levels below the
183
+ * session folder (`<session>/agents/main/wire.jsonl`), `context.jsonl` sits
184
+ * directly in it, so the folder to name the session after differs by layout.
185
+ */
186
+ function sessionDirFor(path) {
187
+ const dir = dirname(path);
188
+ return basename(path) === "wire.jsonl" ? dirname(dirname(dir)) : dir;
189
+ }
190
+ /**
191
+ * Kimi puts nothing in the transcript itself, so the id and the working
192
+ * directory both come off the `state.json` beside it — read here through the
193
+ * same two rules `readSession` uses, so a session cannot be called one thing
194
+ * when it is listed and another when it is parsed. Without a working directory
195
+ * no path in the transcript can be made repository-relative
196
+ * (`mask-paths.ts`), so a caller that knows it wins and one that does not,
197
+ * such as `isy analyze`, still gets it here.
198
+ */
199
+ async function kimiRecords(path, given) {
200
+ const lines = (await readFile(path, "utf8")).split("\n");
201
+ const dir = sessionDirFor(path);
202
+ const state = await readState(dir);
203
+ const sessionId = sessionIdOf(state, dir);
204
+ const cwd = given ?? recordedCwd(state);
205
+ // Newer builds keep the whole session as one event log and write no
206
+ // `context.jsonl` at all. The first line says which format this is.
207
+ if (isKimiWireTranscript(lines[0] ?? "")) {
208
+ return wireToClaudeRecords(lines, { sessionId, cwd });
209
+ }
210
+ let wire;
211
+ try {
212
+ wire = (await readFile(join(dirname(path), "wire.jsonl"), "utf8")).split("\n");
213
+ }
214
+ catch {
215
+ wire = undefined;
216
+ }
217
+ return toClaudeRecords(lines, { sessionId, cwd, wire });
218
+ }
219
+ export const kimiAgent = {
220
+ id: "kimi",
221
+ label: "Kimi CLI",
222
+ async present() {
223
+ try {
224
+ await access(kimiHome());
225
+ return true;
226
+ }
227
+ catch {
228
+ return false;
229
+ }
230
+ },
231
+ configLocation() {
232
+ return kimiConfigPath();
233
+ },
234
+ hooks: kimiHooks,
235
+ // Sessions are found by reading each one's cwd, not by deriving a path, so
236
+ // there is no per-directory folder to name. The root is what must be readable.
237
+ transcriptDir() {
238
+ return kimiSessionsRoot();
239
+ },
240
+ transcriptRoot: kimiSessionsRoot,
241
+ async parsedSession(path, cwd) {
242
+ const session = parseLines(await kimiRecords(path, cwd));
243
+ session.filePath = path;
244
+ return session;
245
+ },
246
+ async sessionsIn(cwd) {
247
+ return discovered((await allSessions()).filter((session) => session.cwd === cwd));
248
+ },
249
+ // Kimi reads `state.json` to list anything at all, so unlike the other two
250
+ // adapters the working directory comes for free with the listing — which is
251
+ // why `DiscoveredSession` carries it and a sweep never asks `cwdOf` again.
252
+ async allSessions() {
253
+ return discovered(await allSessions());
254
+ },
255
+ async cwdOf(path) {
256
+ return recordedCwd(await readState(sessionDirFor(path)));
257
+ },
258
+ // Kimi's hook payload carries no transcript path, so compose it from the
259
+ // session id and cwd it does send, and fall back to the newest session.
260
+ async transcriptFor(hook, cwd) {
261
+ const sessionId = hook?.session_id;
262
+ if (sessionId) {
263
+ // Matched by id across every workspace: a session resumed from another
264
+ // directory keeps its id but moves, and the id is the thing we were told.
265
+ const exact = (await allSessions()).find((session) => session.sessionId === sessionId);
266
+ if (exact)
267
+ return exact.transcript;
268
+ }
269
+ return (await kimiAgent.sessionsIn(hook?.cwd ?? cwd))[0]?.path;
270
+ },
271
+ async redactedLines(path, options) {
272
+ const records = await kimiRecords(path, options.cwd);
273
+ return redactLines(records, { extraPatterns: options.extraPatterns, cwd: options.cwd }).lines;
274
+ },
275
+ async hooksInstalled() {
276
+ const contents = await readConfigToml();
277
+ return kimiHooks()
278
+ .filter((hook) => [hook.command, ...(hook.superseded ?? [])].some((command) => contents.includes(command)))
279
+ .map((hook) => hook.event);
280
+ },
281
+ async installHooks() {
282
+ const contents = await readConfigToml();
283
+ const desired = managedBlock();
284
+ const start = contents.indexOf(BEGIN);
285
+ if (start >= 0) {
286
+ const stop = contents.indexOf(END, start);
287
+ const existing = stop >= 0 ? contents.slice(start, stop + END.length) : undefined;
288
+ if (existing === desired)
289
+ return "already-present";
290
+ if (existing !== undefined) {
291
+ // An older isy wrote different commands for the same job: replace them.
292
+ await writeConfigToml(contents.replace(existing, desired));
293
+ return "installed";
294
+ }
295
+ }
296
+ const separator = contents.length === 0 || contents.endsWith("\n") ? "" : "\n";
297
+ await writeConfigToml(`${contents}${separator}${contents.length > 0 ? "\n" : ""}${desired}\n`);
298
+ return "installed";
299
+ },
300
+ async removeHooks() {
301
+ const contents = await readConfigToml();
302
+ const start = contents.indexOf(BEGIN);
303
+ if (start < 0)
304
+ return "absent";
305
+ const stop = contents.indexOf(END, start);
306
+ if (stop < 0)
307
+ return "absent";
308
+ const before = contents.slice(0, start).replace(/\n+$/, "\n");
309
+ const after = contents.slice(stop + END.length).replace(/^\n+/, "");
310
+ await writeConfigToml(`${before}${after}`);
311
+ return "removed";
312
+ },
313
+ // Kimi discards hook stdout on the events we care about, so write straight to
314
+ // the terminal. SessionEnd fires after the session closes, so the TUI is down
315
+ // and the line lands in the shell. With no terminal to write to — CI, a piped
316
+ // run — park it for the UserPromptSubmit drain instead of losing it.
317
+ async deliver(message) {
318
+ try {
319
+ await writeFile("/dev/tty", `${message}\n`);
320
+ return;
321
+ }
322
+ catch {
323
+ // No controlling terminal.
324
+ }
325
+ await parkAlert(message);
326
+ },
327
+ };
328
+ async function writeConfigToml(contents) {
329
+ await mkdir(kimiHome(), { recursive: true });
330
+ await writeFile(kimiConfigPath(), contents, "utf8");
331
+ }
332
+ //# sourceMappingURL=kimi.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kimi.js","sourceRoot":"","sources":["../../src/agents/kimi.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ import type { DiscoveredSession, ParsedSession, SessionFile } from "../types.js";
2
+ export type AgentId = "claude" | "kimi" | "codex";
3
+ /**
4
+ * What a CLI hands us on stdin when it fires a hook. Claude Code and Codex CLI
5
+ * both send `transcript_path` under the same field names; Kimi sends no path,
6
+ * and only its older builds name themselves in `client_type` (see `detectAgent`).
7
+ * Because Codex's payload is indistinguishable from Claude's, its hooks pass
8
+ * `--agent codex` explicitly.
9
+ */
10
+ export interface HookInput {
11
+ session_id?: string;
12
+ transcript_path?: string;
13
+ cwd?: string;
14
+ hook_event_name?: string;
15
+ client_type?: string;
16
+ }
17
+ export interface AgentHook {
18
+ event: string;
19
+ command: string;
20
+ /** Commands an older isy wrote for the same job: replace, never stack. */
21
+ superseded?: string[];
22
+ }
23
+ /**
24
+ * One coding CLI ISY can watch. Only the parts that genuinely differ between
25
+ * CLIs live here — parsing, redaction, detectors and upload are shared.
26
+ */
27
+ export interface Agent {
28
+ id: AgentId;
29
+ label: string;
30
+ /** Is this CLI actually installed? We never write config for one that is not. */
31
+ present(): Promise<boolean>;
32
+ /** Where this agent's hooks live, for messages to the user. */
33
+ configLocation(): string;
34
+ hooks(): AgentHook[];
35
+ /** Where this agent keeps transcripts for a working directory. */
36
+ transcriptDir(cwd: string): string;
37
+ /**
38
+ * The directory every session of this agent lives under, whatever directory
39
+ * it ran in. For Claude that is the parent of the per-project folders; for
40
+ * the other two it is the same thing `transcriptDir` already returns.
41
+ */
42
+ transcriptRoot(): string;
43
+ /** Every session recorded for a working directory, newest first. */
44
+ sessionsIn(cwd: string): Promise<SessionFile[]>;
45
+ /**
46
+ * Every session this CLI recorded on this machine, newest first, without
47
+ * opening any of them. What a sweep starts from: a desktop app fires no hook
48
+ * and names no working directory, so there is nothing to scope the scan to.
49
+ *
50
+ * `cwd` comes back set only where listing already had to read it (Kimi).
51
+ */
52
+ allSessions(): Promise<DiscoveredSession[]>;
53
+ /**
54
+ * Where one session ran, for the adapters whose listing does not know. Separate
55
+ * from `allSessions` on purpose: it costs a read, and a sweep only needs it for
56
+ * the sessions that grew since last time.
57
+ */
58
+ cwdOf(path: string): Promise<string | undefined>;
59
+ /** Parse one transcript without redacting it — for local inspection only. */
60
+ parsedSession(path: string, cwd?: string): Promise<ParsedSession>;
61
+ /** Resolve the transcript this hook invocation is about. */
62
+ transcriptFor(hook: HookInput | undefined, cwd: string): Promise<string | undefined>;
63
+ /**
64
+ * Redacted, Claude-record-shaped JSONL lines, ready for parseLines and upload.
65
+ * Agents whose native format differs normalize here, so everything downstream
66
+ * — including the server's own parseLines — sees one shape.
67
+ */
68
+ redactedLines(path: string, options: {
69
+ extraPatterns?: readonly string[];
70
+ cwd?: string;
71
+ }): Promise<string[]>;
72
+ /** Anything the user must still do after hooks are written, if anything. */
73
+ afterInstall?: string;
74
+ hooksInstalled(): Promise<string[]>;
75
+ installHooks(): Promise<"installed" | "already-present">;
76
+ removeHooks(): Promise<"removed" | "absent">;
77
+ /**
78
+ * Show one line to the user. Each CLI displays text its own way, and the same
79
+ * CLI can differ per event: Codex renders a hook's stdout at SessionStart but
80
+ * discards it at SessionEnd, so the event decides the route.
81
+ */
82
+ deliver(message: string, event?: string): Promise<void>;
83
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * One line to the developer that had nowhere to go at the moment it happened.
3
+ *
4
+ * Three things produce such a line: Kimi and Codex discard hook stdout on their
5
+ * lifecycle events, and a sweep runs detached from any CLI at all — nobody is
6
+ * watching its stdout. A parked line is shown at the next SessionStart, which
7
+ * is the next time this developer is looking at a CLI rather than mid-thought.
8
+ *
9
+ * Never throws: an alert is not worth breaking a session over.
10
+ */
11
+ export declare function parkAlert(message: string): Promise<void>;
12
+ /**
13
+ * The parked lines, taken rather than read: the file is renamed first, so a
14
+ * park landing between the read and the truncate is not lost — it creates a
15
+ * fresh file the next drain picks up. Two CLIs starting at once means one of
16
+ * them wins the rename and shows the backlog; neither shows it twice.
17
+ *
18
+ * A claim that cannot then be read is put back. Stranding it would lose every
19
+ * line in it silently, and a `.claimed-<pid>` nobody reads is not a backlog,
20
+ * it is litter.
21
+ */
22
+ export declare function drainAlerts(): Promise<string>;
23
+ /** What to show now, with anything parked earlier ahead of it. */
24
+ export declare function withParkedAlerts(message: string): Promise<string>;