@jingyi0605/codingns 0.1.4 → 0.1.5

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 (209) hide show
  1. package/dist/public/assets/{TerminalPage-4ulgBhv9.js → TerminalPage-4p6EBqrR.js} +1 -1
  2. package/dist/public/assets/gemini-D4G1NbrE.png +0 -0
  3. package/dist/public/assets/index-CxeghocY.css +1 -0
  4. package/dist/public/assets/index-DXusStl0.js +108 -0
  5. package/dist/public/assets/kimi-BWNNSh7e.png +0 -0
  6. package/dist/public/index.html +2 -2
  7. package/dist/server/config/env.d.ts +6 -0
  8. package/dist/server/config/env.js +145 -0
  9. package/dist/server/config/env.js.map +1 -1
  10. package/dist/server/config/opencode-system-probe-helper-process.d.ts +24 -0
  11. package/dist/server/config/opencode-system-probe-helper-process.js +70 -5
  12. package/dist/server/config/opencode-system-probe-helper-process.js.map +1 -1
  13. package/dist/server/modules/butler/butler-action-context-service.d.ts +30 -0
  14. package/dist/server/modules/butler/butler-action-context-service.js +108 -0
  15. package/dist/server/modules/butler/butler-action-context-service.js.map +1 -0
  16. package/dist/server/modules/butler/butler-auth-service.d.ts +17 -0
  17. package/dist/server/modules/butler/butler-auth-service.js +91 -0
  18. package/dist/server/modules/butler/butler-auth-service.js.map +1 -0
  19. package/dist/server/modules/butler/butler-control-action-service.d.ts +65 -0
  20. package/dist/server/modules/butler/butler-control-action-service.js +296 -0
  21. package/dist/server/modules/butler/butler-control-action-service.js.map +1 -0
  22. package/dist/server/modules/butler/butler-control-session-service.d.ts +55 -0
  23. package/dist/server/modules/butler/butler-control-session-service.js +367 -0
  24. package/dist/server/modules/butler/butler-control-session-service.js.map +1 -0
  25. package/dist/server/modules/butler/butler-controller.d.ts +367 -0
  26. package/dist/server/modules/butler/butler-controller.js +475 -0
  27. package/dist/server/modules/butler/butler-controller.js.map +1 -0
  28. package/dist/server/modules/butler/butler-follow-up-evaluation-instruction-adapter.d.ts +34 -0
  29. package/dist/server/modules/butler/butler-follow-up-evaluation-instruction-adapter.js +77 -0
  30. package/dist/server/modules/butler/butler-follow-up-evaluation-instruction-adapter.js.map +1 -0
  31. package/dist/server/modules/butler/butler-follow-up-scheduler.d.ts +23 -0
  32. package/dist/server/modules/butler/butler-follow-up-scheduler.js +57 -0
  33. package/dist/server/modules/butler/butler-follow-up-scheduler.js.map +1 -0
  34. package/dist/server/modules/butler/butler-follow-up-service.d.ts +86 -0
  35. package/dist/server/modules/butler/butler-follow-up-service.js +948 -0
  36. package/dist/server/modules/butler/butler-follow-up-service.js.map +1 -0
  37. package/dist/server/modules/butler/butler-inbox-service.d.ts +35 -0
  38. package/dist/server/modules/butler/butler-inbox-service.js +136 -0
  39. package/dist/server/modules/butler/butler-inbox-service.js.map +1 -0
  40. package/dist/server/modules/butler/butler-notification-service.d.ts +12 -0
  41. package/dist/server/modules/butler/butler-notification-service.js +45 -0
  42. package/dist/server/modules/butler/butler-notification-service.js.map +1 -0
  43. package/dist/server/modules/butler/butler-profile-service.d.ts +26 -0
  44. package/dist/server/modules/butler/butler-profile-service.js +529 -0
  45. package/dist/server/modules/butler/butler-profile-service.js.map +1 -0
  46. package/dist/server/modules/butler/butler-project-service.d.ts +48 -0
  47. package/dist/server/modules/butler/butler-project-service.js +253 -0
  48. package/dist/server/modules/butler/butler-project-service.js.map +1 -0
  49. package/dist/server/modules/butler/butler-session-service.d.ts +79 -0
  50. package/dist/server/modules/butler/butler-session-service.js +503 -0
  51. package/dist/server/modules/butler/butler-session-service.js.map +1 -0
  52. package/dist/server/modules/butler/butler-session-summary-service.d.ts +55 -0
  53. package/dist/server/modules/butler/butler-session-summary-service.js +382 -0
  54. package/dist/server/modules/butler/butler-session-summary-service.js.map +1 -0
  55. package/dist/server/modules/butler/context-aggregator.d.ts +187 -0
  56. package/dist/server/modules/butler/context-aggregator.js +807 -0
  57. package/dist/server/modules/butler/context-aggregator.js.map +1 -0
  58. package/dist/server/modules/butler/instruction-adapter.d.ts +28 -0
  59. package/dist/server/modules/butler/instruction-adapter.js +101 -0
  60. package/dist/server/modules/butler/instruction-adapter.js.map +1 -0
  61. package/dist/server/modules/butler/patrol-execution-service.d.ts +47 -0
  62. package/dist/server/modules/butler/patrol-execution-service.js +347 -0
  63. package/dist/server/modules/butler/patrol-execution-service.js.map +1 -0
  64. package/dist/server/modules/butler/patrol-plan-service.d.ts +54 -0
  65. package/dist/server/modules/butler/patrol-plan-service.js +272 -0
  66. package/dist/server/modules/butler/patrol-plan-service.js.map +1 -0
  67. package/dist/server/modules/butler/patrol-run-service.d.ts +60 -0
  68. package/dist/server/modules/butler/patrol-run-service.js +185 -0
  69. package/dist/server/modules/butler/patrol-run-service.js.map +1 -0
  70. package/dist/server/modules/butler/patrol-scheduler.d.ts +36 -0
  71. package/dist/server/modules/butler/patrol-scheduler.js +99 -0
  72. package/dist/server/modules/butler/patrol-scheduler.js.map +1 -0
  73. package/dist/server/modules/butler/project-memory-service.d.ts +30 -0
  74. package/dist/server/modules/butler/project-memory-service.js +103 -0
  75. package/dist/server/modules/butler/project-memory-service.js.map +1 -0
  76. package/dist/server/modules/butler/provider-adapter-registry.d.ts +61 -0
  77. package/dist/server/modules/butler/provider-adapter-registry.js +430 -0
  78. package/dist/server/modules/butler/provider-adapter-registry.js.map +1 -0
  79. package/dist/server/modules/butler/session-summary-instruction-adapter.d.ts +28 -0
  80. package/dist/server/modules/butler/session-summary-instruction-adapter.js +79 -0
  81. package/dist/server/modules/butler/session-summary-instruction-adapter.js.map +1 -0
  82. package/dist/server/modules/butler/session-summary-scheduler.d.ts +23 -0
  83. package/dist/server/modules/butler/session-summary-scheduler.js +57 -0
  84. package/dist/server/modules/butler/session-summary-scheduler.js.map +1 -0
  85. package/dist/server/modules/butler/verification-run-service.d.ts +73 -0
  86. package/dist/server/modules/butler/verification-run-service.js +633 -0
  87. package/dist/server/modules/butler/verification-run-service.js.map +1 -0
  88. package/dist/server/modules/preferences/profile-service.js +8 -2
  89. package/dist/server/modules/preferences/profile-service.js.map +1 -1
  90. package/dist/server/modules/sessions/claude-runtime-helper-process.js +1 -1
  91. package/dist/server/modules/sessions/claude-runtime-helper-process.js.map +1 -1
  92. package/dist/server/modules/sessions/codex-app-server-helper-client.d.ts +5 -1
  93. package/dist/server/modules/sessions/codex-app-server-helper-client.js +10 -2
  94. package/dist/server/modules/sessions/codex-app-server-helper-client.js.map +1 -1
  95. package/dist/server/modules/sessions/session-controller.d.ts +3 -1
  96. package/dist/server/modules/sessions/session-controller.js +11 -2
  97. package/dist/server/modules/sessions/session-controller.js.map +1 -1
  98. package/dist/server/modules/sessions/session-history-service.d.ts +14 -1
  99. package/dist/server/modules/sessions/session-history-service.js +291 -30
  100. package/dist/server/modules/sessions/session-history-service.js.map +1 -1
  101. package/dist/server/modules/sessions/session-live-runtime-service.d.ts +25 -2
  102. package/dist/server/modules/sessions/session-live-runtime-service.js +526 -158
  103. package/dist/server/modules/sessions/session-live-runtime-service.js.map +1 -1
  104. package/dist/server/modules/sessions/session-provider-error-mapper.js +28 -0
  105. package/dist/server/modules/sessions/session-provider-error-mapper.js.map +1 -1
  106. package/dist/server/modules/workbench/workbench-service.d.ts +7 -1
  107. package/dist/server/modules/workbench/workbench-service.js +31 -7
  108. package/dist/server/modules/workbench/workbench-service.js.map +1 -1
  109. package/dist/server/routes/butler.d.ts +3 -0
  110. package/dist/server/routes/butler.js +54 -0
  111. package/dist/server/routes/butler.js.map +1 -0
  112. package/dist/server/server/create-server.d.ts +61 -0
  113. package/dist/server/server/create-server.js +148 -4
  114. package/dist/server/server/create-server.js.map +1 -1
  115. package/dist/server/storage/repositories/butler-control-event-repository.d.ts +8 -0
  116. package/dist/server/storage/repositories/butler-control-event-repository.js +78 -0
  117. package/dist/server/storage/repositories/butler-control-event-repository.js.map +1 -0
  118. package/dist/server/storage/repositories/butler-control-session-repository.d.ts +11 -0
  119. package/dist/server/storage/repositories/butler-control-session-repository.js +86 -0
  120. package/dist/server/storage/repositories/butler-control-session-repository.js.map +1 -0
  121. package/dist/server/storage/repositories/butler-follow-up-task-repository.d.ts +16 -0
  122. package/dist/server/storage/repositories/butler-follow-up-task-repository.js +252 -0
  123. package/dist/server/storage/repositories/butler-follow-up-task-repository.js.map +1 -0
  124. package/dist/server/storage/repositories/butler-inbox-item-repository.d.ts +15 -0
  125. package/dist/server/storage/repositories/butler-inbox-item-repository.js +111 -0
  126. package/dist/server/storage/repositories/butler-inbox-item-repository.js.map +1 -0
  127. package/dist/server/storage/repositories/butler-notification-archive-repository.d.ts +9 -0
  128. package/dist/server/storage/repositories/butler-notification-archive-repository.js +48 -0
  129. package/dist/server/storage/repositories/butler-notification-archive-repository.js.map +1 -0
  130. package/dist/server/storage/repositories/butler-profile-repository.d.ts +9 -0
  131. package/dist/server/storage/repositories/butler-profile-repository.js +86 -0
  132. package/dist/server/storage/repositories/butler-profile-repository.js.map +1 -0
  133. package/dist/server/storage/repositories/butler-project-repository.d.ts +14 -0
  134. package/dist/server/storage/repositories/butler-project-repository.js +140 -0
  135. package/dist/server/storage/repositories/butler-project-repository.js.map +1 -0
  136. package/dist/server/storage/repositories/butler-session-repository.d.ts +11 -0
  137. package/dist/server/storage/repositories/butler-session-repository.js +106 -0
  138. package/dist/server/storage/repositories/butler-session-repository.js.map +1 -0
  139. package/dist/server/storage/repositories/butler-session-summary-state-repository.d.ts +8 -0
  140. package/dist/server/storage/repositories/butler-session-summary-state-repository.js +62 -0
  141. package/dist/server/storage/repositories/butler-session-summary-state-repository.js.map +1 -0
  142. package/dist/server/storage/repositories/patrol-plan-repository.d.ts +27 -0
  143. package/dist/server/storage/repositories/patrol-plan-repository.js +119 -0
  144. package/dist/server/storage/repositories/patrol-plan-repository.js.map +1 -0
  145. package/dist/server/storage/repositories/patrol-run-repository.d.ts +28 -0
  146. package/dist/server/storage/repositories/patrol-run-repository.js +121 -0
  147. package/dist/server/storage/repositories/patrol-run-repository.js.map +1 -0
  148. package/dist/server/storage/repositories/project-memory-repository.d.ts +15 -0
  149. package/dist/server/storage/repositories/project-memory-repository.js +150 -0
  150. package/dist/server/storage/repositories/project-memory-repository.js.map +1 -0
  151. package/dist/server/storage/repositories/session-checkpoint-repository.d.ts +9 -0
  152. package/dist/server/storage/repositories/session-checkpoint-repository.js +72 -0
  153. package/dist/server/storage/repositories/session-checkpoint-repository.js.map +1 -0
  154. package/dist/server/storage/repositories/session-message-origin-repository.d.ts +10 -0
  155. package/dist/server/storage/repositories/session-message-origin-repository.js +93 -0
  156. package/dist/server/storage/repositories/session-message-origin-repository.js.map +1 -0
  157. package/dist/server/storage/repositories/verification-run-repository.d.ts +29 -0
  158. package/dist/server/storage/repositories/verification-run-repository.js +125 -0
  159. package/dist/server/storage/repositories/verification-run-repository.js.map +1 -0
  160. package/dist/server/storage/sqlite/client.js +39 -0
  161. package/dist/server/storage/sqlite/client.js.map +1 -1
  162. package/dist/server/storage/sqlite/schema.sql +324 -0
  163. package/dist/server/types/domain.d.ts +261 -1
  164. package/dist/server/ws/ws-server.d.ts +2 -1
  165. package/dist/server/ws/ws-server.js +2 -1
  166. package/dist/server/ws/ws-server.js.map +1 -1
  167. package/node_modules/@codingns/session-sync-core/dist/index.d.ts +4 -0
  168. package/node_modules/@codingns/session-sync-core/dist/index.js +4 -0
  169. package/node_modules/@codingns/session-sync-core/dist/index.js.map +1 -1
  170. package/node_modules/@codingns/session-sync-core/dist/kimi-message-normalizer.d.ts +18 -0
  171. package/node_modules/@codingns/session-sync-core/dist/kimi-message-normalizer.js +659 -0
  172. package/node_modules/@codingns/session-sync-core/dist/kimi-message-normalizer.js.map +1 -0
  173. package/node_modules/@codingns/session-sync-core/dist/kimi-shared.d.ts +11 -0
  174. package/node_modules/@codingns/session-sync-core/dist/kimi-shared.js +72 -0
  175. package/node_modules/@codingns/session-sync-core/dist/kimi-shared.js.map +1 -0
  176. package/node_modules/@codingns/session-sync-core/dist/patch-builder.d.ts +8 -0
  177. package/node_modules/@codingns/session-sync-core/dist/patch-builder.js +89 -0
  178. package/node_modules/@codingns/session-sync-core/dist/patch-builder.js.map +1 -1
  179. package/node_modules/@codingns/session-sync-core/dist/providers/codex.js +4 -1
  180. package/node_modules/@codingns/session-sync-core/dist/providers/codex.js.map +1 -1
  181. package/node_modules/@codingns/session-sync-core/dist/providers/gemini.d.ts +41 -0
  182. package/node_modules/@codingns/session-sync-core/dist/providers/gemini.js +1086 -0
  183. package/node_modules/@codingns/session-sync-core/dist/providers/gemini.js.map +1 -0
  184. package/node_modules/@codingns/session-sync-core/dist/providers/kimi.d.ts +29 -0
  185. package/node_modules/@codingns/session-sync-core/dist/providers/kimi.js +578 -0
  186. package/node_modules/@codingns/session-sync-core/dist/providers/kimi.js.map +1 -0
  187. package/node_modules/@codingns/session-sync-core/dist/providers/opencode.js +2 -1
  188. package/node_modules/@codingns/session-sync-core/dist/providers/opencode.js.map +1 -1
  189. package/node_modules/@codingns/session-sync-core/dist/providers/utils.js +30 -2
  190. package/node_modules/@codingns/session-sync-core/dist/providers/utils.js.map +1 -1
  191. package/node_modules/@codingns/session-sync-core/dist/runtime/active-run-registry.d.ts +2 -0
  192. package/node_modules/@codingns/session-sync-core/dist/runtime/active-run-registry.js +43 -5
  193. package/node_modules/@codingns/session-sync-core/dist/runtime/active-run-registry.js.map +1 -1
  194. package/node_modules/@codingns/session-sync-core/dist/runtime/codex-runtime.d.ts +2 -0
  195. package/node_modules/@codingns/session-sync-core/dist/runtime/codex-runtime.js +320 -69
  196. package/node_modules/@codingns/session-sync-core/dist/runtime/codex-runtime.js.map +1 -1
  197. package/node_modules/@codingns/session-sync-core/dist/runtime/gemini-runtime.d.ts +21 -0
  198. package/node_modules/@codingns/session-sync-core/dist/runtime/gemini-runtime.js +537 -0
  199. package/node_modules/@codingns/session-sync-core/dist/runtime/gemini-runtime.js.map +1 -0
  200. package/node_modules/@codingns/session-sync-core/dist/runtime/kimi-runtime.d.ts +38 -0
  201. package/node_modules/@codingns/session-sync-core/dist/runtime/kimi-runtime.js +911 -0
  202. package/node_modules/@codingns/session-sync-core/dist/runtime/kimi-runtime.js.map +1 -0
  203. package/node_modules/@codingns/session-sync-core/dist/sqlite/node-sqlite.d.ts +6 -0
  204. package/node_modules/@codingns/session-sync-core/dist/sqlite/node-sqlite.js +9 -0
  205. package/node_modules/@codingns/session-sync-core/dist/sqlite/node-sqlite.js.map +1 -0
  206. package/node_modules/@codingns/session-sync-core/package.json +8 -0
  207. package/package.json +1 -1
  208. package/dist/public/assets/index-C5lu52cQ.css +0 -1
  209. package/dist/public/assets/index-WpdUo_Vs.js +0 -108
@@ -0,0 +1,382 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { createId } from "../../shared/utils/id.js";
5
+ import { nowIso } from "../../shared/utils/time.js";
6
+ import { ensureButlerWorkspaceIsolation } from "./butler-profile-service.js";
7
+ const DEFAULT_DEBOUNCE_MS = 300_000;
8
+ const DEFAULT_RECENT_MESSAGE_LIMIT = 40;
9
+ export class ButlerSessionSummaryService {
10
+ butlerProfileService;
11
+ butlerProjectService;
12
+ butlerSessionService;
13
+ butlerSessionRepository;
14
+ butlerSessionSummaryStateRepository;
15
+ sessionCheckpointRepository;
16
+ sessionIndexRepository;
17
+ authUserRepository;
18
+ workspaceService;
19
+ sessionHistoryService;
20
+ providerAdapterRegistry;
21
+ instructionAdapter;
22
+ debounceMs;
23
+ recentMessageLimit;
24
+ now;
25
+ logger;
26
+ summaryCodexHomeDir;
27
+ sourceCodexHomeDir;
28
+ inFlightButlerSessionIds = new Set();
29
+ constructor(butlerProfileService, butlerProjectService, butlerSessionService, butlerSessionRepository, butlerSessionSummaryStateRepository, sessionCheckpointRepository, sessionIndexRepository, authUserRepository, workspaceService, sessionHistoryService, providerAdapterRegistry, instructionAdapter, options = {}) {
30
+ this.butlerProfileService = butlerProfileService;
31
+ this.butlerProjectService = butlerProjectService;
32
+ this.butlerSessionService = butlerSessionService;
33
+ this.butlerSessionRepository = butlerSessionRepository;
34
+ this.butlerSessionSummaryStateRepository = butlerSessionSummaryStateRepository;
35
+ this.sessionCheckpointRepository = sessionCheckpointRepository;
36
+ this.sessionIndexRepository = sessionIndexRepository;
37
+ this.authUserRepository = authUserRepository;
38
+ this.workspaceService = workspaceService;
39
+ this.sessionHistoryService = sessionHistoryService;
40
+ this.providerAdapterRegistry = providerAdapterRegistry;
41
+ this.instructionAdapter = instructionAdapter;
42
+ this.debounceMs = Math.max(5_000, options.debounceMs ?? DEFAULT_DEBOUNCE_MS);
43
+ this.recentMessageLimit = Math.max(10, options.recentMessageLimit ?? DEFAULT_RECENT_MESSAGE_LIMIT);
44
+ this.now = options.now ?? nowIso;
45
+ this.logger = options.logger ?? console;
46
+ this.summaryCodexHomeDir = options.summaryCodexHomeDir ?? null;
47
+ this.sourceCodexHomeDir = options.sourceCodexHomeDir ?? null;
48
+ }
49
+ async runOnce() {
50
+ const profile = this.butlerProfileService.getProfile();
51
+ if (!profile) {
52
+ return;
53
+ }
54
+ const userId = this.resolveExecutorUserId();
55
+ if (!userId) {
56
+ return;
57
+ }
58
+ ensureButlerWorkspaceIsolation(profile.workspacePath);
59
+ this.workspaceService.importWorkspace(profile.workspacePath, "代码助手");
60
+ this.syncSummaryInstructionFiles(profile.workspacePath, profile.providerId);
61
+ const debounceMs = this.resolveDebounceMs(profile.focus.summaryDebounceSeconds);
62
+ const projects = this.butlerProjectService.list({
63
+ lifecycleStatus: "active"
64
+ });
65
+ for (const project of projects) {
66
+ await this.butlerSessionService.ensureProjectSessionsSynced(project.id, userId);
67
+ const sessions = this.butlerSessionService.listByProject(project.id, userId);
68
+ for (const session of sessions) {
69
+ await this.maybeSummarizeSession(project, session, userId, profile.providerId, profile.workspacePath, debounceMs);
70
+ }
71
+ }
72
+ }
73
+ async maybeSummarizeSession(project, session, userId, providerId, summaryWorkspacePath, debounceMs) {
74
+ const index = this.sessionIndexRepository.findIndexRecordBySessionId(session.sessionId);
75
+ if (!index || index.isArchived || index.isSubagent) {
76
+ return;
77
+ }
78
+ const state = this.butlerSessionSummaryStateRepository.findByButlerSessionId(session.id);
79
+ const sourceChanged = !state
80
+ || state.sourceMessageCount !== index.messageCount
81
+ || state.sourceLastMessageAt !== index.lastMessageAt;
82
+ if (sourceChanged) {
83
+ this.scheduleSession(state, session.id, index.messageCount, index.lastMessageAt, debounceMs);
84
+ return;
85
+ }
86
+ if (!state || state.status !== "scheduled" || !state.debounceUntil || state.debounceUntil > this.now()) {
87
+ return;
88
+ }
89
+ if (this.inFlightButlerSessionIds.has(session.id)) {
90
+ return;
91
+ }
92
+ await this.summarizeSession(project, session, index.title, index.messageCount, index.lastMessageAt, userId, providerId, summaryWorkspacePath);
93
+ }
94
+ scheduleSession(current, butlerSessionId, sourceMessageCount, sourceLastMessageAt, debounceMs) {
95
+ const timestamp = this.now();
96
+ this.butlerSessionSummaryStateRepository.upsert({
97
+ butlerSessionId,
98
+ sourceMessageCount,
99
+ sourceLastMessageAt,
100
+ lastSummarizedAt: current?.lastSummarizedAt ?? null,
101
+ lastSummarizedSequence: current?.lastSummarizedSequence ?? null,
102
+ debounceUntil: new Date(Date.parse(timestamp) + debounceMs).toISOString(),
103
+ status: "scheduled",
104
+ errorDetail: null,
105
+ updatedAt: timestamp
106
+ });
107
+ }
108
+ resolveDebounceMs(summaryDebounceSeconds) {
109
+ return Math.max(5_000, Math.trunc(summaryDebounceSeconds * 1_000 || this.debounceMs));
110
+ }
111
+ async summarizeSession(project, session, sessionTitle, sourceMessageCount, sourceLastMessageAt, userId, providerId, summaryWorkspacePath) {
112
+ this.inFlightButlerSessionIds.add(session.id);
113
+ const runningAt = this.now();
114
+ const currentState = this.butlerSessionSummaryStateRepository.findByButlerSessionId(session.id);
115
+ this.butlerSessionSummaryStateRepository.upsert({
116
+ butlerSessionId: session.id,
117
+ sourceMessageCount,
118
+ sourceLastMessageAt,
119
+ lastSummarizedAt: currentState?.lastSummarizedAt ?? null,
120
+ lastSummarizedSequence: currentState?.lastSummarizedSequence ?? null,
121
+ debounceUntil: currentState?.debounceUntil ?? null,
122
+ status: "running",
123
+ errorDetail: null,
124
+ updatedAt: runningAt
125
+ });
126
+ try {
127
+ const incrementalHistory = await this.collectIncrementalHistory(session.sessionId, currentState?.lastSummarizedSequence ?? null, userId);
128
+ if (incrementalHistory.messages.length === 0 || incrementalHistory.latestSequence === null) {
129
+ this.butlerSessionSummaryStateRepository.upsert({
130
+ butlerSessionId: session.id,
131
+ sourceMessageCount,
132
+ sourceLastMessageAt,
133
+ lastSummarizedAt: currentState?.lastSummarizedAt ?? null,
134
+ lastSummarizedSequence: currentState?.lastSummarizedSequence ?? null,
135
+ debounceUntil: null,
136
+ status: "idle",
137
+ errorDetail: null,
138
+ updatedAt: this.now()
139
+ });
140
+ return;
141
+ }
142
+ const transcriptLines = incrementalHistory.messages
143
+ .map((message) => renderHistoryLine(message.role, message.kind, message.timestamp, message.content));
144
+ const instruction = this.instructionAdapter.buildInstruction({
145
+ providerId,
146
+ project,
147
+ butlerSessionId: session.id,
148
+ sessionId: session.sessionId,
149
+ sessionTitle,
150
+ lastMessageAt: sourceLastMessageAt,
151
+ messageCount: sourceMessageCount,
152
+ previousSummary: session.lastSummary,
153
+ lastSummarizedSequence: currentState?.lastSummarizedSequence ?? null,
154
+ transcriptLines
155
+ });
156
+ const adapter = this.providerAdapterRegistry.get(providerId);
157
+ const summaryWorkspace = this.workspaceService.importWorkspace(summaryWorkspacePath, "代码助手");
158
+ const launch = await adapter.startPatrolSession({
159
+ workspaceId: summaryWorkspace.id,
160
+ userId,
161
+ providerId,
162
+ prompt: instruction.prompt,
163
+ model: resolveSummaryModel(providerId),
164
+ reasoningLevel: "low",
165
+ permissionMode: "default"
166
+ });
167
+ await adapter.waitForSessionTerminal(launch.sessionId);
168
+ const result = await adapter.readPatrolResult(launch.sessionId);
169
+ this.persistSummary(session, sourceMessageCount, sourceLastMessageAt, incrementalHistory.latestSequence, result, runningAt);
170
+ }
171
+ catch (error) {
172
+ const detail = error instanceof Error ? error.message : String(error);
173
+ this.butlerSessionSummaryStateRepository.upsert({
174
+ butlerSessionId: session.id,
175
+ sourceMessageCount,
176
+ sourceLastMessageAt,
177
+ lastSummarizedAt: currentState?.lastSummarizedAt ?? null,
178
+ lastSummarizedSequence: currentState?.lastSummarizedSequence ?? null,
179
+ debounceUntil: null,
180
+ status: "failed",
181
+ errorDetail: detail,
182
+ updatedAt: this.now()
183
+ });
184
+ this.logger.error("[butler-session-summary] summarize failed", {
185
+ butlerSessionId: session.id,
186
+ sessionId: session.sessionId,
187
+ error: detail
188
+ });
189
+ }
190
+ finally {
191
+ this.inFlightButlerSessionIds.delete(session.id);
192
+ }
193
+ }
194
+ persistSummary(session, sourceMessageCount, sourceLastMessageAt, lastSummarizedSequence, result, startedAt) {
195
+ const timestamp = this.now();
196
+ const summary = result.structured.summary ?? result.latestAssistantMessage ?? "已尝试生成摘要,但未拿到有效结果";
197
+ const progressState = result.structured.progressState ?? "unknown";
198
+ const nextActions = dedupeItems([
199
+ ...result.structured.nextActions,
200
+ ...result.structured.suggestions
201
+ ]).slice(0, 3);
202
+ const riskFlags = dedupeItems(result.structured.riskFlags).slice(0, 4);
203
+ const existing = this.butlerSessionRepository.findById(session.id);
204
+ if (existing) {
205
+ this.butlerSessionRepository.update({
206
+ ...existing,
207
+ status: resolveButlerSessionStatus(session.runningState, progressState),
208
+ lastSummary: summary,
209
+ lastCheckpointAt: timestamp,
210
+ updatedAt: timestamp
211
+ });
212
+ }
213
+ this.sessionCheckpointRepository.create({
214
+ id: createId(),
215
+ butlerSessionId: session.id,
216
+ checkpointSeq: this.sessionCheckpointRepository.getLatestSeq(session.id) + 1,
217
+ sourceKind: "summary",
218
+ progressState,
219
+ summary,
220
+ riskFlags,
221
+ nextActions,
222
+ capturedAt: timestamp
223
+ });
224
+ this.butlerSessionSummaryStateRepository.upsert({
225
+ butlerSessionId: session.id,
226
+ sourceMessageCount,
227
+ sourceLastMessageAt,
228
+ lastSummarizedAt: timestamp,
229
+ lastSummarizedSequence,
230
+ debounceUntil: null,
231
+ status: "idle",
232
+ errorDetail: null,
233
+ updatedAt: timestamp
234
+ });
235
+ if (timestamp < startedAt) {
236
+ this.logger.error("[butler-session-summary] invalid clock order", {
237
+ butlerSessionId: session.id,
238
+ startedAt,
239
+ finishedAt: timestamp
240
+ });
241
+ }
242
+ }
243
+ resolveExecutorUserId() {
244
+ return this.authUserRepository.listIds()[0] ?? null;
245
+ }
246
+ async collectIncrementalHistory(sessionId, lastSummarizedSequence, userId) {
247
+ const collected = new Map();
248
+ let cursor = null;
249
+ let latestSequence = null;
250
+ while (true) {
251
+ const page = await this.sessionHistoryService.readSessionHistory(sessionId, cursor, this.recentMessageLimit, "backward", userId);
252
+ const sortedMessages = page.messages
253
+ .slice()
254
+ .sort((left, right) => left.sequence - right.sequence);
255
+ for (const message of sortedMessages) {
256
+ if (latestSequence === null || message.sequence > latestSequence) {
257
+ latestSequence = message.sequence;
258
+ }
259
+ if (lastSummarizedSequence !== null && message.sequence <= lastSummarizedSequence) {
260
+ continue;
261
+ }
262
+ collected.set(message.sequence, message);
263
+ }
264
+ const reachedBoundary = lastSummarizedSequence !== null
265
+ && sortedMessages.some((message) => message.sequence <= lastSummarizedSequence);
266
+ if (reachedBoundary || !page.nextCursor) {
267
+ break;
268
+ }
269
+ cursor = page.nextCursor;
270
+ }
271
+ return {
272
+ messages: Array.from(collected.values()).sort((left, right) => left.sequence - right.sequence),
273
+ latestSequence
274
+ };
275
+ }
276
+ syncSummaryInstructionFiles(workspacePath, providerId) {
277
+ const summaryAgentsPath = path.join(workspacePath, "SUMMARY_AGENTS.md");
278
+ writeFileIfChanged(summaryAgentsPath, [
279
+ "# 代码助手后台摘要规则",
280
+ "",
281
+ "你现在不是面向用户的聊天助手,而是后台摘要器。",
282
+ "你的唯一职责是把单个项目会话最近消息压缩成短摘要,供后续检索和聚合使用。",
283
+ "禁止编造不存在的项目状态;信息不足时直接承认不足。",
284
+ "输出语言必须是中文,先给摘要,再给结构化 JSON。"
285
+ ].join("\n"));
286
+ if (providerId === "codex") {
287
+ syncCodexSummaryConfig(this.summaryCodexHomeDir, this.sourceCodexHomeDir, summaryAgentsPath);
288
+ }
289
+ }
290
+ }
291
+ function resolveSummaryModel(providerId) {
292
+ return providerId === "codex" ? "gpt-5.1-codex-mini" : "haiku";
293
+ }
294
+ function resolveButlerSessionStatus(runningState, progressState) {
295
+ switch (runningState) {
296
+ case "starting":
297
+ case "running":
298
+ return "running";
299
+ case "failed":
300
+ case "interrupted":
301
+ return "blocked";
302
+ default:
303
+ return progressState === "blocked" ? "blocked" : "idle";
304
+ }
305
+ }
306
+ function renderHistoryLine(role, kind, timestamp, content) {
307
+ const compactContent = truncateText(content
308
+ .replace(/\s+/g, " ")
309
+ .trim(), kind === "tool_call" ? 220 : 360);
310
+ return `[${timestamp}] ${role}/${kind}: ${compactContent || "(空内容)"}`;
311
+ }
312
+ function truncateText(value, maxLength) {
313
+ if (value.length <= maxLength) {
314
+ return value;
315
+ }
316
+ return `${value.slice(0, Math.max(0, maxLength - 1))}…`;
317
+ }
318
+ function dedupeItems(items) {
319
+ return Array.from(new Set(items.map((item) => item.trim()).filter((item) => item.length > 0)));
320
+ }
321
+ function syncCodexSummaryConfig(codexHomeDir, sourceCodexHomeDir, instructionFilePath) {
322
+ if (!codexHomeDir?.trim()) {
323
+ return;
324
+ }
325
+ const targetHomeDir = path.resolve(codexHomeDir);
326
+ const sourceHomeDir = resolveSourceCodexHomeDir(sourceCodexHomeDir, targetHomeDir);
327
+ const sourceConfigPath = path.join(sourceHomeDir, "config.toml");
328
+ const sourceConfigContent = sourceHomeDir !== targetHomeDir && fs.existsSync(sourceConfigPath) && fs.statSync(sourceConfigPath).isFile()
329
+ ? fs.readFileSync(sourceConfigPath, "utf8")
330
+ : "";
331
+ fs.mkdirSync(targetHomeDir, { recursive: true });
332
+ syncOptionalFile(path.join(sourceHomeDir, "auth.json"), path.join(targetHomeDir, "auth.json"));
333
+ writeFileIfChanged(path.join(targetHomeDir, "config.toml"), `${composeCodexConfigContent(sourceConfigContent, path.resolve(instructionFilePath))}\n`);
334
+ }
335
+ function resolveSourceCodexHomeDir(sourceCodexHomeDir, targetHomeDir) {
336
+ const configuredSource = sourceCodexHomeDir?.trim();
337
+ if (configuredSource) {
338
+ const resolvedConfiguredSource = path.resolve(configuredSource);
339
+ if (resolvedConfiguredSource !== targetHomeDir) {
340
+ return resolvedConfiguredSource;
341
+ }
342
+ }
343
+ const fallbackHomeDir = path.resolve(path.join(os.homedir(), ".codex"));
344
+ if (fallbackHomeDir !== targetHomeDir) {
345
+ return fallbackHomeDir;
346
+ }
347
+ return targetHomeDir;
348
+ }
349
+ function composeCodexConfigContent(sourceConfigContent, instructionFilePath) {
350
+ const normalizedSource = sourceConfigContent
351
+ .split(/\r?\n/)
352
+ .filter((line) => {
353
+ const trimmed = line.trim();
354
+ return trimmed.length > 0 && !trimmed.startsWith("model_instructions_file");
355
+ })
356
+ .join("\n")
357
+ .trim();
358
+ return [
359
+ "# 代码助手后台摘要专用 Codex 配置(系统自动生成)",
360
+ normalizedSource,
361
+ `model_instructions_file = ${toTomlString(instructionFilePath)}`
362
+ ]
363
+ .filter((part) => part.trim().length > 0)
364
+ .join("\n\n");
365
+ }
366
+ function writeFileIfChanged(filePath, content) {
367
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
368
+ if (fs.existsSync(filePath) && fs.readFileSync(filePath, "utf8") === content) {
369
+ return;
370
+ }
371
+ fs.writeFileSync(filePath, content, "utf8");
372
+ }
373
+ function syncOptionalFile(sourcePath, targetPath) {
374
+ if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isFile()) {
375
+ return;
376
+ }
377
+ writeFileIfChanged(targetPath, fs.readFileSync(sourcePath, "utf8"));
378
+ }
379
+ function toTomlString(value) {
380
+ return JSON.stringify(value);
381
+ }
382
+ //# sourceMappingURL=butler-session-summary-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"butler-session-summary-service.js","sourceRoot":"","sources":["../../../../src/modules/butler/butler-session-summary-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,187 @@
1
+ import type { ButlerProject, ButlerCheckpointProgressState } from "../../types/domain.js";
2
+ import type { SessionCheckpointRepository } from "../../storage/repositories/session-checkpoint-repository.js";
3
+ import type { ButlerInboxService } from "./butler-inbox-service.js";
4
+ import type { ButlerProfileService } from "./butler-profile-service.js";
5
+ import type { ButlerProjectService } from "./butler-project-service.js";
6
+ import type { ButlerProjectSessionView, ButlerSessionService } from "./butler-session-service.js";
7
+ import type { PatrolRunService } from "./patrol-run-service.js";
8
+ import type { ProjectMemoryService } from "./project-memory-service.js";
9
+ import type { VerificationRunService } from "./verification-run-service.js";
10
+ export interface ButlerGlobalDigest {
11
+ projectCount: number;
12
+ activeProjectCount: number;
13
+ blockedProjectCount: number;
14
+ highRiskProjectCount: number;
15
+ topRisks: string[];
16
+ nextActions: string[];
17
+ }
18
+ export interface ButlerProjectDigest {
19
+ id: string;
20
+ workspaceId: string;
21
+ name: string;
22
+ repoRoot: string;
23
+ lifecycleStatus: ButlerProject["lifecycleStatus"];
24
+ riskLevel: ButlerProject["riskLevel"];
25
+ activeSessionCount: number;
26
+ sessionCount: number;
27
+ memoryCount: number;
28
+ failedPatrolCount: number;
29
+ failedVerificationCount: number;
30
+ latestSessionSummary: string | null;
31
+ latestPatrolSummary: string | null;
32
+ latestVerificationSummary: string | null;
33
+ topRisks: string[];
34
+ nextActions: string[];
35
+ lastActivityAt: string;
36
+ updatedAt: string;
37
+ }
38
+ export interface ButlerSessionDigest {
39
+ id: string;
40
+ projectId: string;
41
+ sessionId: string;
42
+ provider: string | null;
43
+ title: string | null;
44
+ isArchived: boolean;
45
+ role: ButlerProjectSessionView["role"];
46
+ ownershipMode: ButlerProjectSessionView["ownershipMode"];
47
+ status: ButlerProjectSessionView["status"];
48
+ runningState: ButlerProjectSessionView["runningState"];
49
+ lastSummary: string | null;
50
+ lastCheckpointAt: string | null;
51
+ progressState: ButlerCheckpointProgressState;
52
+ riskFlags: string[];
53
+ nextActions: string[];
54
+ updatedAt: string;
55
+ createdAt: string;
56
+ }
57
+ export interface ButlerMemoryDigest {
58
+ id: string;
59
+ projectId: string;
60
+ title: string;
61
+ memoryType: string;
62
+ status: string;
63
+ scopePath: string | null;
64
+ tags: string[];
65
+ confidence: number;
66
+ updatedAt: string;
67
+ createdAt: string;
68
+ }
69
+ export interface ButlerInboxDigest {
70
+ id: string;
71
+ projectId: string;
72
+ workspaceId: string;
73
+ projectName: string;
74
+ itemType: string;
75
+ title: string;
76
+ content: string;
77
+ priority: string;
78
+ status: string;
79
+ updatedAt: string;
80
+ createdAt: string;
81
+ closedAt: string | null;
82
+ }
83
+ export interface ButlerPatrolDigest {
84
+ id: string;
85
+ projectId: string;
86
+ planId: string | null;
87
+ triggeredBy: string;
88
+ status: string;
89
+ riskLevel: string | null;
90
+ summary: string | null;
91
+ suggestions: string[];
92
+ startedAt: string | null;
93
+ finishedAt: string | null;
94
+ createdAt: string;
95
+ }
96
+ export interface ButlerVerificationDigest {
97
+ id: string;
98
+ projectId: string;
99
+ verificationType: string;
100
+ status: string;
101
+ targetRef: string | null;
102
+ summary: string | null;
103
+ startedAt: string | null;
104
+ finishedAt: string | null;
105
+ createdAt: string;
106
+ }
107
+ export interface ButlerContextSnapshot {
108
+ version: string;
109
+ generatedAt: string;
110
+ global: ButlerGlobalDigest;
111
+ projects: ButlerProjectDigest[];
112
+ sessions: ButlerSessionDigest[];
113
+ memories: ButlerMemoryDigest[];
114
+ inboxItems: ButlerInboxDigest[];
115
+ patrols: ButlerPatrolDigest[];
116
+ verifications: ButlerVerificationDigest[];
117
+ }
118
+ export interface ButlerOverview {
119
+ version: string;
120
+ generatedAt: string;
121
+ global: ButlerGlobalDigest;
122
+ projects: ButlerProjectDigest[];
123
+ sessions: ButlerSessionDigest[];
124
+ inboxItems: ButlerInboxDigest[];
125
+ patrols: ButlerPatrolDigest[];
126
+ verifications: ButlerVerificationDigest[];
127
+ }
128
+ export interface ButlerProjectContext {
129
+ version: string;
130
+ generatedAt: string;
131
+ project: ButlerProjectDigest;
132
+ sessions: ButlerSessionDigest[];
133
+ memories: ButlerMemoryDigest[];
134
+ inboxItems: ButlerInboxDigest[];
135
+ patrols: ButlerPatrolDigest[];
136
+ verifications: ButlerVerificationDigest[];
137
+ topRisks: string[];
138
+ nextActions: string[];
139
+ }
140
+ export interface ButlerPromptContext {
141
+ version: string;
142
+ generatedAt: string;
143
+ scope: "global" | "project";
144
+ projectId: string | null;
145
+ prompt: string;
146
+ }
147
+ export interface ButlerSearchHit {
148
+ kind: "project" | "session" | "memory" | "patrol" | "verification";
149
+ id: string;
150
+ sessionId: string | null;
151
+ projectId: string | null;
152
+ workspaceId: string | null;
153
+ title: string;
154
+ summary: string;
155
+ score: number;
156
+ updatedAt: string;
157
+ isArchived: boolean;
158
+ }
159
+ export interface ButlerSearchResult {
160
+ version: string;
161
+ generatedAt: string;
162
+ query: string;
163
+ items: ButlerSearchHit[];
164
+ }
165
+ export declare class ButlerContextAggregator {
166
+ private readonly butlerProfileService;
167
+ private readonly butlerProjectService;
168
+ private readonly butlerSessionService;
169
+ private readonly butlerInboxService;
170
+ private readonly projectMemoryService;
171
+ private readonly patrolRunService;
172
+ private readonly verificationRunService;
173
+ private readonly sessionCheckpointRepository;
174
+ constructor(butlerProfileService: Pick<ButlerProfileService, "getProfile">, butlerProjectService: Pick<ButlerProjectService, "getById" | "list">, butlerSessionService: Pick<ButlerSessionService, "ensureProjectSessionsSynced" | "listByProject">, butlerInboxService: Pick<ButlerInboxService, "listItems">, projectMemoryService: Pick<ProjectMemoryService, "listMemories">, patrolRunService: Pick<PatrolRunService, "listRuns">, verificationRunService: Pick<VerificationRunService, "listRuns">, sessionCheckpointRepository: Pick<SessionCheckpointRepository, "listByButlerSessionId">);
175
+ getOverview(userId: string): Promise<ButlerOverview>;
176
+ getSnapshot(userId: string): Promise<ButlerContextSnapshot>;
177
+ getProjectContext(projectId: string, userId: string): Promise<ButlerProjectContext>;
178
+ resolvePromptContext(userId: string, userMessage?: string | null): Promise<ButlerPromptContext>;
179
+ searchSummaries(userId: string, query: string, options?: {
180
+ projectId?: string | null;
181
+ includeArchived?: boolean;
182
+ }): Promise<ButlerSearchResult>;
183
+ private collectProjectContexts;
184
+ private buildProjectContext;
185
+ private resolveProjectIdFromMessage;
186
+ private getProjectOrThrow;
187
+ }