@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,184 @@
1
+ import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
2
+ import { isDeepStrictEqual } from "node:util";
3
+ import { isoNow } from "../clock.js";
4
+ import { all, one, run, transaction } from "../store/db.js";
5
+ import { configSchema, defaultConfig } from "./schema.js";
6
+ export class ConfigError extends Error {
7
+ }
8
+ /**
9
+ * Owns `config.json` and its version history. Every change is validated, written atomically
10
+ * with owner-only permissions, and recorded as a new version so it can be rolled back.
11
+ */
12
+ export class ConfigManager {
13
+ current;
14
+ db;
15
+ file;
16
+ clock;
17
+ log;
18
+ onChange;
19
+ constructor(options) {
20
+ this.db = options.db;
21
+ this.file = options.file;
22
+ this.clock = options.clock;
23
+ this.log = options.log;
24
+ this.onChange = options.onChange;
25
+ this.current = this.load(options.initial);
26
+ this.onChange?.(this.current);
27
+ }
28
+ get() {
29
+ return structuredClone(this.current);
30
+ }
31
+ update(patch, reason) {
32
+ return this.commit(this.preview(patch), reason);
33
+ }
34
+ /** The validated config `patch` would produce, without saving it. Throws ConfigError. */
35
+ preview(patch) {
36
+ const parsed = configSchema.safeParse(mergePatch(this.current, patch));
37
+ if (!parsed.success)
38
+ throw new ConfigError(describeIssues(parsed.error));
39
+ return parsed.data;
40
+ }
41
+ /** Saves what `change` returns for a copy of the current config (to replace a whole section). */
42
+ transform(change, reason) {
43
+ const parsed = configSchema.safeParse(change(this.get()));
44
+ if (!parsed.success)
45
+ throw new ConfigError(describeIssues(parsed.error));
46
+ return this.commit(parsed.data, reason);
47
+ }
48
+ commit(next, reason) {
49
+ if (isDeepStrictEqual(next, this.current)) {
50
+ return { version: this.latestVersion() ?? 0, config: this.get() };
51
+ }
52
+ const version = this.save(next, reason);
53
+ return { version, config: this.get() };
54
+ }
55
+ /** The number of the newest config version. */
56
+ version() {
57
+ return this.latestVersion() ?? 0;
58
+ }
59
+ /** The config as it was recorded in `version`, if there is such a version. */
60
+ at(version) {
61
+ const row = one(this.db, "SELECT config FROM config_versions WHERE version = :version", { version });
62
+ const parsed = row ? configSchema.safeParse(JSON.parse(row.config)) : undefined;
63
+ return parsed?.success ? parsed.data : undefined;
64
+ }
65
+ history(limit = 20) {
66
+ return all(this.db, "SELECT version, reason, created_at FROM config_versions ORDER BY version DESC LIMIT :limit", { limit }).map((r) => ({ version: r.version, reason: r.reason, createdAt: r.created_at }));
67
+ }
68
+ /** Restores an earlier version by recording it again as the newest version. */
69
+ rollback(version) {
70
+ const row = one(this.db, "SELECT config FROM config_versions WHERE version = :version", { version });
71
+ if (!row)
72
+ throw new ConfigError(`There is no config version ${version}.`);
73
+ const parsed = configSchema.safeParse(JSON.parse(row.config));
74
+ if (!parsed.success)
75
+ throw new ConfigError(describeIssues(parsed.error));
76
+ const newVersion = this.save(parsed.data, `rollback to version ${version}`);
77
+ return { version: newVersion, config: this.get() };
78
+ }
79
+ load(initial) {
80
+ const latest = this.latestRecorded();
81
+ if (!existsSync(this.file)) {
82
+ const config = latest ?? configSchema.parse(mergePatch(defaultConfig(), initial ?? {}));
83
+ this.current = config;
84
+ if (latest) {
85
+ this.writeFile(config);
86
+ this.log.warn("config.json was missing; restored the latest recorded version");
87
+ }
88
+ else {
89
+ this.save(config, "initial");
90
+ }
91
+ return config;
92
+ }
93
+ let raw;
94
+ try {
95
+ raw = JSON.parse(readFileSync(this.file, "utf8"));
96
+ }
97
+ catch (err) {
98
+ throw new ConfigError(`${this.file} is not valid JSON: ${err.message}`);
99
+ }
100
+ const parsed = configSchema.safeParse(raw);
101
+ if (!parsed.success) {
102
+ throw new ConfigError(`${this.file} is invalid: ${describeIssues(parsed.error)}`);
103
+ }
104
+ this.current = parsed.data;
105
+ if (!latest || !isDeepStrictEqual(latest, parsed.data)) {
106
+ this.save(parsed.data, latest ? "edited on disk" : "initial");
107
+ }
108
+ return parsed.data;
109
+ }
110
+ save(config, reason) {
111
+ return transaction(this.db, () => {
112
+ const version = (this.latestVersion() ?? 0) + 1;
113
+ run(this.db, "INSERT INTO config_versions (version, config, reason, created_at) VALUES (:version, :config, :reason, :at)", { version, config: JSON.stringify(config), reason, at: isoNow(this.clock) });
114
+ this.writeFile(config);
115
+ this.current = config;
116
+ this.log.info("config changed", { version, reason });
117
+ this.onChange?.(config);
118
+ return version;
119
+ });
120
+ }
121
+ writeFile(config) {
122
+ const tmp = `${this.file}.tmp`;
123
+ writeFileSync(tmp, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
124
+ renameSync(tmp, this.file);
125
+ }
126
+ latestVersion() {
127
+ return (one(this.db, "SELECT MAX(version) AS v FROM config_versions")?.v ??
128
+ undefined);
129
+ }
130
+ latestRecorded() {
131
+ const row = one(this.db, "SELECT config FROM config_versions ORDER BY version DESC LIMIT 1");
132
+ if (!row)
133
+ return undefined;
134
+ const parsed = configSchema.safeParse(JSON.parse(row.config));
135
+ return parsed.success ? parsed.data : undefined;
136
+ }
137
+ }
138
+ function mergePatch(base, patch) {
139
+ if (!isPlainObject(patch))
140
+ return patch;
141
+ const out = isPlainObject(base) ? { ...base } : {};
142
+ for (const [key, value] of Object.entries(patch)) {
143
+ if (value === null)
144
+ delete out[key];
145
+ else
146
+ out[key] = mergePatch(out[key], value);
147
+ }
148
+ return out;
149
+ }
150
+ function isPlainObject(value) {
151
+ return typeof value === "object" && value !== null && !Array.isArray(value);
152
+ }
153
+ function describeIssues(error) {
154
+ return error.issues
155
+ .map((i) => `${i.path.length ? i.path.map(String).join(".") : "config"}: ${i.message}`)
156
+ .join("; ");
157
+ }
158
+ const SECRET_KEY = /token|secret|password|apikey|api_key|key$/i;
159
+ /**
160
+ * Every credential-looking string value in the config, for log masking. Everything under a
161
+ * credential-looking key counts, e.g. each value of `contextTokens: { <user>: <token> }`.
162
+ */
163
+ export function configSecrets(value, key = "", secret = false) {
164
+ const isSecret = secret || SECRET_KEY.test(key);
165
+ if (Array.isArray(value))
166
+ return value.flatMap((v) => configSecrets(v, key, isSecret));
167
+ if (isPlainObject(value)) {
168
+ return Object.entries(value).flatMap(([k, v]) => configSecrets(v, k, isSecret));
169
+ }
170
+ return typeof value === "string" && isSecret ? [value] : [];
171
+ }
172
+ /** A copy of the config safe to show an agent or a Channel: credential values are masked. */
173
+ export function maskConfig(value, key = "", secret = false) {
174
+ const isSecret = secret || SECRET_KEY.test(key);
175
+ if (Array.isArray(value))
176
+ return value.map((v) => maskConfig(v, key, isSecret));
177
+ if (isPlainObject(value)) {
178
+ return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, maskConfig(v, k, isSecret)]));
179
+ }
180
+ if (typeof value === "string" && isSecret)
181
+ return value ? "(set)" : "";
182
+ return value;
183
+ }
184
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,209 @@
1
+ import { z } from "zod";
2
+ import { languageSchema } from "../i18n/index.js";
3
+ const MINUTE = 60_000;
4
+ const ms = (fallback) => z.number().int().positive().default(fallback);
5
+ export const agentKindSchema = z.enum(["claude", "codex", "fake"]);
6
+ const modelSettings = {
7
+ /** Unset means: inherit the user's own CLI configuration (or the Coordinator default). */
8
+ model: z.string().min(1).optional(),
9
+ effort: z.string().min(1).optional(),
10
+ };
11
+ /**
12
+ * Preston's config file (`<home>/config.json`). Plain text, owner-only. Unknown keys are
13
+ * rejected so typos are caught; Channel sections are validated by each Channel.
14
+ */
15
+ export const configSchema = z.strictObject({
16
+ /** The language Preston speaks to the user in (see src/i18n). */
17
+ language: languageSchema.default("en"),
18
+ agents: z
19
+ .strictObject({
20
+ /** Agent CLIs Preston may use, in order of preference. */
21
+ enabled: z.array(agentKindSchema).default([]),
22
+ /** With more than one agent: spread work across them by remaining quota. */
23
+ balanceByQuota: z.boolean().default(false),
24
+ /** Keep the agent CLIs up to date (only ever while no Run is using that CLI). */
25
+ autoUpdate: z.boolean().default(true),
26
+ /** Base interval between update checks for each agent CLI (spread by jitter). */
27
+ updateIntervalMs: ms(24 * 60 * MINUTE),
28
+ })
29
+ .prefault({}),
30
+ coordinator: z
31
+ .strictObject({
32
+ agent: agentKindSchema.optional(),
33
+ ...modelSettings,
34
+ })
35
+ .prefault({}),
36
+ workers: z
37
+ .strictObject({
38
+ ...modelSettings,
39
+ /** Settings for Workers on one agent; they win over the two above for that agent. */
40
+ claude: z.strictObject(modelSettings).optional(),
41
+ codex: z.strictObject(modelSettings).optional(),
42
+ })
43
+ .prefault({}),
44
+ verification: z
45
+ .strictObject({
46
+ checkTimeoutMs: z.number().int().positive().default(600_000),
47
+ /** How many times a Worker is resumed with failing-check evidence before reporting. */
48
+ maxFixAttempts: z.number().int().min(0).max(5).default(1),
49
+ })
50
+ .prefault({}),
51
+ recovery: z
52
+ .strictObject({
53
+ /** Unexpected exits tolerated per Run before the Goal is reported as failed. */
54
+ maxAttempts: z.number().int().min(0).max(10).default(3),
55
+ })
56
+ .prefault({}),
57
+ questions: z
58
+ .strictObject({
59
+ /** How long `ask_preston` waits for the Coordinator before parking the Worker. */
60
+ workerWaitMs: z.number().int().positive().default(45_000),
61
+ })
62
+ .prefault({}),
63
+ quota: z
64
+ .strictObject({
65
+ /** Base interval between token-free quota reads while a bucket is blocked (±jitter). */
66
+ recheckIntervalMs: ms(12.5 * MINUTE),
67
+ /** Base interval between probes (a real resumed turn) when no quota read is available. */
68
+ probeIntervalMs: ms(30 * MINUTE),
69
+ /** Each check that still finds the bucket blocked multiplies the interval by this. */
70
+ backoffFactor: z.number().min(1).max(4).default(1.5),
71
+ maxRecheckIntervalMs: ms(60 * MINUTE),
72
+ /** Spread of each interval, as a fraction of it, so checks do not line up. */
73
+ jitterRatio: z.number().min(0).max(0.5).default(0.2),
74
+ /** Check this long after an advertised reset time. */
75
+ resetGraceMs: ms(MINUTE),
76
+ /** Gap between resuming Runs that waited on the same bucket. */
77
+ resumeStaggerMs: ms(90_000),
78
+ /** First wait after a transient rate limit; doubles per repeat up to the maximum. */
79
+ rateLimitWaitMs: ms(MINUTE),
80
+ rateLimitMaxWaitMs: ms(10 * MINUTE),
81
+ /** A quota wait is told to the user only when it is expected to last longer than this. */
82
+ notifyAfterMs: ms(30 * MINUTE),
83
+ /** A Goal moves to another agent with headroom only when its wait is longer than this. */
84
+ switchAfterMs: ms(60 * MINUTE),
85
+ /** An agent whose metered quota is used up beyond this share has no headroom for new work. */
86
+ headroomPercent: z.number().min(1).max(100).default(90),
87
+ })
88
+ .prefault({}),
89
+ supervision: z
90
+ .strictObject({
91
+ /** Silence after which a turn with no tool running counts as stalled. */
92
+ idleStallMs: ms(10 * MINUTE),
93
+ /** Silence after which a turn with a tool or command still running counts as stalled. */
94
+ toolStallMs: ms(60 * MINUTE),
95
+ /** Coordinator strategy changes per Goal before Preston reports it as Blocked. */
96
+ maxStrategyChanges: z.number().int().min(0).max(5).default(2),
97
+ })
98
+ .prefault({}),
99
+ landing: z
100
+ .strictObject({
101
+ /** How finished work is merged: a merge commit, or one squashed commit. */
102
+ mergeMethod: z.enum(["merge", "squash"]).default("merge"),
103
+ /**
104
+ * Merge without asking even when the merge would also publish something (deploy a site,
105
+ * release a build, publish a package). Off: Preston asks first.
106
+ */
107
+ autoMergePublishing: z.boolean().default(false),
108
+ /** How long to wait for a pull request's required checks before reporting Blocked. */
109
+ requireCiWaitMs: ms(30 * MINUTE),
110
+ /** How often those checks are looked at (no model is involved). */
111
+ ciPollIntervalMs: ms(20_000),
112
+ /** How long to wait for checks to appear on a new pull request before assuming none. */
113
+ ciStartGraceMs: z.number().int().min(0).default(90_000),
114
+ /** Times the Worker is re-run to fix a merge conflict or a failure found while landing. */
115
+ conflictFixAttempts: z.number().int().min(0).max(3).default(1),
116
+ /**
117
+ * How long the working copy of a Goal that ended without its work landing (cancelled,
118
+ * failed, blocked, held) is kept before its folder is removed. The branch always stays.
119
+ */
120
+ worktreeRetentionMs: ms(14 * 24 * 60 * MINUTE),
121
+ })
122
+ .prefault({}),
123
+ outbox: z
124
+ .strictObject({
125
+ maxAttempts: z.number().int().positive().default(8),
126
+ baseDelayMs: z.number().int().positive().default(2_000),
127
+ maxDelayMs: z
128
+ .number()
129
+ .int()
130
+ .positive()
131
+ .default(10 * 60_000),
132
+ })
133
+ .prefault({}),
134
+ outcomes: z
135
+ .strictObject({
136
+ /**
137
+ * How long the Coordinator has to tell the user in its own words that a Goal finished (it
138
+ * can also hold the message until a time the user chose). If it has not by then, Preston's
139
+ * own standard message goes out. 0 sends Preston's standard message at once and the
140
+ * Coordinator is not asked.
141
+ */
142
+ coordinatorWaitMs: z
143
+ .number()
144
+ .int()
145
+ .min(0)
146
+ .default(3 * MINUTE),
147
+ })
148
+ .prefault({}),
149
+ selfUpdate: z
150
+ .strictObject({
151
+ /** Keep Preston itself current when it was installed with `npm install -g`. */
152
+ enabled: z.boolean().default(true),
153
+ /** How often npm is asked for a newer version. */
154
+ checkIntervalMs: ms(6 * 60 * MINUTE),
155
+ })
156
+ .prefault({}),
157
+ review: z
158
+ .strictObject({
159
+ /** Look back over finished work now and then and suggest improvements (never applied unasked). */
160
+ enabled: z.boolean().default(true),
161
+ /** How often Preston looks back, and how far back each look goes. */
162
+ intervalMs: ms(24 * 60 * MINUTE),
163
+ })
164
+ .prefault({}),
165
+ setup: z
166
+ .strictObject({
167
+ /** Set by the Coordinator once the setup conversation has nothing left to do. */
168
+ complete: z.boolean().default(false),
169
+ })
170
+ .prefault({}),
171
+ standing: z
172
+ .strictObject({
173
+ /** Roughly how many tokens of standing orders go into one Worker's guidance (4 chars each). */
174
+ tokenBudget: z.number().int().min(0).max(5_000).default(600),
175
+ })
176
+ .prefault({}),
177
+ schedules: z
178
+ .strictObject({
179
+ /** The longest the scheduler sleeps before looking at the clock again (also detects wake). */
180
+ tickMs: z.number().int().min(1_000).default(60_000),
181
+ /** A missed run is still caught up (once) if it was due no longer ago than this. */
182
+ catchUpWindowMs: z
183
+ .number()
184
+ .int()
185
+ .positive()
186
+ .default(24 * 3_600_000),
187
+ })
188
+ .prefault({}),
189
+ memory: z
190
+ .strictObject({
191
+ /** The most characters of "what you know about the user" shown to the Coordinator. */
192
+ contextChars: z.number().int().min(0).max(20_000).default(2_000),
193
+ })
194
+ .prefault({}),
195
+ /** Per-Channel settings (pairing, credentials), keyed by Channel kind. */
196
+ channels: z.record(z.string(), z.unknown()).default({}),
197
+ });
198
+ /**
199
+ * The model and effort for a Worker on `agent`: that agent's own setting, else the general one,
200
+ * else unset (the user's own CLI configuration applies).
201
+ */
202
+ export function workerSettings(workers, agent) {
203
+ const own = agent === "claude" || agent === "codex" ? workers[agent] : undefined;
204
+ return { model: own?.model ?? workers.model, effort: own?.effort ?? workers.effort };
205
+ }
206
+ export function defaultConfig() {
207
+ return configSchema.parse({});
208
+ }
209
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}