@cello-protocol/cli 0.0.305 → 0.0.307

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 (234) hide show
  1. package/.claude-plugin/marketplace.json +15 -0
  2. package/README.md +107 -0
  3. package/dist/cli.d.ts +2 -0
  4. package/dist/cli.js +564 -0
  5. package/dist/daemon/account-page-assets.d.ts +4 -0
  6. package/dist/daemon/account-page-assets.js +160 -0
  7. package/dist/daemon/account-page.d.ts +14 -0
  8. package/dist/daemon/account-page.js +104 -0
  9. package/dist/daemon/address.d.ts +10 -0
  10. package/dist/daemon/address.js +34 -0
  11. package/dist/daemon/away.d.ts +31 -0
  12. package/dist/daemon/away.js +65 -0
  13. package/dist/daemon/channel-store.d.ts +112 -0
  14. package/dist/daemon/channel-store.js +284 -0
  15. package/dist/daemon/channels.d.ts +46 -0
  16. package/dist/daemon/channels.js +1049 -0
  17. package/dist/daemon/contacts.d.ts +26 -0
  18. package/dist/daemon/contacts.js +74 -0
  19. package/dist/daemon/engine.d.ts +80 -0
  20. package/dist/daemon/engine.js +2882 -0
  21. package/dist/daemon/errors.d.ts +5 -0
  22. package/dist/daemon/errors.js +16 -0
  23. package/dist/daemon/governance.d.ts +66 -0
  24. package/dist/daemon/governance.js +514 -0
  25. package/dist/daemon/guards.d.ts +36 -0
  26. package/dist/daemon/guards.js +140 -0
  27. package/dist/daemon/issuer-client.d.ts +56 -0
  28. package/dist/daemon/issuer-client.js +143 -0
  29. package/dist/daemon/link.d.ts +30 -0
  30. package/dist/daemon/link.js +191 -0
  31. package/dist/daemon/log.d.ts +1 -0
  32. package/dist/daemon/log.js +4 -0
  33. package/dist/daemon/main.d.ts +1 -0
  34. package/dist/daemon/main.js +511 -0
  35. package/dist/daemon/paths.d.ts +6 -0
  36. package/dist/daemon/paths.js +21 -0
  37. package/dist/daemon/pii.d.ts +24 -0
  38. package/dist/daemon/pii.js +146 -0
  39. package/dist/daemon/policy-cadence.d.ts +33 -0
  40. package/dist/daemon/policy-cadence.js +59 -0
  41. package/dist/daemon/policy-proposals.d.ts +41 -0
  42. package/dist/daemon/policy-proposals.js +83 -0
  43. package/dist/daemon/policy-store.d.ts +47 -0
  44. package/dist/daemon/policy-store.js +144 -0
  45. package/dist/daemon/presented.d.ts +36 -0
  46. package/dist/daemon/presented.js +94 -0
  47. package/dist/daemon/rate-limit.d.ts +17 -0
  48. package/dist/daemon/rate-limit.js +44 -0
  49. package/dist/daemon/reach.d.ts +63 -0
  50. package/dist/daemon/reach.js +207 -0
  51. package/dist/daemon/screening.d.ts +97 -0
  52. package/dist/daemon/screening.js +362 -0
  53. package/dist/daemon/settings.d.ts +125 -0
  54. package/dist/daemon/settings.js +73 -0
  55. package/dist/daemon/signal-rules.d.ts +55 -0
  56. package/dist/daemon/signal-rules.js +127 -0
  57. package/dist/daemon/signal-store.d.ts +53 -0
  58. package/dist/daemon/signal-store.js +114 -0
  59. package/dist/daemon/store.d.ts +188 -0
  60. package/dist/daemon/store.js +474 -0
  61. package/dist/daemon/tiers.d.ts +14 -0
  62. package/dist/daemon/tiers.js +9 -0
  63. package/dist/daemon/wallet.d.ts +73 -0
  64. package/dist/daemon/wallet.js +428 -0
  65. package/dist/daemon/who-label.d.ts +3 -0
  66. package/dist/daemon/who-label.js +11 -0
  67. package/dist/guidance.d.ts +39 -0
  68. package/dist/guidance.js +98 -0
  69. package/dist/hermes-bridge.d.ts +26 -0
  70. package/dist/hermes-bridge.js +180 -0
  71. package/dist/install-mcp.d.ts +6 -0
  72. package/dist/install-mcp.js +77 -0
  73. package/dist/ipc/client.d.ts +18 -0
  74. package/dist/ipc/client.js +107 -0
  75. package/dist/ipc/operations.d.ts +30 -0
  76. package/dist/ipc/operations.js +835 -0
  77. package/dist/ipc/protocol.d.ts +21 -0
  78. package/dist/ipc/protocol.js +1 -0
  79. package/dist/issuer-list-sign.d.ts +12 -0
  80. package/dist/issuer-list-sign.js +43 -0
  81. package/dist/local-operations.d.ts +2 -0
  82. package/dist/local-operations.js +73 -0
  83. package/dist/mcp-tools.d.ts +14 -0
  84. package/dist/mcp-tools.js +45 -0
  85. package/dist/mcp.d.ts +2 -0
  86. package/dist/mcp.js +155 -0
  87. package/dist/protocol/aead.d.ts +4 -0
  88. package/dist/protocol/aead.js +35 -0
  89. package/dist/protocol/cbor.d.ts +40 -0
  90. package/dist/protocol/cbor.js +106 -0
  91. package/dist/protocol/chain.d.ts +44 -0
  92. package/dist/protocol/chain.js +126 -0
  93. package/dist/protocol/channel.d.ts +153 -0
  94. package/dist/protocol/channel.js +298 -0
  95. package/dist/protocol/encode.d.ts +6 -0
  96. package/dist/protocol/encode.js +21 -0
  97. package/dist/protocol/identity.d.ts +27 -0
  98. package/dist/protocol/identity.js +94 -0
  99. package/dist/protocol/issuer-list.d.ts +56 -0
  100. package/dist/protocol/issuer-list.js +193 -0
  101. package/dist/protocol/issuer-roots.d.ts +6 -0
  102. package/dist/protocol/issuer-roots.js +10 -0
  103. package/dist/protocol/key-agreement.d.ts +20 -0
  104. package/dist/protocol/key-agreement.js +88 -0
  105. package/dist/protocol/merkle.d.ts +16 -0
  106. package/dist/protocol/merkle.js +166 -0
  107. package/dist/protocol/ml-dsa.d.ts +28 -0
  108. package/dist/protocol/ml-dsa.js +58 -0
  109. package/dist/protocol/ml-kem.d.ts +14 -0
  110. package/dist/protocol/ml-kem.js +57 -0
  111. package/dist/protocol/pq-errors.d.ts +9 -0
  112. package/dist/protocol/pq-errors.js +23 -0
  113. package/dist/protocol/pq-warnings.d.ts +1 -0
  114. package/dist/protocol/pq-warnings.js +18 -0
  115. package/dist/protocol/presented-signals.d.ts +17 -0
  116. package/dist/protocol/presented-signals.js +92 -0
  117. package/dist/protocol/salt.d.ts +5 -0
  118. package/dist/protocol/salt.js +47 -0
  119. package/dist/protocol/seal.d.ts +58 -0
  120. package/dist/protocol/seal.js +220 -0
  121. package/dist/protocol/signal.d.ts +54 -0
  122. package/dist/protocol/signal.js +266 -0
  123. package/dist/protocol/status.d.ts +41 -0
  124. package/dist/protocol/status.js +64 -0
  125. package/dist/protocol/structures.d.ts +359 -0
  126. package/dist/protocol/structures.js +296 -0
  127. package/dist/protocol/transcript.d.ts +61 -0
  128. package/dist/protocol/transcript.js +319 -0
  129. package/dist/protocol/wire.d.ts +212 -0
  130. package/dist/protocol/wire.js +161 -0
  131. package/dist/require-node.d.ts +1 -0
  132. package/dist/require-node.js +10 -0
  133. package/dist/screener/affordance.d.ts +1 -0
  134. package/dist/screener/affordance.js +2 -0
  135. package/dist/screener/classifier-selfcheck.d.ts +29 -0
  136. package/dist/screener/classifier-selfcheck.js +56 -0
  137. package/dist/screener/exfil.d.ts +11 -0
  138. package/dist/screener/exfil.js +45 -0
  139. package/dist/screener/gitleaks-rules.d.ts +9 -0
  140. package/dist/screener/gitleaks-rules.js +226 -0
  141. package/dist/screener/inbound.d.ts +25 -0
  142. package/dist/screener/inbound.js +102 -0
  143. package/dist/screener/injection-classifier-onnx.d.ts +20 -0
  144. package/dist/screener/injection-classifier-onnx.js +89 -0
  145. package/dist/screener/injection-classifier-wasm.d.ts +2 -0
  146. package/dist/screener/injection-classifier-wasm.js +97 -0
  147. package/dist/screener/injection-patterns.d.ts +8 -0
  148. package/dist/screener/injection-patterns.js +48 -0
  149. package/dist/screener/injection-windows.d.ts +9 -0
  150. package/dist/screener/injection-windows.js +37 -0
  151. package/dist/screener/language.d.ts +15 -0
  152. package/dist/screener/language.js +71 -0
  153. package/dist/screener/linear-regex.d.ts +8 -0
  154. package/dist/screener/linear-regex.js +27 -0
  155. package/dist/screener/model-installer.d.ts +14 -0
  156. package/dist/screener/model-installer.js +61 -0
  157. package/dist/screener/outbound.d.ts +19 -0
  158. package/dist/screener/outbound.js +62 -0
  159. package/dist/screener/sanitize.d.ts +44 -0
  160. package/dist/screener/sanitize.js +361 -0
  161. package/dist/screener/scan-variants.d.ts +5 -0
  162. package/dist/screener/scan-variants.js +146 -0
  163. package/dist/screener/screener-model-manifest.d.ts +16 -0
  164. package/dist/screener/screener-model-manifest.js +20 -0
  165. package/dist/screener/screener-state.d.ts +29 -0
  166. package/dist/screener/screener-state.js +119 -0
  167. package/dist/screener/secrets.d.ts +18 -0
  168. package/dist/screener/secrets.js +84 -0
  169. package/dist/screener/worker.d.ts +6 -0
  170. package/dist/screener/worker.js +83 -0
  171. package/dist/setup.d.ts +9 -0
  172. package/dist/setup.js +252 -0
  173. package/dist/shipped-issuer-list.d.ts +1 -0
  174. package/dist/shipped-issuer-list.js +3 -0
  175. package/dist/signals-text.d.ts +46 -0
  176. package/dist/signals-text.js +81 -0
  177. package/dist/verify-seal.d.ts +9 -0
  178. package/dist/verify-seal.js +30 -0
  179. package/hermes/plugin/__init__.py +1040 -0
  180. package/hermes/plugin/plugin.yaml +30 -0
  181. package/hermes/skills/cello-bridge-setup/SKILL.md +38 -0
  182. package/hermes/skills/cello-policy/SKILL.md +44 -0
  183. package/package.json +48 -16
  184. package/plugins/cello/.claude-plugin/plugin.json +19 -0
  185. package/plugins/cello/.mcp.json +7 -0
  186. package/plugins/cello/skills/cello/SKILL.md +117 -0
  187. package/dist/arg-parse.d.ts +0 -19
  188. package/dist/arg-parse.d.ts.map +0 -1
  189. package/dist/arg-parse.js +0 -29
  190. package/dist/arg-parse.js.map +0 -1
  191. package/dist/bin/cello.d.ts +0 -15
  192. package/dist/bin/cello.d.ts.map +0 -1
  193. package/dist/bin/cello.js +0 -110
  194. package/dist/bin/cello.js.map +0 -1
  195. package/dist/cli-args.d.ts +0 -62
  196. package/dist/cli-args.d.ts.map +0 -1
  197. package/dist/cli-args.js +0 -129
  198. package/dist/cli-args.js.map +0 -1
  199. package/dist/commands.d.ts +0 -196
  200. package/dist/commands.d.ts.map +0 -1
  201. package/dist/commands.js +0 -1544
  202. package/dist/commands.js.map +0 -1
  203. package/dist/hermes/assets.d.ts +0 -41
  204. package/dist/hermes/assets.d.ts.map +0 -1
  205. package/dist/hermes/assets.js +0 -2281
  206. package/dist/hermes/assets.js.map +0 -1
  207. package/dist/hermes/install-hermes.d.ts +0 -50
  208. package/dist/hermes/install-hermes.d.ts.map +0 -1
  209. package/dist/hermes/install-hermes.js +0 -232
  210. package/dist/hermes/install-hermes.js.map +0 -1
  211. package/dist/json-out.d.ts +0 -41
  212. package/dist/json-out.d.ts.map +0 -1
  213. package/dist/json-out.js +0 -59
  214. package/dist/json-out.js.map +0 -1
  215. package/dist/node-runtime-guard-init.d.ts +0 -6
  216. package/dist/node-runtime-guard-init.d.ts.map +0 -1
  217. package/dist/node-runtime-guard-init.js +0 -7
  218. package/dist/node-runtime-guard-init.js.map +0 -1
  219. package/dist/node-runtime-guard.d.ts +0 -48
  220. package/dist/node-runtime-guard.d.ts.map +0 -1
  221. package/dist/node-runtime-guard.js +0 -79
  222. package/dist/node-runtime-guard.js.map +0 -1
  223. package/dist/parity-commands.d.ts +0 -427
  224. package/dist/parity-commands.d.ts.map +0 -1
  225. package/dist/parity-commands.js +0 -953
  226. package/dist/parity-commands.js.map +0 -1
  227. package/dist/registry.d.ts +0 -120
  228. package/dist/registry.d.ts.map +0 -1
  229. package/dist/registry.js +0 -2169
  230. package/dist/registry.js.map +0 -1
  231. package/dist/screener-commands.d.ts +0 -85
  232. package/dist/screener-commands.d.ts.map +0 -1
  233. package/dist/screener-commands.js +0 -313
  234. package/dist/screener-commands.js.map +0 -1
@@ -0,0 +1,511 @@
1
+ // The daemon: the local socket opens first, so a client never sees "failed" while it's coming up.
2
+ import { randomBytes, randomUUID } from "node:crypto";
3
+ import { existsSync, mkdirSync, unlinkSync } from "node:fs";
4
+ import { createServer, createConnection } from "node:net";
5
+ import { monitorEventLoopDelay } from "node:perf_hooks";
6
+ import { createInterface } from "node:readline";
7
+ import { DEFAULT_WAIT_SECONDS } from "../ipc/operations.js";
8
+ import { CONFIG_SERVER_URL, Engine, LocalError } from "./engine.js";
9
+ import { serveAccountPage } from "./account-page.js";
10
+ import { Channels } from "./channels.js";
11
+ import { logEvent } from "./log.js";
12
+ import { currentSetting } from "./settings.js";
13
+ import { celloHome, databasePath, holdsOldVersion, oldVersionMessage, socketPath } from "./paths.js";
14
+ import { Store } from "./store.js";
15
+ const home = celloHome();
16
+ if (holdsOldVersion(home)) {
17
+ logEvent("daemon.old_version_data", { message: oldVersionMessage(home) });
18
+ process.exit(1);
19
+ }
20
+ mkdirSync(home, { recursive: true, mode: 0o700 });
21
+ const path = socketPath(home);
22
+ // One daemon per home. A socket file nobody answers on is left over from a crash.
23
+ async function clearStaleSocket() {
24
+ if (!existsSync(path))
25
+ return;
26
+ const answered = await new Promise((resolve) => {
27
+ const probe = createConnection(path);
28
+ probe.once("connect", () => { probe.destroy(); resolve(true); });
29
+ probe.once("error", () => resolve(false));
30
+ });
31
+ if (answered)
32
+ throw new Error(`a daemon is already running on ${path}`);
33
+ unlinkSync(path);
34
+ }
35
+ await clearStaleSocket();
36
+ const store = new Store(databasePath(home));
37
+ // The server is named once, and then lives in the database, so moving the database and its key moves everything.
38
+ const serverUrl = process.argv[2] ?? store.getConfig(CONFIG_SERVER_URL);
39
+ if (!serverUrl) {
40
+ logEvent("daemon.no_server", { message: "no server is set for this data yet. Run: cello setup, or cello login --server <url>" });
41
+ process.exit(1);
42
+ }
43
+ const sockets = new Set();
44
+ const holders = new Map();
45
+ const listeners = new Map();
46
+ function writeFrame(socket, frame) {
47
+ if (!socket.destroyed)
48
+ socket.write(`${JSON.stringify(frame)}\n`);
49
+ }
50
+ function ring(agentHex, bell) {
51
+ for (const listener of listeners.get(agentHex) ?? []) {
52
+ if (listener.onBell)
53
+ listener.onBell(bell);
54
+ else
55
+ writeFrame(listener.socket, { notification: bell.type, data: { ...bell } });
56
+ }
57
+ }
58
+ const engine = new Engine(store, serverUrl, { ring, channelPush: (frame) => channels.onPush(frame), reachable: (agent) => holders.has(agent) });
59
+ const channels = new Channels(store, engine.channelHost());
60
+ const STALL_RESOLUTION_MS = 5;
61
+ const mainThreadDelay = monitorEventLoopDelay({ resolution: STALL_RESOLUTION_MS });
62
+ mainThreadDelay.enable();
63
+ function text(params, key) {
64
+ const value = params[key];
65
+ if (typeof value !== "string" || value.length === 0)
66
+ throw new LocalError("bad_argument", `${key} must be a non-empty string`);
67
+ return value;
68
+ }
69
+ function optionalText(params, key) {
70
+ return params[key] === undefined ? undefined : text(params, key);
71
+ }
72
+ function describeCaller(caller) {
73
+ if (caller === "cli")
74
+ return "the command line on this machine";
75
+ return caller.startsWith("mcp:") ? "another session" : `the caller "${caller}"`;
76
+ }
77
+ function takeHold(agentHex, caller, force) {
78
+ const holder = holders.get(agentHex);
79
+ if (holder && holder.caller !== caller) {
80
+ if (!force)
81
+ throw new LocalError("agent_held", `${describeCaller(holder.caller)} holds ${engine.agentName(agentHex)}. It can be taken over with force.`);
82
+ for (const listener of [...(listeners.get(agentHex) ?? [])]) {
83
+ if (listener.caller === caller)
84
+ continue;
85
+ // A wait in progress ends now and says why, rather than running out its time.
86
+ if (listener.onBell)
87
+ listener.onBell({ type: "agent_displaced", agent: engine.agentName(agentHex) });
88
+ else
89
+ writeFrame(listener.socket, { notification: "agent_displaced", data: { agent: engine.agentName(agentHex) } });
90
+ listeners.get(agentHex)?.delete(listener);
91
+ }
92
+ }
93
+ if (holder?.caller !== caller)
94
+ holders.set(agentHex, { caller, since: Date.now() });
95
+ }
96
+ // Every call that acts as an agent passes through here, with its identity in the call itself.
97
+ function acting(params) {
98
+ const agent = engine.resolveAgent(text(params, "agent"));
99
+ takeHold(agent, text(params, "caller"), params["force"] === true);
100
+ return agent;
101
+ }
102
+ // Naming an agent is enough for its own wallet: it doesn't act as the agent, so it takes no hold.
103
+ function named(params) {
104
+ return engine.resolveAgent(text(params, "agent"));
105
+ }
106
+ function requirePerson(params) {
107
+ if (params["person_confirmed"] !== true)
108
+ throw new LocalError("person_required", "This takes a person at a terminal, on this machine, with the cello command. Nothing changed.");
109
+ }
110
+ function stopListening(socket) {
111
+ for (const [agent, set] of listeners) {
112
+ // All of this socket's listeners go first, so a wait in progress on it can't keep a dead caller's hold alive.
113
+ const gone = [...set].filter((listener) => listener.socket === socket);
114
+ for (const listener of gone)
115
+ set.delete(listener);
116
+ for (const listener of gone) {
117
+ const stillThere = [...set].some((other) => other.caller === listener.caller);
118
+ // A session's hold lasts as long as it can be reached. The command line's lasts until it lets go.
119
+ if (listener.releaseOnClose && !stillThere && holders.get(agent)?.caller === listener.caller)
120
+ holders.delete(agent);
121
+ }
122
+ }
123
+ }
124
+ let shuttingDown = false;
125
+ function shutdown() {
126
+ if (shuttingDown)
127
+ return;
128
+ shuttingDown = true;
129
+ logEvent("daemon.stopping");
130
+ void accountPage?.close();
131
+ channels.stop();
132
+ engine.stop();
133
+ for (const socket of sockets)
134
+ socket.destroy();
135
+ ipc.close(() => {
136
+ store.close();
137
+ process.exit(0);
138
+ });
139
+ }
140
+ // A result that counts only once it's written to an open socket. That protects a caller that hung up first.
141
+ // It can't protect one killed after the write and before reading it: written isn't the same as read.
142
+ class AfterWrite {
143
+ result;
144
+ commit;
145
+ constructor(result, commit) {
146
+ this.result = result;
147
+ this.commit = commit;
148
+ }
149
+ }
150
+ // For a program passing a read on: it counts only when the program says it reached whoever asked. Tokens live in memory,
151
+ // so after a restart or this long the messages are simply still unread.
152
+ const DEFERRED_READ_MS = 5 * 60_000;
153
+ const deferredReads = new Map();
154
+ function delivered(params, agent, read) {
155
+ if (params["defer_commit"] !== true)
156
+ return new AfterWrite(read.result, read.commit);
157
+ const token = randomUUID();
158
+ const timer = setTimeout(() => deferredReads.delete(token), DEFERRED_READ_MS);
159
+ timer.unref();
160
+ deferredReads.set(token, { agent, commit: read.commit, timer });
161
+ return { ...read.result, commit_token: token };
162
+ }
163
+ function waitForEvent(socket, agent, caller, seconds) {
164
+ return new Promise((resolve) => {
165
+ const set = listeners.get(agent) ?? new Set();
166
+ listeners.set(agent, set);
167
+ const finish = (outcome) => {
168
+ clearTimeout(timer);
169
+ socket.off("close", gone);
170
+ set.delete(listener);
171
+ resolve(outcome);
172
+ };
173
+ const listener = { socket, caller, releaseOnClose: false, onBell: (bell) => finish({ event: bell.type, ...bell }) };
174
+ const gone = () => finish({ event: "caller_gone" });
175
+ const timer = setTimeout(() => finish({ event: "timeout" }), seconds * 1000);
176
+ socket.once("close", gone);
177
+ set.add(listener);
178
+ });
179
+ }
180
+ function governed(method, params) {
181
+ const named = params["agent"] === undefined ? undefined : engine.resolveAgent(text(params, "agent"));
182
+ const id = named === undefined ? undefined : new Uint8Array(Buffer.from(named, "hex"));
183
+ const g = engine.governance;
184
+ if (method === "settings")
185
+ return g.listSettings(id);
186
+ if (method === "settings_set") {
187
+ const answer = g.settingsSet(id, named, params);
188
+ channels.settingsChanged();
189
+ return answer;
190
+ }
191
+ if (!id || !named)
192
+ throw new LocalError("no_current_agent", "name the agent");
193
+ switch (method) {
194
+ case "contacts": return g.listContacts(id);
195
+ case "contact_add": return g.contactAdd(id, named, params);
196
+ case "contact_remove": return g.contactRemove(id, named, params);
197
+ case "contact_set_tier": return g.contactSetTier(id, named, params);
198
+ case "contact_set_away": return g.contactSetAway(id, params);
199
+ case "contact_set_moniker": return g.contactSetMoniker(id, params);
200
+ case "config": return g.listGuards(id, params["key"]);
201
+ case "config_set": return g.guardSet(id, named, params);
202
+ case "screening": return g.setScreening(id, named, params);
203
+ case "screening_log": return g.screeningLog(id, params["limit"]);
204
+ case "signal_rules": return g.signalRules(id);
205
+ case "signal_rule_set": return g.signalRuleSet(id, named, params);
206
+ case "signal_rule_clear": return g.signalRuleClear(id, named, params);
207
+ case "policy_list": return g.policyList(id);
208
+ case "policy_pending": return g.policyPending(id);
209
+ case "policy_propose": return g.policyPropose(id, named, params);
210
+ case "policy_approve": return g.policyApprove(id, named, params);
211
+ case "moniker": return g.setOwnMoniker(id, named, params);
212
+ default: throw new LocalError("unknown_method", `no such method: ${method}`);
213
+ }
214
+ }
215
+ // A call with no socket behind it can't be woken or kept waiting, so the two that need one refuse by name.
216
+ function needSocket(socket, method) {
217
+ if (!socket)
218
+ throw new LocalError("needs_connection", `${method} needs the connection of a session, so it can't be asked this way.`);
219
+ return socket;
220
+ }
221
+ async function handle(socket, method, params) {
222
+ // Channel actions stop with everything else. The server refuses them too, so this only saves the trip and covers what's read from here.
223
+ if (method.startsWith("channel_") && typeof params["agent"] === "string")
224
+ engine.assertCanAct(engine.resolveAgent(params["agent"]));
225
+ switch (method) {
226
+ case "status": {
227
+ // A fact about this thread, measured here. It's the longest it has been held up since the last time anyone asked.
228
+ const longestStallMs = Math.max(0, Math.round(mainThreadDelay.max / 1e6 - STALL_RESOLUTION_MS));
229
+ mainThreadDelay.reset();
230
+ return { pid: process.pid, home, main_thread: { longest_stall_ms: longestStallMs }, account_page: accountPageState, ...engine.status() };
231
+ }
232
+ // The link carries the secret, so it goes only to a person at a terminal.
233
+ case "account": {
234
+ requirePerson(params);
235
+ if (!accountPage)
236
+ throw new LocalError("account_page_unavailable", `The account page isn't running: ${accountPageState.problem ?? "it hasn't started yet"}.`);
237
+ return { url: `http://127.0.0.1:${accountPage.port}/#${accountPageToken}` };
238
+ }
239
+ case "create_agent":
240
+ return engine.createAgent(text(params, "name"));
241
+ case "enroll_agent":
242
+ return engine.enrollAgent(optionalText(params, "name"), optionalText(params, "code"));
243
+ case "signals_list":
244
+ return engine.wallet.list(named(params), params["all"] === true);
245
+ case "signals_view":
246
+ return engine.wallet.view(named(params), text(params, "hash"));
247
+ case "signals_enable":
248
+ return engine.wallet.enable(named(params), text(params, "hash"));
249
+ case "signals_disable":
250
+ return engine.wallet.disable(named(params), text(params, "hash"));
251
+ case "signals_collect":
252
+ return engine.wallet.collect(named(params));
253
+ case "signals_publish":
254
+ return engine.wallet.publish(acting(params), text(params, "hash"));
255
+ case "signals_unpublish":
256
+ return engine.wallet.unpublish(acting(params), optionalText(params, "hash"), optionalText(params, "signal_id"));
257
+ case "signals_presented":
258
+ return engine.presentedSignals(named(params), text(params, "session_id"));
259
+ case "signals_lookup":
260
+ return engine.wallet.lookup(acting(params), text(params, "address"));
261
+ case "issuer_trust": {
262
+ const agent = named(params);
263
+ if (params["person_confirmed"] !== true)
264
+ throw new LocalError("person_required", `This would count signals from ${engine.wallet.describeIssuerOf(agent, text(params, "hash"))} as verified on this machine. Anyone can create an issuer, so this weakens a guard. Nothing changed. Only a person at a terminal can do this, with the cello command.`);
265
+ return engine.wallet.trustIssuer(agent, text(params, "hash"));
266
+ }
267
+ case "issuer_untrust":
268
+ return engine.wallet.untrustIssuer(named(params), text(params, "hash"));
269
+ case "use_agent": {
270
+ const agent = acting(params);
271
+ return { name: engine.agentName(agent), agent_id: agent, unread: engine.unreadCount(agent) };
272
+ }
273
+ // Takes hold, and keeps this socket as the way to reach the caller with doorbells. Used by a session that can be woken.
274
+ case "subscribe": {
275
+ const agent = acting(params);
276
+ const set = listeners.get(agent) ?? new Set();
277
+ listeners.set(agent, set);
278
+ const caller = text(params, "caller");
279
+ // Selecting an agent twice must not ring twice.
280
+ const own = needSocket(socket, method);
281
+ if (![...set].some((listener) => listener.socket === own && listener.caller === caller && !listener.onBell)) {
282
+ set.add({ socket: own, caller, releaseOnClose: true });
283
+ }
284
+ return { name: engine.agentName(agent), agent_id: agent, unread: engine.unreadCount(agent) };
285
+ }
286
+ case "stop_using_agent": {
287
+ const agent = engine.resolveAgent(text(params, "agent"));
288
+ const caller = text(params, "caller");
289
+ if (holders.get(agent)?.caller === caller)
290
+ holders.delete(agent);
291
+ for (const listener of [...(listeners.get(agent) ?? [])]) {
292
+ if (listener.caller === caller && !listener.onBell)
293
+ listeners.get(agent)?.delete(listener);
294
+ }
295
+ return { released: true, agent_id: agent };
296
+ }
297
+ case "initiate_session":
298
+ return engine.initiate(acting(params), text(params, "target"), params);
299
+ case "send":
300
+ return engine.send(acting(params), text(params, "session_id"), text(params, "text"), params["signal"], params["est_minutes"], params["notice"] === true, params);
301
+ case "receive": {
302
+ const agent = acting(params);
303
+ return delivered(params, agent, engine.receive(agent, params["session_id"] === undefined ? undefined : text(params, "session_id")));
304
+ }
305
+ case "commit_read": {
306
+ const agent = acting(params);
307
+ const token = text(params, "token");
308
+ const read = deferredReads.get(token);
309
+ if (read?.agent !== agent)
310
+ throw new LocalError("read_token_unknown", "That read has expired or isn't this agent's. Nothing was marked as read, so the messages come back on the next read.");
311
+ deferredReads.delete(token);
312
+ clearTimeout(read.timer);
313
+ read.commit();
314
+ return { committed: true };
315
+ }
316
+ case "wait": {
317
+ const agent = acting(params);
318
+ const seconds = params["timeout_seconds"] === undefined ? DEFAULT_WAIT_SECONDS : params["timeout_seconds"];
319
+ if (typeof seconds !== "number" || !(seconds > 0))
320
+ throw new LocalError("bad_argument", "timeout_seconds must be a positive number");
321
+ engine.assertCanAct(agent);
322
+ const unread = engine.unreadCount(agent);
323
+ if (unread > 0)
324
+ return { event: "unread", unread };
325
+ return waitForEvent(needSocket(socket, method), agent, text(params, "caller"), seconds);
326
+ }
327
+ case "close_session":
328
+ return engine.close(acting(params), text(params, "session_id"));
329
+ case "seal":
330
+ return engine.seal(acting(params), text(params, "session_id"), params["through"]);
331
+ case "seals":
332
+ return engine.seals(engine.resolveAgent(text(params, "agent")), params["session_id"] === undefined ? undefined : text(params, "session_id"));
333
+ case "export_seal":
334
+ return engine.exportSeal(engine.resolveAgent(text(params, "agent")), text(params, "seal_id"));
335
+ case "export_transcript":
336
+ return engine.exportTranscript(engine.resolveAgent(text(params, "agent")), text(params, "session_id"), {
337
+ reveal: params["reveal"] === undefined ? undefined : text(params, "reveal"),
338
+ all: params["all"] === true,
339
+ sealId: params["seal_id"] === undefined ? undefined : text(params, "seal_id"),
340
+ });
341
+ // Only a person at a terminal, through the command line, which confirms first. These have no tools.
342
+ case "suspend":
343
+ requirePerson(params);
344
+ return engine.suspend(engine.resolveAgent(text(params, "agent")), params["reason"]);
345
+ case "retire":
346
+ requirePerson(params);
347
+ return engine.retire(engine.resolveAgent(text(params, "agent")), params["reason"]);
348
+ case "remove_agent": {
349
+ requirePerson(params);
350
+ const agent = engine.resolveAgent(text(params, "agent"));
351
+ const answer = await engine.removeAgent(agent);
352
+ holders.delete(agent);
353
+ return answer;
354
+ }
355
+ case "agent_status":
356
+ return engine.agentStatus(engine.resolveAgent(text(params, "agent")));
357
+ // Reading a record acts as nobody, so these need no hold.
358
+ case "agents":
359
+ return engine.agents();
360
+ case "sessions":
361
+ return engine.sessions(engine.resolveAgent(text(params, "agent")), params["all"] === true);
362
+ case "greetings":
363
+ return engine.greetings(engine.resolveAgent(text(params, "agent")));
364
+ case "inbox":
365
+ return engine.inbox(engine.resolveAgent(text(params, "agent")));
366
+ case "transcript":
367
+ return engine.transcript(engine.resolveAgent(text(params, "agent")), text(params, "session_id"), typeof params["after"] === "number" ? params["after"] : 0);
368
+ case "evidence":
369
+ return engine.evidence(engine.resolveAgent(text(params, "agent")), text(params, "session_id"));
370
+ case "verify_session":
371
+ return engine.verifySession(engine.resolveAgent(text(params, "agent")), text(params, "session_id"));
372
+ // What a person decides. Each of these judges which way a change goes, and refuses a loosening that no person agreed to.
373
+ case "contacts":
374
+ case "contact_add":
375
+ case "contact_remove":
376
+ case "contact_set_tier":
377
+ case "contact_set_away":
378
+ case "contact_set_moniker":
379
+ case "settings":
380
+ case "settings_set":
381
+ case "config":
382
+ case "config_set":
383
+ case "screening":
384
+ case "screening_log":
385
+ case "signal_rules":
386
+ case "signal_rule_set":
387
+ case "signal_rule_clear":
388
+ case "policy_list":
389
+ case "policy_pending":
390
+ case "policy_propose":
391
+ case "policy_approve":
392
+ case "moniker":
393
+ return governed(method, params);
394
+ case "channel_create":
395
+ return channels.create(acting(params), text(params, "name"), text(params, "type"), optionalText(params, "posting"), params["retention_days"]);
396
+ case "channel_join":
397
+ return channels.join(acting(params), text(params, "channel_id"), optionalText(params, "note"));
398
+ case "channel_leave":
399
+ return channels.leave(acting(params), text(params, "channel_id"));
400
+ case "channel_requests":
401
+ return channels.requests(engine.resolveAgent(text(params, "agent")), text(params, "channel_id"));
402
+ case "channel_approve":
403
+ return channels.approve(acting(params), text(params, "channel_id"), text(params, "member"));
404
+ case "channel_refuse":
405
+ return channels.refuse(acting(params), text(params, "channel_id"), text(params, "member"));
406
+ case "channel_eject":
407
+ return channels.eject(acting(params), text(params, "channel_id"), text(params, "member"));
408
+ case "channel_add_poster":
409
+ return channels.addPoster(acting(params), text(params, "channel_id"), text(params, "poster"));
410
+ case "channel_remove_poster":
411
+ return channels.removePoster(acting(params), text(params, "channel_id"), text(params, "poster"));
412
+ case "channel_post":
413
+ return channels.post(acting(params), text(params, "channel_id"), text(params, "text"), optionalText(params, "title"), params);
414
+ case "channel_collect":
415
+ return channels.collect(engine.resolveAgent(text(params, "agent")), optionalText(params, "channel_id"));
416
+ case "channels":
417
+ return channels.list(engine.resolveAgent(text(params, "agent")));
418
+ case "channel_settings":
419
+ return channels.settings(acting(params), text(params, "channel_id"), optionalText(params, "delivery"), optionalText(params, "screen_bodies"));
420
+ case "channel_read": {
421
+ const agent = acting(params);
422
+ return delivered(params, agent, await channels.read(agent, text(params, "channel_id"), params["titles_only"] === true));
423
+ }
424
+ case "channel_history":
425
+ return channels.history(engine.resolveAgent(text(params, "agent")), text(params, "channel_id"), typeof params["after"] === "number" ? params["after"] : 0);
426
+ case "screener_reload":
427
+ return engine.reloadScreener();
428
+ case "shutdown":
429
+ setImmediate(shutdown);
430
+ return { stopping: true };
431
+ default:
432
+ throw new LocalError("unknown_method", `no such method: ${method}`);
433
+ }
434
+ }
435
+ // The page's secret lives in the encrypted database with everything else, so moving the database moves the link's meaning.
436
+ const ACCOUNT_PAGE_TOKEN_KEY = "account_page.token";
437
+ let accountPageToken = store.getConfig(ACCOUNT_PAGE_TOKEN_KEY);
438
+ if (!accountPageToken) {
439
+ accountPageToken = randomBytes(32).toString("hex");
440
+ store.setConfig(ACCOUNT_PAGE_TOKEN_KEY, accountPageToken);
441
+ }
442
+ let accountPage;
443
+ // What status says about the page, from what happened when it tried to start.
444
+ let accountPageState = { listening: false };
445
+ // A port someone else holds costs the page, never the daemon.
446
+ async function startAccountPage() {
447
+ const port = currentSetting(store, "account_page_port");
448
+ try {
449
+ accountPage = await serveAccountPage({
450
+ host: "127.0.0.1",
451
+ port,
452
+ token: accountPageToken,
453
+ call: (method, params) => handle(undefined, method, params),
454
+ allowedHosts: (bound) => [`127.0.0.1:${bound}`, `localhost:${bound}`],
455
+ });
456
+ accountPageState = { listening: true, port: accountPage.port };
457
+ logEvent("account_page.listening", { port: accountPage.port });
458
+ }
459
+ catch (err) {
460
+ const reason = err instanceof Error ? err.message : String(err);
461
+ accountPageState = { listening: false, port, problem: `port ${port} could not be used (${reason}). Change it with: cello settings-set account_page_port <port>, then log in again` };
462
+ logEvent("account_page.unavailable", { port, reason });
463
+ }
464
+ }
465
+ const ipc = createServer((socket) => {
466
+ sockets.add(socket);
467
+ const respond = (response, afterWrite) => {
468
+ if (socket.destroyed)
469
+ return;
470
+ socket.write(`${JSON.stringify(response)}\n`, (err) => {
471
+ if (!err && afterWrite)
472
+ afterWrite();
473
+ });
474
+ };
475
+ createInterface({ input: socket }).on("line", (line) => {
476
+ let request;
477
+ try {
478
+ request = JSON.parse(line);
479
+ }
480
+ catch {
481
+ socket.destroy();
482
+ return;
483
+ }
484
+ handle(socket, request.method, request.params ?? {}).then((result) => {
485
+ if (result instanceof AfterWrite)
486
+ respond({ id: request.id, ok: true, result: result.result }, result.commit);
487
+ else
488
+ respond({ id: request.id, ok: true, result });
489
+ }, (err) => {
490
+ if (err instanceof LocalError) {
491
+ respond({ id: request.id, ok: false, error: { code: err.code, message: err.message } });
492
+ return;
493
+ }
494
+ const message = err instanceof Error ? err.message : String(err);
495
+ logEvent("ipc.failed", { method: request.method, message });
496
+ respond({ id: request.id, ok: false, error: { code: "internal_error", message } });
497
+ });
498
+ });
499
+ socket.on("close", () => {
500
+ stopListening(socket);
501
+ sockets.delete(socket);
502
+ });
503
+ socket.on("error", () => undefined);
504
+ });
505
+ await new Promise((resolve) => ipc.listen({ path, readableAll: false, writableAll: false }, resolve));
506
+ logEvent("daemon.listening", { pid: process.pid, server: serverUrl });
507
+ await engine.start();
508
+ channels.start();
509
+ await startAccountPage();
510
+ process.on("SIGTERM", shutdown);
511
+ process.on("SIGINT", shutdown);
@@ -0,0 +1,6 @@
1
+ export declare function celloHome(): string;
2
+ export declare function socketPath(home?: string): string;
3
+ export declare function databasePath(home?: string): string;
4
+ export declare function logPath(home?: string): string;
5
+ export declare function holdsOldVersion(home?: string): boolean;
6
+ export declare const oldVersionMessage: (home?: string) => string;
@@ -0,0 +1,21 @@
1
+ import { existsSync } from "node:fs";
2
+ import { homedir } from "node:os";
3
+ import { join } from "node:path";
4
+ export function celloHome() {
5
+ return process.env["CELLO_HOME"] ?? join(homedir(), ".cello");
6
+ }
7
+ export function socketPath(home = celloHome()) {
8
+ return join(home, "daemon.sock");
9
+ }
10
+ export function databasePath(home = celloHome()) {
11
+ return join(home, "cello.db");
12
+ }
13
+ export function logPath(home = celloHome()) {
14
+ return join(home, "daemon.log");
15
+ }
16
+ // Files only the old version writes. The new version can't read them, so it must never start over them.
17
+ const OLD_VERSION_FILES = ["sessions.db", "gateway.db", "directory-key", "daemon.singleton"];
18
+ export function holdsOldVersion(home = celloHome()) {
19
+ return OLD_VERSION_FILES.some((file) => existsSync(join(home, file)));
20
+ }
21
+ export const oldVersionMessage = (home = celloHome()) => `${home} holds data from the old version of CELLO, which this version can't read, so nothing was started. Its agents don't carry over. Run cello setup at a terminal, and it offers to move that data to ${home}-old.`;
@@ -0,0 +1,24 @@
1
+ export type PIICategory = "pii:email" | "pii:ip" | "pii:ssn" | "pii:credit_card" | "pii:phone";
2
+ export interface PIIEvent {
3
+ category: PIICategory;
4
+ value: string;
5
+ flagId: string;
6
+ }
7
+ export interface PIIResult {
8
+ disposition: "allow" | "warn";
9
+ severity?: "normal" | "bulk";
10
+ events: PIIEvent[];
11
+ count: number;
12
+ }
13
+ export interface PIIScreenerOptions {
14
+ whitelist: string[];
15
+ checkEmail?: boolean;
16
+ checkPhone?: boolean;
17
+ bulkThreshold?: number;
18
+ cumulativeThreshold?: number;
19
+ }
20
+ export declare class OutboundPIIScreener {
21
+ #private;
22
+ constructor(opts: PIIScreenerOptions);
23
+ screen(content: Uint8Array, sessionId: string): PIIResult;
24
+ }