@cello-protocol/cli 0.0.306 → 0.0.308

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 +602 -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 +82 -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 +513 -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 +147 -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 +62 -0
  50. package/dist/daemon/reach.js +204 -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 +189 -0
  60. package/dist/daemon/store.js +477 -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 +429 -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 +34 -0
  70. package/dist/hermes-bridge.js +223 -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 +846 -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 +160 -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 +259 -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 +1066 -0
  180. package/hermes/plugin/plugin.yaml +30 -0
  181. package/hermes/skills/cello-bridge-setup/SKILL.md +48 -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,477 @@
1
+ // The daemon's durable state, in SQLCipher. Everything here is a fact: holders, sockets and doorbells live in memory.
2
+ // The session key is on disk until the session ends (ruled, so a restart doesn't end a conversation).
3
+ import { randomBytes } from "node:crypto";
4
+ import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
5
+ import { dirname } from "node:path";
6
+ import Database from "@signalapp/sqlcipher";
7
+ const SCHEMA = `
8
+ CREATE TABLE IF NOT EXISTS config (key TEXT PRIMARY KEY, value TEXT NOT NULL);
9
+
10
+ CREATE TABLE IF NOT EXISTS agents (
11
+ agent_id BLOB PRIMARY KEY,
12
+ name TEXT NOT NULL,
13
+ ed_seed BLOB NOT NULL,
14
+ pq_seed BLOB NOT NULL,
15
+ registered INTEGER NOT NULL DEFAULT 0
16
+ );
17
+
18
+ CREATE TABLE IF NOT EXISTS sessions (
19
+ agent_id BLOB NOT NULL REFERENCES agents(agent_id),
20
+ session_id BLOB NOT NULL,
21
+ role TEXT NOT NULL CHECK (role IN ('caller', 'callee')),
22
+ counterparty_id BLOB NOT NULL,
23
+ counterparty_name TEXT NOT NULL,
24
+ counterparty_keys TEXT NOT NULL,
25
+ state TEXT NOT NULL CHECK (state IN ('offered', 'accepted', 'active', 'closed')),
26
+ x25519_secret BLOB,
27
+ mlkem_seed BLOB,
28
+ session_key BLOB,
29
+ own_salt BLOB,
30
+ salt BLOB,
31
+ offer TEXT NOT NULL,
32
+ accept TEXT,
33
+ confirm TEXT,
34
+ assignment TEXT,
35
+ read_position INTEGER NOT NULL DEFAULT 0,
36
+ verified_position INTEGER NOT NULL DEFAULT 0,
37
+ delivered_through INTEGER NOT NULL DEFAULT 0,
38
+ own_closed INTEGER NOT NULL DEFAULT 0,
39
+ peer_closed INTEGER NOT NULL DEFAULT 0,
40
+ fault TEXT,
41
+ acked_screened INTEGER NOT NULL DEFAULT 0,
42
+ peer_screened_through INTEGER NOT NULL DEFAULT 0,
43
+ peer_eta_told INTEGER NOT NULL DEFAULT 0,
44
+ server_url TEXT, -- The server hosting this conversation, when it isn't this daemon's own.
45
+ PRIMARY KEY (agent_id, session_id)
46
+ );
47
+
48
+ CREATE TABLE IF NOT EXISTS entries (
49
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
50
+ agent_id BLOB NOT NULL,
51
+ session_id BLOB NOT NULL,
52
+ entry_hash BLOB NOT NULL,
53
+ position INTEGER,
54
+ state TEXT NOT NULL CHECK (state IN ('pending', 'landed', 'received', 'not_sent')),
55
+ own INTEGER NOT NULL,
56
+ entry TEXT NOT NULL,
57
+ ack TEXT,
58
+ ciphertext BLOB,
59
+ body BLOB NOT NULL,
60
+ -- Null means not screened yet, and such a message is never delivered. It's set once, by the screen, never by arrival.
61
+ verdict TEXT CHECK (verdict IN ('allow', 'flagged', 'blocked')),
62
+ verdict_detail TEXT,
63
+ UNIQUE (agent_id, session_id, position),
64
+ FOREIGN KEY (agent_id, session_id) REFERENCES sessions(agent_id, session_id)
65
+ );
66
+ DROP INDEX IF EXISTS entries_session;
67
+ CREATE INDEX IF NOT EXISTS entries_by_state ON entries(agent_id, session_id, state, position);
68
+ -- Every send asks for the author's last entry. Without this, that sorts the author's whole history, bodies included.
69
+ CREATE INDEX IF NOT EXISTS entries_own ON entries(agent_id, session_id, own, id);
70
+
71
+ -- What was refused, or what proves misbehaviour, exactly as received. Nothing removes it: it's what lets a party show what happened.
72
+ CREATE TABLE IF NOT EXISTS evidence (
73
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
74
+ agent_id BLOB NOT NULL,
75
+ session_id BLOB NOT NULL,
76
+ kind TEXT NOT NULL CHECK (kind IN ('unverifiable_text', 'refused_entry_landed', 'two_acks')),
77
+ position INTEGER NOT NULL,
78
+ entry TEXT,
79
+ ack TEXT NOT NULL,
80
+ other_ack TEXT,
81
+ ciphertext BLOB,
82
+ UNIQUE (agent_id, session_id, kind, position, ack),
83
+ FOREIGN KEY (agent_id, session_id) REFERENCES sessions(agent_id, session_id)
84
+ );
85
+
86
+ CREATE TABLE IF NOT EXISTS notices (
87
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
88
+ agent_id BLOB NOT NULL REFERENCES agents(agent_id),
89
+ session_id BLOB,
90
+ text TEXT NOT NULL
91
+ );
92
+
93
+ CREATE TABLE IF NOT EXISTS seals (
94
+ agent_id BLOB NOT NULL,
95
+ seal_id BLOB NOT NULL,
96
+ session_id BLOB NOT NULL,
97
+ record TEXT NOT NULL,
98
+ PRIMARY KEY (agent_id, seal_id),
99
+ FOREIGN KEY (agent_id, session_id) REFERENCES sessions(agent_id, session_id)
100
+ );
101
+
102
+ -- A seal asked for and not finished, so it survives a restart. Through 0 means everything held when it goes.
103
+ CREATE TABLE IF NOT EXISTS seal_wants (
104
+ agent_id BLOB NOT NULL,
105
+ session_id BLOB NOT NULL,
106
+ through INTEGER NOT NULL,
107
+ PRIMARY KEY (agent_id, session_id, through),
108
+ FOREIGN KEY (agent_id, session_id) REFERENCES sessions(agent_id, session_id)
109
+ );
110
+
111
+ -- What a server last said about one of these agents. everywhere: it stops the agent on every server, because it was its own server's word or its own keys'.
112
+ CREATE TABLE IF NOT EXISTS agent_status (
113
+ agent_id BLOB NOT NULL REFERENCES agents(agent_id),
114
+ server_url TEXT NOT NULL,
115
+ status TEXT NOT NULL CHECK (status IN ('active', 'suspended', 'retired')),
116
+ reason TEXT NOT NULL,
117
+ everywhere INTEGER NOT NULL,
118
+ PRIMARY KEY (agent_id, server_url)
119
+ );
120
+
121
+ -- Signed status statements still to reach a server. Each stays until that server has answered.
122
+ CREATE TABLE IF NOT EXISTS status_outbox (
123
+ agent_id BLOB NOT NULL REFERENCES agents(agent_id),
124
+ server_url TEXT NOT NULL,
125
+ statement TEXT NOT NULL,
126
+ PRIMARY KEY (agent_id, server_url, statement)
127
+ );
128
+
129
+ -- Conversations this agent has been told have stopped, so a restart neither repeats that nor loses it.
130
+ CREATE TABLE IF NOT EXISTS stopped_sessions (
131
+ agent_id BLOB NOT NULL,
132
+ session_id BLOB NOT NULL,
133
+ PRIMARY KEY (agent_id, session_id),
134
+ FOREIGN KEY (agent_id, session_id) REFERENCES sessions(agent_id, session_id)
135
+ );
136
+
137
+ -- What a person chose for one sender (the subject is its agent id), or for a tier (the subject is its name), ranked below that.
138
+ CREATE TABLE IF NOT EXISTS screening_rules (
139
+ agent_id BLOB NOT NULL REFERENCES agents(agent_id),
140
+ scope TEXT NOT NULL CHECK (scope IN ('sender', 'tier')),
141
+ subject TEXT NOT NULL,
142
+ level TEXT NOT NULL CHECK (level IN ('full', 'deterministic', 'off')),
143
+ set_at INTEGER NOT NULL,
144
+ PRIMARY KEY (agent_id, scope, subject)
145
+ );
146
+
147
+ -- A standby whose lateness has been told, so a restart can neither repeat that nor lose it. Its position names the promise.
148
+ CREATE TABLE IF NOT EXISTS standby_told (
149
+ agent_id BLOB NOT NULL,
150
+ session_id BLOB NOT NULL,
151
+ position INTEGER NOT NULL,
152
+ PRIMARY KEY (agent_id, session_id, position),
153
+ FOREIGN KEY (agent_id, session_id) REFERENCES sessions(agent_id, session_id)
154
+ );
155
+ `;
156
+ function openKey(dbPath) {
157
+ const keyPath = `${dbPath}.key`;
158
+ if (existsSync(keyPath)) {
159
+ const key = readFileSync(keyPath);
160
+ if (key.length !== 32)
161
+ throw new Error(`the database key file ${keyPath} is ${key.length} bytes, not 32. Restore it from backup.`);
162
+ return key.toString("hex");
163
+ }
164
+ // Never make a new key for an existing database: that would look like data loss.
165
+ if (existsSync(dbPath))
166
+ throw new Error(`the database ${dbPath} exists but its key file ${keyPath} is missing. Restore it from backup.`);
167
+ const key = randomBytes(32);
168
+ writeFileSync(keyPath, key, { mode: 0o600, flag: "wx" });
169
+ return key.toString("hex");
170
+ }
171
+ export class Store {
172
+ #db;
173
+ constructor(dbPath) {
174
+ mkdirSync(dirname(dbPath), { recursive: true, mode: 0o700 });
175
+ const keyHex = openKey(dbPath);
176
+ this.#db = new Database(dbPath);
177
+ chmodSync(dbPath, 0o600);
178
+ this.#db.pragma(`key = "x'${keyHex}'"`);
179
+ this.#prep("SELECT count(*) AS c FROM sqlite_master").get([]);
180
+ this.#db.pragma("journal_mode=WAL");
181
+ this.#db.pragma("synchronous=FULL");
182
+ this.#db.pragma("busy_timeout=5000");
183
+ this.#db.pragma("foreign_keys=ON");
184
+ this.#db.exec(SCHEMA);
185
+ // A table made before these columns existed. Old rows come out unscreened, and the screen picks them up.
186
+ this.#addColumn("entries", "verdict", "TEXT CHECK (verdict IN ('allow', 'flagged', 'blocked'))");
187
+ this.#addColumn("entries", "verdict_detail", "TEXT");
188
+ this.#addColumn("sessions", "acked_screened", "INTEGER NOT NULL DEFAULT 0");
189
+ this.#addColumn("sessions", "peer_screened_through", "INTEGER NOT NULL DEFAULT 0");
190
+ this.#addColumn("sessions", "peer_eta_told", "INTEGER NOT NULL DEFAULT 0");
191
+ this.#addColumn("sessions", "bytes_received", "INTEGER NOT NULL DEFAULT 0");
192
+ this.#addColumn("sessions", "bytes_told", "INTEGER NOT NULL DEFAULT 0");
193
+ this.#addColumn("sessions", "last_activity_at", "INTEGER NOT NULL DEFAULT 0");
194
+ // A database made before federation. Additive, so its conversations carry on, on their own server.
195
+ this.#addColumn("sessions", "server_url", "TEXT");
196
+ this.#addColumn("entries", "withheld", "INTEGER NOT NULL DEFAULT 0");
197
+ this.#db.exec("CREATE INDEX IF NOT EXISTS entries_unscreened ON entries(agent_id, session_id, position) WHERE state = 'received' AND verdict IS NULL");
198
+ // A database made before federation. Additive, so its conversations carry on, on their own server.
199
+ this.#addColumn("sessions", "server_url", "TEXT");
200
+ this.#addColumn("agents", "removed", "INTEGER NOT NULL DEFAULT 0");
201
+ this.#addColumn("sessions", "frozen", "INTEGER NOT NULL DEFAULT 0");
202
+ // An agent still getting its first signal. It doesn't try to register until it has one.
203
+ this.#addColumn("agents", "awaiting_signal", "INTEGER NOT NULL DEFAULT 0");
204
+ }
205
+ #addColumn(table, column, definition) {
206
+ const columns = this.#prep(`PRAGMA table_info(${table})`).all([]);
207
+ if (!columns.some((c) => c.name === column))
208
+ this.#db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${definition}`);
209
+ }
210
+ statusRows(agentId) {
211
+ return this.#prep("SELECT server_url, status, reason, everywhere FROM agent_status WHERE agent_id = ?").all([agentId]);
212
+ }
213
+ setStatus(agentId, row) {
214
+ this.#prep(`INSERT INTO agent_status (agent_id, server_url, status, reason, everywhere) VALUES (?, ?, ?, ?, ?)
215
+ ON CONFLICT (agent_id, server_url) DO UPDATE SET status = excluded.status, reason = excluded.reason, everywhere = excluded.everywhere`).run([agentId, row.server_url, row.status, row.reason, row.everywhere]);
216
+ }
217
+ addToOutbox(agentId, serverUrl, statement) {
218
+ this.#prep("INSERT OR IGNORE INTO status_outbox (agent_id, server_url, statement) VALUES (?, ?, ?)").run([agentId, serverUrl, statement]);
219
+ }
220
+ outbox(serverUrl) {
221
+ const columns = "SELECT agent_id, server_url, statement FROM status_outbox";
222
+ return (serverUrl === undefined ? this.#prep(columns).all([]) : this.#prep(`${columns} WHERE server_url = ?`).all([serverUrl]));
223
+ }
224
+ removeFromOutbox(row) {
225
+ this.#prep("DELETE FROM status_outbox WHERE agent_id = ? AND server_url = ? AND statement = ?").run([row.agent_id, row.server_url, row.statement]);
226
+ }
227
+ renameAgent(agentId, name) {
228
+ this.#prep("UPDATE agents SET name = ? WHERE agent_id = ?").run([name, agentId]);
229
+ }
230
+ // The row stays, with its keys and its history: a name is freed, and nothing is lost.
231
+ markRemoved(agentId) {
232
+ this.#prep("UPDATE agents SET removed = 1 WHERE agent_id = ?").run([agentId]);
233
+ }
234
+ isStopped(agentId, sessionId) {
235
+ return this.#prep("SELECT 1 FROM stopped_sessions WHERE agent_id = ? AND session_id = ?").get([agentId, sessionId]) !== undefined;
236
+ }
237
+ setStopped(agentId, sessionId, stopped) {
238
+ if (stopped)
239
+ this.#prep("INSERT OR IGNORE INTO stopped_sessions (agent_id, session_id) VALUES (?, ?)").run([agentId, sessionId]);
240
+ else
241
+ this.#prep("DELETE FROM stopped_sessions WHERE agent_id = ? AND session_id = ?").run([agentId, sessionId]);
242
+ }
243
+ // The driver's types want one exact byte-array type. Our bytes are all plain Uint8Array.
244
+ #prep(sql) {
245
+ return this.#db.prepare(sql);
246
+ }
247
+ close() {
248
+ this.#db.close();
249
+ }
250
+ exec(sql) {
251
+ this.#db.exec(sql);
252
+ }
253
+ // For the modules that keep their own tables here: contacts, reach, guards and policies.
254
+ prepare(sql) {
255
+ const statement = this.#prep(sql);
256
+ return { run: (...params) => statement.run(params), get: (...params) => statement.get(params), all: (...params) => statement.all(params) };
257
+ }
258
+ // For channel-store.ts, which keeps channel tables out of this file.
259
+ raw() {
260
+ return {
261
+ exec: (sql) => { this.#db.exec(sql); },
262
+ run: (sql, params) => { this.#prep(sql).run(params); },
263
+ get: (sql, params) => this.#prep(sql).get(params),
264
+ all: (sql, params) => this.#prep(sql).all(params),
265
+ transaction: (work) => this.transaction(work),
266
+ };
267
+ }
268
+ transaction(work) {
269
+ this.#db.exec("BEGIN IMMEDIATE");
270
+ try {
271
+ const result = work();
272
+ this.#db.exec("COMMIT");
273
+ return result;
274
+ }
275
+ catch (err) {
276
+ this.#db.exec("ROLLBACK");
277
+ throw err;
278
+ }
279
+ }
280
+ getConfig(key) {
281
+ return this.#prep("SELECT value FROM config WHERE key = ?").get([key])?.value;
282
+ }
283
+ setConfig(key, value) {
284
+ this.#prep("INSERT INTO config (key, value) VALUES (?, ?) ON CONFLICT (key) DO UPDATE SET value = excluded.value").run([key, value]);
285
+ }
286
+ insertAgent(agentId, name, edSeed, pqSeed) {
287
+ this.#prep("INSERT INTO agents (agent_id, name, ed_seed, pq_seed) VALUES (?, ?, ?, ?)").run([agentId, name, edSeed, pqSeed]);
288
+ }
289
+ setAwaitingSignal(agentId, awaiting) {
290
+ this.#prep("UPDATE agents SET awaiting_signal = ? WHERE agent_id = ?").run([awaiting ? 1 : 0, agentId]);
291
+ }
292
+ markRegistered(agentId) {
293
+ this.#prep("UPDATE agents SET registered = 1 WHERE agent_id = ?").run([agentId]);
294
+ }
295
+ agents() {
296
+ return this.#prep("SELECT * FROM agents WHERE removed = 0 ORDER BY rowid").all([]);
297
+ }
298
+ insertSession(row) {
299
+ const keys = Object.keys(row);
300
+ const sql = `INSERT INTO sessions (${keys.join(", ")}) VALUES (${keys.map(() => "?").join(", ")})`;
301
+ this.#prep(sql).run(keys.map((k) => row[k]));
302
+ }
303
+ updateSession(agentId, sessionId, update) {
304
+ const keys = Object.keys(update);
305
+ if (keys.length === 0)
306
+ return;
307
+ const sql = `UPDATE sessions SET ${keys.map((k) => `${k} = ?`).join(", ")} WHERE agent_id = ? AND session_id = ?`;
308
+ this.#prep(sql).run([...keys.map((k) => update[k]), agentId, sessionId]);
309
+ }
310
+ session(agentId, sessionId) {
311
+ return this.#prep("SELECT * FROM sessions WHERE agent_id = ? AND session_id = ?").get([agentId, sessionId]);
312
+ }
313
+ sessionsOf(agentId) {
314
+ return this.#prep("SELECT * FROM sessions WHERE agent_id = ? ORDER BY rowid").all([agentId]);
315
+ }
316
+ insertEntry(row) {
317
+ // The driver binds an empty body as NULL, and a withheld message's body is empty.
318
+ this.#prep("INSERT INTO entries (agent_id, session_id, entry_hash, position, state, own, entry, ack, ciphertext, body) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, coalesce(?, x''))").run([row.agent_id, row.session_id, row.entry_hash, row.position ?? null, row.state, row.own, row.entry, row.ack ?? null, row.ciphertext ?? null, row.body]);
319
+ }
320
+ ownEntryByHash(agentId, sessionId, hash) {
321
+ return this.#prep("SELECT * FROM entries WHERE agent_id = ? AND session_id = ? AND entry_hash = ? AND own = 1").get([agentId, sessionId, hash]);
322
+ }
323
+ markLanded(id, position, ack) {
324
+ this.#prep("UPDATE entries SET state = 'landed', position = ?, ack = ?, ciphertext = NULL WHERE id = ?").run([position, ack, id]);
325
+ }
326
+ markNotSent(id) {
327
+ this.#prep("UPDATE entries SET state = 'not_sent', ciphertext = NULL WHERE id = ?").run([id]);
328
+ }
329
+ pendingEntries(agentId, sessionId) {
330
+ return this.#prep("SELECT * FROM entries WHERE agent_id = ? AND session_id = ? AND state = 'pending' ORDER BY id").all([agentId, sessionId]);
331
+ }
332
+ // The last entry in this author's chain, landed or still trying to.
333
+ lastOwnEntry(agentId, sessionId) {
334
+ return this.#prep("SELECT * FROM entries WHERE agent_id = ? AND session_id = ? AND own = 1 AND state IN ('pending', 'landed') ORDER BY id DESC LIMIT 1").get([agentId, sessionId]);
335
+ }
336
+ lastPeerEntry(agentId, sessionId) {
337
+ return this.#prep("SELECT * FROM entries WHERE agent_id = ? AND session_id = ? AND own = 0 ORDER BY position DESC LIMIT 1").get([agentId, sessionId]);
338
+ }
339
+ // Your earliest message landed between these positions, so a reply written at "after" hadn't seen it.
340
+ firstOwnBetween(agentId, sessionId, after, before) {
341
+ return this.#prep("SELECT min(position) AS first FROM entries WHERE agent_id = ? AND session_id = ? AND own = 1 AND position > ? AND position < ?").get([agentId, sessionId, after, before]).first ?? undefined;
342
+ }
343
+ standbyTold(agentId, sessionId, position) {
344
+ return this.#prep("SELECT 1 FROM standby_told WHERE agent_id = ? AND session_id = ? AND position = ?").get([agentId, sessionId, position]) !== undefined;
345
+ }
346
+ markStandbyTold(agentId, sessionId, position) {
347
+ this.#prep("INSERT INTO standby_told (agent_id, session_id, position) VALUES (?, ?, ?)").run([agentId, sessionId, position]);
348
+ }
349
+ verifiedEntries(agentId, sessionId, throughPosition) {
350
+ return this.#prep("SELECT * FROM entries WHERE agent_id = ? AND session_id = ? AND position IS NOT NULL AND position <= ? ORDER BY position").all([agentId, sessionId, throughPosition]);
351
+ }
352
+ // The rest of these leave the message bodies on disk. They run for every message, and the reads are synchronous,
353
+ // so loading a long history here stops every other agent on this daemon until it's done.
354
+ // A message withheld for being past the byte limit isn't unread: there's nothing to read, and it must not stop a reply.
355
+ unreadCount(agentId, sessionId, readPosition) {
356
+ return this.#prep("SELECT count(*) AS c FROM entries WHERE agent_id = ? AND session_id = ? AND state = 'received' AND withheld = 0 AND position > ?").get([agentId, sessionId, readPosition]).c;
357
+ }
358
+ firstUnreadToAnswer(agentId, sessionId, readPosition) {
359
+ return this.#prep("SELECT min(position) AS first FROM entries WHERE agent_id = ? AND session_id = ? AND state = 'received' AND withheld = 0 AND position > ?").get([agentId, sessionId, readPosition]).first ?? undefined;
360
+ }
361
+ addEvidence(row) {
362
+ this.#prep("INSERT OR IGNORE INTO evidence (agent_id, session_id, kind, position, entry, ack, other_ack, ciphertext) VALUES (?, ?, ?, ?, ?, ?, ?, ?)")
363
+ .run([row.agent_id, row.session_id, row.kind, row.position, row.entry, row.ack, row.other_ack, row.ciphertext]);
364
+ }
365
+ evidence(agentId, sessionId) {
366
+ return this.#prep("SELECT agent_id, session_id, kind, position, entry, ack, other_ack, ciphertext FROM evidence WHERE agent_id = ? AND session_id = ? ORDER BY id").all([agentId, sessionId]);
367
+ }
368
+ unverifiablePositions(agentId, sessionId) {
369
+ return this.#prep("SELECT DISTINCT position FROM evidence WHERE agent_id = ? AND session_id = ? AND kind = 'unverifiable_text' ORDER BY position").all([agentId, sessionId]).map((row) => row.position);
370
+ }
371
+ markWithheld(id, detail) {
372
+ this.#prep("UPDATE entries SET withheld = 1, verdict = 'blocked', verdict_detail = ? WHERE id = ?").run([detail, id]);
373
+ }
374
+ firstUnscreened(agentId, sessionId) {
375
+ return this.#prep("SELECT min(position) AS first FROM entries WHERE agent_id = ? AND session_id = ? AND state = 'received' AND verdict IS NULL").get([agentId, sessionId]).first ?? undefined;
376
+ }
377
+ deliverableCount(agentId, sessionId, readPosition) {
378
+ const stop = this.firstUnscreened(agentId, sessionId) ?? Number.MAX_SAFE_INTEGER;
379
+ return this.#prep("SELECT count(*) AS c FROM entries WHERE agent_id = ? AND session_id = ? AND state = 'received' AND withheld = 0 AND position > ? AND position < ?").get([agentId, sessionId, readPosition, stop]).c;
380
+ }
381
+ // Sizes and ids only: a queue can be long, and this runs on the thread every agent shares.
382
+ unscreened() {
383
+ return this.#prep("SELECT e.id, e.agent_id, e.session_id, e.position, s.counterparty_id AS sender, length(e.body) AS size FROM entries e JOIN sessions s ON s.agent_id = e.agent_id AND s.session_id = e.session_id WHERE e.state = 'received' AND e.verdict IS NULL ORDER BY e.position").all([]);
384
+ }
385
+ entryAt(agentId, sessionId, position) {
386
+ return this.#prep("SELECT entry, verdict FROM entries WHERE agent_id = ? AND session_id = ? AND position = ?").get([agentId, sessionId, position]);
387
+ }
388
+ bodyOf(id) {
389
+ return this.#prep("SELECT body FROM entries WHERE id = ?").get([id])?.body;
390
+ }
391
+ setVerdict(id, verdict, detail) {
392
+ this.#prep("UPDATE entries SET verdict = ?, verdict_detail = ? WHERE id = ? AND verdict IS NULL").run([verdict, detail, id]);
393
+ }
394
+ entryIdAt(agentId, sessionId, position) {
395
+ return this.#prep("SELECT id FROM entries WHERE agent_id = ? AND session_id = ? AND position = ?").get([agentId, sessionId, position])?.id;
396
+ }
397
+ countOwnAfter(agentId, sessionId, position) {
398
+ return this.#prep("SELECT count(*) AS c FROM entries WHERE agent_id = ? AND session_id = ? AND own = 1 AND state = 'landed' AND position > ?").get([agentId, sessionId, position]).c;
399
+ }
400
+ screeningRule(agentId, scope, subject) {
401
+ return this.#prep("SELECT level FROM screening_rules WHERE agent_id = ? AND scope = ? AND subject = ?").get([agentId, scope, subject])?.level;
402
+ }
403
+ setScreeningRule(agentId, scope, subject, level) {
404
+ this.#prep("INSERT INTO screening_rules (agent_id, scope, subject, level, set_at) VALUES (?, ?, ?, ?, ?) ON CONFLICT (agent_id, scope, subject) DO UPDATE SET level = excluded.level, set_at = excluded.set_at").run([agentId, scope, subject, level, Date.now()]);
405
+ }
406
+ unreadBounds(agentId, sessionId, readPosition) {
407
+ const row = this.#prep("SELECT min(position) AS first, max(position) AS last FROM entries WHERE agent_id = ? AND session_id = ? AND state = 'received' AND position > ?").get([agentId, sessionId, readPosition]);
408
+ return row.first === null || row.last === null ? undefined : { first: row.first, last: row.last };
409
+ }
410
+ ackAt(agentId, sessionId, position) {
411
+ return this.#prep("SELECT ack FROM entries WHERE agent_id = ? AND session_id = ? AND position = ?").get([agentId, sessionId, position])?.ack;
412
+ }
413
+ signedRecord(agentId, sessionId, throughPosition) {
414
+ return this.#prep("SELECT entry, ack, position FROM entries WHERE agent_id = ? AND session_id = ? AND position IS NOT NULL AND position <= ? ORDER BY position").all([agentId, sessionId, throughPosition]);
415
+ }
416
+ // The last position that fits in maxBytes of bodies, and at least the first. Sizes come from the row header, not the body.
417
+ #pageEnd(where, params, maxBytes) {
418
+ const sizes = this.#prep(`SELECT position, length(body) AS size FROM entries WHERE ${where} ORDER BY position`).all(params);
419
+ let used = 0;
420
+ let through;
421
+ for (const row of sizes) {
422
+ used += row.size;
423
+ if (through !== undefined && used > maxBytes)
424
+ return { through, more: true };
425
+ through = row.position;
426
+ }
427
+ return through === undefined ? undefined : { through, more: false };
428
+ }
429
+ // What can be delivered: everything unread with a verdict, up to the first without one. Nothing overtakes.
430
+ unreadPage(agentId, sessionId, readPosition, maxBytes) {
431
+ const stop = this.firstUnscreened(agentId, sessionId) ?? Number.MAX_SAFE_INTEGER;
432
+ const end = this.#pageEnd("agent_id = ? AND session_id = ? AND state = 'received' AND position > ? AND position < ?", [agentId, sessionId, readPosition, stop], maxBytes);
433
+ if (!end)
434
+ return { rows: [], more: false };
435
+ const rows = this.#prep("SELECT * FROM entries WHERE agent_id = ? AND session_id = ? AND state = 'received' AND position > ? AND position <= ? ORDER BY position").all([agentId, sessionId, readPosition, end.through]);
436
+ return { rows, more: end.more };
437
+ }
438
+ recordPage(agentId, sessionId, after, throughPosition, maxBytes) {
439
+ const end = this.#pageEnd("agent_id = ? AND session_id = ? AND position IS NOT NULL AND position > ? AND position <= ?", [agentId, sessionId, after, throughPosition], maxBytes);
440
+ if (!end)
441
+ return { rows: [], more: false };
442
+ const rows = this.#prep("SELECT * FROM entries WHERE agent_id = ? AND session_id = ? AND position IS NOT NULL AND position > ? AND position <= ? ORDER BY position").all([agentId, sessionId, after, end.through]);
443
+ return { rows, more: end.more };
444
+ }
445
+ addNotice(agentId, sessionId, text) {
446
+ this.#prep("INSERT INTO notices (agent_id, session_id, text) VALUES (?, ?, ?)").run([agentId, sessionId, text]);
447
+ }
448
+ notices(agentId) {
449
+ return this.#prep("SELECT id, session_id, text FROM notices WHERE agent_id = ? ORDER BY id").all([agentId]);
450
+ }
451
+ clearNotices(agentId, throughId) {
452
+ this.#prep("DELETE FROM notices WHERE agent_id = ? AND id <= ?").run([agentId, throughId]);
453
+ }
454
+ addSealWant(agentId, sessionId, through) {
455
+ this.#prep("INSERT OR IGNORE INTO seal_wants (agent_id, session_id, through) VALUES (?, ?, ?)").run([agentId, sessionId, through]);
456
+ }
457
+ removeSealWant(agentId, sessionId, through) {
458
+ this.#prep("DELETE FROM seal_wants WHERE agent_id = ? AND session_id = ? AND through = ?").run([agentId, sessionId, through]);
459
+ }
460
+ sealWants(agentId, sessionId) {
461
+ if (sessionId)
462
+ return this.#prep("SELECT session_id, through FROM seal_wants WHERE agent_id = ? AND session_id = ? ORDER BY through").all([agentId, sessionId]);
463
+ return this.#prep("SELECT session_id, through FROM seal_wants WHERE agent_id = ? ORDER BY rowid").all([agentId]);
464
+ }
465
+ // A repeat from the server is the same certificate, so storing it twice changes nothing.
466
+ addSeal(agentId, sealId, sessionId, record) {
467
+ this.#prep("INSERT OR IGNORE INTO seals (agent_id, seal_id, session_id, record) VALUES (?, ?, ?, ?)").run([agentId, sealId, sessionId, record]);
468
+ }
469
+ seals(agentId, sessionId) {
470
+ if (sessionId)
471
+ return this.#prep("SELECT seal_id, session_id, record FROM seals WHERE agent_id = ? AND session_id = ? ORDER BY rowid").all([agentId, sessionId]);
472
+ return this.#prep("SELECT seal_id, session_id, record FROM seals WHERE agent_id = ? ORDER BY rowid").all([agentId]);
473
+ }
474
+ seal(agentId, sealId) {
475
+ return this.#prep("SELECT seal_id, session_id, record FROM seals WHERE agent_id = ? AND seal_id = ?").get([agentId, sealId]);
476
+ }
477
+ }
@@ -0,0 +1,14 @@
1
+ export declare const TIER: {
2
+ readonly BLOCKED: 0;
3
+ readonly UNKNOWN: 1;
4
+ readonly KNOWN: 2;
5
+ readonly WHITELISTED: 3;
6
+ readonly VIP: 4;
7
+ };
8
+ export type Tier = (typeof TIER)[keyof typeof TIER];
9
+ export declare const TIER_NAMES: readonly ["blocked", "unknown", "known", "whitelisted", "vip"];
10
+ export type TierName = (typeof TIER_NAMES)[number];
11
+ export declare const SETTABLE_TIERS: readonly ["unknown", "known", "whitelisted", "vip"];
12
+ export type SettableTier = (typeof SETTABLE_TIERS)[number];
13
+ export declare const tierName: (tier: number) => TierName;
14
+ export declare function tierFromName(name: unknown): Tier | undefined;
@@ -0,0 +1,9 @@
1
+ // The five tiers. One of an agent's own judgements about one counterparty, and it never leaves this machine.
2
+ export const TIER = { BLOCKED: 0, UNKNOWN: 1, KNOWN: 2, WHITELISTED: 3, VIP: 4 };
3
+ export const TIER_NAMES = ["blocked", "unknown", "known", "whitelisted", "vip"];
4
+ export const SETTABLE_TIERS = ["unknown", "known", "whitelisted", "vip"];
5
+ export const tierName = (tier) => TIER_NAMES[tier];
6
+ export function tierFromName(name) {
7
+ const at = TIER_NAMES.indexOf(name);
8
+ return at < 0 ? undefined : at;
9
+ }
@@ -0,0 +1,73 @@
1
+ import type { PublicIdentity } from "../protocol/identity.ts";
2
+ import { type IssuerList, type RootKey } from "../protocol/issuer-list.ts";
3
+ import type { InboundVerdict } from "../screener/inbound.ts";
4
+ import { type AgentKeys } from "./issuer-client.ts";
5
+ import { type WalletRow } from "./signal-store.ts";
6
+ import type { Store } from "./store.ts";
7
+ export declare const STATUS_PAGE = "https://celloprotocol.com/status";
8
+ export declare const WAITLIST_PAGE = "https://celloprotocol.com/waitlist";
9
+ export declare const HOW_TO_GET_A_CODE = "You need a code. It's in the email that said you were admitted. Lost it, or setting up another device? Sign in at https://celloprotocol.com/status and ask for one. Not admitted yet? Join at https://celloprotocol.com/waitlist.";
10
+ export type IssuerStanding = "recognised" | "trusted_by_owner" | "unknown";
11
+ export interface WalletHooks {
12
+ keys(agentHex: string): AgentKeys;
13
+ screen(agentHex: string, issuerHex: string, text: string): Promise<InboundVerdict>;
14
+ notify(agentId: Uint8Array, text: string): void;
15
+ roots(): readonly RootKey[];
16
+ shippedList: string | null;
17
+ publishToServer(agentHex: string, file: Uint8Array): Promise<void>;
18
+ unpublishFromServer(agentHex: string, signalId: Uint8Array): Promise<void>;
19
+ readPublic(agentHex: string, address: string): Promise<{
20
+ target: string;
21
+ files: Uint8Array[];
22
+ }>;
23
+ }
24
+ export interface SignalRefusal {
25
+ fault: string;
26
+ message: string;
27
+ }
28
+ export interface Collected {
29
+ stored: number;
30
+ held: number;
31
+ refused: SignalRefusal[];
32
+ }
33
+ export declare function readClaim(payload: Uint8Array): string | null;
34
+ export declare function issuerStanding(row: Pick<WalletRow, "issuer_address" | "issuer_pubkey">, keys: PublicIdentity, list: IssuerList | null, trusted: readonly {
35
+ issuer_address: string;
36
+ issuer_pubkey: string;
37
+ }[], now: number): IssuerStanding;
38
+ export declare function newestValidList(files: readonly Uint8Array[], roots: readonly RootKey[] | null, now: number): Promise<IssuerList | null>;
39
+ export declare class Wallet {
40
+ #private;
41
+ constructor(store: Store, hooks: WalletHooks);
42
+ settlePublic(agentHex: string, force?: boolean): Promise<number>;
43
+ collect(agentHex: string): Promise<Collected>;
44
+ redeem(agentHex: string, code: string): Promise<Collected>;
45
+ holderAmong(agentHexes: readonly string[]): string | undefined;
46
+ copyFromHolder(agentHex: string, holderHex: string): Promise<Collected>;
47
+ hasEmail(agentHex: string): boolean;
48
+ emailFile(agentHex: string): Uint8Array | undefined;
49
+ list(agentHex: string, all: boolean): Promise<unknown>;
50
+ view(agentHex: string, prefix: string): Promise<unknown>;
51
+ enable(agentHex: string, prefix: string): unknown;
52
+ disable(agentHex: string, prefix: string): unknown;
53
+ publish(agentHex: string, prefix: string): Promise<unknown>;
54
+ unpublish(agentHex: string, prefix: string | undefined, signalIdHex?: string): Promise<unknown>;
55
+ lookup(agentHex: string, address: string): Promise<unknown>;
56
+ examine(agentHex: string, subjectHex: string, files: readonly Uint8Array[], event: string): Promise<{
57
+ signals: Record<string, unknown>[];
58
+ refused: SignalRefusal[];
59
+ }>;
60
+ standings(subjectHex: string, files: readonly Uint8Array[]): Promise<{
61
+ type: string;
62
+ issuer_kind: string;
63
+ counts_as_verified: boolean;
64
+ same_operator: boolean;
65
+ }[]>;
66
+ presentable(agentHex: string, spec?: string): {
67
+ files: Uint8Array[];
68
+ hashes: string[];
69
+ };
70
+ trustIssuer(agentHex: string, prefix: string): unknown;
71
+ describeIssuerOf(agentHex: string, prefix: string): string;
72
+ untrustIssuer(agentHex: string, prefix: string): unknown;
73
+ }