@polyweave/preston 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (271) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +119 -2
  3. package/assets/logo.png +0 -0
  4. package/assets/logo.webp +0 -0
  5. package/dist/agents/migration.js +29 -0
  6. package/dist/agents/migration.js.map +1 -0
  7. package/dist/agents/updater.js +385 -0
  8. package/dist/agents/updater.js.map +1 -0
  9. package/dist/channels/chat.js +236 -0
  10. package/dist/channels/chat.js.map +1 -0
  11. package/dist/channels/discord/index.js +491 -0
  12. package/dist/channels/discord/index.js.map +1 -0
  13. package/dist/channels/discord/transport.js +130 -0
  14. package/dist/channels/discord/transport.js.map +1 -0
  15. package/dist/channels/fake/index.js +104 -0
  16. package/dist/channels/fake/index.js.map +1 -0
  17. package/dist/channels/hub.js +153 -0
  18. package/dist/channels/hub.js.map +1 -0
  19. package/dist/channels/outbox.js +219 -0
  20. package/dist/channels/outbox.js.map +1 -0
  21. package/dist/channels/registry.js +67 -0
  22. package/dist/channels/registry.js.map +1 -0
  23. package/dist/channels/router.js +50 -0
  24. package/dist/channels/router.js.map +1 -0
  25. package/dist/channels/shared/delivery.js +74 -0
  26. package/dist/channels/shared/delivery.js.map +1 -0
  27. package/dist/channels/shared/files.js +87 -0
  28. package/dist/channels/shared/files.js.map +1 -0
  29. package/dist/channels/shared/pairing.js +99 -0
  30. package/dist/channels/shared/pairing.js.map +1 -0
  31. package/dist/channels/shared/secrets.js +75 -0
  32. package/dist/channels/shared/secrets.js.map +1 -0
  33. package/dist/channels/shared/text.js +68 -0
  34. package/dist/channels/shared/text.js.map +1 -0
  35. package/dist/channels/shared/typing.js +59 -0
  36. package/dist/channels/shared/typing.js.map +1 -0
  37. package/dist/channels/slack/index.js +560 -0
  38. package/dist/channels/slack/index.js.map +1 -0
  39. package/dist/channels/slack/transport.js +184 -0
  40. package/dist/channels/slack/transport.js.map +1 -0
  41. package/dist/channels/terminal.js +67 -0
  42. package/dist/channels/terminal.js.map +1 -0
  43. package/dist/channels/types.js +6 -0
  44. package/dist/channels/types.js.map +1 -0
  45. package/dist/cli-args.js +92 -0
  46. package/dist/cli-args.js.map +1 -0
  47. package/dist/cli.js +120 -0
  48. package/dist/cli.js.map +1 -0
  49. package/dist/clock.js +76 -0
  50. package/dist/clock.js.map +1 -0
  51. package/dist/config/config.js +184 -0
  52. package/dist/config/config.js.map +1 -0
  53. package/dist/config/schema.js +209 -0
  54. package/dist/config/schema.js.map +1 -0
  55. package/dist/coordinator/coordinator.js +494 -0
  56. package/dist/coordinator/coordinator.js.map +1 -0
  57. package/dist/coordinator/inbox.js +64 -0
  58. package/dist/coordinator/inbox.js.map +1 -0
  59. package/dist/coordinator/input.js +75 -0
  60. package/dist/coordinator/input.js.map +1 -0
  61. package/dist/daemon/daemon.js +228 -0
  62. package/dist/daemon/daemon.js.map +1 -0
  63. package/dist/daemon/ensure.js +87 -0
  64. package/dist/daemon/ensure.js.map +1 -0
  65. package/dist/daemon/lock.js +54 -0
  66. package/dist/daemon/lock.js.map +1 -0
  67. package/dist/daemon/start-at-login.js +20 -0
  68. package/dist/daemon/start-at-login.js.map +1 -0
  69. package/dist/daemon/stop.js +51 -0
  70. package/dist/daemon/stop.js.map +1 -0
  71. package/dist/goals/agents.js +36 -0
  72. package/dist/goals/agents.js.map +1 -0
  73. package/dist/goals/brief.js +51 -0
  74. package/dist/goals/brief.js.map +1 -0
  75. package/dist/goals/checks.js +75 -0
  76. package/dist/goals/checks.js.map +1 -0
  77. package/dist/goals/engine.js +1253 -0
  78. package/dist/goals/engine.js.map +1 -0
  79. package/dist/goals/messages.js +110 -0
  80. package/dist/goals/messages.js.map +1 -0
  81. package/dist/goals/status.js +118 -0
  82. package/dist/goals/status.js.map +1 -0
  83. package/dist/goals/store.js +285 -0
  84. package/dist/goals/store.js.map +1 -0
  85. package/dist/home.js +52 -0
  86. package/dist/home.js.map +1 -0
  87. package/dist/i18n/index.js +37 -0
  88. package/dist/i18n/index.js.map +1 -0
  89. package/dist/ipc/client.js +82 -0
  90. package/dist/ipc/client.js.map +1 -0
  91. package/dist/ipc/private-dir.js +23 -0
  92. package/dist/ipc/private-dir.js.map +1 -0
  93. package/dist/ipc/protocol.js +50 -0
  94. package/dist/ipc/protocol.js.map +1 -0
  95. package/dist/ipc/server.js +110 -0
  96. package/dist/ipc/server.js.map +1 -0
  97. package/dist/landing/exec.js +38 -0
  98. package/dist/landing/exec.js.map +1 -0
  99. package/dist/landing/git.js +93 -0
  100. package/dist/landing/git.js.map +1 -0
  101. package/dist/landing/github.js +154 -0
  102. package/dist/landing/github.js.map +1 -0
  103. package/dist/landing/hooks.js +2 -0
  104. package/dist/landing/hooks.js.map +1 -0
  105. package/dist/landing/landing.js +777 -0
  106. package/dist/landing/landing.js.map +1 -0
  107. package/dist/landing/messages.js +157 -0
  108. package/dist/landing/messages.js.map +1 -0
  109. package/dist/landing/migration.js +50 -0
  110. package/dist/landing/migration.js.map +1 -0
  111. package/dist/landing/paths.js +54 -0
  112. package/dist/landing/paths.js.map +1 -0
  113. package/dist/landing/project.js +95 -0
  114. package/dist/landing/project.js.map +1 -0
  115. package/dist/landing/publishing.js +208 -0
  116. package/dist/landing/publishing.js.map +1 -0
  117. package/dist/landing/stage.js +129 -0
  118. package/dist/landing/stage.js.map +1 -0
  119. package/dist/landing/store.js +160 -0
  120. package/dist/landing/store.js.map +1 -0
  121. package/dist/landing/tools.js +38 -0
  122. package/dist/landing/tools.js.map +1 -0
  123. package/dist/landing/workspace.js +349 -0
  124. package/dist/landing/workspace.js.map +1 -0
  125. package/dist/log.js +77 -0
  126. package/dist/log.js.map +1 -0
  127. package/dist/mcp/coordinator-tools.js +500 -0
  128. package/dist/mcp/coordinator-tools.js.map +1 -0
  129. package/dist/mcp/names.js +8 -0
  130. package/dist/mcp/names.js.map +1 -0
  131. package/dist/mcp/owner-turn.js +15 -0
  132. package/dist/mcp/owner-turn.js.map +1 -0
  133. package/dist/mcp/setup-tools.js +243 -0
  134. package/dist/mcp/setup-tools.js.map +1 -0
  135. package/dist/mcp/stdio.js +74 -0
  136. package/dist/mcp/stdio.js.map +1 -0
  137. package/dist/mcp/tools.js +76 -0
  138. package/dist/mcp/tools.js.map +1 -0
  139. package/dist/mcp/worker-tools.js +53 -0
  140. package/dist/mcp/worker-tools.js.map +1 -0
  141. package/dist/memory/files.js +183 -0
  142. package/dist/memory/files.js.map +1 -0
  143. package/dist/memory/index.js +174 -0
  144. package/dist/memory/index.js.map +1 -0
  145. package/dist/memory/service.js +319 -0
  146. package/dist/memory/service.js.map +1 -0
  147. package/dist/memory/tools.js +82 -0
  148. package/dist/memory/tools.js.map +1 -0
  149. package/dist/notify/index.js +122 -0
  150. package/dist/notify/index.js.map +1 -0
  151. package/dist/prompts/coordinator.js +76 -0
  152. package/dist/prompts/coordinator.js.map +1 -0
  153. package/dist/prompts/grilling.js +8 -0
  154. package/dist/prompts/grilling.js.map +1 -0
  155. package/dist/prompts/teaching.js +17 -0
  156. package/dist/prompts/teaching.js.map +1 -0
  157. package/dist/prompts/worker.js +50 -0
  158. package/dist/prompts/worker.js.map +1 -0
  159. package/dist/questions/questions.js +209 -0
  160. package/dist/questions/questions.js.map +1 -0
  161. package/dist/quota/monitor.js +399 -0
  162. package/dist/quota/monitor.js.map +1 -0
  163. package/dist/quota/schedule.js +38 -0
  164. package/dist/quota/schedule.js.map +1 -0
  165. package/dist/quota/store.js +94 -0
  166. package/dist/quota/store.js.map +1 -0
  167. package/dist/quota/time.js +41 -0
  168. package/dist/quota/time.js.map +1 -0
  169. package/dist/review/digest.js +202 -0
  170. package/dist/review/digest.js.map +1 -0
  171. package/dist/review/reviewer.js +113 -0
  172. package/dist/review/reviewer.js.map +1 -0
  173. package/dist/runtime.js +456 -0
  174. package/dist/runtime.js.map +1 -0
  175. package/dist/schedule/cron.js +354 -0
  176. package/dist/schedule/cron.js.map +1 -0
  177. package/dist/schedule/service.js +425 -0
  178. package/dist/schedule/service.js.map +1 -0
  179. package/dist/schedule/store.js +210 -0
  180. package/dist/schedule/store.js.map +1 -0
  181. package/dist/schedule/tools.js +246 -0
  182. package/dist/schedule/tools.js.map +1 -0
  183. package/dist/selfupdate/npm.js +114 -0
  184. package/dist/selfupdate/npm.js.map +1 -0
  185. package/dist/selfupdate/start.js +113 -0
  186. package/dist/selfupdate/start.js.map +1 -0
  187. package/dist/selfupdate/state.js +22 -0
  188. package/dist/selfupdate/state.js.map +1 -0
  189. package/dist/selfupdate/updater.js +120 -0
  190. package/dist/selfupdate/updater.js.map +1 -0
  191. package/dist/service/host.js +46 -0
  192. package/dist/service/host.js.map +1 -0
  193. package/dist/service/index.js +142 -0
  194. package/dist/service/index.js.map +1 -0
  195. package/dist/service/launchd.js +88 -0
  196. package/dist/service/launchd.js.map +1 -0
  197. package/dist/service/spec.js +9 -0
  198. package/dist/service/spec.js.map +1 -0
  199. package/dist/service/systemd.js +90 -0
  200. package/dist/service/systemd.js.map +1 -0
  201. package/dist/service/windows.js +122 -0
  202. package/dist/service/windows.js.map +1 -0
  203. package/dist/setup/pairing.js +143 -0
  204. package/dist/setup/pairing.js.map +1 -0
  205. package/dist/setup/setup.js +76 -0
  206. package/dist/setup/setup.js.map +1 -0
  207. package/dist/standing/defaults.js +80 -0
  208. package/dist/standing/defaults.js.map +1 -0
  209. package/dist/standing/model.js +72 -0
  210. package/dist/standing/model.js.map +1 -0
  211. package/dist/standing/service.js +228 -0
  212. package/dist/standing/service.js.map +1 -0
  213. package/dist/standing/tools.js +184 -0
  214. package/dist/standing/tools.js.map +1 -0
  215. package/dist/store/db.js +67 -0
  216. package/dist/store/db.js.map +1 -0
  217. package/dist/store/migrations.js +280 -0
  218. package/dist/store/migrations.js.map +1 -0
  219. package/dist/supervisor/processes.js +128 -0
  220. package/dist/supervisor/processes.js.map +1 -0
  221. package/dist/supervisor/stalls.js +103 -0
  222. package/dist/supervisor/stalls.js.map +1 -0
  223. package/dist/terminal/activity.js +97 -0
  224. package/dist/terminal/activity.js.map +1 -0
  225. package/dist/terminal/conversation.js +231 -0
  226. package/dist/terminal/conversation.js.map +1 -0
  227. package/dist/util/async-queue.js +41 -0
  228. package/dist/util/async-queue.js.map +1 -0
  229. package/dist/util/command.js +29 -0
  230. package/dist/util/command.js.map +1 -0
  231. package/dist/util/ids.js +9 -0
  232. package/dist/util/ids.js.map +1 -0
  233. package/dist/util/process-tree.js +62 -0
  234. package/dist/util/process-tree.js.map +1 -0
  235. package/dist/util/secrets.js +31 -0
  236. package/dist/util/secrets.js.map +1 -0
  237. package/dist/version.js +5 -0
  238. package/dist/version.js.map +1 -0
  239. package/dist/workers/claude/classify.js +172 -0
  240. package/dist/workers/claude/classify.js.map +1 -0
  241. package/dist/workers/claude/index.js +440 -0
  242. package/dist/workers/claude/index.js.map +1 -0
  243. package/dist/workers/claude/process.js +135 -0
  244. package/dist/workers/claude/process.js.map +1 -0
  245. package/dist/workers/claude/quota.js +37 -0
  246. package/dist/workers/claude/quota.js.map +1 -0
  247. package/dist/workers/claude/stream.js +286 -0
  248. package/dist/workers/claude/stream.js.map +1 -0
  249. package/dist/workers/codex/index.js +181 -0
  250. package/dist/workers/codex/index.js.map +1 -0
  251. package/dist/workers/codex/mapping.js +166 -0
  252. package/dist/workers/codex/mapping.js.map +1 -0
  253. package/dist/workers/codex/process.js +124 -0
  254. package/dist/workers/codex/process.js.map +1 -0
  255. package/dist/workers/codex/protocol.js +7 -0
  256. package/dist/workers/codex/protocol.js.map +1 -0
  257. package/dist/workers/codex/rpc.js +145 -0
  258. package/dist/workers/codex/rpc.js.map +1 -0
  259. package/dist/workers/codex/run.js +556 -0
  260. package/dist/workers/codex/run.js.map +1 -0
  261. package/dist/workers/env.js +49 -0
  262. package/dist/workers/env.js.map +1 -0
  263. package/dist/workers/fake/index.js +283 -0
  264. package/dist/workers/fake/index.js.map +1 -0
  265. package/dist/workers/models.js +171 -0
  266. package/dist/workers/models.js.map +1 -0
  267. package/dist/workers/registry.js +63 -0
  268. package/dist/workers/registry.js.map +1 -0
  269. package/dist/workers/types.js +6 -0
  270. package/dist/workers/types.js.map +1 -0
  271. package/package.json +66 -4
@@ -0,0 +1,399 @@
1
+ import { isoNow } from "../clock.js";
2
+ import { errorMessage } from "../log.js";
3
+ import { nextCheckDelay } from "./schedule.js";
4
+ import { BLOCKED_STATES, QuotaStore, } from "./store.js";
5
+ export { QuotaStore };
6
+ export const COORDINATOR_OWNER = "coordinator";
7
+ export function authBucket(agent) {
8
+ return `auth:${agent}`;
9
+ }
10
+ /**
11
+ * One monitor per quota bucket, shared by every Run (and the Coordinator) waiting on it. While a
12
+ * bucket is blocked it is rechecked on a jittered, backed-off schedule, earlier near its
13
+ * advertised reset, with the agent's token-free read where there is one (`readQuota`, or
14
+ * `detect` for a broken login). Without a read, a conservative probe resumes one waiting turn.
15
+ * When the bucket is available again, waiters resume one at a time, `resumeStaggerMs` apart.
16
+ * Everything is persisted, so a restart picks the schedule up where it was. No model calls.
17
+ */
18
+ export class QuotaMonitor {
19
+ deps;
20
+ timers = new Map();
21
+ staggers = new Map();
22
+ probes = new Map();
23
+ checking = new Set();
24
+ stopped = true;
25
+ constructor(deps) {
26
+ this.deps = deps;
27
+ }
28
+ /** Resumes monitoring from persisted state. */
29
+ start() {
30
+ this.stopped = false;
31
+ for (const bucket of this.deps.store.list()) {
32
+ if (!this.hasWaiters(bucket))
33
+ continue;
34
+ if (isBlocked(bucket.state)) {
35
+ const at = bucket.nextCheckAt ? Date.parse(bucket.nextCheckAt) : this.deps.clock.now();
36
+ this.schedule(bucket, Math.max(at, this.deps.clock.now()));
37
+ }
38
+ else if (bucket.state === "available") {
39
+ this.stagger(bucket.bucket, 0);
40
+ }
41
+ }
42
+ }
43
+ stop() {
44
+ this.stopped = true;
45
+ for (const timer of [...this.timers.values(), ...this.staggers.values()])
46
+ timer.cancel();
47
+ this.timers.clear();
48
+ this.staggers.clear();
49
+ this.probes.clear();
50
+ }
51
+ /** A Run's turn ended because its quota ran out (or its spending limit was reached). */
52
+ runBlocked(input) {
53
+ const state = input.kind === "spend_limit" ? "spend_blocked" : "blocked";
54
+ return this.block({ ...input, state });
55
+ }
56
+ /** The agent's login stopped working. Monitored through `detect()`. */
57
+ authBroken(input) {
58
+ return this.block({ ...input, bucket: authBucket(input.agent), state: "auth_broken" });
59
+ }
60
+ /** A waiting Run (or the Coordinator) made progress, which ends a probe successfully. */
61
+ progress(owner) {
62
+ for (const [name, probe] of this.probes) {
63
+ if (probe.owner !== owner)
64
+ continue;
65
+ this.probes.delete(name);
66
+ this.deps.store.recordCheck({
67
+ bucket: name,
68
+ method: "probe",
69
+ result: "available",
70
+ cost: { turns: 1, durationMs: this.deps.clock.now() - probe.startedAt },
71
+ });
72
+ const bucket = this.deps.store.get(name);
73
+ if (bucket && isBlocked(bucket.state))
74
+ this.available(bucket, "probe");
75
+ }
76
+ }
77
+ /** A turn ended without progress or a new block: a probe through it told nothing. */
78
+ turnEnded(owner) {
79
+ for (const [name, probe] of this.probes) {
80
+ if (probe.owner !== owner)
81
+ continue;
82
+ this.probes.delete(name);
83
+ this.deps.store.recordCheck({
84
+ bucket: name,
85
+ method: "probe",
86
+ result: "unknown",
87
+ cost: { turns: 1, durationMs: this.deps.clock.now() - probe.startedAt },
88
+ });
89
+ }
90
+ }
91
+ /** The worst current block for an agent: one that someone waits on or that has not reset. */
92
+ activeBlock(agent) {
93
+ const now = this.deps.clock.now();
94
+ const rank = { auth_broken: 3, spend_blocked: 2, blocked: 1 };
95
+ return this.deps.store
96
+ .list()
97
+ .filter((b) => b.agent === agent &&
98
+ isBlocked(b.state) &&
99
+ (this.hasWaiters(b) || (b.resetsAt !== null && Date.parse(b.resetsAt) > now)))
100
+ .sort((a, b) => (rank[b.state] ?? 0) - (rank[a.state] ?? 0) ||
101
+ (b.resetsAt ?? "").localeCompare(a.resetsAt ?? ""))[0];
102
+ }
103
+ /** The bucket the Coordinator waits on for this agent, if any. */
104
+ coordinatorBlock(agent) {
105
+ return this.deps.store
106
+ .list()
107
+ .find((b) => b.agent === agent && b.coordinatorWaiting && isBlocked(b.state));
108
+ }
109
+ /** Whether an agent can take on work now: nothing blocks it and its quota read has room. */
110
+ async headroom(agent) {
111
+ return (await this.headroomInfo(agent)).ok;
112
+ }
113
+ /**
114
+ * Headroom, and when the agent is expected to have quota again (milliseconds) if it has none
115
+ * and that is known. "Room" means below `quota.headroomPercent` of every metered window.
116
+ */
117
+ async headroomInfo(agent) {
118
+ const known = this.headroomKnown(agent);
119
+ const adapter = this.deps.adapter(agent);
120
+ if (!known.ok || !adapter?.readQuota)
121
+ return known;
122
+ try {
123
+ const { headroomPercent } = this.deps.settings();
124
+ const full = (await adapter.readQuota()).filter((r) => r.available === false || (r.usedPercent ?? 0) >= headroomPercent);
125
+ const resets = full.flatMap((r) => parseTime(r.resetsAt) ?? []);
126
+ return { ok: full.length === 0, resetsAt: resets.length ? Math.min(...resets) : undefined };
127
+ }
128
+ catch (err) {
129
+ this.deps.log.warn("quota read failed", { agent, error: errorMessage(err) });
130
+ return { ok: false };
131
+ }
132
+ }
133
+ /** Headroom as far as Preston already knows (blocks and logins), without reading quota. */
134
+ headroomKnown(agent) {
135
+ if (!this.deps.adapter(agent))
136
+ return { ok: false };
137
+ const block = this.activeBlock(agent);
138
+ return block ? { ok: false, resetsAt: parseTime(block.resetsAt) } : { ok: true };
139
+ }
140
+ list() {
141
+ return this.deps.store.list().map((b) => ({ ...b, monitored: this.timers.has(b.bucket) }));
142
+ }
143
+ /**
144
+ * The user said "resume": recheck spending limits and logins now, probing if needed (the
145
+ * user has presumably raised the limit or signed in). Returns the agents rechecked.
146
+ */
147
+ recheckForUser() {
148
+ const agents = new Set();
149
+ for (const bucket of this.deps.store.list()) {
150
+ if (bucket.state !== "spend_blocked" && bucket.state !== "auth_broken")
151
+ continue;
152
+ if (!this.hasWaiters(bucket))
153
+ continue;
154
+ agents.add(bucket.agent);
155
+ void this.check(bucket.bucket, true);
156
+ }
157
+ return [...agents];
158
+ }
159
+ // ---- Internals ---------------------------------------------------------------------------
160
+ block(input) {
161
+ const { store, clock } = this.deps;
162
+ const existing = store.get(input.bucket);
163
+ const probe = this.probes.get(input.bucket);
164
+ const failedProbe = probe?.owner === input.owner;
165
+ if (failedProbe && probe) {
166
+ this.probes.delete(input.bucket);
167
+ store.recordCheck({
168
+ bucket: input.bucket,
169
+ method: "probe",
170
+ result: "blocked",
171
+ cost: { turns: 1, durationMs: clock.now() - probe.startedAt },
172
+ detail: input.detail,
173
+ });
174
+ }
175
+ const wasBlocked = existing !== undefined && isBlocked(existing.state);
176
+ const bucket = store.block({
177
+ bucket: input.bucket,
178
+ agent: input.agent,
179
+ state: input.state,
180
+ resetsAt: input.resetsAt,
181
+ evidence: input.detail,
182
+ failedChecks: (wasBlocked ? existing.failedChecks : 0) + (failedProbe ? 1 : 0),
183
+ coordinator: input.owner === COORDINATOR_OWNER,
184
+ });
185
+ store.recordCheck({
186
+ bucket: input.bucket,
187
+ method: "signal",
188
+ result: "blocked",
189
+ detail: input.detail,
190
+ });
191
+ this.staggers.get(input.bucket)?.cancel();
192
+ this.staggers.delete(input.bucket);
193
+ const computed = this.computeNext(bucket);
194
+ const scheduled = bucket.nextCheckAt ? Date.parse(bucket.nextCheckAt) : Number.NaN;
195
+ const keep = !failedProbe && this.timers.has(input.bucket) && scheduled <= computed;
196
+ if (!keep)
197
+ this.schedule(bucket, computed);
198
+ this.deps.log.info("quota blocked", {
199
+ bucket: input.bucket,
200
+ state: input.state,
201
+ resetsAt: bucket.resetsAt,
202
+ owner: input.owner,
203
+ });
204
+ return store.get(input.bucket);
205
+ }
206
+ computeNext(bucket) {
207
+ const now = this.deps.clock.now();
208
+ return (now +
209
+ nextCheckDelay({
210
+ bucket: bucket.bucket,
211
+ now,
212
+ resetsAt: bucket.resetsAt,
213
+ failedChecks: bucket.failedChecks,
214
+ canRead: this.canRead(bucket),
215
+ settings: this.deps.settings(),
216
+ }));
217
+ }
218
+ schedule(bucket, at = this.computeNext(bucket)) {
219
+ if (this.stopped)
220
+ return;
221
+ const { clock, store } = this.deps;
222
+ store.update(bucket.bucket, { nextCheckAt: new Date(at).toISOString() });
223
+ this.timers.get(bucket.bucket)?.cancel();
224
+ this.timers.set(bucket.bucket, clock.setTimeout(() => {
225
+ this.timers.delete(bucket.bucket);
226
+ void this.check(bucket.bucket, false);
227
+ }, at - clock.now()));
228
+ }
229
+ async check(name, forceProbe) {
230
+ if (this.stopped || this.checking.has(name))
231
+ return;
232
+ this.checking.add(name);
233
+ try {
234
+ const { store } = this.deps;
235
+ let bucket = store.get(name);
236
+ if (!bucket || !isBlocked(bucket.state))
237
+ return;
238
+ if (!this.hasWaiters(bucket)) {
239
+ // Nobody waits any more (Goals cancelled); stop monitoring until something blocks again.
240
+ this.timers.get(name)?.cancel();
241
+ this.timers.delete(name);
242
+ store.update(name, { nextCheckAt: null });
243
+ return;
244
+ }
245
+ if (this.probes.has(name)) {
246
+ this.schedule(bucket);
247
+ return;
248
+ }
249
+ const seen = await this.observe(bucket);
250
+ if (this.stopped)
251
+ return;
252
+ bucket = store.get(name);
253
+ if (!bucket || !isBlocked(bucket.state))
254
+ return;
255
+ store.update(name, { lastCheckedAt: isoNow(this.deps.clock) });
256
+ if (seen.result === "available") {
257
+ this.available(bucket, "read");
258
+ return;
259
+ }
260
+ const mayProbe = bucket.state !== "spend_blocked" || forceProbe;
261
+ if (seen.result === "unknown" && mayProbe) {
262
+ this.probe(bucket);
263
+ this.schedule(store.get(name));
264
+ return;
265
+ }
266
+ store.update(name, {
267
+ failedChecks: bucket.failedChecks + 1,
268
+ resetsAt: seen.resetsAt ?? bucket.resetsAt,
269
+ });
270
+ const updated = store.get(name);
271
+ this.schedule(updated);
272
+ this.deps.stillBlocked(updated);
273
+ }
274
+ catch (err) {
275
+ this.deps.log.error("quota check failed", { bucket: name, error: err });
276
+ }
277
+ finally {
278
+ this.checking.delete(name);
279
+ }
280
+ }
281
+ /** A token-free look at the bucket. Recorded as a check. */
282
+ async observe(bucket) {
283
+ const adapter = this.deps.adapter(bucket.agent);
284
+ const record = (method, seen, detail) => {
285
+ this.deps.store.recordCheck({
286
+ bucket: bucket.bucket,
287
+ method,
288
+ result: seen === "error" ? "error" : seen.result,
289
+ ...(detail ? { detail } : {}),
290
+ });
291
+ return seen === "error" ? { result: "unknown" } : seen;
292
+ };
293
+ if (!adapter)
294
+ return record("read", "error", "agent not available");
295
+ if (bucket.state === "auth_broken") {
296
+ try {
297
+ const detection = await adapter.detect();
298
+ const result = detection.loggedIn === true
299
+ ? "available"
300
+ : detection.loggedIn === false
301
+ ? "blocked"
302
+ : "unknown";
303
+ return record("login", { result }, detection.problem);
304
+ }
305
+ catch (err) {
306
+ return record("login", "error", errorMessage(err));
307
+ }
308
+ }
309
+ if (!adapter.readQuota)
310
+ return { result: "unknown" };
311
+ try {
312
+ const reading = (await adapter.readQuota()).find((r) => r.bucket === bucket.bucket);
313
+ const result = reading?.available === true
314
+ ? "available"
315
+ : reading?.available === false
316
+ ? "blocked"
317
+ : "unknown";
318
+ return record("read", { result, resetsAt: reading?.resetsAt });
319
+ }
320
+ catch (err) {
321
+ return record("read", "error", errorMessage(err));
322
+ }
323
+ }
324
+ /** Resumes one waiter to find out whether the bucket works again. */
325
+ probe(bucket) {
326
+ if (this.probes.has(bucket.bucket))
327
+ return;
328
+ const startedAt = this.deps.clock.now();
329
+ let owner;
330
+ if (bucket.coordinatorWaiting && this.deps.resumeCoordinator(true)) {
331
+ owner = COORDINATOR_OWNER;
332
+ }
333
+ else {
334
+ owner = this.deps.waitingRuns(bucket.bucket).find((id) => this.deps.resumeRun(id, true));
335
+ }
336
+ if (!owner)
337
+ return;
338
+ this.probes.set(bucket.bucket, { owner, startedAt });
339
+ this.deps.store.recordCheck({ bucket: bucket.bucket, method: "probe", result: "started" });
340
+ this.deps.log.info("quota probe", { bucket: bucket.bucket, owner });
341
+ }
342
+ available(bucket, via) {
343
+ this.deps.store.update(bucket.bucket, {
344
+ state: "available",
345
+ failedChecks: 0,
346
+ nextCheckAt: null,
347
+ resetsAt: null,
348
+ });
349
+ this.timers.get(bucket.bucket)?.cancel();
350
+ this.timers.delete(bucket.bucket);
351
+ this.deps.log.info("quota available", { bucket: bucket.bucket, via });
352
+ // A successful probe already resumed one waiter; the next one follows after the gap.
353
+ this.stagger(bucket.bucket, via === "probe" ? this.deps.settings().resumeStaggerMs : 0);
354
+ }
355
+ /** Resumes waiters one at a time, stopping if the bucket blocks again. */
356
+ stagger(name, firstDelay) {
357
+ if (this.staggers.has(name) || this.stopped)
358
+ return;
359
+ const step = () => {
360
+ this.staggers.delete(name);
361
+ const { store } = this.deps;
362
+ const bucket = store.get(name);
363
+ if (this.stopped || bucket?.state !== "available")
364
+ return;
365
+ let resumed = false;
366
+ if (bucket.coordinatorWaiting) {
367
+ store.update(name, { coordinatorWaiting: false });
368
+ resumed = this.deps.resumeCoordinator(false);
369
+ }
370
+ if (!resumed) {
371
+ resumed = this.deps.waitingRuns(name).some((id) => this.deps.resumeRun(id, false));
372
+ }
373
+ const next = store.get(name);
374
+ if (resumed && next && this.hasWaiters(next)) {
375
+ this.staggers.set(name, this.deps.clock.setTimeout(step, this.deps.settings().resumeStaggerMs));
376
+ }
377
+ };
378
+ if (firstDelay > 0)
379
+ this.staggers.set(name, this.deps.clock.setTimeout(step, firstDelay));
380
+ else
381
+ step();
382
+ }
383
+ hasWaiters(bucket) {
384
+ return bucket.coordinatorWaiting || this.deps.waitingRuns(bucket.bucket).length > 0;
385
+ }
386
+ canRead(bucket) {
387
+ if (bucket.state === "auth_broken")
388
+ return true;
389
+ return Boolean(this.deps.adapter(bucket.agent)?.readQuota);
390
+ }
391
+ }
392
+ function isBlocked(state) {
393
+ return BLOCKED_STATES.includes(state);
394
+ }
395
+ function parseTime(iso) {
396
+ const time = iso ? Date.parse(iso) : Number.NaN;
397
+ return Number.isFinite(time) ? time : undefined;
398
+ }
399
+ //# sourceMappingURL=monitor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../src/quota/monitor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ /** Checks are never closer together than this, whatever the advertised reset says. */
2
+ const MIN_CHECK_DELAY_MS = 30_000;
3
+ /**
4
+ * When a blocked bucket is next checked. Deterministic: the jitter comes from the bucket name
5
+ * and attempt number, so checks for different buckets spread out but tests are repeatable.
6
+ *
7
+ * - Token-free reads start at `recheckIntervalMs`; probes (a real resumed turn) at the more
8
+ * conservative `probeIntervalMs`.
9
+ * - Each check that still finds the bucket blocked backs off by `backoffFactor`, up to
10
+ * `maxRecheckIntervalMs` (probes may wait up to twice that).
11
+ * - A known reset time pulls the check earlier, to just after the reset; checks keep happening
12
+ * before it too, because providers sometimes reset early.
13
+ */
14
+ export function nextCheckDelay(input) {
15
+ const { settings } = input;
16
+ const base = input.canRead ? settings.recheckIntervalMs : settings.probeIntervalMs;
17
+ const cap = input.canRead ? settings.maxRecheckIntervalMs : settings.maxRecheckIntervalMs * 2;
18
+ const backedOff = Math.min(base * settings.backoffFactor ** input.failedChecks, cap);
19
+ const jitter = (unitHash(`${input.bucket}:${input.failedChecks}`) * 2 - 1) * settings.jitterRatio;
20
+ let delay = Math.round(backedOff * (1 + jitter));
21
+ const reset = input.resetsAt ? Date.parse(input.resetsAt) : Number.NaN;
22
+ if (Number.isFinite(reset)) {
23
+ const afterReset = reset + settings.resetGraceMs - input.now;
24
+ if (afterReset > 0 && afterReset < delay)
25
+ delay = afterReset;
26
+ }
27
+ return Math.max(delay, MIN_CHECK_DELAY_MS);
28
+ }
29
+ /** A stable number in [0, 1) for a string (FNV-1a). */
30
+ function unitHash(text) {
31
+ let hash = 0x811c9dc5;
32
+ for (let i = 0; i < text.length; i++) {
33
+ hash ^= text.charCodeAt(i);
34
+ hash = Math.imul(hash, 0x01000193);
35
+ }
36
+ return (hash >>> 0) / 2 ** 32;
37
+ }
38
+ //# sourceMappingURL=schedule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/quota/schedule.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAO9B;IACC,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IACnF,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,GAAG,CAAC,CAAC;IAC9F,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,aAAa,IAAI,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;IAClG,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IACvE,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC;QAC7D,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,KAAK;YAAE,KAAK,GAAG,UAAU,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;AAC7C,CAAC;AAED,uDAAuD;AACvD,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC"}
@@ -0,0 +1,94 @@
1
+ import { isoNow } from "../clock.js";
2
+ import { all, one, run } from "../store/db.js";
3
+ export const BLOCKED_STATES = ["blocked", "auth_broken", "spend_blocked"];
4
+ /** Durable per-bucket quota state and the log of every check and probe. */
5
+ export class QuotaStore {
6
+ db;
7
+ clock;
8
+ constructor(db, clock) {
9
+ this.db = db;
10
+ this.clock = clock;
11
+ }
12
+ get(bucket) {
13
+ const row = one(this.db, "SELECT * FROM quota_buckets WHERE bucket = :bucket", {
14
+ bucket,
15
+ });
16
+ return row ? toBucket(row) : undefined;
17
+ }
18
+ list() {
19
+ return all(this.db, "SELECT * FROM quota_buckets ORDER BY bucket").map(toBucket);
20
+ }
21
+ /** Records a block (a signal from an agent turn, or a failed check). */
22
+ block(input) {
23
+ const at = isoNow(this.clock);
24
+ const existing = this.get(input.bucket);
25
+ const stillBlocked = existing && BLOCKED_STATES.includes(existing.state);
26
+ // The newest signal wins; without a reset time, one already known for this block stays.
27
+ const keep = input.resetsAt ?? (stillBlocked ? existing.resetsAt : null);
28
+ run(this.db, `INSERT INTO quota_buckets (bucket, agent, state, resets_at, blocked_at, failed_checks, evidence, coordinator_waiting, updated_at)
29
+ VALUES (:bucket, :agent, :state, :resets, :at, :failed, :evidence, :coord, :at)
30
+ ON CONFLICT (bucket) DO UPDATE SET agent = :agent, state = :state, resets_at = :resets,
31
+ blocked_at = COALESCE(CASE WHEN state IN ('blocked', 'auth_broken', 'spend_blocked') THEN blocked_at END, :at),
32
+ failed_checks = :failed, evidence = COALESCE(:evidence, evidence),
33
+ coordinator_waiting = MAX(coordinator_waiting, :coord), updated_at = :at`, {
34
+ bucket: input.bucket,
35
+ agent: input.agent,
36
+ state: input.state,
37
+ resets: keep ?? null,
38
+ at,
39
+ failed: input.failedChecks,
40
+ evidence: input.evidence?.slice(0, 2000) ?? null,
41
+ coord: input.coordinator ? 1 : 0,
42
+ });
43
+ return this.get(input.bucket);
44
+ }
45
+ update(bucket, patch) {
46
+ const columns = {
47
+ state: "state",
48
+ resetsAt: "resets_at",
49
+ nextCheckAt: "next_check_at",
50
+ failedChecks: "failed_checks",
51
+ lastCheckedAt: "last_checked_at",
52
+ coordinatorWaiting: "coordinator_waiting",
53
+ };
54
+ const sets = ["updated_at = :at"];
55
+ const params = { bucket, at: isoNow(this.clock) };
56
+ for (const [key, value] of Object.entries(patch)) {
57
+ const column = columns[key];
58
+ if (!column || value === undefined)
59
+ continue;
60
+ sets.push(`${column} = :${key}`);
61
+ params[key] = typeof value === "boolean" ? Number(value) : value;
62
+ }
63
+ run(this.db, `UPDATE quota_buckets SET ${sets.join(", ")} WHERE bucket = :bucket`, params);
64
+ }
65
+ recordCheck(check) {
66
+ run(this.db, `INSERT INTO quota_checks (bucket, at, method, result, cost, detail)
67
+ VALUES (:bucket, :at, :method, :result, :cost, :detail)`, {
68
+ bucket: check.bucket,
69
+ at: isoNow(this.clock),
70
+ method: check.method,
71
+ result: check.result,
72
+ cost: check.cost === undefined ? null : JSON.stringify(check.cost),
73
+ detail: check.detail?.slice(0, 1000) ?? null,
74
+ });
75
+ }
76
+ checks(bucket) {
77
+ return all(this.db, "SELECT * FROM quota_checks WHERE bucket = :bucket ORDER BY id", { bucket }).map((r) => ({ ...r, cost: r.cost ? JSON.parse(r.cost) : null }));
78
+ }
79
+ }
80
+ function toBucket(row) {
81
+ return {
82
+ bucket: row.bucket,
83
+ agent: row.agent,
84
+ state: row.state,
85
+ resetsAt: row.resets_at,
86
+ blockedAt: row.blocked_at,
87
+ nextCheckAt: row.next_check_at,
88
+ failedChecks: row.failed_checks,
89
+ lastCheckedAt: row.last_checked_at,
90
+ evidence: row.evidence,
91
+ coordinatorWaiting: row.coordinator_waiting === 1,
92
+ };
93
+ }
94
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/quota/store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ import { language } from "../i18n/index.js";
2
+ /** Plain-language times for messages, in the host's local time zone (the user's machine). */
3
+ const DAY_MS = 86_400_000;
4
+ /** "3:40pm" today, "Tue 3:40pm" within the week, otherwise "Nov 23 3:40pm". */
5
+ export function formatResetTime(iso, now) {
6
+ const at = new Date(iso);
7
+ if (language() === "zh-CN")
8
+ return formatResetTimeZh(at, now);
9
+ const parts = Object.fromEntries(new Intl.DateTimeFormat("en-US", {
10
+ weekday: "short",
11
+ month: "short",
12
+ day: "numeric",
13
+ hour: "numeric",
14
+ minute: "2-digit",
15
+ hour12: true,
16
+ })
17
+ .formatToParts(at)
18
+ .map((p) => [p.type, p.value]));
19
+ const time = `${parts.hour}:${parts.minute}${(parts.dayPeriod ?? "").toLowerCase()}`;
20
+ const today = new Date(now);
21
+ if (at.toDateString() === today.toDateString())
22
+ return time;
23
+ if (at.getTime() - now < 6 * DAY_MS)
24
+ return `${parts.weekday} ${time}`;
25
+ return `${parts.month} ${parts.day} ${time}`;
26
+ }
27
+ /** "15:40" today, "周二 15:40" within the week, otherwise "11月23日 15:40". */
28
+ function formatResetTimeZh(at, now) {
29
+ const time = new Intl.DateTimeFormat("zh-CN", {
30
+ hour: "2-digit",
31
+ minute: "2-digit",
32
+ hour12: false,
33
+ }).format(at);
34
+ if (at.toDateString() === new Date(now).toDateString())
35
+ return time;
36
+ if (at.getTime() - now < 6 * DAY_MS) {
37
+ return `${new Intl.DateTimeFormat("zh-CN", { weekday: "short" }).format(at)} ${time}`;
38
+ }
39
+ return `${new Intl.DateTimeFormat("zh-CN", { month: "long", day: "numeric" }).format(at)} ${time}`;
40
+ }
41
+ //# sourceMappingURL=time.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/quota/time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,6FAA6F;AAE7F,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,GAAW;IACtD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,QAAQ,EAAE,KAAK,OAAO;QAAE,OAAO,iBAAiB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC/B,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,IAAI;KACb,CAAC;SACC,aAAa,CAAC,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CACP,CAAC;IAC5B,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IACrF,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,YAAY,EAAE,KAAK,KAAK,CAAC,YAAY,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC,GAAG,MAAM;QAAE,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;IACvE,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED,2EAA2E;AAC3E,SAAS,iBAAiB,CAAC,EAAQ,EAAE,GAAW;IAC9C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC5C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACd,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACd,IAAI,EAAE,CAAC,YAAY,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;QACpC,OAAO,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IACxF,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;AACrG,CAAC"}