@multiplayer-app/agent 0.1.9 → 0.1.11

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 (274) hide show
  1. package/README.md +106 -0
  2. package/dist/agent/definition.d.ts +22 -0
  3. package/dist/agent/definition.d.ts.map +1 -0
  4. package/dist/agent/definition.js +3 -0
  5. package/dist/agent/definition.js.map +1 -0
  6. package/dist/agent/definition.test.d.ts +2 -0
  7. package/dist/agent/definition.test.d.ts.map +1 -0
  8. package/dist/agent/definition.test.js +40 -0
  9. package/dist/agent/definition.test.js.map +1 -0
  10. package/dist/agent/model-failure.d.ts +10 -0
  11. package/dist/agent/model-failure.d.ts.map +1 -0
  12. package/dist/agent/model-failure.js +50 -0
  13. package/dist/agent/model-failure.js.map +1 -0
  14. package/dist/agent/profiles/coding.d.ts +4 -0
  15. package/dist/agent/profiles/coding.d.ts.map +1 -0
  16. package/dist/agent/profiles/coding.js +17 -0
  17. package/dist/agent/profiles/coding.js.map +1 -0
  18. package/dist/agent/profiles/index.d.ts +4 -0
  19. package/dist/agent/profiles/index.d.ts.map +1 -0
  20. package/dist/agent/profiles/index.js +9 -0
  21. package/dist/agent/profiles/index.js.map +1 -0
  22. package/dist/agent/profiles/research.d.ts +4 -0
  23. package/dist/agent/profiles/research.d.ts.map +1 -0
  24. package/dist/agent/profiles/research.js +53 -0
  25. package/dist/agent/profiles/research.js.map +1 -0
  26. package/dist/agent/progress-reminder.test.d.ts +2 -0
  27. package/dist/agent/progress-reminder.test.d.ts.map +1 -0
  28. package/dist/agent/progress-reminder.test.js +20 -0
  29. package/dist/agent/progress-reminder.test.js.map +1 -0
  30. package/dist/agent/turn-runner.d.ts +54 -0
  31. package/dist/agent/turn-runner.d.ts.map +1 -0
  32. package/dist/agent/turn-runner.js +147 -0
  33. package/dist/agent/turn-runner.js.map +1 -0
  34. package/dist/agent/turn-runner.test.d.ts +2 -0
  35. package/dist/agent/turn-runner.test.d.ts.map +1 -0
  36. package/dist/agent/turn-runner.test.js +181 -0
  37. package/dist/agent/turn-runner.test.js.map +1 -0
  38. package/dist/context-pruning.d.ts +13 -0
  39. package/dist/context-pruning.d.ts.map +1 -0
  40. package/dist/context-pruning.js +61 -0
  41. package/dist/context-pruning.js.map +1 -0
  42. package/dist/context-pruning.test.d.ts +2 -0
  43. package/dist/context-pruning.test.d.ts.map +1 -0
  44. package/dist/context-pruning.test.js +48 -0
  45. package/dist/context-pruning.test.js.map +1 -0
  46. package/dist/index.d.ts +11 -6
  47. package/dist/index.d.ts.map +1 -1
  48. package/dist/index.js +18 -10
  49. package/dist/index.js.map +1 -1
  50. package/dist/models/attribution.d.ts.map +1 -0
  51. package/dist/models/attribution.js.map +1 -0
  52. package/dist/{model.d.ts → models/resolve-model.d.ts} +2 -2
  53. package/dist/models/resolve-model.d.ts.map +1 -0
  54. package/dist/{model.js → models/resolve-model.js} +4 -2
  55. package/dist/models/resolve-model.js.map +1 -0
  56. package/dist/models/usage.d.ts +11 -0
  57. package/dist/models/usage.d.ts.map +1 -0
  58. package/dist/models/usage.js +19 -0
  59. package/dist/models/usage.js.map +1 -0
  60. package/dist/{git-sync.d.ts → persistence/git-sync.d.ts} +1 -1
  61. package/dist/persistence/git-sync.d.ts.map +1 -0
  62. package/dist/persistence/git-sync.js.map +1 -0
  63. package/dist/persistence/git-sync.test.d.ts.map +1 -0
  64. package/dist/{git-sync.test.js → persistence/git-sync.test.js} +2 -2
  65. package/dist/persistence/git-sync.test.js.map +1 -0
  66. package/dist/{session-storage-sync.d.ts → persistence/snapshot-sync.d.ts} +2 -2
  67. package/dist/persistence/snapshot-sync.d.ts.map +1 -0
  68. package/dist/{session-storage-sync.js → persistence/snapshot-sync.js} +1 -1
  69. package/dist/persistence/snapshot-sync.js.map +1 -0
  70. package/dist/persistence/snapshot-sync.test.d.ts +2 -0
  71. package/dist/persistence/snapshot-sync.test.d.ts.map +1 -0
  72. package/dist/{session-storage-sync.test.js → persistence/snapshot-sync.test.js} +3 -3
  73. package/dist/persistence/snapshot-sync.test.js.map +1 -0
  74. package/dist/persistence/workspace.d.ts +17 -0
  75. package/dist/persistence/workspace.d.ts.map +1 -0
  76. package/dist/persistence/workspace.js +26 -0
  77. package/dist/persistence/workspace.js.map +1 -0
  78. package/dist/persistence/workspace.test.d.ts +2 -0
  79. package/dist/persistence/workspace.test.d.ts.map +1 -0
  80. package/dist/persistence/workspace.test.js +38 -0
  81. package/dist/persistence/workspace.test.js.map +1 -0
  82. package/dist/research/extract-texts.d.ts +41 -0
  83. package/dist/research/extract-texts.d.ts.map +1 -0
  84. package/dist/research/extract-texts.js +239 -0
  85. package/dist/research/extract-texts.js.map +1 -0
  86. package/dist/research/extract-texts.test.d.ts +2 -0
  87. package/dist/research/extract-texts.test.d.ts.map +1 -0
  88. package/dist/research/extract-texts.test.js +120 -0
  89. package/dist/research/extract-texts.test.js.map +1 -0
  90. package/dist/research/extraction-tool.d.ts +6 -0
  91. package/dist/research/extraction-tool.d.ts.map +1 -0
  92. package/dist/research/extraction-tool.js +41 -0
  93. package/dist/research/extraction-tool.js.map +1 -0
  94. package/dist/research/extraction-tool.test.d.ts +2 -0
  95. package/dist/research/extraction-tool.test.d.ts.map +1 -0
  96. package/dist/research/extraction-tool.test.js +102 -0
  97. package/dist/research/extraction-tool.test.js.map +1 -0
  98. package/dist/research/filingramp/attachment-tools.d.ts +4 -0
  99. package/dist/research/filingramp/attachment-tools.d.ts.map +1 -0
  100. package/dist/research/filingramp/attachment-tools.js +198 -0
  101. package/dist/research/filingramp/attachment-tools.js.map +1 -0
  102. package/dist/research/filingramp/document-search-tool.d.ts +4 -0
  103. package/dist/research/filingramp/document-search-tool.d.ts.map +1 -0
  104. package/dist/research/filingramp/document-search-tool.js +231 -0
  105. package/dist/research/filingramp/document-search-tool.js.map +1 -0
  106. package/dist/research/filingramp/filing-detail-tool.d.ts +8 -0
  107. package/dist/research/filingramp/filing-detail-tool.d.ts.map +1 -0
  108. package/dist/research/filingramp/filing-detail-tool.js +161 -0
  109. package/dist/research/filingramp/filing-detail-tool.js.map +1 -0
  110. package/dist/research/filingramp/filing-search-tools.d.ts +4 -0
  111. package/dist/research/filingramp/filing-search-tools.d.ts.map +1 -0
  112. package/dist/research/filingramp/filing-search-tools.js +207 -0
  113. package/dist/research/filingramp/filing-search-tools.js.map +1 -0
  114. package/dist/research/filingramp/shared.d.ts +64 -0
  115. package/dist/research/filingramp/shared.d.ts.map +1 -0
  116. package/dist/research/filingramp/shared.js +130 -0
  117. package/dist/research/filingramp/shared.js.map +1 -0
  118. package/dist/research/filingramp-client.d.ts +1 -1
  119. package/dist/research/filingramp-client.d.ts.map +1 -1
  120. package/dist/research/filingramp-contract.d.ts.map +1 -1
  121. package/dist/research/filingramp-contract.js +8 -2
  122. package/dist/research/filingramp-contract.js.map +1 -1
  123. package/dist/research/filingramp-tools.d.ts +4 -8
  124. package/dist/research/filingramp-tools.d.ts.map +1 -1
  125. package/dist/research/filingramp-tools.js +19 -597
  126. package/dist/research/filingramp-tools.js.map +1 -1
  127. package/dist/research/filingramp-tools.test.js +138 -2
  128. package/dist/research/filingramp-tools.test.js.map +1 -1
  129. package/dist/research/prompt.d.ts +1 -1
  130. package/dist/research/prompt.d.ts.map +1 -1
  131. package/dist/research/prompt.js +16 -7
  132. package/dist/research/prompt.js.map +1 -1
  133. package/dist/research/scope.d.ts +1 -1
  134. package/dist/research/scope.d.ts.map +1 -1
  135. package/dist/runtime/cli.d.ts.map +1 -0
  136. package/dist/{cli.js → runtime/cli.js} +3 -3
  137. package/dist/runtime/cli.js.map +1 -0
  138. package/dist/{config.d.ts → runtime/config.d.ts} +1 -1
  139. package/dist/runtime/config.d.ts.map +1 -0
  140. package/dist/{config.js → runtime/config.js} +1 -1
  141. package/dist/runtime/config.js.map +1 -0
  142. package/dist/{runtime.d.ts → runtime/index.d.ts} +2 -2
  143. package/dist/runtime/index.d.ts.map +1 -0
  144. package/dist/{runtime.js → runtime/index.js} +7 -7
  145. package/dist/runtime/index.js.map +1 -0
  146. package/dist/runtime/lambda-microvm.d.ts +3 -0
  147. package/dist/runtime/lambda-microvm.d.ts.map +1 -0
  148. package/dist/{lambda-microvm-entrypoint.js → runtime/lambda-microvm.js} +4 -4
  149. package/dist/runtime/lambda-microvm.js.map +1 -0
  150. package/dist/runtime/lifecycle.test.d.ts.map +1 -0
  151. package/dist/{lifecycle.test.js → runtime/lifecycle.test.js} +5 -5
  152. package/dist/runtime/lifecycle.test.js.map +1 -0
  153. package/dist/session/checkpoint-timer.test.d.ts.map +1 -0
  154. package/dist/{checkpoint-timer.test.js → session/checkpoint-timer.test.js} +8 -8
  155. package/dist/session/checkpoint-timer.test.js.map +1 -0
  156. package/dist/session/conversation.d.ts +15 -0
  157. package/dist/session/conversation.d.ts.map +1 -0
  158. package/dist/session/conversation.js +61 -0
  159. package/dist/session/conversation.js.map +1 -0
  160. package/dist/session/conversation.test.d.ts +2 -0
  161. package/dist/session/conversation.test.d.ts.map +1 -0
  162. package/dist/session/conversation.test.js +53 -0
  163. package/dist/session/conversation.test.js.map +1 -0
  164. package/dist/session/idle-checkpoint.test.d.ts.map +1 -0
  165. package/dist/{idle-checkpoint.test.js → session/idle-checkpoint.test.js} +8 -4
  166. package/dist/session/idle-checkpoint.test.js.map +1 -0
  167. package/dist/session/index.d.ts +7 -0
  168. package/dist/session/index.d.ts.map +1 -0
  169. package/dist/session/index.js +16 -0
  170. package/dist/session/index.js.map +1 -0
  171. package/dist/session/runtime.d.ts +58 -0
  172. package/dist/session/runtime.d.ts.map +1 -0
  173. package/dist/session/runtime.js +292 -0
  174. package/dist/session/runtime.js.map +1 -0
  175. package/dist/session/runtime.test.d.ts +2 -0
  176. package/dist/session/runtime.test.d.ts.map +1 -0
  177. package/dist/session/runtime.test.js +201 -0
  178. package/dist/session/runtime.test.js.map +1 -0
  179. package/dist/session/tool-context.d.ts +12 -0
  180. package/dist/session/tool-context.d.ts.map +1 -0
  181. package/dist/session/tool-context.js +3 -0
  182. package/dist/session/tool-context.js.map +1 -0
  183. package/dist/session/tools.d.ts +6 -0
  184. package/dist/session/tools.d.ts.map +1 -0
  185. package/dist/session/tools.js +97 -0
  186. package/dist/session/tools.js.map +1 -0
  187. package/dist/session/tools.test.d.ts +2 -0
  188. package/dist/session/tools.test.d.ts.map +1 -0
  189. package/dist/session/tools.test.js +55 -0
  190. package/dist/session/tools.test.js.map +1 -0
  191. package/dist/task/loop.d.ts +6 -0
  192. package/dist/task/loop.d.ts.map +1 -0
  193. package/dist/{loop.js → task/loop.js} +6 -6
  194. package/dist/task/loop.js.map +1 -0
  195. package/dist/tool-call-repair.d.ts +11 -0
  196. package/dist/tool-call-repair.d.ts.map +1 -0
  197. package/dist/tool-call-repair.js +91 -0
  198. package/dist/tool-call-repair.js.map +1 -0
  199. package/dist/tool-call-repair.test.d.ts +2 -0
  200. package/dist/tool-call-repair.test.d.ts.map +1 -0
  201. package/dist/tool-call-repair.test.js +50 -0
  202. package/dist/tool-call-repair.test.js.map +1 -0
  203. package/dist/tools/exec-tools.d.ts +1 -0
  204. package/dist/tools/exec-tools.d.ts.map +1 -1
  205. package/dist/tools/exec-tools.js +23 -3
  206. package/dist/tools/exec-tools.js.map +1 -1
  207. package/dist/transport/link.d.ts.map +1 -0
  208. package/dist/transport/link.js.map +1 -0
  209. package/dist/{protocol.d.ts → transport/protocol.d.ts} +4 -0
  210. package/dist/transport/protocol.d.ts.map +1 -0
  211. package/dist/transport/protocol.js.map +1 -0
  212. package/dist/transport/protocol.test.d.ts.map +1 -0
  213. package/dist/transport/protocol.test.js.map +1 -0
  214. package/dist/{report.d.ts → transport/reporter.d.ts} +1 -1
  215. package/dist/transport/reporter.d.ts.map +1 -0
  216. package/dist/{report.js → transport/reporter.js} +1 -1
  217. package/dist/transport/reporter.js.map +1 -0
  218. package/package.json +11 -11
  219. package/dist/attribution.d.ts.map +0 -1
  220. package/dist/attribution.js.map +0 -1
  221. package/dist/checkpoint-timer.test.d.ts.map +0 -1
  222. package/dist/checkpoint-timer.test.js.map +0 -1
  223. package/dist/cli.d.ts.map +0 -1
  224. package/dist/cli.js.map +0 -1
  225. package/dist/config.d.ts.map +0 -1
  226. package/dist/config.js.map +0 -1
  227. package/dist/git-sync.d.ts.map +0 -1
  228. package/dist/git-sync.js.map +0 -1
  229. package/dist/git-sync.test.d.ts.map +0 -1
  230. package/dist/git-sync.test.js.map +0 -1
  231. package/dist/idle-checkpoint.test.d.ts.map +0 -1
  232. package/dist/idle-checkpoint.test.js.map +0 -1
  233. package/dist/lambda-microvm-entrypoint.d.ts +0 -3
  234. package/dist/lambda-microvm-entrypoint.d.ts.map +0 -1
  235. package/dist/lambda-microvm-entrypoint.js.map +0 -1
  236. package/dist/lifecycle.test.d.ts.map +0 -1
  237. package/dist/lifecycle.test.js.map +0 -1
  238. package/dist/link.d.ts.map +0 -1
  239. package/dist/link.js.map +0 -1
  240. package/dist/loop.d.ts +0 -6
  241. package/dist/loop.d.ts.map +0 -1
  242. package/dist/loop.js.map +0 -1
  243. package/dist/model.d.ts.map +0 -1
  244. package/dist/model.js.map +0 -1
  245. package/dist/protocol.d.ts.map +0 -1
  246. package/dist/protocol.js.map +0 -1
  247. package/dist/protocol.test.d.ts.map +0 -1
  248. package/dist/protocol.test.js.map +0 -1
  249. package/dist/report.d.ts.map +0 -1
  250. package/dist/report.js.map +0 -1
  251. package/dist/runtime.d.ts.map +0 -1
  252. package/dist/runtime.js.map +0 -1
  253. package/dist/session-storage-sync.d.ts.map +0 -1
  254. package/dist/session-storage-sync.js.map +0 -1
  255. package/dist/session-storage-sync.test.d.ts +0 -2
  256. package/dist/session-storage-sync.test.d.ts.map +0 -1
  257. package/dist/session-storage-sync.test.js.map +0 -1
  258. package/dist/session.d.ts +0 -46
  259. package/dist/session.d.ts.map +0 -1
  260. package/dist/session.js +0 -512
  261. package/dist/session.js.map +0 -1
  262. /package/dist/{attribution.d.ts → models/attribution.d.ts} +0 -0
  263. /package/dist/{attribution.js → models/attribution.js} +0 -0
  264. /package/dist/{git-sync.js → persistence/git-sync.js} +0 -0
  265. /package/dist/{git-sync.test.d.ts → persistence/git-sync.test.d.ts} +0 -0
  266. /package/dist/{cli.d.ts → runtime/cli.d.ts} +0 -0
  267. /package/dist/{lifecycle.test.d.ts → runtime/lifecycle.test.d.ts} +0 -0
  268. /package/dist/{checkpoint-timer.test.d.ts → session/checkpoint-timer.test.d.ts} +0 -0
  269. /package/dist/{idle-checkpoint.test.d.ts → session/idle-checkpoint.test.d.ts} +0 -0
  270. /package/dist/{link.d.ts → transport/link.d.ts} +0 -0
  271. /package/dist/{link.js → transport/link.js} +0 -0
  272. /package/dist/{protocol.js → transport/protocol.js} +0 -0
  273. /package/dist/{protocol.test.d.ts → transport/protocol.test.d.ts} +0 -0
  274. /package/dist/{protocol.test.js → transport/protocol.test.js} +0 -0
@@ -0,0 +1,292 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.SessionRuntime = exports.PERIODIC_CHECKPOINT_MS = void 0;
7
+ // Owns session state and lifecycle. Model/tool execution belongs to TurnRunner.
8
+ const node_fs_1 = require("node:fs");
9
+ const node_path_1 = __importDefault(require("node:path"));
10
+ const profiles_1 = require("../agent/profiles");
11
+ const conversation_1 = require("./conversation");
12
+ const turn_runner_1 = require("../agent/turn-runner");
13
+ const model_failure_1 = require("../agent/model-failure");
14
+ const workspace_1 = require("../persistence/workspace");
15
+ exports.PERIODIC_CHECKPOINT_MS = 5 * 60000;
16
+ /** Share of the token budget after which a research turn stops researching and saves what it has. */
17
+ const WRAP_UP_AT = 0.9;
18
+ class SessionRuntime {
19
+ constructor(config, link, dependencies = {}) {
20
+ var _a, _b, _c;
21
+ this.config = config;
22
+ this.link = link;
23
+ this.messages = [];
24
+ this.usedTokens = 0;
25
+ this.budgetPaused = false;
26
+ this.queue = [];
27
+ this.systemPrompt = '';
28
+ this.stopped = false;
29
+ this.checkpointTask = Promise.resolve();
30
+ this.lastCheckpointAt = 0;
31
+ this.lastActivityAt = Date.now();
32
+ this.budget = config.tokenBudget;
33
+ this.persistence = (_a = dependencies.persistence) !== null && _a !== void 0 ? _a : (0, workspace_1.createWorkspacePersistence)(config);
34
+ this.definition = (_b = dependencies.definition) !== null && _b !== void 0 ? _b : (0, profiles_1.createAgentDefinition)(config, this.workspaceDir);
35
+ this.turnRunner = (_c = dependencies.turnRunner) !== null && _c !== void 0 ? _c : new turn_runner_1.TurnRunner(this.definition);
36
+ }
37
+ get workspaceDir() {
38
+ var _a, _b;
39
+ return (_b = (_a = this.persistence) === null || _a === void 0 ? void 0 : _a.dir) !== null && _b !== void 0 ? _b : this.config.workspaceDir;
40
+ }
41
+ async start() {
42
+ let restored = false;
43
+ if (this.persistence) {
44
+ restored = await this.persistence.restore();
45
+ }
46
+ await node_fs_1.promises.mkdir(this.workspaceDir, { recursive: true });
47
+ restored = (await this.loadConversation()) || restored;
48
+ await Promise.all(this.definition.workspaceDirectories.map((dir) => node_fs_1.promises.mkdir(node_path_1.default.join(this.workspaceDir, dir), { recursive: true })));
49
+ this.systemPrompt = this.definition.instructions({ tokenBudget: this.budget, restored });
50
+ this.link.onCommand((command) => this.handle(command));
51
+ await this.link.ready();
52
+ this.lastActivityAt = Date.now();
53
+ this.scheduleCheckpoint();
54
+ this.link.send({ type: 'ready', mode: 'session', profile: this.definition.profile, restored });
55
+ console.log(`[session] ready session=${this.config.sessionId} profile=${this.definition.profile} restored=${restored}`);
56
+ }
57
+ /** Lifecycle hooks (suspend / terminate) call this; it is safe to call repeatedly. */
58
+ checkpoint(reason, requestId) {
59
+ const work = async () => {
60
+ await this.saveConversation();
61
+ if (!this.persistence) {
62
+ if (requestId)
63
+ throw new Error('Durable storage is not configured; workspace cannot be checkpointed');
64
+ return;
65
+ }
66
+ const checkpoint = await this.persistence.checkpoint(`checkpoint: ${reason}`);
67
+ const commit = checkpoint.kind === 'git' ? checkpoint.commit : undefined;
68
+ this.lastCheckpointAt = Date.now();
69
+ this.link.send({ type: 'checkpointed', commit, requestId });
70
+ };
71
+ const next = this.checkpointTask.then(work, work);
72
+ this.checkpointTask = next.catch(() => undefined);
73
+ return next;
74
+ }
75
+ async stop() {
76
+ var _a;
77
+ this.stopped = true;
78
+ if (this.periodic)
79
+ clearTimeout(this.periodic);
80
+ this.periodic = undefined;
81
+ this.queue.length = 0;
82
+ (_a = this.current) === null || _a === void 0 ? void 0 : _a.abort.abort();
83
+ await this.turnTask;
84
+ await this.checkpoint('shutdown');
85
+ }
86
+ /** Idle policy never aborts a turn, and rechecks after a potentially slow storage push. */
87
+ async checkpointIfIdle(idleForMs, requestId) {
88
+ const idle = () => idleForMs > 0
89
+ && !this.stopped
90
+ && !this.current
91
+ && this.queue.length === 0
92
+ && Date.now() - this.lastActivityAt >= idleForMs;
93
+ if (!this.persistence || !idle()) {
94
+ this.link.send({ type: 'checkpointed', requestId, skipped: true });
95
+ return;
96
+ }
97
+ await this.checkpoint('idle');
98
+ const idleConfirmed = idle();
99
+ this.link.send({ type: 'checkpointed', requestId, skipped: !idleConfirmed, idleConfirmed });
100
+ }
101
+ scheduleCheckpoint(delayMs = exports.PERIODIC_CHECKPOINT_MS) {
102
+ if (this.stopped)
103
+ return;
104
+ // Schedule after completion so slow storage cannot build an unbounded checkpoint queue.
105
+ this.periodic = setTimeout(() => {
106
+ const remaining = exports.PERIODIC_CHECKPOINT_MS - (Date.now() - this.lastCheckpointAt);
107
+ if (remaining > 0) {
108
+ this.scheduleCheckpoint(remaining);
109
+ return;
110
+ }
111
+ void this.checkpoint('periodic')
112
+ .catch((error) => console.error('[session] periodic checkpoint failed:', error))
113
+ .finally(() => this.scheduleCheckpoint());
114
+ }, delayMs);
115
+ this.periodic.unref();
116
+ }
117
+ async handle(command) {
118
+ var _a;
119
+ switch (command.type) {
120
+ case 'message':
121
+ if (this.stopped)
122
+ throw new Error('Session has stopped; cannot accept messages');
123
+ this.lastActivityAt = Date.now();
124
+ this.queue.push({ messageId: command.messageId, text: command.text });
125
+ this.startQueuedTurns();
126
+ return;
127
+ case 'abort':
128
+ this.queue.length = 0;
129
+ (_a = this.current) === null || _a === void 0 ? void 0 : _a.abort.abort();
130
+ return;
131
+ case 'checkpoint':
132
+ if (command.onlyIfIdleForMs !== undefined) {
133
+ await this.checkpointIfIdle(command.onlyIfIdleForMs, command.requestId);
134
+ return;
135
+ }
136
+ if (command.waitForTurn)
137
+ await this.turnTask;
138
+ await this.checkpoint('requested', command.requestId);
139
+ return;
140
+ }
141
+ }
142
+ /** One task owns the queue, including turns arriving while the previous turn checkpoints. */
143
+ startQueuedTurns() {
144
+ if (this.turnTask || this.current || this.stopped || this.queue.length === 0)
145
+ return;
146
+ this.turnTask = this.drainQueue().finally(() => {
147
+ this.turnTask = undefined;
148
+ // A message can arrive between drainQueue's last check and this completion callback.
149
+ this.startQueuedTurns();
150
+ });
151
+ }
152
+ async drainQueue() {
153
+ while (!this.stopped && this.queue.length > 0) {
154
+ const next = this.queue.shift();
155
+ await this.runTurn(next.messageId, next.text);
156
+ }
157
+ }
158
+ budgetExceeded() {
159
+ return this.budget !== undefined && this.usedTokens >= this.budget;
160
+ }
161
+ nearBudget() {
162
+ return this.budget !== undefined && this.usedTokens >= this.budget * WRAP_UP_AT;
163
+ }
164
+ /**
165
+ * The budget pause as a question with an answer form, like the agent's own request_clarification:
166
+ * the platform routes the answer straight back here (answer-research-question.ts) instead of to
167
+ * the chat's orchestrator, which would otherwise decide for itself whether to resume.
168
+ */
169
+ askBudgetQuestion(messageId) {
170
+ var _a, _b;
171
+ const toolCallId = `budget-${messageId}-${this.usedTokens}`;
172
+ const extension = (_b = (_a = this.config.tokenBudget) === null || _a === void 0 ? void 0 : _a.toLocaleString()) !== null && _b !== void 0 ? _b : '';
173
+ const input = {
174
+ question: `The token budget for this session is used up. Continue the research with ${extension} more tokens, or wrap up with what I have?`,
175
+ selectionMode: 'single',
176
+ options: [
177
+ { id: 'continue', label: `Continue (+${extension} tokens)` },
178
+ { id: 'wrap_up', label: 'Wrap up with what I have' },
179
+ ],
180
+ allowFreeText: false,
181
+ };
182
+ this.link.send({ type: 'tool_call_start', messageId, toolCallId, toolName: 'request_clarification', input });
183
+ this.link.send({ type: 'question', messageId, toolCallId, question: input.question });
184
+ }
185
+ async runTurn(messageId, text) {
186
+ var _a;
187
+ const turn = { messageId, abort: new AbortController() };
188
+ let wrapUpOnly = false;
189
+ this.current = turn;
190
+ let accepted = false;
191
+ let completed = false;
192
+ let responseRecorded = false;
193
+ try {
194
+ this.link.send({ type: 'turn_start', messageId });
195
+ // A paused session resumes when the user agrees to another original-sized budget. The answer
196
+ // usually comes from the pause question's form (askBudgetQuestion labels).
197
+ if (this.budgetPaused && this.config.tokenBudget) {
198
+ if (/^(continue|yes|go on|proceed)/i.test(text.trim())) {
199
+ this.budget = this.usedTokens + this.config.tokenBudget;
200
+ this.budgetPaused = false;
201
+ }
202
+ else if (/^wrap/i.test(text.trim()) && this.definition.profile === 'research') {
203
+ wrapUpOnly = true;
204
+ }
205
+ else {
206
+ this.link.send({ type: 'done', messageId, summary: 'The token budget is used up. Reply "continue" to extend it, or "wrap up" to save what I have.' });
207
+ return;
208
+ }
209
+ }
210
+ this.messages.push({ role: 'user', content: text });
211
+ accepted = true;
212
+ const result = await this.turnRunner.run({
213
+ messageId,
214
+ messages: (0, conversation_1.limitConversation)(this.messages),
215
+ instructions: this.systemPrompt,
216
+ workspaceDir: this.workspaceDir,
217
+ abortSignal: turn.abort.signal,
218
+ budgetExceeded: () => this.budgetExceeded(),
219
+ nearBudget: () => this.nearBudget(),
220
+ wrapUpOnly,
221
+ recordUsage: (usage) => { this.usedTokens += usage.totalTokens; },
222
+ emit: (event) => this.link.send(event),
223
+ });
224
+ this.messages.push(...result.messages);
225
+ responseRecorded = true;
226
+ completed = result.status === 'completed';
227
+ if (result.status === 'completed') {
228
+ let partialText = result.partialText;
229
+ // A wrap-up that finished just under the budget still pauses: the next turn would only wrap up again.
230
+ if ((this.budgetExceeded() || result.wrappedUp) && !result.askedUser) {
231
+ this.budgetPaused = true;
232
+ const saved = result.saved ? ' I saved partial findings and notes.' : '';
233
+ const notice = wrapUpOnly
234
+ ? `${partialText ? '\n\n' : ''}${result.saved ? 'I saved what I have.' : 'I could not save the findings.'} Reply "continue" if you want me to resume the research.`
235
+ : `${partialText ? '\n\n' : ''}I have used ${this.usedTokens.toLocaleString()} tokens, which reaches this session's budget.${saved}`;
236
+ partialText += notice;
237
+ this.link.send({ type: 'text_delta', messageId, text: notice });
238
+ if (!wrapUpOnly)
239
+ this.askBudgetQuestion(messageId);
240
+ }
241
+ await this.checkpoint('turn finished');
242
+ this.link.send({ type: 'done', messageId, summary: result.text || partialText });
243
+ }
244
+ else if (result.status === 'aborted') {
245
+ this.link.send({ type: 'done', messageId, summary: result.partialText ? `${result.partialText}\n\n_Stopped._` : 'Stopped.' });
246
+ }
247
+ else {
248
+ this.reportTurnError(messageId, result.error, result.userMessage);
249
+ }
250
+ }
251
+ catch (error) {
252
+ // Unexpected executor or checkpoint failures must not leave an unanswered user message.
253
+ if (accepted && !responseRecorded)
254
+ this.messages.push({ role: 'assistant', content: '(turn failed)' });
255
+ this.reportTurnError(messageId, (0, model_failure_1.describeModelFailure)(error), (_a = (0, model_failure_1.userFacingModelFailure)(error)) !== null && _a !== void 0 ? _a : (0, model_failure_1.describeModelFailure)(error));
256
+ }
257
+ finally {
258
+ if (accepted && !completed) {
259
+ await this.checkpoint('turn interrupted').catch((error) => console.error('[session] checkpoint failed:', error));
260
+ }
261
+ this.current = undefined;
262
+ this.lastActivityAt = Date.now();
263
+ }
264
+ }
265
+ /** `detail` is the failure as reported (log only); `message` is what reaches the chat. */
266
+ reportTurnError(messageId, detail, message) {
267
+ console.error('[session] turn failed:', detail);
268
+ this.link.send({ type: 'error', messageId, message });
269
+ }
270
+ async loadConversation() {
271
+ var _a, _b, _c;
272
+ const saved = await (0, conversation_1.readConversation)(this.workspaceDir);
273
+ if (!saved)
274
+ return false;
275
+ this.messages = saved.messages;
276
+ this.usedTokens = (_a = saved.usedTokens) !== null && _a !== void 0 ? _a : 0;
277
+ this.budget = (_b = saved.budget) !== null && _b !== void 0 ? _b : this.budget;
278
+ this.budgetPaused = (_c = saved.budgetPaused) !== null && _c !== void 0 ? _c : this.budgetExceeded();
279
+ return this.messages.length > 0;
280
+ }
281
+ saveConversation() {
282
+ return (0, conversation_1.writeConversation)(this.workspaceDir, () => ({
283
+ version: 1,
284
+ messages: this.messages,
285
+ usedTokens: this.usedTokens,
286
+ budget: this.budget,
287
+ budgetPaused: this.budgetPaused,
288
+ }));
289
+ }
290
+ }
291
+ exports.SessionRuntime = SessionRuntime;
292
+ //# sourceMappingURL=runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/session/runtime.ts"],"names":[],"mappings":";;;;;;AAAA,gFAAgF;AAChF,qCAAwC;AACxC,0DAA4B;AAM5B,gDAAyD;AACzD,iDAAuF;AACvF,sDAAiD;AACjD,0DAAqF;AACrF,wDAAgG;AAEnF,QAAA,sBAAsB,GAAG,CAAC,GAAG,KAAM,CAAA;AAkBhD,qGAAqG;AACrG,MAAM,UAAU,GAAG,GAAG,CAAA;AAEtB,MAAa,cAAc;IAkBzB,YACmB,MAA0B,EAC1B,IAAiB,EAClC,eAA2C,EAAE;;QAF5B,WAAM,GAAN,MAAM,CAAoB;QAC1B,SAAI,GAAJ,IAAI,CAAa;QAnB5B,aAAQ,GAAmB,EAAE,CAAA;QAC7B,eAAU,GAAG,CAAC,CAAA;QAEd,iBAAY,GAAG,KAAK,CAAA;QAEX,UAAK,GAAoB,EAAE,CAAA;QAIpC,iBAAY,GAAG,EAAE,CAAA;QAEjB,YAAO,GAAG,KAAK,CAAA;QAEf,mBAAc,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAA;QACjD,qBAAgB,GAAG,CAAC,CAAA;QACpB,mBAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAOjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAA;QAChC,IAAI,CAAC,WAAW,GAAG,MAAA,YAAY,CAAC,WAAW,mCAAI,IAAA,sCAA0B,EAAC,MAAM,CAAC,CAAA;QACjF,IAAI,CAAC,UAAU,GAAG,MAAA,YAAY,CAAC,UAAU,mCAAI,IAAA,gCAAqB,EAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAC7F,IAAI,CAAC,UAAU,GAAG,MAAA,YAAY,CAAC,UAAU,mCAAI,IAAI,wBAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC9E,CAAC;IAED,IAAY,YAAY;;QACtB,OAAO,MAAA,MAAA,IAAI,CAAC,WAAW,0CAAE,GAAG,mCAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;IAC1D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAA;QAC7C,CAAC;QACD,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,QAAQ,CAAA;QACtD,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACtI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;QAExF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QACtD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;QACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAChC,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC9F,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,MAAM,CAAC,SAAS,YAAY,IAAI,CAAC,UAAU,CAAC,OAAO,aAAa,QAAQ,EAAE,CAAC,CAAA;IACzH,CAAC;IAED,sFAAsF;IACtF,UAAU,CAAC,MAAc,EAAE,SAAkB;QAC3C,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;YAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,IAAI,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAA;gBACrG,OAAM;YACR,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,eAAe,MAAM,EAAE,CAAC,CAAA;YAC7E,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;YACxE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QAC7D,CAAC,CAAA;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACjD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACjD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,IAAI;;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,IAAI,CAAC,QAAQ;YAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;QACzB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QACrB,MAAA,IAAI,CAAC,OAAO,0CAAE,KAAK,CAAC,KAAK,EAAE,CAAA;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAA;QACnB,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IACnC,CAAC;IAED,2FAA2F;IAC3F,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,SAAkB;QAC1D,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,GAAG,CAAC;eAC3B,CAAC,IAAI,CAAC,OAAO;eACb,CAAC,IAAI,CAAC,OAAO;eACb,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;eACvB,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,IAAI,SAAS,CAAA;QAClD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YAClE,OAAM;QACR,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QAC7B,MAAM,aAAa,GAAG,IAAI,EAAE,CAAA;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAA;IAC7F,CAAC;IAEO,kBAAkB,CAAC,OAAO,GAAG,8BAAsB;QACzD,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,wFAAwF;QACxF,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,MAAM,SAAS,GAAG,8BAAsB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAA;YAC/E,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;gBAClC,OAAM;YACR,CAAC;YACD,KAAK,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;iBAC7B,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;iBAC/E,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAA;QAC7C,CAAC,EAAE,OAAO,CAAC,CAAA;QACX,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAA4B;;QAC/C,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,SAAS;gBACZ,IAAI,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;gBAChF,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;gBACrE,IAAI,CAAC,gBAAgB,EAAE,CAAA;gBACvB,OAAM;YACR,KAAK,OAAO;gBACV,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;gBACrB,MAAA,IAAI,CAAC,OAAO,0CAAE,KAAK,CAAC,KAAK,EAAE,CAAA;gBAC3B,OAAM;YACR,KAAK,YAAY;gBACf,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;oBAC1C,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;oBACvE,OAAM;gBACR,CAAC;gBACD,IAAI,OAAO,CAAC,WAAW;oBAAE,MAAM,IAAI,CAAC,QAAQ,CAAA;gBAC5C,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;gBACrD,OAAM;QACV,CAAC;IACH,CAAC;IAED,6FAA6F;IACrF,gBAAgB;QACtB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACpF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAC7C,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;YACzB,qFAAqF;YACrF,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACzB,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAA;YAChC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAA;IACpE,CAAC;IAEO,UAAU;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,CAAA;IACjF,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,SAAiB;;QACzC,MAAM,UAAU,GAAG,UAAU,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAA;QAC3D,MAAM,SAAS,GAAG,MAAA,MAAA,IAAI,CAAC,MAAM,CAAC,WAAW,0CAAE,cAAc,EAAE,mCAAI,EAAE,CAAA;QACjE,MAAM,KAAK,GAAG;YACZ,QAAQ,EAAE,4EAA4E,SAAS,4CAA4C;YAC3I,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE;gBACP,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,SAAS,UAAU,EAAE;gBAC5D,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,0BAA0B,EAAE;aACrD;YACD,aAAa,EAAE,KAAK;SACrB,CAAA;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5G,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvF,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,IAAY;;QACnD,MAAM,IAAI,GAAe,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,eAAe,EAAE,EAAE,CAAA;QACpE,IAAI,UAAU,GAAG,KAAK,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,IAAI,gBAAgB,GAAG,KAAK,CAAA;QAE5B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAA;YACjD,6FAA6F;YAC7F,2EAA2E;YAC3E,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBACjD,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBACvD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAA;oBACvD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;gBAC3B,CAAC;qBAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBAChF,UAAU,GAAG,IAAI,CAAA;gBACnB,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,+FAA+F,EAAE,CAAC,CAAA;oBACrJ,OAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YACnD,QAAQ,GAAG,IAAI,CAAA;YACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBACvC,SAAS;gBACT,QAAQ,EAAE,IAAA,gCAAiB,EAAC,IAAI,CAAC,QAAQ,CAAC;gBAC1C,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;gBAC9B,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC3C,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE;gBACnC,UAAU;gBACV,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW,CAAA,CAAC,CAAC;gBAChE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;aACvC,CAAC,CAAA;YACF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;YACtC,gBAAgB,GAAG,IAAI,CAAA;YACvB,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,WAAW,CAAA;YAEzC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,IAAI,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;gBACpC,sGAAsG;gBACtG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;oBACrE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;oBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAAE,CAAA;oBACxE,MAAM,MAAM,GAAG,UAAU;wBACvB,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,gCAAgC,0DAA0D;wBACnK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,gDAAgD,KAAK,EAAE,CAAA;oBACtI,WAAW,IAAI,MAAM,CAAA;oBACrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;oBAC/D,IAAI,CAAC,UAAU;wBAAE,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;gBACpD,CAAC;gBACD,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;gBACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAA;YAClF,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,gBAAgB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAA;YAC/H,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;YACnE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wFAAwF;YACxF,IAAI,QAAQ,IAAI,CAAC,gBAAgB;gBAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAA;YACtG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,IAAA,oCAAoB,EAAC,KAAK,CAAC,EAAE,MAAA,IAAA,sCAAsB,EAAC,KAAK,CAAC,mCAAI,IAAA,oCAAoB,EAAC,KAAK,CAAC,CAAC,CAAA;QAC5H,CAAC;gBAAS,CAAC;YACT,IAAI,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC,CAAA;YAClH,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;YACxB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAClC,CAAC;IACH,CAAC;IAED,0FAA0F;IAClF,eAAe,CAAC,SAAiB,EAAE,MAAc,EAAE,OAAe;QACxE,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;IAEO,KAAK,CAAC,gBAAgB;;QAC5B,MAAM,KAAK,GAAG,MAAM,IAAA,+BAAgB,EAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACvD,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;QAC9B,IAAI,CAAC,UAAU,GAAG,MAAA,KAAK,CAAC,UAAU,mCAAI,CAAC,CAAA;QACvC,IAAI,CAAC,MAAM,GAAG,MAAA,KAAK,CAAC,MAAM,mCAAI,IAAI,CAAC,MAAM,CAAA;QACzC,IAAI,CAAC,YAAY,GAAG,MAAA,KAAK,CAAC,YAAY,mCAAI,IAAI,CAAC,cAAc,EAAE,CAAA;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;IACjC,CAAC;IAEO,gBAAgB;QACtB,OAAO,IAAA,gCAAiB,EAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;YACjD,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC,CAAA;IACL,CAAC;CACF;AAxRD,wCAwRC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=runtime.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.test.d.ts","sourceRoot":"","sources":["../../src/session/runtime.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,201 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_fs_1 = require("node:fs");
8
+ const node_os_1 = __importDefault(require("node:os"));
9
+ const node_path_1 = __importDefault(require("node:path"));
10
+ const node_test_1 = require("node:test");
11
+ const index_1 = require("./index");
12
+ const runtime_1 = require("./runtime");
13
+ const conversation_1 = require("./conversation");
14
+ function deferred() {
15
+ let resolve;
16
+ const promise = new Promise((done) => {
17
+ resolve = done;
18
+ });
19
+ return { promise, resolve };
20
+ }
21
+ function completed(text = 'Answer') {
22
+ return { status: 'completed', text, partialText: text, askedUser: false, messages: [{ role: 'assistant', content: text }] };
23
+ }
24
+ async function fixture(t, options = {}) {
25
+ const dir = await node_fs_1.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'agent-runtime-'));
26
+ const events = [];
27
+ const calls = [];
28
+ const checkpoints = [];
29
+ let handle;
30
+ const config = {
31
+ sessionId: 'test', mode: 'session', profile: 'coding', workspaceDir: dir,
32
+ model: 'unused', extractionModel: 'unused', provider: {}, mcpConnections: [], tokenBudget: options.tokenBudget,
33
+ };
34
+ const runtime = new runtime_1.SessionRuntime(config, {
35
+ send: (event) => events.push(event), onCommand: (handler) => { handle = handler; },
36
+ async ready() { }, async close() { },
37
+ }, {
38
+ turnRunner: { async run(input) {
39
+ calls.push(input);
40
+ return options.run ? options.run(input) : completed();
41
+ } },
42
+ persistence: {
43
+ dir,
44
+ async restore() { return false; },
45
+ async checkpoint(reason) {
46
+ var _a;
47
+ checkpoints.push(reason);
48
+ await ((_a = options.checkpoint) === null || _a === void 0 ? void 0 : _a.call(options, reason, dir));
49
+ return { kind: 'snapshot', hash: 'snapshot-hash' };
50
+ },
51
+ },
52
+ });
53
+ t.after(async () => {
54
+ await runtime.stop();
55
+ await node_fs_1.promises.rm(dir, { recursive: true, force: true });
56
+ });
57
+ await runtime.start();
58
+ const send = async (messageId, text = messageId) => handle({ type: 'message', messageId, text });
59
+ const flush = async () => handle({ type: 'checkpoint', requestId: 'flush', waitForTurn: true });
60
+ return { runtime, events, calls, checkpoints, dir, send, flush };
61
+ }
62
+ (0, node_test_1.it)('preserves SessionAgent as an alias for SessionRuntime', () => {
63
+ strict_1.default.equal(index_1.SessionAgent, runtime_1.SessionRuntime);
64
+ });
65
+ (0, node_test_1.it)('queues messages behind durable completion and waits for accepted turns before acknowledging a checkpoint', async (t) => {
66
+ var _a;
67
+ const entered = deferred();
68
+ const release = deferred();
69
+ let first = true;
70
+ const { send, flush, calls, events, checkpoints, dir } = await fixture(t, {
71
+ checkpoint: async (reason, workspace) => {
72
+ var _a;
73
+ if (!first)
74
+ return;
75
+ first = false;
76
+ strict_1.default.equal(reason, 'checkpoint: turn finished');
77
+ strict_1.default.deepEqual((_a = (await (0, conversation_1.readConversation)(workspace))) === null || _a === void 0 ? void 0 : _a.messages.map((message) => message.role), ['user', 'assistant']);
78
+ entered.resolve();
79
+ await release.promise;
80
+ },
81
+ });
82
+ await send('first');
83
+ await entered.promise;
84
+ try {
85
+ await send('second');
86
+ strict_1.default.equal(calls.length, 1);
87
+ strict_1.default.equal(events.some((event) => event.type === 'done'), false);
88
+ }
89
+ finally {
90
+ release.resolve();
91
+ }
92
+ await flush();
93
+ strict_1.default.deepEqual(calls.map((call) => call.messageId), ['first', 'second']);
94
+ strict_1.default.deepEqual(events.filter((event) => event.type === 'done').map((event) => event.messageId), ['first', 'second']);
95
+ strict_1.default.deepEqual(checkpoints, ['checkpoint: turn finished', 'checkpoint: turn finished', 'checkpoint: requested']);
96
+ strict_1.default.equal((_a = (await (0, conversation_1.readConversation)(dir))) === null || _a === void 0 ? void 0 : _a.messages.length, 4);
97
+ strict_1.default.ok(events.filter((event) => event.type === 'checkpointed').every((event) => event.commit === undefined), 'snapshot hashes are not Git commits');
98
+ });
99
+ (0, node_test_1.it)('continues draining the queue after a budget rejection and persists the extended budget', async (t) => {
100
+ const started = deferred();
101
+ const release = deferred();
102
+ const { send, flush, calls, events, dir } = await fixture(t, {
103
+ tokenBudget: 10,
104
+ run: async (input) => {
105
+ if (input.messageId === 'first') {
106
+ started.resolve();
107
+ await release.promise;
108
+ }
109
+ input.recordUsage({ inputTokens: 5, outputTokens: 5, totalTokens: 10 });
110
+ return completed();
111
+ },
112
+ });
113
+ await send('first');
114
+ await started.promise;
115
+ try {
116
+ await send('rejected', 'Explain more');
117
+ await send('continued', 'continue');
118
+ }
119
+ finally {
120
+ release.resolve();
121
+ }
122
+ await flush();
123
+ strict_1.default.deepEqual(calls.map((call) => call.messageId), ['first', 'continued']);
124
+ strict_1.default.ok(events.some((event) => { var _a; return event.type === 'done' && event.messageId === 'rejected' && ((_a = event.summary) === null || _a === void 0 ? void 0 : _a.includes('budget is used up')); }));
125
+ const saved = await (0, conversation_1.readConversation)(dir);
126
+ strict_1.default.equal(saved === null || saved === void 0 ? void 0 : saved.usedTokens, 20);
127
+ strict_1.default.equal(saved === null || saved === void 0 ? void 0 : saved.budget, 20);
128
+ strict_1.default.equal(saved === null || saved === void 0 ? void 0 : saved.budgetPaused, true);
129
+ strict_1.default.equal(saved === null || saved === void 0 ? void 0 : saved.messages.length, 4);
130
+ });
131
+ (0, node_test_1.it)('reports a failed durable checkpoint without announcing completion or duplicating the response on retry', async (t) => {
132
+ var _a;
133
+ let fail = true;
134
+ const { send, flush, events, dir } = await fixture(t, {
135
+ checkpoint: async () => {
136
+ if (fail) {
137
+ fail = false;
138
+ throw new Error('Storage unavailable');
139
+ }
140
+ },
141
+ });
142
+ await send('first');
143
+ await flush();
144
+ strict_1.default.ok(events.some((event) => event.type === 'error' && event.message === 'Storage unavailable'));
145
+ strict_1.default.equal(events.some((event) => event.type === 'done'), false);
146
+ strict_1.default.equal((_a = (await (0, conversation_1.readConversation)(dir))) === null || _a === void 0 ? void 0 : _a.messages.length, 2);
147
+ strict_1.default.ok(events.some((event) => event.type === 'checkpointed' && event.requestId === 'flush'));
148
+ });
149
+ (0, node_test_1.it)('aborts the active turn, discards queued work, and checkpoints before shutdown resolves', async (t) => {
150
+ var _a;
151
+ const started = deferred();
152
+ const { runtime, send, calls, checkpoints, dir } = await fixture(t, {
153
+ run: async (input) => {
154
+ started.resolve();
155
+ await new Promise((resolve) => input.abortSignal.addEventListener('abort', () => resolve(), { once: true }));
156
+ return { status: 'aborted', partialText: 'Partial work', askedUser: false, messages: [{ role: 'assistant', content: 'Partial work' }] };
157
+ },
158
+ });
159
+ await send('first');
160
+ await started.promise;
161
+ await send('queued');
162
+ await runtime.stop();
163
+ strict_1.default.equal(calls.length, 1);
164
+ strict_1.default.deepEqual(checkpoints, ['checkpoint: turn interrupted', 'checkpoint: shutdown']);
165
+ strict_1.default.deepEqual((_a = (await (0, conversation_1.readConversation)(dir))) === null || _a === void 0 ? void 0 : _a.messages, [
166
+ { role: 'user', content: 'first' }, { role: 'assistant', content: 'Partial work' },
167
+ ]);
168
+ await strict_1.default.rejects(send('too-late'), /Session has stopped/);
169
+ });
170
+ (0, node_test_1.it)('serializes concurrent checkpoints and allows the next checkpoint to retry after failure', async (t) => {
171
+ const entered = deferred();
172
+ const release = deferred();
173
+ let active = 0;
174
+ let maximum = 0;
175
+ let attempts = 0;
176
+ const { runtime, events } = await fixture(t, {
177
+ checkpoint: async () => {
178
+ attempts += 1;
179
+ active += 1;
180
+ maximum = Math.max(maximum, active);
181
+ try {
182
+ if (attempts === 1) {
183
+ entered.resolve();
184
+ await release.promise;
185
+ throw new Error('First upload failed');
186
+ }
187
+ }
188
+ finally {
189
+ active -= 1;
190
+ }
191
+ },
192
+ });
193
+ const failed = strict_1.default.rejects(runtime.checkpoint('first', 'first'), /First upload failed/);
194
+ await entered.promise;
195
+ const retried = runtime.checkpoint('second', 'second');
196
+ release.resolve();
197
+ await Promise.all([failed, retried]);
198
+ strict_1.default.equal(maximum, 1);
199
+ strict_1.default.deepEqual(events.filter((event) => event.type === 'checkpointed').map((event) => event.requestId), ['second']);
200
+ });
201
+ //# sourceMappingURL=runtime.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.test.js","sourceRoot":"","sources":["../../src/session/runtime.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { AgentProgressStep, AgentSessionFile } from '../transport/protocol';
2
+ import type { TokenUsage } from '../models/usage';
3
+ /** Bound to one turn. Tools cannot access the queue, session state, or gateway connection. */
4
+ export interface SessionToolContext {
5
+ readonly workspaceDir: string;
6
+ readonly abortSignal: AbortSignal;
7
+ reportProgress(steps: AgentProgressStep[], toolCallId: string): void;
8
+ requestClarification(question: string, toolCallId: string): void;
9
+ publishFiles(files: AgentSessionFile[]): void;
10
+ recordUsage(usage: TokenUsage, model: string): void;
11
+ }
12
+ //# sourceMappingURL=tool-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-context.d.ts","sourceRoot":"","sources":["../../src/session/tool-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,8FAA8F;AAC9F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACpE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAChE,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAA;IAC7C,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACpD"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=tool-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-context.js","sourceRoot":"","sources":["../../src/session/tool-context.ts"],"names":[],"mappings":""}
@@ -0,0 +1,6 @@
1
+ import { type Tool } from 'ai';
2
+ import type { McpConnectionRecord } from '../mcp/mcp-connection';
3
+ import type { SessionToolContext } from './tool-context';
4
+ /** Common tools for both profiles. Callbacks are bound to the turn that owns these tools. */
5
+ export declare function createSessionTools(context: SessionToolContext, mcpConnections: McpConnectionRecord[]): Record<string, Tool>;
6
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/session/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAGpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAIhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAIxD,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAqF3H"}