genaicode 2.33.0 → 2.35.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 (194) hide show
  1. package/README.md +1 -0
  2. package/dist/agents/artifacts.d.ts +1 -1
  3. package/dist/agents/artifacts.js +4 -65
  4. package/dist/agents/artifacts.js.map +1 -1
  5. package/dist/agents/cli-agent.d.ts +3 -0
  6. package/dist/agents/cli-agent.js +1 -0
  7. package/dist/agents/cli-agent.js.map +1 -1
  8. package/dist/agents/drivers/anthropic-managed.d.ts +145 -0
  9. package/dist/agents/drivers/anthropic-managed.js +799 -0
  10. package/dist/agents/drivers/anthropic-managed.js.map +1 -0
  11. package/dist/agents/drivers/antigravity.js +2 -0
  12. package/dist/agents/drivers/antigravity.js.map +1 -1
  13. package/dist/agents/drivers/claude.js +2 -0
  14. package/dist/agents/drivers/claude.js.map +1 -1
  15. package/dist/agents/drivers/codex-live.js +2 -0
  16. package/dist/agents/drivers/codex-live.js.map +1 -1
  17. package/dist/agents/drivers/codex.js +2 -0
  18. package/dist/agents/drivers/codex.js.map +1 -1
  19. package/dist/agents/drivers/copilot.js +2 -0
  20. package/dist/agents/drivers/copilot.js.map +1 -1
  21. package/dist/agents/drivers/cursor-cloud.d.ts +78 -0
  22. package/dist/agents/drivers/cursor-cloud.js +523 -0
  23. package/dist/agents/drivers/cursor-cloud.js.map +1 -0
  24. package/dist/agents/drivers/cursor.js +2 -0
  25. package/dist/agents/drivers/cursor.js.map +1 -1
  26. package/dist/agents/drivers/gemini-managed.d.ts +78 -0
  27. package/dist/agents/drivers/gemini-managed.js +528 -0
  28. package/dist/agents/drivers/gemini-managed.js.map +1 -0
  29. package/dist/agents/drivers/gemini.js +2 -0
  30. package/dist/agents/drivers/gemini.js.map +1 -1
  31. package/dist/agents/drivers/managed-http.d.ts +28 -0
  32. package/dist/agents/drivers/managed-http.js +142 -0
  33. package/dist/agents/drivers/managed-http.js.map +1 -0
  34. package/dist/agents/drivers/muse-live.js +2 -0
  35. package/dist/agents/drivers/muse-live.js.map +1 -1
  36. package/dist/agents/drivers/muse.js +2 -0
  37. package/dist/agents/drivers/muse.js.map +1 -1
  38. package/dist/agents/drivers/openai-managed.d.ts +79 -0
  39. package/dist/agents/drivers/openai-managed.js +404 -0
  40. package/dist/agents/drivers/openai-managed.js.map +1 -0
  41. package/dist/agents/drivers/opencode.js +2 -0
  42. package/dist/agents/drivers/opencode.js.map +1 -1
  43. package/dist/agents/drivers/vibe.js +2 -0
  44. package/dist/agents/drivers/vibe.js.map +1 -1
  45. package/dist/agents/failover.d.ts +19 -1
  46. package/dist/agents/failover.js +63 -2
  47. package/dist/agents/failover.js.map +1 -1
  48. package/dist/agents/hosted.d.ts +5 -1
  49. package/dist/agents/hosted.js +47 -132
  50. package/dist/agents/hosted.js.map +1 -1
  51. package/dist/agents/live-agent.d.ts +3 -0
  52. package/dist/agents/live-agent.js +1 -0
  53. package/dist/agents/live-agent.js.map +1 -1
  54. package/dist/agents/managed.d.ts +157 -0
  55. package/dist/agents/managed.js +562 -0
  56. package/dist/agents/managed.js.map +1 -0
  57. package/dist/agents/mcp-server.d.ts +19 -0
  58. package/dist/agents/mcp-server.js +74 -0
  59. package/dist/agents/mcp-server.js.map +1 -0
  60. package/dist/agents/pack-git.d.ts +23 -0
  61. package/dist/agents/pack-git.js +112 -0
  62. package/dist/agents/pack-git.js.map +1 -0
  63. package/dist/agents/pack.d.ts +68 -0
  64. package/dist/agents/pack.js +611 -0
  65. package/dist/agents/pack.js.map +1 -0
  66. package/dist/agents/runtime.d.ts +5 -1
  67. package/dist/agents/runtime.js +9 -0
  68. package/dist/agents/runtime.js.map +1 -1
  69. package/dist/agents/session.d.ts +10 -0
  70. package/dist/agents/session.js +26 -0
  71. package/dist/agents/session.js.map +1 -1
  72. package/dist/agents/sessions/claude.d.ts +14 -0
  73. package/dist/agents/sessions/claude.js +233 -0
  74. package/dist/agents/sessions/claude.js.map +1 -0
  75. package/dist/agents/sessions/codex-api.d.ts +32 -0
  76. package/dist/agents/sessions/codex-api.js +233 -0
  77. package/dist/agents/sessions/codex-api.js.map +1 -0
  78. package/dist/agents/sessions/codex.d.ts +28 -0
  79. package/dist/agents/sessions/codex.js +430 -0
  80. package/dist/agents/sessions/codex.js.map +1 -0
  81. package/dist/agents/sessions/doctor.d.ts +67 -0
  82. package/dist/agents/sessions/doctor.js +182 -0
  83. package/dist/agents/sessions/doctor.js.map +1 -0
  84. package/dist/agents/sessions/files.d.ts +44 -0
  85. package/dist/agents/sessions/files.js +150 -0
  86. package/dist/agents/sessions/files.js.map +1 -0
  87. package/dist/agents/sessions/group.d.ts +24 -0
  88. package/dist/agents/sessions/group.js +27 -0
  89. package/dist/agents/sessions/group.js.map +1 -0
  90. package/dist/agents/sessions/hooks.d.ts +32 -0
  91. package/dist/agents/sessions/hooks.js +155 -0
  92. package/dist/agents/sessions/hooks.js.map +1 -0
  93. package/dist/agents/sessions/index.d.ts +42 -0
  94. package/dist/agents/sessions/index.js +97 -0
  95. package/dist/agents/sessions/index.js.map +1 -0
  96. package/dist/agents/sessions/live.d.ts +67 -0
  97. package/dist/agents/sessions/live.js +308 -0
  98. package/dist/agents/sessions/live.js.map +1 -0
  99. package/dist/agents/sessions/sqlite.d.ts +12 -0
  100. package/dist/agents/sessions/sqlite.js +61 -0
  101. package/dist/agents/sessions/sqlite.js.map +1 -0
  102. package/dist/agents/sessions/stores.d.ts +38 -0
  103. package/dist/agents/sessions/stores.js +616 -0
  104. package/dist/agents/sessions/stores.js.map +1 -0
  105. package/dist/agents/sessions/transcript.d.ts +20 -0
  106. package/dist/agents/sessions/transcript.js +134 -0
  107. package/dist/agents/sessions/transcript.js.map +1 -0
  108. package/dist/agents/sessions/types.d.ts +95 -0
  109. package/dist/agents/sessions/types.js +2 -0
  110. package/dist/agents/sessions/types.js.map +1 -0
  111. package/dist/agents/types.d.ts +31 -0
  112. package/dist/agents.d.ts +17 -1
  113. package/dist/agents.js +9 -1
  114. package/dist/agents.js.map +1 -1
  115. package/dist/backend/backend.d.ts +131 -0
  116. package/dist/backend/backend.js +773 -0
  117. package/dist/backend/backend.js.map +1 -0
  118. package/dist/backend/limiter.d.ts +34 -0
  119. package/dist/backend/limiter.js +76 -0
  120. package/dist/backend/limiter.js.map +1 -0
  121. package/dist/backend/node.d.ts +10 -0
  122. package/dist/backend/node.js +124 -0
  123. package/dist/backend/node.js.map +1 -0
  124. package/dist/backend/protocol.d.ts +98 -0
  125. package/dist/backend/protocol.js +2 -0
  126. package/dist/backend/protocol.js.map +1 -0
  127. package/dist/backend/seal.d.ts +7 -0
  128. package/dist/backend/seal.js +60 -0
  129. package/dist/backend/seal.js.map +1 -0
  130. package/dist/backend.d.ts +27 -0
  131. package/dist/backend.js +25 -0
  132. package/dist/backend.js.map +1 -0
  133. package/dist/browser/invoke.d.ts +17 -0
  134. package/dist/browser/invoke.js +69 -0
  135. package/dist/browser/invoke.js.map +1 -0
  136. package/dist/browser/nano.d.ts +10 -0
  137. package/dist/browser/nano.js +10 -56
  138. package/dist/browser/nano.js.map +1 -1
  139. package/dist/browser/page-agent.d.ts +7 -0
  140. package/dist/browser/page-agent.js +26 -5
  141. package/dist/browser/page-agent.js.map +1 -1
  142. package/dist/browser/remote.d.ts +44 -0
  143. package/dist/browser/remote.js +372 -0
  144. package/dist/browser/remote.js.map +1 -0
  145. package/dist/browser.d.ts +9 -2
  146. package/dist/browser.js +8 -2
  147. package/dist/browser.js.map +1 -1
  148. package/dist/cli/args.d.ts +26 -0
  149. package/dist/cli/args.js +66 -0
  150. package/dist/cli/args.js.map +1 -1
  151. package/dist/cli/hook.d.ts +7 -0
  152. package/dist/cli/hook.js +21 -0
  153. package/dist/cli/hook.js.map +1 -0
  154. package/dist/cli/main.d.ts +3 -1
  155. package/dist/cli/main.js +237 -2
  156. package/dist/cli/main.js.map +1 -1
  157. package/dist/cli.js +31 -21
  158. package/dist/cli.js.map +1 -1
  159. package/dist/core/types.d.ts +5 -0
  160. package/dist/core/types.js.map +1 -1
  161. package/dist/index.d.ts +1 -1
  162. package/dist/index.js +1 -1
  163. package/dist/index.js.map +1 -1
  164. package/dist/providers/google-converter.js +21 -8
  165. package/dist/providers/google-converter.js.map +1 -1
  166. package/dist/providers/google.js +7 -10
  167. package/dist/providers/google.js.map +1 -1
  168. package/dist/providers/openai-converter.js +3 -2
  169. package/dist/providers/openai-converter.js.map +1 -1
  170. package/dist/providers/openai-responses-converter.d.ts +35 -0
  171. package/dist/providers/openai-responses-converter.js +188 -0
  172. package/dist/providers/openai-responses-converter.js.map +1 -0
  173. package/dist/providers/openai.d.ts +6 -1
  174. package/dist/providers/openai.js +16 -1
  175. package/dist/providers/openai.js.map +1 -1
  176. package/dist/providers.d.ts +1 -0
  177. package/dist/providers.js +1 -0
  178. package/dist/providers.js.map +1 -1
  179. package/dist/react/page-agent-chat.js +6 -2
  180. package/dist/react/page-agent-chat.js.map +1 -1
  181. package/dist/ui/index.js +109 -82
  182. package/dist/ui/sessions.d.ts +19 -0
  183. package/dist/ui/sessions.js +59 -0
  184. package/dist/ui/sessions.js.map +1 -0
  185. package/dist/ui/web-client.js +15 -14
  186. package/docs/CHANGELOG.md +51 -388
  187. package/docs/agents.md +417 -2
  188. package/docs/backend.md +125 -0
  189. package/docs/browser.md +6 -1
  190. package/docs/changelog-2.26-and-older.md +441 -0
  191. package/docs/cli.md +39 -0
  192. package/docs/llm.md +6 -1
  193. package/docs/pivot.md +1 -1
  194. package/package.json +5 -1
@@ -0,0 +1,182 @@
1
+ import { execFile } from 'node:child_process';
2
+ import { stat } from 'node:fs/promises';
3
+ import { HOOK_AGENTS, hooksStatus } from './hooks.js';
4
+ import { readLive } from './live.js';
5
+ const DAY_MS = 24 * 60 * 60 * 1000;
6
+ /** Fewer sessions than this say too little about a store to call its format changed. */
7
+ const MIN_FOR_SHARES = 5;
8
+ /** Fewer conversations than this prove nothing by being empty or unanswered. */
9
+ const MIN_READS = 3;
10
+ /** Readers fill in the latest prompt of about this many newest sessions; older ones may lack it. */
11
+ const JUDGED = 200;
12
+ /**
13
+ * Check that each source still reads its agent's store: how many sessions it lists, how many of
14
+ * them have what a listing needs, and whether the newest conversations open. An agent's update can
15
+ * change its store without notice; this is how to see it. The result holds counts only.
16
+ */
17
+ export async function checkSessions(sources, options = {}) {
18
+ const now = options.now ?? Date.now();
19
+ const env = options.env ?? process.env;
20
+ const live = await readLive(env, now).catch(() => new Map());
21
+ return Promise.all(sources.map(async (source) => {
22
+ const check = {
23
+ source: source.name,
24
+ where: source.where,
25
+ newer: false,
26
+ listed: 0,
27
+ withPrompt: 0,
28
+ withCwd: 0,
29
+ withState: 0,
30
+ sampled: 0,
31
+ read: 0,
32
+ withReply: 0,
33
+ withTools: 0,
34
+ problems: [],
35
+ notes: [],
36
+ };
37
+ if (source.verified !== undefined)
38
+ check.verified = source.verified;
39
+ const version = await options.version?.(source).catch(() => undefined);
40
+ if (version !== undefined)
41
+ check.version = version;
42
+ check.newer = version !== undefined && source.verified !== undefined && isNewer(version, source.verified);
43
+ const query = { env, since: options.since ?? now - 30 * DAY_MS, live: false };
44
+ if (options.signal)
45
+ query.signal = options.signal;
46
+ let sessions;
47
+ try {
48
+ sessions = await source.list(query);
49
+ }
50
+ catch (error) {
51
+ check.problems.push(`cannot list: ${errorKind(error)}`);
52
+ return check;
53
+ }
54
+ check.listed = sessions.length;
55
+ check.withPrompt = sessions.filter(hasPrompt).length;
56
+ check.withCwd = sessions.filter((session) => session.cwd !== undefined).length;
57
+ check.withState = sessions.filter((session) => session.state !== undefined).length;
58
+ // Judged on the newest ones: a reader may fill in only those from the conversations.
59
+ const newest = [...sessions].sort((a, b) => b.updatedAt - a.updatedAt).slice(0, JUDGED);
60
+ if (newest.length >= MIN_FOR_SHARES) {
61
+ const prompts = newest.filter(hasPrompt).length;
62
+ const dirs = newest.filter((session) => session.cwd !== undefined).length;
63
+ const of = `of the ${newest.length} newest sessions`;
64
+ if (prompts * 2 < newest.length)
65
+ check.problems.push(`only ${prompts} ${of} have a prompt or a title`);
66
+ if (source.where === 'local' && dirs * 2 < newest.length) {
67
+ check.problems.push(`only ${dirs} ${of} have a directory`);
68
+ }
69
+ }
70
+ if (options.reference && source.reference) {
71
+ const asked = await source.reference(query).catch(() => undefined);
72
+ if (asked) {
73
+ const have = new Set(sessions.map((session) => session.id));
74
+ const missing = asked.filter((session) => !have.has(session.id)).length;
75
+ check.reference = { listed: asked.length, missing };
76
+ if (asked.length >= MIN_FOR_SHARES && missing * 10 > asked.length) {
77
+ check.problems.push(`${source.name} itself lists ${asked.length} sessions; ${missing} of them were not read`);
78
+ }
79
+ }
80
+ else
81
+ check.notes.push(`${source.name} could not be asked for its sessions`);
82
+ }
83
+ if (source.read) {
84
+ // Sessions with a prompt surely have a conversation to open; the others fill the sample,
85
+ // so a store whose listing lost its prompts still has its conversations tried.
86
+ const chosen = [...newest.filter(hasPrompt), ...newest.filter((session) => !hasPrompt(session))].slice(0, options.sample ?? 5);
87
+ check.sampled = chosen.length;
88
+ let failed = false;
89
+ for (const session of chosen) {
90
+ const turns = await source.read(session, { maxTurns: 20 }).catch(() => {
91
+ failed = true;
92
+ return [];
93
+ });
94
+ if (!turns.length)
95
+ continue;
96
+ check.read += 1;
97
+ const entries = turns.flatMap((turn) => turn.entries);
98
+ if (entries.some((entry) => entry.kind === 'text'))
99
+ check.withReply += 1;
100
+ if (entries.some((entry) => entry.kind === 'tool'))
101
+ check.withTools += 1;
102
+ }
103
+ if (check.sampled && !check.read) {
104
+ const none = `none of the ${check.sampled} newest conversations could be read`;
105
+ // One or two that give nothing may be empty, or longer than a reader looks back; a
106
+ // read that failed, or several sessions with a prompt and nothing in them, is a change.
107
+ if (failed || (check.sampled >= MIN_READS && chosen.some(hasPrompt)))
108
+ check.problems.push(none);
109
+ else
110
+ check.notes.push(`${none}: empty or very long sessions, or a store that changed`);
111
+ }
112
+ else if (check.read && !check.withReply) {
113
+ const none = `no agent message in the ${check.read} conversations read`;
114
+ // A prompt nobody answered yet is a healthy session; several of them in a row are not.
115
+ if (check.read >= MIN_READS)
116
+ check.problems.push(none);
117
+ else
118
+ check.notes.push(`${none}: not answered yet, or a store that changed`);
119
+ }
120
+ else if (check.read >= MIN_READS && !check.withTools) {
121
+ check.notes.push(`no tool call in the ${check.read} conversations read`);
122
+ }
123
+ }
124
+ else {
125
+ check.notes.push('conversations cannot be read, only listed');
126
+ }
127
+ if (HOOK_AGENTS.includes(source.name)) {
128
+ const hooks = await hooksStatus(source.name, { env }).catch(() => undefined);
129
+ if (hooks) {
130
+ const reported = [...live.values()].filter((record) => record.agent === source.name).length;
131
+ check.hooks = { installed: hooks.installed, reported };
132
+ // Sessions worked since the hooks went in, yet none of them said anything.
133
+ const since = hooks.installed
134
+ ? await stat(hooks.file).then((file) => file.mtimeMs, () => undefined)
135
+ : undefined;
136
+ const worked = since === undefined ? 0 : sessions.filter((session) => session.updatedAt > since + 60_000).length;
137
+ if (!reported && worked) {
138
+ check.notes.push(`hooks are installed but ${worked} session${worked === 1 ? '' : 's'} active since reported nothing` +
139
+ (source.name === 'codex' ? ' (Codex runs hooks only once trusted under /hooks)' : ''));
140
+ }
141
+ }
142
+ }
143
+ if (check.newer && check.problems.length) {
144
+ check.notes.push(`the CLI (${check.version}) is newer than the one checked (${check.verified}): its store may have changed`);
145
+ }
146
+ return check;
147
+ }));
148
+ }
149
+ /** What went wrong, without the paths and names an error message may carry. */
150
+ function errorKind(error) {
151
+ const code = error?.code;
152
+ if (typeof code === 'string' && code)
153
+ return code;
154
+ const message = error instanceof Error ? error.message : String(error);
155
+ const safe = message
156
+ .split(' ')
157
+ .map((word) => (word.includes('/') || word.includes('\\') ? '<path>' : word))
158
+ .join(' ');
159
+ return safe.length > 120 ? `${safe.slice(0, 119)}…` : safe;
160
+ }
161
+ function hasPrompt(session) {
162
+ return (session.title ?? session.firstPrompt ?? session.lastPrompt) !== undefined;
163
+ }
164
+ /** Whether version `a` is later than `b`, comparing their numbers left to right. */
165
+ export function isNewer(a, b) {
166
+ const [left, right] = [a, b].map((version) => (version.match(/\d+/g) ?? []).map(Number));
167
+ for (let at = 0; at < Math.max(left.length, right.length); at += 1) {
168
+ const difference = (left[at] ?? 0) - (right[at] ?? 0);
169
+ if (difference)
170
+ return difference > 0;
171
+ }
172
+ return false;
173
+ }
174
+ /** The version `command --version` prints, or undefined when it prints none in a few seconds. */
175
+ export function cliVersion(command, env = process.env) {
176
+ return new Promise((resolve) => {
177
+ execFile(command, ['--version'], { env, timeout: 5000, windowsHide: true }, (error, stdout, stderr) => {
178
+ resolve(error ? undefined : /\d+\.\d+(?:\.\d+)?/.exec(`${stdout}\n${stderr}`)?.[0]);
179
+ });
180
+ });
181
+ }
182
+ //# sourceMappingURL=doctor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/agents/sessions/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,wFAAwF;AACxF,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,gFAAgF;AAChF,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,oGAAoG;AACpG,MAAM,MAAM,GAAG,GAAG,CAAC;AAsDnB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAiC,EACjC,UAA+B,EAAE;IAEjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC,GAAG,CAChB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAiB;YAC1B,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;SACV,CAAC;QACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACpE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvE,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QACnD,KAAK,CAAC,KAAK,GAAG,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE1G,MAAM,KAAK,GAAiB,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC5F,IAAI,OAAO,CAAC,MAAM;YAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAClD,IAAI,QAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC/B,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QACrD,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QAC/E,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QACnF,qFAAqF;QACrF,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxF,IAAI,MAAM,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;YAChD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;YAC1E,MAAM,EAAE,GAAG,UAAU,MAAM,CAAC,MAAM,kBAAkB,CAAC;YACrD,IAAI,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM;gBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,OAAO,IAAI,EAAE,2BAA2B,CAAC,CAAC;YACvG,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACzD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,mBAAmB,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACnE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;gBACxE,KAAK,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpD,IAAI,KAAK,CAAC,MAAM,IAAI,cAAc,IAAI,OAAO,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;oBAClE,KAAK,CAAC,QAAQ,CAAC,IAAI,CACjB,GAAG,MAAM,CAAC,IAAI,iBAAiB,KAAK,CAAC,MAAM,cAAc,OAAO,wBAAwB,CACzF,CAAC;gBACJ,CAAC;YACH,CAAC;;gBAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,sCAAsC,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,yFAAyF;YACzF,+EAA+E;YAC/E,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CACpG,CAAC,EACD,OAAO,CAAC,MAAM,IAAI,CAAC,CACpB,CAAC;YACF,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,IAAI,MAAM,GAAG,KAAK,CAAC;YACnB,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBACpE,MAAM,GAAG,IAAI,CAAC;oBACd,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,MAAM;oBAAE,SAAS;gBAC5B,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;gBAChB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;oBAAE,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;gBACzE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;oBAAE,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,eAAe,KAAK,CAAC,OAAO,qCAAqC,CAAC;gBAC/E,mFAAmF;gBACnF,wFAAwF;gBACxF,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;oBAC3F,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,wDAAwD,CAAC,CAAC;YACzF,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,2BAA2B,KAAK,CAAC,IAAI,qBAAqB,CAAC;gBACxE,uFAAuF;gBACvF,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS;oBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;oBAClD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,6CAA6C,CAAC,CAAC;YAC9E,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACvD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,IAAI,qBAAqB,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAChE,CAAC;QAED,IAAK,WAAiC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,IAAiB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1F,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;gBAC5F,KAAK,CAAC,KAAK,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;gBACvD,2EAA2E;gBAC3E,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS;oBAC3B,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CACzB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EACtB,GAAG,EAAE,CAAC,SAAS,CAChB;oBACH,CAAC,CAAC,SAAS,CAAC;gBACd,MAAM,MAAM,GACV,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;gBACpG,IAAI,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACxB,KAAK,CAAC,KAAK,CAAC,IAAI,CACd,2BAA2B,MAAM,WAAW,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,gCAAgC;wBACjG,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,oDAAoD,CAAC,CAAC,CAAC,EAAE,CAAC,CACxF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzC,KAAK,CAAC,KAAK,CAAC,IAAI,CACd,YAAY,KAAK,CAAC,OAAO,oCAAoC,KAAK,CAAC,QAAQ,+BAA+B,CAC3G,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GAAI,KAAmC,EAAE,IAAI,CAAC;IACxD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,OAAO;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC5E,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,OAAoB;IACrC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC;AACpF,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,CAAS,EAAE,CAAS;IAC1C,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzF,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAK,CAAC,MAAM,EAAE,KAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,UAAU,GAAG,CAAC,IAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,IAAI,UAAU;YAAE,OAAO,UAAU,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC9E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACpG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,44 @@
1
+ import type { SessionInfo, SessionQuery } from './types.js';
2
+ export interface SessionFile {
3
+ path: string;
4
+ mtimeMs: number;
5
+ size: number;
6
+ }
7
+ /** Files under `dir` (to `depth` levels) whose name passes `match`, newest first. A missing `dir` is empty. */
8
+ export declare function findFiles(dir: string, depth: number, match: (name: string) => boolean): Promise<SessionFile[]>;
9
+ /**
10
+ * The JSON lines at the start and at the end of a file, without reading the middle of a large
11
+ * one: session logs grow to many megabytes, and what names a session sits at its two ends.
12
+ */
13
+ export declare function headAndTail(file: SessionFile): Promise<{
14
+ head: unknown[];
15
+ tail: unknown[];
16
+ }>;
17
+ /** The same two ends of a transcript that is already in memory. */
18
+ export declare function chunksOf(data: Buffer): {
19
+ head: unknown[];
20
+ tail: unknown[];
21
+ };
22
+ export declare function isRecord(value: unknown): value is Record<string, unknown>;
23
+ /** One line of at most `max` characters. */
24
+ export declare function oneLine(text: string, max?: number): string;
25
+ /** The last `max` characters of `text`, as one line. */
26
+ export declare function ending(text: string, max?: number): string;
27
+ /** Whether `dir` is `root` or inside it. */
28
+ export declare function isWithin(dir: string, root: string): boolean;
29
+ /** Run `task` over `items`, at most `width` at a time, keeping order. */
30
+ export declare function mapLimited<T, R>(items: readonly T[], width: number, task: (item: T) => Promise<R>): Promise<R[]>;
31
+ /** Written to this recently: an agent is probably still working in it. */
32
+ export declare const ACTIVE_MS: number;
33
+ /** Apply a `SessionQuery` to sessions a source read: filter, newest first, cut to `limit`. */
34
+ export declare function select(sessions: SessionInfo[], query: SessionQuery): SessionInfo[];
35
+ /** `state` for a store that only says when a session was last written. */
36
+ export declare function activeIfRecent(updatedAt: number, now?: number): {
37
+ state?: 'active';
38
+ };
39
+ /** A JSON file's value, or undefined when it is missing or broken. */
40
+ export declare function readJson(file: string): Promise<unknown>;
41
+ /** The user's home directory as `env` has it. */
42
+ export declare function homeOf(env: NodeJS.ProcessEnv): string;
43
+ /** Epoch milliseconds of an ISO date string. */
44
+ export declare function timeOf(value: unknown): number | undefined;
@@ -0,0 +1,150 @@
1
+ import { promises as fs } from 'node:fs';
2
+ import { homedir } from 'node:os';
3
+ import path from 'node:path';
4
+ /** Files under `dir` (to `depth` levels) whose name passes `match`, newest first. A missing `dir` is empty. */
5
+ export async function findFiles(dir, depth, match) {
6
+ const found = [];
7
+ const walk = async (current, left) => {
8
+ let entries;
9
+ try {
10
+ entries = await fs.readdir(current, { withFileTypes: true });
11
+ }
12
+ catch {
13
+ return;
14
+ }
15
+ await Promise.all(entries.map(async (entry) => {
16
+ const full = path.join(current, entry.name);
17
+ if (entry.isDirectory()) {
18
+ if (left > 0)
19
+ await walk(full, left - 1);
20
+ }
21
+ else if (entry.isFile() && match(entry.name)) {
22
+ try {
23
+ const stat = await fs.stat(full);
24
+ found.push({ path: full, mtimeMs: Math.round(stat.mtimeMs), size: stat.size });
25
+ }
26
+ catch {
27
+ // Removed while listing.
28
+ }
29
+ }
30
+ }));
31
+ };
32
+ await walk(dir, depth);
33
+ return found.sort((a, b) => b.mtimeMs - a.mtimeMs);
34
+ }
35
+ const CHUNK = 256 * 1024;
36
+ /**
37
+ * The JSON lines at the start and at the end of a file, without reading the middle of a large
38
+ * one: session logs grow to many megabytes, and what names a session sits at its two ends.
39
+ */
40
+ export async function headAndTail(file) {
41
+ const handle = await fs.open(file.path, 'r');
42
+ try {
43
+ if (file.size <= CHUNK * 2) {
44
+ const all = parseLines((await handle.readFile('utf8')).split('\n'));
45
+ return { head: all, tail: all };
46
+ }
47
+ const first = Buffer.alloc(CHUNK);
48
+ const last = Buffer.alloc(CHUNK);
49
+ await handle.read(first, 0, CHUNK, 0);
50
+ await handle.read(last, 0, CHUNK, file.size - CHUNK);
51
+ return cut(first, last);
52
+ }
53
+ finally {
54
+ await handle.close();
55
+ }
56
+ }
57
+ /** The same two ends of a transcript that is already in memory. */
58
+ export function chunksOf(data) {
59
+ if (data.length <= CHUNK * 2) {
60
+ const all = parseLines(data.toString('utf8').split('\n'));
61
+ return { head: all, tail: all };
62
+ }
63
+ return cut(data.subarray(0, CHUNK), data.subarray(data.length - CHUNK));
64
+ }
65
+ // The cut falls inside a line at the end of the head and at the start of the tail.
66
+ function cut(first, last) {
67
+ return {
68
+ head: parseLines(first.toString('utf8').split('\n').slice(0, -1)),
69
+ tail: parseLines(last.toString('utf8').split('\n').slice(1)),
70
+ };
71
+ }
72
+ function parseLines(lines) {
73
+ const values = [];
74
+ for (const line of lines) {
75
+ if (!line.trim())
76
+ continue;
77
+ try {
78
+ values.push(JSON.parse(line));
79
+ }
80
+ catch {
81
+ // A half-written last line.
82
+ }
83
+ }
84
+ return values;
85
+ }
86
+ export function isRecord(value) {
87
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
88
+ }
89
+ /** One line of at most `max` characters. */
90
+ export function oneLine(text, max = 200) {
91
+ const flat = text.replace(/\s+/g, ' ').trim();
92
+ return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
93
+ }
94
+ /** The last `max` characters of `text`, as one line. */
95
+ export function ending(text, max = 200) {
96
+ const flat = text.replace(/\s+/g, ' ').trim();
97
+ return flat.length > max ? `…${flat.slice(flat.length - max + 1)}` : flat;
98
+ }
99
+ /** Whether `dir` is `root` or inside it. */
100
+ export function isWithin(dir, root) {
101
+ const relative = path.relative(root, dir);
102
+ return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
103
+ }
104
+ /** Run `task` over `items`, at most `width` at a time, keeping order. */
105
+ export async function mapLimited(items, width, task) {
106
+ const results = new Array(items.length);
107
+ let next = 0;
108
+ await Promise.all(Array.from({ length: Math.min(width, items.length) }, async () => {
109
+ while (next < items.length) {
110
+ const index = next++;
111
+ results[index] = await task(items[index]);
112
+ }
113
+ }));
114
+ return results;
115
+ }
116
+ /** Written to this recently: an agent is probably still working in it. */
117
+ export const ACTIVE_MS = 2 * 60_000;
118
+ /** Apply a `SessionQuery` to sessions a source read: filter, newest first, cut to `limit`. */
119
+ export function select(sessions, query) {
120
+ const kept = sessions
121
+ .filter((session) => query.since === undefined || session.updatedAt >= query.since)
122
+ .filter((session) => query.cwd === undefined || (!!session.cwd && isWithin(session.cwd, query.cwd)))
123
+ .sort((a, b) => b.updatedAt - a.updatedAt);
124
+ return query.limit === undefined ? kept : kept.slice(0, query.limit);
125
+ }
126
+ /** `state` for a store that only says when a session was last written. */
127
+ export function activeIfRecent(updatedAt, now = Date.now()) {
128
+ return now - updatedAt < ACTIVE_MS ? { state: 'active' } : {};
129
+ }
130
+ /** A JSON file's value, or undefined when it is missing or broken. */
131
+ export async function readJson(file) {
132
+ try {
133
+ return JSON.parse(await fs.readFile(file, 'utf8'));
134
+ }
135
+ catch {
136
+ return undefined;
137
+ }
138
+ }
139
+ /** The user's home directory as `env` has it. */
140
+ export function homeOf(env) {
141
+ return env.HOME ?? env.USERPROFILE ?? homedir();
142
+ }
143
+ /** Epoch milliseconds of an ISO date string. */
144
+ export function timeOf(value) {
145
+ if (typeof value !== 'string')
146
+ return undefined;
147
+ const at = Date.parse(value);
148
+ return Number.isNaN(at) ? undefined : at;
149
+ }
150
+ //# sourceMappingURL=files.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/agents/sessions/files.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import type { SessionInfo } from './types.js';
2
+ export type { SessionInfo };
3
+ export interface SessionListing {
4
+ /** Every source's sessions, newest first. */
5
+ sessions: SessionInfo[];
6
+ /** Sources that could not be read; the others are still listed. */
7
+ errors: Array<{
8
+ source: string;
9
+ message: string;
10
+ }>;
11
+ }
12
+ /** A project: the sessions of every agent that share a directory (or a repository, in the cloud). */
13
+ export interface SessionProject {
14
+ /** The directory or repository. `''` for sessions that name neither. */
15
+ key: string;
16
+ /** Its last path segment, for display. */
17
+ name: string;
18
+ sessions: SessionInfo[];
19
+ updatedAt: number;
20
+ /** Sessions per agent. */
21
+ agents: Record<string, number>;
22
+ }
23
+ /** Group sessions by where they work, newest project first. */
24
+ export declare function groupSessions(sessions: readonly SessionInfo[]): SessionProject[];
@@ -0,0 +1,27 @@
1
+ /** Group sessions by where they work, newest project first. */
2
+ export function groupSessions(sessions) {
3
+ const projects = new Map();
4
+ for (const session of sessions) {
5
+ const place = session.cwd ?? session.repository;
6
+ // A cloud session that names no repository groups under its platform.
7
+ const key = place ?? (session.where === 'cloud' ? `cloud:${session.source}` : '');
8
+ let project = projects.get(key);
9
+ if (!project) {
10
+ const name = place ? lastSegment(place) || place : key ? session.source : '(no directory)';
11
+ projects.set(key, (project = { key, name, sessions: [], updatedAt: 0, agents: {} }));
12
+ }
13
+ project.sessions.push(session);
14
+ project.updatedAt = Math.max(project.updatedAt, session.updatedAt);
15
+ project.agents[session.agent] = (project.agents[session.agent] ?? 0) + 1;
16
+ }
17
+ return [...projects.values()].sort((a, b) => b.updatedAt - a.updatedAt);
18
+ }
19
+ /** The last path segment of a directory or a repository URL, without `.git`. */
20
+ function lastSegment(place) {
21
+ const parts = place
22
+ .replace(/\.git$/, '')
23
+ .split(/[\\/]/)
24
+ .filter(Boolean);
25
+ return parts[parts.length - 1] ?? '';
26
+ }
27
+ //# sourceMappingURL=group.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/agents/sessions/group.ts"],"names":[],"mappings":"AAwBA,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,QAAgC;IAC5D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;QAChD,sEAAsE;QACtE,MAAM,GAAG,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC3F,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACnE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED,gFAAgF;AAChF,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,KAAK;SAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC"}
@@ -0,0 +1,32 @@
1
+ /** The agents whose hooks can report what a session is doing. */
2
+ export declare const HOOK_AGENTS: readonly ["claude", "codex"];
3
+ export type HookAgent = (typeof HOOK_AGENTS)[number];
4
+ export interface HooksOptions {
5
+ env?: NodeJS.ProcessEnv;
6
+ /** The command a hook runs, without the agent: default `"<node>" "<this genaicode's cli.js>" hook`. */
7
+ command?: string;
8
+ }
9
+ export interface HooksStatus {
10
+ agent: HookAgent;
11
+ /** The agent's file the hooks are declared in. */
12
+ file: string;
13
+ /** Events genaicode's hook is installed for. */
14
+ events: string[];
15
+ /** Whether every event is covered by the command this genaicode would install. */
16
+ installed: boolean;
17
+ /** The installed command, when there is one. */
18
+ command?: string;
19
+ }
20
+ /** The file `agent` reads its user-level hooks from. */
21
+ export declare function hooksFile(agent: HookAgent, env?: NodeJS.ProcessEnv): string;
22
+ /** The command line of the hook for `agent`. */
23
+ export declare function hookCommand(agent: HookAgent, command: string): string;
24
+ /** What is installed for `agent` now. */
25
+ export declare function hooksStatus(agent: HookAgent, options?: HooksOptions): Promise<HooksStatus>;
26
+ /**
27
+ * Declare genaicode's hook in the user-level hooks of `agent`, beside whatever is declared there.
28
+ * An earlier install is replaced. The hook only notes what the session is doing (see `recordHook`).
29
+ */
30
+ export declare function installHooks(agent: HookAgent, options?: HooksOptions): Promise<HooksStatus>;
31
+ /** Take genaicode's hook out of the hooks of `agent`. Resolves to whether there was one. */
32
+ export declare function uninstallHooks(agent: HookAgent, options?: HooksOptions): Promise<boolean>;
@@ -0,0 +1,155 @@
1
+ import { promises as fs } from 'node:fs';
2
+ import { homedir } from 'node:os';
3
+ import path from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ /** The agents whose hooks can report what a session is doing. */
6
+ export const HOOK_AGENTS = ['claude', 'codex'];
7
+ /** Ends every hook command genaicode installs: how its own entries are told from the user's. */
8
+ const MARKER = '--genaicode-live';
9
+ /** The events reported, per agent. `SessionEnd` is waited for; the rest run in the background. */
10
+ const EVENTS = {
11
+ claude: [
12
+ 'SessionStart',
13
+ 'UserPromptSubmit',
14
+ 'PermissionRequest',
15
+ 'Notification',
16
+ 'PostToolUse',
17
+ 'PostToolUseFailure',
18
+ 'Stop',
19
+ // A turn an API error ended: without it the session would look busy.
20
+ 'StopFailure',
21
+ 'SessionEnd',
22
+ ],
23
+ codex: ['SessionStart', 'UserPromptSubmit', 'PermissionRequest', 'PostToolUse', 'Stop', 'Interrupt', 'SessionEnd'],
24
+ };
25
+ /** The file `agent` reads its user-level hooks from. */
26
+ export function hooksFile(agent, env = process.env) {
27
+ const home = env.HOME ?? env.USERPROFILE ?? homedir();
28
+ return agent === 'claude'
29
+ ? path.join(env.CLAUDE_CONFIG_DIR ?? path.join(home, '.claude'), 'settings.json')
30
+ : path.join(env.CODEX_HOME ?? path.join(home, '.codex'), 'hooks.json');
31
+ }
32
+ /** The command line of the hook for `agent`. */
33
+ export function hookCommand(agent, command) {
34
+ return `${command} ${agent} ${MARKER}`;
35
+ }
36
+ const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
37
+ const ours = (handler) => isObject(handler) && typeof handler.command === 'string' && handler.command.endsWith(MARKER);
38
+ async function readConfig(file) {
39
+ let source;
40
+ try {
41
+ source = await fs.readFile(file, 'utf8');
42
+ }
43
+ catch (error) {
44
+ if (error.code === 'ENOENT')
45
+ return {};
46
+ throw error;
47
+ }
48
+ if (!source.trim())
49
+ return {};
50
+ let value;
51
+ try {
52
+ value = JSON.parse(source);
53
+ }
54
+ catch {
55
+ throw new Error(`${file} is not valid JSON. Fix it first: it is left as it is.`);
56
+ }
57
+ if (!isObject(value))
58
+ throw new Error(`${file} does not hold a JSON object. It is left as it is.`);
59
+ return value;
60
+ }
61
+ async function writeConfig(file, config) {
62
+ await fs.mkdir(path.dirname(file), { recursive: true });
63
+ const mode = await fs.stat(file).then((stat) => stat.mode & 0o777, () => 0o600);
64
+ const temporary = `${file}.${process.pid}.tmp`;
65
+ await fs.writeFile(temporary, `${JSON.stringify(config, null, 2)}\n`, { mode });
66
+ await fs.rename(temporary, file);
67
+ }
68
+ /** `config` without genaicode's hook entries; what the user declared stays. */
69
+ function without(config) {
70
+ if (!isObject(config.hooks))
71
+ return config;
72
+ const hooks = {};
73
+ for (const [event, groups] of Object.entries(config.hooks)) {
74
+ if (!Array.isArray(groups)) {
75
+ hooks[event] = groups;
76
+ continue;
77
+ }
78
+ const kept = groups.flatMap((group) => {
79
+ if (!isObject(group) || !Array.isArray(group.hooks) || !group.hooks.some(ours))
80
+ return [group];
81
+ const handlers = group.hooks.filter((handler) => !ours(handler));
82
+ return handlers.length ? [{ ...group, hooks: handlers }] : [];
83
+ });
84
+ if (kept.length)
85
+ hooks[event] = kept;
86
+ }
87
+ const rest = { ...config };
88
+ delete rest.hooks;
89
+ return Object.keys(hooks).length ? { ...rest, hooks } : rest;
90
+ }
91
+ /** This package's own `cli.js`, whoever calls: the CLI or an app that imports `installHooks`. */
92
+ function defaultCommand() {
93
+ const script = fileURLToPath(new URL('../../cli.js', import.meta.url));
94
+ return `"${process.execPath}" "${script}" hook`;
95
+ }
96
+ function found(config) {
97
+ const events = [];
98
+ let command;
99
+ for (const [event, groups] of Object.entries(isObject(config.hooks) ? config.hooks : {})) {
100
+ for (const group of Array.isArray(groups) ? groups : []) {
101
+ const handler = isObject(group) && Array.isArray(group.hooks) ? group.hooks.find(ours) : undefined;
102
+ if (!isObject(handler))
103
+ continue;
104
+ events.push(event);
105
+ command = handler.command;
106
+ }
107
+ }
108
+ return { events, ...(command ? { command } : {}) };
109
+ }
110
+ /** What is installed for `agent` now. */
111
+ export async function hooksStatus(agent, options = {}) {
112
+ const file = hooksFile(agent, options.env);
113
+ const { events, command } = found(await readConfig(file));
114
+ const wanted = hookCommand(agent, options.command ?? defaultCommand());
115
+ return {
116
+ agent,
117
+ file,
118
+ events,
119
+ installed: command === wanted && EVENTS[agent].every((event) => events.includes(event)),
120
+ ...(command ? { command } : {}),
121
+ };
122
+ }
123
+ /**
124
+ * Declare genaicode's hook in the user-level hooks of `agent`, beside whatever is declared there.
125
+ * An earlier install is replaced. The hook only notes what the session is doing (see `recordHook`).
126
+ */
127
+ export async function installHooks(agent, options = {}) {
128
+ const file = hooksFile(agent, options.env);
129
+ const config = without(await readConfig(file));
130
+ const command = hookCommand(agent, options.command ?? defaultCommand());
131
+ const hooks = isObject(config.hooks) ? { ...config.hooks } : {};
132
+ for (const event of EVENTS[agent]) {
133
+ const groups = Array.isArray(hooks[event]) ? hooks[event] : [];
134
+ // Codex gives an `Interrupt` hook three seconds at most.
135
+ const handler = {
136
+ type: 'command',
137
+ command,
138
+ timeout: event === 'Interrupt' ? 3 : 10,
139
+ ...(event === 'SessionEnd' ? {} : { async: true }),
140
+ };
141
+ hooks[event] = [...groups, { hooks: [handler] }];
142
+ }
143
+ await writeConfig(file, { ...config, hooks });
144
+ return hooksStatus(agent, options);
145
+ }
146
+ /** Take genaicode's hook out of the hooks of `agent`. Resolves to whether there was one. */
147
+ export async function uninstallHooks(agent, options = {}) {
148
+ const file = hooksFile(agent, options.env);
149
+ const config = await readConfig(file);
150
+ if (!found(config).events.length)
151
+ return false;
152
+ await writeConfig(file, without(config));
153
+ return true;
154
+ }
155
+ //# sourceMappingURL=hooks.js.map