@polyweave/preston 0.0.0-stage → 1.0.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 (267) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +115 -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 +201 -0
  54. package/dist/config/schema.js.map +1 -0
  55. package/dist/coordinator/coordinator.js +491 -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 +71 -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 +492 -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 +72 -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 +205 -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/runtime.js +438 -0
  170. package/dist/runtime.js.map +1 -0
  171. package/dist/schedule/cron.js +354 -0
  172. package/dist/schedule/cron.js.map +1 -0
  173. package/dist/schedule/service.js +425 -0
  174. package/dist/schedule/service.js.map +1 -0
  175. package/dist/schedule/store.js +210 -0
  176. package/dist/schedule/store.js.map +1 -0
  177. package/dist/schedule/tools.js +246 -0
  178. package/dist/schedule/tools.js.map +1 -0
  179. package/dist/selfupdate/npm.js +114 -0
  180. package/dist/selfupdate/npm.js.map +1 -0
  181. package/dist/selfupdate/start.js +113 -0
  182. package/dist/selfupdate/start.js.map +1 -0
  183. package/dist/selfupdate/state.js +22 -0
  184. package/dist/selfupdate/state.js.map +1 -0
  185. package/dist/selfupdate/updater.js +120 -0
  186. package/dist/selfupdate/updater.js.map +1 -0
  187. package/dist/service/host.js +46 -0
  188. package/dist/service/host.js.map +1 -0
  189. package/dist/service/index.js +142 -0
  190. package/dist/service/index.js.map +1 -0
  191. package/dist/service/launchd.js +88 -0
  192. package/dist/service/launchd.js.map +1 -0
  193. package/dist/service/spec.js +9 -0
  194. package/dist/service/spec.js.map +1 -0
  195. package/dist/service/systemd.js +90 -0
  196. package/dist/service/systemd.js.map +1 -0
  197. package/dist/service/windows.js +122 -0
  198. package/dist/service/windows.js.map +1 -0
  199. package/dist/setup/pairing.js +143 -0
  200. package/dist/setup/pairing.js.map +1 -0
  201. package/dist/setup/setup.js +76 -0
  202. package/dist/setup/setup.js.map +1 -0
  203. package/dist/standing/defaults.js +80 -0
  204. package/dist/standing/defaults.js.map +1 -0
  205. package/dist/standing/model.js +72 -0
  206. package/dist/standing/model.js.map +1 -0
  207. package/dist/standing/service.js +228 -0
  208. package/dist/standing/service.js.map +1 -0
  209. package/dist/standing/tools.js +184 -0
  210. package/dist/standing/tools.js.map +1 -0
  211. package/dist/store/db.js +67 -0
  212. package/dist/store/db.js.map +1 -0
  213. package/dist/store/migrations.js +280 -0
  214. package/dist/store/migrations.js.map +1 -0
  215. package/dist/supervisor/processes.js +128 -0
  216. package/dist/supervisor/processes.js.map +1 -0
  217. package/dist/supervisor/stalls.js +103 -0
  218. package/dist/supervisor/stalls.js.map +1 -0
  219. package/dist/terminal/activity.js +97 -0
  220. package/dist/terminal/activity.js.map +1 -0
  221. package/dist/terminal/conversation.js +231 -0
  222. package/dist/terminal/conversation.js.map +1 -0
  223. package/dist/util/async-queue.js +41 -0
  224. package/dist/util/async-queue.js.map +1 -0
  225. package/dist/util/command.js +29 -0
  226. package/dist/util/command.js.map +1 -0
  227. package/dist/util/ids.js +9 -0
  228. package/dist/util/ids.js.map +1 -0
  229. package/dist/util/process-tree.js +62 -0
  230. package/dist/util/process-tree.js.map +1 -0
  231. package/dist/util/secrets.js +31 -0
  232. package/dist/util/secrets.js.map +1 -0
  233. package/dist/version.js +5 -0
  234. package/dist/version.js.map +1 -0
  235. package/dist/workers/claude/classify.js +172 -0
  236. package/dist/workers/claude/classify.js.map +1 -0
  237. package/dist/workers/claude/index.js +440 -0
  238. package/dist/workers/claude/index.js.map +1 -0
  239. package/dist/workers/claude/process.js +135 -0
  240. package/dist/workers/claude/process.js.map +1 -0
  241. package/dist/workers/claude/quota.js +37 -0
  242. package/dist/workers/claude/quota.js.map +1 -0
  243. package/dist/workers/claude/stream.js +286 -0
  244. package/dist/workers/claude/stream.js.map +1 -0
  245. package/dist/workers/codex/index.js +181 -0
  246. package/dist/workers/codex/index.js.map +1 -0
  247. package/dist/workers/codex/mapping.js +166 -0
  248. package/dist/workers/codex/mapping.js.map +1 -0
  249. package/dist/workers/codex/process.js +124 -0
  250. package/dist/workers/codex/process.js.map +1 -0
  251. package/dist/workers/codex/protocol.js +7 -0
  252. package/dist/workers/codex/protocol.js.map +1 -0
  253. package/dist/workers/codex/rpc.js +145 -0
  254. package/dist/workers/codex/rpc.js.map +1 -0
  255. package/dist/workers/codex/run.js +556 -0
  256. package/dist/workers/codex/run.js.map +1 -0
  257. package/dist/workers/env.js +49 -0
  258. package/dist/workers/env.js.map +1 -0
  259. package/dist/workers/fake/index.js +283 -0
  260. package/dist/workers/fake/index.js.map +1 -0
  261. package/dist/workers/models.js +171 -0
  262. package/dist/workers/models.js.map +1 -0
  263. package/dist/workers/registry.js +63 -0
  264. package/dist/workers/registry.js.map +1 -0
  265. package/dist/workers/types.js +6 -0
  266. package/dist/workers/types.js.map +1 -0
  267. package/package.json +66 -4
@@ -0,0 +1,104 @@
1
+ import { randomBytes } from "node:crypto";
2
+ /**
3
+ * A Channel for tests: delivers owner and non-owner messages, records what Preston sends
4
+ * (including reactions), and can be told to fail deliveries.
5
+ */
6
+ export class FakeChannel {
7
+ kind;
8
+ capabilities;
9
+ sent = [];
10
+ /** Refs passed to `markAnswered`. */
11
+ reactions = [];
12
+ /** Refs of the owner's messages Preston marked as read. */
13
+ acknowledged = [];
14
+ /** Every `setTyping` call, in order. */
15
+ typing = [];
16
+ /** Delivery attempts, including failed ones. */
17
+ attempts = 0;
18
+ ctx;
19
+ failures = [];
20
+ failAll;
21
+ failWithFiles;
22
+ seq = 0;
23
+ /** Native refs are unique across instances, as a real service's are across restarts. */
24
+ tag = randomBytes(3).toString("hex");
25
+ constructor(options = {}) {
26
+ this.kind = options.kind ?? "fake";
27
+ this.capabilities = {
28
+ reactions: options.reactions ?? true,
29
+ proactive: options.proactive ?? "always",
30
+ files: { maxBytes: options.maxFileBytes ?? 1024 * 1024, maxCount: 10 },
31
+ };
32
+ }
33
+ async start(ctx) {
34
+ this.ctx = ctx;
35
+ ctx.setStatus("connected");
36
+ }
37
+ async stop() {
38
+ this.ctx?.setStatus("disconnected");
39
+ this.ctx = undefined;
40
+ }
41
+ /** Simulates the user (or, with `owner: false`, someone else) sending a message. */
42
+ /** With `ref`, simulates the service delivering the same native message again. */
43
+ receive(text, options = {}) {
44
+ if (!this.ctx)
45
+ throw new Error(`${this.kind} fake Channel is not started`);
46
+ const ref = options.ref ?? `${this.kind}-in-${this.tag}-${++this.seq}`;
47
+ const owner = options.owner ?? true;
48
+ this.ctx.onMessage({
49
+ channel: this.kind,
50
+ conversationId: `${this.kind}-dm`,
51
+ senderId: options.senderId ?? (owner ? "owner" : "stranger"),
52
+ isOwner: owner,
53
+ text,
54
+ ref,
55
+ receivedAt: new Date().toISOString(),
56
+ });
57
+ return ref;
58
+ }
59
+ /** Fail the next `count` deliveries. */
60
+ failNext(count, failure = { error: "fake outage", retryable: true }) {
61
+ for (let i = 0; i < count; i++)
62
+ this.failures.push(failure);
63
+ }
64
+ /** Fail every delivery until `stopFailing`. */
65
+ failEverything(failure = { error: "fake outage", retryable: true }) {
66
+ this.failAll = failure;
67
+ }
68
+ /** Fail every delivery that carries files (the service refuses uploads), until `stopFailing`. */
69
+ failFiles(failure = { error: "uploads are down", retryable: true }) {
70
+ this.failWithFiles = failure;
71
+ }
72
+ stopFailing() {
73
+ this.failAll = undefined;
74
+ this.failWithFiles = undefined;
75
+ this.failures = [];
76
+ }
77
+ setStatus(status) {
78
+ this.ctx?.setStatus(status);
79
+ }
80
+ async send(message) {
81
+ this.attempts++;
82
+ const failure = this.failAll ??
83
+ (message.files?.length ? this.failWithFiles : undefined) ??
84
+ this.failures.shift();
85
+ if (failure)
86
+ return { status: "failed", ...failure };
87
+ const ref = `${this.kind}-out-${++this.seq}`;
88
+ this.sent.push({ ...message, ref });
89
+ return { status: "delivered", ref };
90
+ }
91
+ async acknowledge(ref) {
92
+ this.acknowledged.push(ref);
93
+ }
94
+ setTyping(conversationId, typing) {
95
+ this.typing.push({ conversationId, typing });
96
+ }
97
+ async markAnswered(ref) {
98
+ this.reactions.push(ref);
99
+ }
100
+ texts(kind) {
101
+ return this.sent.filter((m) => !kind || m.kind === kind).map((m) => m.text);
102
+ }
103
+ }
104
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/channels/fake/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,153 @@
1
+ import { isoNow } from "../clock.js";
2
+ import { errorMessage } from "../log.js";
3
+ import { saveReceivedFile } from "./shared/files.js";
4
+ /**
5
+ * Owns the registered Channels: starts and stops them, tracks their status, and hands inbound
6
+ * messages to the Router. At most one Channel per kind. Chat Channels can be added and removed
7
+ * while running (their config changed, or they were set up in conversation).
8
+ */
9
+ export class ChannelHub {
10
+ log;
11
+ clock;
12
+ notifier;
13
+ attachmentsDir;
14
+ channels = new Map();
15
+ states = new Map();
16
+ connectedListeners = [];
17
+ inbound = () => { };
18
+ started = false;
19
+ constructor(log, clock, notifier,
20
+ /** Where files the user sends are kept. */
21
+ attachmentsDir) {
22
+ this.log = log;
23
+ this.clock = clock;
24
+ this.notifier = notifier;
25
+ this.attachmentsDir = attachmentsDir;
26
+ }
27
+ register(channel) {
28
+ if (this.channels.has(channel.kind)) {
29
+ throw new Error(`A ${channel.kind} Channel is already registered`);
30
+ }
31
+ this.channels.set(channel.kind, channel);
32
+ this.states.set(channel.kind, { status: "disconnected" });
33
+ }
34
+ /** Registers a Channel while running, and starts it if the hub has started. */
35
+ async add(channel) {
36
+ this.register(channel);
37
+ if (this.started)
38
+ await this.startOne(channel);
39
+ }
40
+ /** Stops and unregisters the Channel of this kind, if any. */
41
+ async remove(kind) {
42
+ const channel = this.channels.get(kind);
43
+ if (!channel)
44
+ return;
45
+ this.channels.delete(kind);
46
+ this.states.delete(kind);
47
+ await channel
48
+ .stop()
49
+ .catch((err) => this.log.warn("channel failed to stop", { kind, error: err }));
50
+ }
51
+ onInbound(handler) {
52
+ this.inbound = handler;
53
+ }
54
+ onConnected(listener) {
55
+ this.connectedListeners.push(listener);
56
+ }
57
+ get(kind) {
58
+ return this.channels.get(kind);
59
+ }
60
+ kinds() {
61
+ return [...this.channels.keys()];
62
+ }
63
+ isConnected(kind) {
64
+ return this.states.get(kind)?.status === "connected";
65
+ }
66
+ status() {
67
+ return this.kinds().map((kind) => ({
68
+ kind,
69
+ status: this.states.get(kind)?.status ?? "disconnected",
70
+ }));
71
+ }
72
+ /** Status and detail of a registered Channel. */
73
+ state(kind) {
74
+ if (!this.channels.has(kind))
75
+ return undefined;
76
+ return { kind, ...(this.states.get(kind) ?? { status: "disconnected" }) };
77
+ }
78
+ async start() {
79
+ this.started = true;
80
+ await Promise.all([...this.channels.values()].map((channel) => this.startOne(channel)));
81
+ }
82
+ async stop() {
83
+ this.started = false;
84
+ await Promise.all([...this.channels.values()].map((channel) => channel
85
+ .stop()
86
+ .catch((err) => this.log.warn("channel failed to stop", { kind: channel.kind, error: err }))));
87
+ }
88
+ async startOne(channel) {
89
+ const log = this.log.child(channel.kind);
90
+ // A replaced Channel instance may still report; only the registered one counts.
91
+ const current = () => this.channels.get(channel.kind) === channel;
92
+ try {
93
+ await channel.start({
94
+ onMessage: (message) => {
95
+ if (current())
96
+ this.receive(channel.kind, message);
97
+ },
98
+ setStatus: (status, detail) => {
99
+ if (current())
100
+ this.setStatus(channel.kind, status, detail);
101
+ },
102
+ notifyHost: (text) => this.notifyHost(channel.kind, text),
103
+ saveFile: async (name, data) => {
104
+ if (!this.attachmentsDir)
105
+ throw new Error("This Preston keeps no files");
106
+ return saveReceivedFile(this.attachmentsDir, name, data);
107
+ },
108
+ log: (level, message, data) => log[level](message, data),
109
+ });
110
+ }
111
+ catch (err) {
112
+ if (current())
113
+ this.setStatus(channel.kind, "disconnected", errorMessage(err));
114
+ log.error("channel failed to start", { error: err });
115
+ }
116
+ }
117
+ notifyHost(kind, text) {
118
+ const notifier = this.notifier;
119
+ if (!notifier) {
120
+ this.log.warn("host notification requested (no notifier installed)", { kind, text });
121
+ return;
122
+ }
123
+ Promise.resolve()
124
+ .then(() => notifier.notify(text))
125
+ .catch((err) => this.log.warn("host notification failed", { kind, error: err }));
126
+ }
127
+ receive(kind, message) {
128
+ if (message.channel !== kind) {
129
+ this.log.warn("dropped message reported by the wrong Channel", {
130
+ kind,
131
+ claimed: message.channel,
132
+ });
133
+ return;
134
+ }
135
+ try {
136
+ this.inbound({ ...message, receivedAt: message.receivedAt || isoNow(this.clock) });
137
+ }
138
+ catch (err) {
139
+ this.log.error("failed to handle inbound message", { kind, error: err });
140
+ }
141
+ }
142
+ setStatus(kind, status, detail) {
143
+ const previous = this.states.get(kind)?.status;
144
+ this.states.set(kind, { status, detail });
145
+ if (previous !== status)
146
+ this.log.info("channel status", { kind, status, detail });
147
+ if (status === "connected" && previous !== "connected") {
148
+ for (const listener of this.connectedListeners)
149
+ listener(kind);
150
+ }
151
+ }
152
+ }
153
+ //# sourceMappingURL=hub.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub.js","sourceRoot":"","sources":["../../src/channels/hub.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,219 @@
1
+ import { isoNow } from "../clock.js";
2
+ import { pick } from "../i18n/index.js";
3
+ import { errorMessage } from "../log.js";
4
+ import { all, one, run } from "../store/db.js";
5
+ /** After this many failed tries a message's files are dropped and its text goes alone. */
6
+ const FILE_FALLBACK_ATTEMPTS = 3;
7
+ /**
8
+ * Durable delivery of every outgoing message. Items are attempted only while their Channel is
9
+ * connected, in order per Channel, with exponential backoff on failure. A failed delivery is
10
+ * recorded and never propagates to the caller (so it can never fail a Goal).
11
+ */
12
+ export class Outbox {
13
+ db;
14
+ hub;
15
+ clock;
16
+ log;
17
+ settings;
18
+ redact;
19
+ timer;
20
+ flushing;
21
+ again = false;
22
+ stopped = true;
23
+ constructor(db, hub, clock, log, settings,
24
+ /** Masks secrets in every message before it is stored or sent (never echo a token). */
25
+ redact = (text) => text) {
26
+ this.db = db;
27
+ this.hub = hub;
28
+ this.clock = clock;
29
+ this.log = log;
30
+ this.settings = settings;
31
+ this.redact = redact;
32
+ hub.onConnected(() => this.kick());
33
+ }
34
+ start() {
35
+ this.stopped = false;
36
+ this.kick();
37
+ }
38
+ async stop() {
39
+ this.stopped = true;
40
+ this.timer?.cancel();
41
+ await this.flushing;
42
+ }
43
+ /** Records an item for delivery. Returns false when the dedupe key was already used. */
44
+ enqueue(item) {
45
+ const at = isoNow(this.clock);
46
+ const changes = run(this.db, `INSERT OR IGNORE INTO outbox (dedupe_key, channel, conversation_id, kind, text, reply_to, goal_id, question_id, files, state, next_attempt_at, created_at)
47
+ VALUES (:key, :channel, :conversation, :kind, :text, :replyTo, :goal, :question, :files, 'pending', :due, :at)`, {
48
+ key: item.dedupeKey ?? null,
49
+ channel: item.channel,
50
+ conversation: item.conversationId ?? null,
51
+ kind: item.kind,
52
+ text: this.redact(item.text),
53
+ replyTo: item.replyTo ?? null,
54
+ goal: item.goalId ?? null,
55
+ question: item.questionId ?? null,
56
+ files: item.files?.length ? JSON.stringify(item.files) : null,
57
+ at,
58
+ due: item.holdUntilMs === undefined ? at : new Date(item.holdUntilMs).toISOString(),
59
+ });
60
+ if (changes > 0)
61
+ this.kick();
62
+ return changes > 0;
63
+ }
64
+ /** Sends the same message to every registered Channel's default conversation. */
65
+ broadcast(item) {
66
+ for (const channel of this.hub.kinds()) {
67
+ this.enqueue({
68
+ ...item,
69
+ channel,
70
+ dedupeKey: item.dedupeKey ? `${item.dedupeKey}:${channel}` : undefined,
71
+ });
72
+ }
73
+ }
74
+ /**
75
+ * Withdraws a Goal's own standard outcome message that has not been sent yet (the Coordinator
76
+ * told the user in its own words). Returns how many were withdrawn.
77
+ */
78
+ cancelOutcome(goalId) {
79
+ return run(this.db, "UPDATE outbox SET state = 'cancelled' WHERE goal_id = :g AND kind = 'outcome' AND state = 'pending' AND attempts = 0", { g: goalId });
80
+ }
81
+ /** Withdraws undelivered copies of a question (it was answered elsewhere). */
82
+ cancelQuestion(questionId) {
83
+ run(this.db, "UPDATE outbox SET state = 'cancelled' WHERE question_id = :q AND state = 'pending'", { q: questionId });
84
+ }
85
+ /** Delivered copies of a question that have not been marked answered yet. */
86
+ deliveredQuestion(questionId) {
87
+ return all(this.db, `SELECT id, channel, delivered_ref FROM outbox
88
+ WHERE question_id = :q AND state = 'delivered' AND delivered_ref IS NOT NULL AND marked_answered = 0`, { q: questionId }).map((r) => ({ id: r.id, channel: r.channel, ref: r.delivered_ref }));
89
+ }
90
+ markAnsweredRecorded(id) {
91
+ run(this.db, "UPDATE outbox SET marked_answered = 1 WHERE id = :id", { id });
92
+ }
93
+ /** Schedules a delivery pass soon. */
94
+ kick() {
95
+ if (this.stopped)
96
+ return;
97
+ if (this.flushing) {
98
+ this.again = true;
99
+ return;
100
+ }
101
+ this.flushing = this.flush().finally(() => {
102
+ this.flushing = undefined;
103
+ if (this.again) {
104
+ this.again = false;
105
+ this.kick();
106
+ }
107
+ });
108
+ }
109
+ async flush() {
110
+ await Promise.resolve();
111
+ const now = isoNow(this.clock);
112
+ const due = all(this.db, "SELECT * FROM outbox WHERE state = 'pending' ORDER BY id");
113
+ const blocked = new Set();
114
+ for (const item of due) {
115
+ if (this.stopped)
116
+ return;
117
+ if (blocked.has(item.channel))
118
+ continue;
119
+ // A message held on purpose (not tried yet) waits without holding anything back.
120
+ if (item.next_attempt_at > now && item.attempts === 0)
121
+ continue;
122
+ // Preserve order per Channel: a retry waiting for its backoff holds back the ones after it.
123
+ if (item.next_attempt_at > now || !this.hub.isConnected(item.channel)) {
124
+ blocked.add(item.channel);
125
+ continue;
126
+ }
127
+ if (!(await this.deliver(item)))
128
+ blocked.add(item.channel);
129
+ }
130
+ this.scheduleNext();
131
+ }
132
+ async deliver(item) {
133
+ const channel = this.hub.get(item.channel);
134
+ let result;
135
+ if (!channel) {
136
+ result = { status: "failed", error: "Channel is not registered", retryable: false };
137
+ }
138
+ else {
139
+ try {
140
+ result = await channel.send({
141
+ conversationId: item.conversation_id ?? undefined,
142
+ text: item.text,
143
+ kind: item.kind,
144
+ replyTo: item.reply_to ?? undefined,
145
+ ...(item.files ? { files: JSON.parse(item.files) } : {}),
146
+ });
147
+ }
148
+ catch (err) {
149
+ result = { status: "failed", error: errorMessage(err), retryable: true };
150
+ }
151
+ }
152
+ if (result.status === "delivered") {
153
+ run(this.db, "UPDATE outbox SET state = 'delivered', delivered_ref = :ref, delivered_at = :at, attempts = attempts + 1 WHERE id = :id", { id: item.id, ref: result.ref ?? null, at: isoNow(this.clock) });
154
+ return true;
155
+ }
156
+ const settings = this.settings();
157
+ const attempts = item.attempts + 1;
158
+ const giveUp = !result.retryable || attempts >= settings.maxAttempts;
159
+ // A file that will not go must not hold back the messages behind it, or leave the user
160
+ // hearing nothing: send the text with a note instead, right away.
161
+ if (item.files && (giveUp || attempts >= FILE_FALLBACK_ATTEMPTS)) {
162
+ this.dropFiles(item, result.error);
163
+ return false;
164
+ }
165
+ const delay = result.retryAfterMs ??
166
+ Math.min(settings.baseDelayMs * 2 ** (attempts - 1), settings.maxDelayMs);
167
+ run(this.db, `UPDATE outbox SET attempts = :attempts, last_error = :error, state = :state, next_attempt_at = :next
168
+ WHERE id = :id AND state = 'pending'`, {
169
+ id: item.id,
170
+ attempts,
171
+ error: result.error,
172
+ state: giveUp ? "failed" : "pending",
173
+ next: new Date(this.clock.now() + delay).toISOString(),
174
+ });
175
+ this.log.warn("delivery failed", {
176
+ id: item.id,
177
+ channel: item.channel,
178
+ attempts,
179
+ error: result.error,
180
+ gaveUp: giveUp,
181
+ });
182
+ return false;
183
+ }
184
+ /** Replaces an item's files by a note that they could not be sent, and retries it at once. */
185
+ dropFiles(item, error) {
186
+ const names = JSON.parse(item.files ?? "[]").map((f) => f.name).join(", ");
187
+ const note = pick({
188
+ en: `(I couldn't send ${names}: ${error} It is still on your computer.)`,
189
+ "zh-CN": `(我没能发送 ${names}:${error} 文件仍在您的电脑上。)`,
190
+ });
191
+ run(this.db, `UPDATE outbox SET files = NULL, text = :text, attempts = :attempts, last_error = :error, next_attempt_at = :at
192
+ WHERE id = :id AND state = 'pending'`, {
193
+ id: item.id,
194
+ text: item.text ? `${item.text}\n\n${note}` : note,
195
+ attempts: item.attempts + 1,
196
+ error,
197
+ at: isoNow(this.clock),
198
+ });
199
+ this.log.warn("could not send files; sending the text without them", {
200
+ id: item.id,
201
+ channel: item.channel,
202
+ error,
203
+ });
204
+ this.again = true;
205
+ }
206
+ scheduleNext() {
207
+ this.timer?.cancel();
208
+ this.timer = undefined;
209
+ if (this.stopped)
210
+ return;
211
+ // Items already due wait for their Channel to connect, which kicks the outbox.
212
+ const next = one(this.db, "SELECT MIN(next_attempt_at) AS at FROM outbox WHERE state = 'pending' AND next_attempt_at > :now", { now: isoNow(this.clock) })?.at;
213
+ if (!next)
214
+ return;
215
+ const delay = Date.parse(next) - this.clock.now();
216
+ this.timer = this.clock.setTimeout(() => this.kick(), delay);
217
+ }
218
+ }
219
+ //# sourceMappingURL=outbox.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../src/channels/outbox.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,67 @@
1
+ import { z } from "zod";
2
+ import { pick } from "../i18n/index.js";
3
+ import { createDiscordChannel, discordSetupGuide, discordSetupGuideZh, } from "./discord/index.js";
4
+ import { createSlackChannel, slackAppManifest, slackSetupGuide, slackSetupGuideZh, } from "./slack/index.js";
5
+ export const CHAT_CHANNEL_KINDS = ["discord", "slack"];
6
+ const id = z.string().min(1).optional();
7
+ const DISCORD_TOKEN = /^[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{4,}\.[A-Za-z0-9_-]{20,}$/;
8
+ const SLACK_BOT_TOKEN = /^xoxb-[A-Za-z0-9-]{10,}$/;
9
+ const SLACK_APP_TOKEN = /^xapp-[A-Za-z0-9-]{10,}$/;
10
+ /**
11
+ * The chat Channels Preston ships, next to the always-present terminal. `deps` replaces their
12
+ * network transports (tests use fakes).
13
+ */
14
+ export function chatChannelSpecs(deps = {}) {
15
+ return {
16
+ discord: {
17
+ label: "Discord",
18
+ settings: z.strictObject({
19
+ botToken: z.string().regex(DISCORD_TOKEN, "that doesn't look like a Discord bot token"),
20
+ ownerUserId: id,
21
+ dmChannelId: id,
22
+ }),
23
+ create: (ctx) => createDiscordChannel(ctx.settings, deps.discord),
24
+ credentials: {
25
+ botToken: {
26
+ label: "Discord bot token",
27
+ pattern: DISCORD_TOKEN,
28
+ hint: 'A Discord bot token is a long text with two dots in it. In the Developer Portal open your application, click "Bot", then "Reset Token" and "Copy".',
29
+ },
30
+ },
31
+ stateKeys: [],
32
+ guide: () => pick({ en: discordSetupGuide, "zh-CN": discordSetupGuideZh }),
33
+ },
34
+ slack: {
35
+ label: "Slack",
36
+ settings: z.strictObject({
37
+ botToken: z.string().regex(SLACK_BOT_TOKEN, "the bot token must start with xoxb-"),
38
+ appToken: z.string().regex(SLACK_APP_TOKEN, "the app-level token must start with xapp-"),
39
+ ownerUserId: id,
40
+ dmChannelId: id,
41
+ }),
42
+ create: (ctx) => createSlackChannel(ctx.settings, deps.slack),
43
+ credentials: {
44
+ botToken: {
45
+ label: "Slack bot token",
46
+ pattern: SLACK_BOT_TOKEN,
47
+ hint: 'The bot token starts with xoxb-. It is under "OAuth & Permissions" as "Bot User OAuth Token".',
48
+ },
49
+ appToken: {
50
+ label: "Slack app-level token",
51
+ pattern: SLACK_APP_TOKEN,
52
+ hint: 'The app-level token starts with xapp-. Create it under "Basic Information", "App-Level Tokens", with the connections:write scope.',
53
+ },
54
+ },
55
+ stateKeys: [],
56
+ guide: () => pick({
57
+ en: `${slackSetupGuide}\n\nThe manifest to paste in step 3:\n\n${slackAppManifest()}`,
58
+ "zh-CN": `${slackSetupGuideZh}\n\n第 3 步要粘贴的 manifest:\n\n${slackAppManifest()}`,
59
+ }),
60
+ },
61
+ };
62
+ }
63
+ export const CHAT_CHANNELS = chatChannelSpecs();
64
+ export function isChatChannelKind(kind) {
65
+ return CHAT_CHANNEL_KINDS.includes(kind);
66
+ }
67
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/channels/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EACL,oBAAoB,EAEpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAElB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,CAAC,MAAM,kBAAkB,GAA+B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AA8CnF,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AACxC,MAAM,aAAa,GAAG,6DAA6D,CAAC;AACpF,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAI,GAAoB,EAAE;IAE1B,OAAO;QACL,OAAO,EAAE;YACP,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC;gBACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,4CAA4C,CAAC;gBACvF,WAAW,EAAE,EAAE;gBACf,WAAW,EAAE,EAAE;aAChB,CAAC;YACF,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAgC,EAAE,IAAI,CAAC,OAAO,CAAC;YACzF,WAAW,EAAE;gBACX,QAAQ,EAAE;oBACR,KAAK,EAAE,mBAAmB;oBAC1B,OAAO,EAAE,aAAa;oBACtB,IAAI,EAAE,oJAAoJ;iBAC3J;aACF;YACD,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;SAC3E;QACD,KAAK,EAAE;YACL,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC;gBACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,qCAAqC,CAAC;gBAClF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,2CAA2C,CAAC;gBACxF,WAAW,EAAE,EAAE;gBACf,WAAW,EAAE,EAAE;aAChB,CAAC;YACF,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CACd,kBAAkB,CAAC,GAAG,CAAC,QAAkD,EAAE,IAAI,CAAC,KAAK,CAAC;YACxF,WAAW,EAAE;gBACX,QAAQ,EAAE;oBACR,KAAK,EAAE,iBAAiB;oBACxB,OAAO,EAAE,eAAe;oBACxB,IAAI,EAAE,+FAA+F;iBACtG;gBACD,QAAQ,EAAE;oBACR,KAAK,EAAE,uBAAuB;oBAC9B,OAAO,EAAE,eAAe;oBACxB,IAAI,EAAE,mIAAmI;iBAC1I;aACF;YACD,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,CAAC;gBACH,EAAE,EAAE,GAAG,eAAe,2CAA2C,gBAAgB,EAAE,EAAE;gBACrF,OAAO,EAAE,GAAG,iBAAiB,8BAA8B,gBAAgB,EAAE,EAAE;aAChF,CAAC;SACL;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA6C,gBAAgB,EAAE,CAAC;AAE1F,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC"}
@@ -0,0 +1,50 @@
1
+ const FIXED_WORDS = ["status", "stop", "pause", "resume"];
2
+ /** Chinese equivalents, always accepted whatever language Preston speaks. */
3
+ const CHINESE_WORDS = {
4
+ 状态: "status",
5
+ 停止: "stop",
6
+ 暂停: "pause",
7
+ 继续: "resume",
8
+ };
9
+ /** The whole message, ignoring case and surrounding whitespace, is one of the fixed words. */
10
+ export function fixedWord(text) {
11
+ const word = text.trim().toLowerCase();
12
+ return FIXED_WORDS.find((w) => w === word) ?? CHINESE_WORDS[word];
13
+ }
14
+ /**
15
+ * Decides what happens to each inbound message: non-owners are ignored, fixed words get a
16
+ * deterministic reply, and everything else becomes a Coordinator invocation.
17
+ */
18
+ export class Router {
19
+ deps;
20
+ constructor(deps) {
21
+ this.deps = deps;
22
+ }
23
+ handle(message) {
24
+ if (!message.isOwner) {
25
+ this.deps.log.info("ignored message from a non-owner", {
26
+ channel: message.channel,
27
+ senderId: message.senderId,
28
+ });
29
+ return;
30
+ }
31
+ const word = fixedWord(message.text);
32
+ // Read receipt first, before any thinking: the owner sees it at once.
33
+ this.deps.acknowledge?.(message);
34
+ if (!word) {
35
+ if (this.deps.intercept?.(message))
36
+ return;
37
+ this.deps.toCoordinator(message);
38
+ return;
39
+ }
40
+ this.deps.log.info("fixed word", { channel: message.channel, word });
41
+ this.deps.outbox.enqueue({
42
+ channel: message.channel,
43
+ conversationId: message.conversationId,
44
+ kind: "reply",
45
+ text: this.deps.fixed[word](),
46
+ replyTo: message.ref,
47
+ });
48
+ }
49
+ }
50
+ //# sourceMappingURL=router.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/channels/router.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,GAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAEhF,6EAA6E;AAC7E,MAAM,aAAa,GAA8B;IAC/C,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF,8FAA8F;AAC9F,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAkBD;;;GAGG;AACH,MAAM,OAAO,MAAM;IACY,IAAI;IAAjC,YAA6B,IAAgB;oBAAhB,IAAI;IAAe,CAAC;IAEjD,MAAM,CAAC,OAAuB;QAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBACrD,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,sEAAsE;QACtE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC;gBAAE,OAAO;YAC3C,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;YAC7B,OAAO,EAAE,OAAO,CAAC,GAAG;SACrB,CAAC,CAAC;IACL,CAAC;CACF"}