@kodelyth/nostr 2026.5.39 → 2026.6.1

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.
@@ -0,0 +1,1467 @@
1
+ import { a as resolveDefaultNostrAccountId, c as validatePrivateKey, i as listNostrAccountIds, n as nostrSetupWizard, o as resolveNostrAccount, s as normalizePubkey, t as nostrSetupAdapter } from "./setup-surface-DFlfVW6j.js";
2
+ import { a as collectStatusIssuesFromLastError, i as buildChannelConfigSchema, n as NostrProfileSchema, o as createDefaultChannelRuntimeState, r as DEFAULT_ACCOUNT_ID, s as formatPairingApproveHint, t as NostrConfigSchema } from "./config-schema-KoL8Et_9.js";
3
+ import { t as DEFAULT_RELAYS } from "./default-relays-DLwdWOTu.js";
4
+ import { describeAccountSnapshot } from "klaw/plugin-sdk/account-helpers";
5
+ import { createScopedDmSecurityResolver, createTopLevelChannelConfigAdapter } from "klaw/plugin-sdk/channel-config-helpers";
6
+ import { createChatChannelPlugin } from "klaw/plugin-sdk/channel-core";
7
+ import { createChannelMessageAdapterFromOutbound } from "klaw/plugin-sdk/channel-message";
8
+ import { buildPassiveChannelStatusSummary, buildTrafficStatusSummary, safeParseJsonWithSchema } from "klaw/plugin-sdk/extension-shared";
9
+ import { createComputedAccountStatusAdapter } from "klaw/plugin-sdk/status-helpers";
10
+ import { z } from "zod";
11
+ import { resolveStableChannelMessageIngress } from "klaw/plugin-sdk/channel-ingress-runtime";
12
+ import { createChannelPairingController } from "klaw/plugin-sdk/channel-pairing";
13
+ import { attachChannelToResult } from "klaw/plugin-sdk/channel-send-result";
14
+ import { createDirectDmPreCryptoGuardPolicy } from "klaw/plugin-sdk/direct-dm-guard-policy";
15
+ import { SimplePool, finalizeEvent, getPublicKey, verifyEvent } from "nostr-tools";
16
+ import { decrypt, encrypt } from "nostr-tools/nip04";
17
+ import { formatErrorMessage } from "klaw/plugin-sdk/error-runtime";
18
+ import os from "node:os";
19
+ import path from "node:path";
20
+ import { privateFileStore } from "klaw/plugin-sdk/security-runtime";
21
+ import { createPluginRuntimeStore } from "klaw/plugin-sdk/runtime-store";
22
+ import { buildChannelOutboundSessionRoute, stripChannelTargetPrefix } from "klaw/plugin-sdk/core";
23
+ //#region extensions/nostr/src/metrics.ts
24
+ /**
25
+ * Create a metrics collector instance.
26
+ * Optionally pass an onMetric callback to receive real-time metric events.
27
+ */
28
+ function createMetrics(onMetric) {
29
+ let eventsReceived = 0;
30
+ let eventsProcessed = 0;
31
+ let eventsDuplicate = 0;
32
+ const eventsRejected = {
33
+ invalidShape: 0,
34
+ wrongKind: 0,
35
+ stale: 0,
36
+ future: 0,
37
+ rateLimited: 0,
38
+ invalidSignature: 0,
39
+ oversizedCiphertext: 0,
40
+ oversizedPlaintext: 0,
41
+ decryptFailed: 0,
42
+ selfMessage: 0
43
+ };
44
+ const relays = /* @__PURE__ */ new Map();
45
+ const rateLimiting = {
46
+ perSenderHits: 0,
47
+ globalHits: 0
48
+ };
49
+ const decrypt = {
50
+ success: 0,
51
+ failure: 0
52
+ };
53
+ const memory = {
54
+ seenTrackerSize: 0,
55
+ rateLimiterEntries: 0
56
+ };
57
+ function getOrCreateRelay(url) {
58
+ let relay = relays.get(url);
59
+ if (!relay) {
60
+ relay = {
61
+ connects: 0,
62
+ disconnects: 0,
63
+ reconnects: 0,
64
+ errors: 0,
65
+ messagesReceived: {
66
+ event: 0,
67
+ eose: 0,
68
+ closed: 0,
69
+ notice: 0,
70
+ ok: 0,
71
+ auth: 0
72
+ },
73
+ circuitBreakerState: "closed",
74
+ circuitBreakerOpens: 0,
75
+ circuitBreakerCloses: 0
76
+ };
77
+ relays.set(url, relay);
78
+ }
79
+ return relay;
80
+ }
81
+ function emit(name, value = 1, labels) {
82
+ if (onMetric) onMetric({
83
+ name,
84
+ value,
85
+ timestamp: Date.now(),
86
+ labels
87
+ });
88
+ const relayUrl = labels?.relay;
89
+ switch (name) {
90
+ case "event.received":
91
+ eventsReceived += value;
92
+ break;
93
+ case "event.processed":
94
+ eventsProcessed += value;
95
+ break;
96
+ case "event.duplicate":
97
+ eventsDuplicate += value;
98
+ break;
99
+ case "event.rejected.invalid_shape":
100
+ eventsRejected.invalidShape += value;
101
+ break;
102
+ case "event.rejected.wrong_kind":
103
+ eventsRejected.wrongKind += value;
104
+ break;
105
+ case "event.rejected.stale":
106
+ eventsRejected.stale += value;
107
+ break;
108
+ case "event.rejected.future":
109
+ eventsRejected.future += value;
110
+ break;
111
+ case "event.rejected.rate_limited":
112
+ eventsRejected.rateLimited += value;
113
+ break;
114
+ case "event.rejected.invalid_signature":
115
+ eventsRejected.invalidSignature += value;
116
+ break;
117
+ case "event.rejected.oversized_ciphertext":
118
+ eventsRejected.oversizedCiphertext += value;
119
+ break;
120
+ case "event.rejected.oversized_plaintext":
121
+ eventsRejected.oversizedPlaintext += value;
122
+ break;
123
+ case "event.rejected.decrypt_failed":
124
+ eventsRejected.decryptFailed += value;
125
+ break;
126
+ case "event.rejected.self_message":
127
+ eventsRejected.selfMessage += value;
128
+ break;
129
+ case "relay.connect":
130
+ if (relayUrl) getOrCreateRelay(relayUrl).connects += value;
131
+ break;
132
+ case "relay.disconnect":
133
+ if (relayUrl) getOrCreateRelay(relayUrl).disconnects += value;
134
+ break;
135
+ case "relay.reconnect":
136
+ if (relayUrl) getOrCreateRelay(relayUrl).reconnects += value;
137
+ break;
138
+ case "relay.error":
139
+ if (relayUrl) getOrCreateRelay(relayUrl).errors += value;
140
+ break;
141
+ case "relay.message.event":
142
+ if (relayUrl) getOrCreateRelay(relayUrl).messagesReceived.event += value;
143
+ break;
144
+ case "relay.message.eose":
145
+ if (relayUrl) getOrCreateRelay(relayUrl).messagesReceived.eose += value;
146
+ break;
147
+ case "relay.message.closed":
148
+ if (relayUrl) getOrCreateRelay(relayUrl).messagesReceived.closed += value;
149
+ break;
150
+ case "relay.message.notice":
151
+ if (relayUrl) getOrCreateRelay(relayUrl).messagesReceived.notice += value;
152
+ break;
153
+ case "relay.message.ok":
154
+ if (relayUrl) getOrCreateRelay(relayUrl).messagesReceived.ok += value;
155
+ break;
156
+ case "relay.message.auth":
157
+ if (relayUrl) getOrCreateRelay(relayUrl).messagesReceived.auth += value;
158
+ break;
159
+ case "relay.circuit_breaker.open":
160
+ if (relayUrl) {
161
+ const r = getOrCreateRelay(relayUrl);
162
+ r.circuitBreakerState = "open";
163
+ r.circuitBreakerOpens += value;
164
+ }
165
+ break;
166
+ case "relay.circuit_breaker.close":
167
+ if (relayUrl) {
168
+ const r = getOrCreateRelay(relayUrl);
169
+ r.circuitBreakerState = "closed";
170
+ r.circuitBreakerCloses += value;
171
+ }
172
+ break;
173
+ case "relay.circuit_breaker.half_open":
174
+ if (relayUrl) getOrCreateRelay(relayUrl).circuitBreakerState = "half_open";
175
+ break;
176
+ case "rate_limit.per_sender":
177
+ rateLimiting.perSenderHits += value;
178
+ break;
179
+ case "rate_limit.global":
180
+ rateLimiting.globalHits += value;
181
+ break;
182
+ case "decrypt.success":
183
+ decrypt.success += value;
184
+ break;
185
+ case "decrypt.failure":
186
+ decrypt.failure += value;
187
+ break;
188
+ case "memory.seen_tracker_size":
189
+ memory.seenTrackerSize = value;
190
+ break;
191
+ case "memory.rate_limiter_entries":
192
+ memory.rateLimiterEntries = value;
193
+ break;
194
+ }
195
+ }
196
+ function getSnapshot() {
197
+ const relaysObj = {};
198
+ for (const [url, stats] of relays) relaysObj[url] = {
199
+ ...stats,
200
+ messagesReceived: { ...stats.messagesReceived }
201
+ };
202
+ return {
203
+ eventsReceived,
204
+ eventsProcessed,
205
+ eventsDuplicate,
206
+ eventsRejected: { ...eventsRejected },
207
+ relays: relaysObj,
208
+ rateLimiting: { ...rateLimiting },
209
+ decrypt: { ...decrypt },
210
+ memory: { ...memory },
211
+ snapshotAt: Date.now()
212
+ };
213
+ }
214
+ function reset() {
215
+ eventsReceived = 0;
216
+ eventsProcessed = 0;
217
+ eventsDuplicate = 0;
218
+ Object.assign(eventsRejected, {
219
+ invalidShape: 0,
220
+ wrongKind: 0,
221
+ stale: 0,
222
+ future: 0,
223
+ rateLimited: 0,
224
+ invalidSignature: 0,
225
+ oversizedCiphertext: 0,
226
+ oversizedPlaintext: 0,
227
+ decryptFailed: 0,
228
+ selfMessage: 0
229
+ });
230
+ relays.clear();
231
+ rateLimiting.perSenderHits = 0;
232
+ rateLimiting.globalHits = 0;
233
+ decrypt.success = 0;
234
+ decrypt.failure = 0;
235
+ memory.seenTrackerSize = 0;
236
+ memory.rateLimiterEntries = 0;
237
+ }
238
+ return {
239
+ emit,
240
+ getSnapshot,
241
+ reset
242
+ };
243
+ }
244
+ /**
245
+ * Create a no-op metrics instance (for when metrics are disabled).
246
+ */
247
+ function createNoopMetrics() {
248
+ const emptySnapshot = {
249
+ eventsReceived: 0,
250
+ eventsProcessed: 0,
251
+ eventsDuplicate: 0,
252
+ eventsRejected: {
253
+ invalidShape: 0,
254
+ wrongKind: 0,
255
+ stale: 0,
256
+ future: 0,
257
+ rateLimited: 0,
258
+ invalidSignature: 0,
259
+ oversizedCiphertext: 0,
260
+ oversizedPlaintext: 0,
261
+ decryptFailed: 0,
262
+ selfMessage: 0
263
+ },
264
+ relays: {},
265
+ rateLimiting: {
266
+ perSenderHits: 0,
267
+ globalHits: 0
268
+ },
269
+ decrypt: {
270
+ success: 0,
271
+ failure: 0
272
+ },
273
+ memory: {
274
+ seenTrackerSize: 0,
275
+ rateLimiterEntries: 0
276
+ },
277
+ snapshotAt: 0
278
+ };
279
+ return {
280
+ emit: () => {},
281
+ getSnapshot: () => ({
282
+ ...emptySnapshot,
283
+ snapshotAt: Date.now()
284
+ }),
285
+ reset: () => {}
286
+ };
287
+ }
288
+ //#endregion
289
+ //#region extensions/nostr/src/nostr-profile-core.ts
290
+ /**
291
+ * Convert our config profile schema to NIP-01 content format.
292
+ * Strips undefined fields and validates URLs.
293
+ */
294
+ function profileToContent(profile) {
295
+ const validated = NostrProfileSchema.parse(profile);
296
+ const content = {};
297
+ if (validated.name !== void 0) content.name = validated.name;
298
+ if (validated.displayName !== void 0) content.display_name = validated.displayName;
299
+ if (validated.about !== void 0) content.about = validated.about;
300
+ if (validated.picture !== void 0) content.picture = validated.picture;
301
+ if (validated.banner !== void 0) content.banner = validated.banner;
302
+ if (validated.website !== void 0) content.website = validated.website;
303
+ if (validated.nip05 !== void 0) content.nip05 = validated.nip05;
304
+ if (validated.lud16 !== void 0) content.lud16 = validated.lud16;
305
+ return content;
306
+ }
307
+ /**
308
+ * Convert NIP-01 content format back to our config profile schema.
309
+ * Useful for importing existing profiles from relays.
310
+ */
311
+ function contentToProfile(content) {
312
+ const profile = {};
313
+ if (content.name !== void 0) profile.name = content.name;
314
+ if (content.display_name !== void 0) profile.displayName = content.display_name;
315
+ if (content.about !== void 0) profile.about = content.about;
316
+ if (content.picture !== void 0) profile.picture = content.picture;
317
+ if (content.banner !== void 0) profile.banner = content.banner;
318
+ if (content.website !== void 0) profile.website = content.website;
319
+ if (content.nip05 !== void 0) profile.nip05 = content.nip05;
320
+ if (content.lud16 !== void 0) profile.lud16 = content.lud16;
321
+ return profile;
322
+ }
323
+ //#endregion
324
+ //#region extensions/nostr/src/nostr-profile.ts
325
+ /**
326
+ * Nostr Profile Management (NIP-01 kind:0)
327
+ *
328
+ * Profile events are "replaceable" - the latest created_at wins.
329
+ * This module handles profile event creation and publishing.
330
+ */
331
+ /**
332
+ * Create a signed kind:0 profile event.
333
+ *
334
+ * @param sk - Private key as Uint8Array (32 bytes)
335
+ * @param profile - Profile data to include
336
+ * @param lastPublishedAt - Previous profile timestamp (for monotonic guarantee)
337
+ * @returns Signed Nostr event
338
+ */
339
+ function createProfileEvent(sk, profile, lastPublishedAt) {
340
+ const content = profileToContent(profile);
341
+ const contentJson = JSON.stringify(content);
342
+ const now = Math.floor(Date.now() / 1e3);
343
+ return finalizeEvent({
344
+ kind: 0,
345
+ content: contentJson,
346
+ tags: [],
347
+ created_at: lastPublishedAt !== void 0 ? Math.max(now, lastPublishedAt + 1) : now
348
+ }, sk);
349
+ }
350
+ /** Per-relay publish timeout (ms) */
351
+ const RELAY_PUBLISH_TIMEOUT_MS = 5e3;
352
+ /**
353
+ * Publish a profile event to multiple relays.
354
+ *
355
+ * Best-effort: publishes to all relays in parallel, reports per-relay results.
356
+ * Does NOT retry automatically - caller should handle retries if needed.
357
+ *
358
+ * @param pool - SimplePool instance for relay connections
359
+ * @param relays - Array of relay WebSocket URLs
360
+ * @param event - Signed profile event (kind:0)
361
+ * @returns Publish results with successes and failures
362
+ */
363
+ async function publishProfileEvent(pool, relays, event) {
364
+ const successes = [];
365
+ const failures = [];
366
+ const publishPromises = relays.map(async (relay) => {
367
+ try {
368
+ const timeoutPromise = new Promise((_, reject) => {
369
+ setTimeout(() => reject(/* @__PURE__ */ new Error("timeout")), RELAY_PUBLISH_TIMEOUT_MS);
370
+ });
371
+ await Promise.race([...pool.publish([relay], event), timeoutPromise]);
372
+ successes.push(relay);
373
+ } catch (err) {
374
+ const errorMessage = formatErrorMessage(err);
375
+ failures.push({
376
+ relay,
377
+ error: errorMessage
378
+ });
379
+ }
380
+ });
381
+ await Promise.all(publishPromises);
382
+ return {
383
+ eventId: event.id,
384
+ successes,
385
+ failures,
386
+ createdAt: event.created_at
387
+ };
388
+ }
389
+ /**
390
+ * Create and publish a profile event in one call.
391
+ *
392
+ * @param pool - SimplePool instance
393
+ * @param sk - Private key as Uint8Array
394
+ * @param relays - Array of relay URLs
395
+ * @param profile - Profile data
396
+ * @param lastPublishedAt - Previous timestamp for monotonic ordering
397
+ * @returns Publish results
398
+ */
399
+ async function publishProfile(pool, sk, relays, profile, lastPublishedAt) {
400
+ return publishProfileEvent(pool, relays, createProfileEvent(sk, profile, lastPublishedAt));
401
+ }
402
+ //#endregion
403
+ //#region extensions/nostr/src/runtime.ts
404
+ const { setRuntime: setNostrRuntime, getRuntime: getNostrRuntime } = createPluginRuntimeStore({
405
+ pluginId: "nostr",
406
+ errorMessage: "Nostr runtime not initialized"
407
+ });
408
+ //#endregion
409
+ //#region extensions/nostr/src/nostr-state-store.ts
410
+ const STORE_VERSION = 2;
411
+ const PROFILE_STATE_VERSION = 1;
412
+ const NullableFiniteNumberSchema = z.number().finite().nullable().catch(null);
413
+ const NostrBusStateV1Schema = z.object({
414
+ version: z.literal(1),
415
+ lastProcessedAt: NullableFiniteNumberSchema,
416
+ gatewayStartedAt: NullableFiniteNumberSchema
417
+ });
418
+ const NostrBusStateSchema = z.object({
419
+ version: z.literal(2),
420
+ lastProcessedAt: NullableFiniteNumberSchema,
421
+ gatewayStartedAt: NullableFiniteNumberSchema,
422
+ recentEventIds: z.array(z.unknown()).catch([]).transform((ids) => ids.filter((id) => typeof id === "string"))
423
+ });
424
+ const NostrProfileStateSchema = z.object({
425
+ version: z.literal(1),
426
+ lastPublishedAt: NullableFiniteNumberSchema,
427
+ lastPublishedEventId: z.string().nullable().catch(null),
428
+ lastPublishResults: z.record(z.string(), z.enum([
429
+ "ok",
430
+ "failed",
431
+ "timeout"
432
+ ])).nullable().catch(null)
433
+ });
434
+ function normalizeAccountId(accountId) {
435
+ const trimmed = accountId?.trim();
436
+ if (!trimmed) return "default";
437
+ return trimmed.replace(/[^a-z0-9._-]+/gi, "_");
438
+ }
439
+ function resolveNostrStatePath(accountId, env = process.env) {
440
+ const stateDir = getNostrRuntime().state.resolveStateDir(env, os.homedir);
441
+ const normalized = normalizeAccountId(accountId);
442
+ return path.join(stateDir, "nostr", `bus-state-${normalized}.json`);
443
+ }
444
+ function resolveNostrProfileStatePath(accountId, env = process.env) {
445
+ const stateDir = getNostrRuntime().state.resolveStateDir(env, os.homedir);
446
+ const normalized = normalizeAccountId(accountId);
447
+ return path.join(stateDir, "nostr", `profile-state-${normalized}.json`);
448
+ }
449
+ function safeParseState(raw) {
450
+ const parsedV2 = safeParseJsonWithSchema(NostrBusStateSchema, raw);
451
+ if (parsedV2) return parsedV2;
452
+ const parsedV1 = safeParseJsonWithSchema(NostrBusStateV1Schema, raw);
453
+ if (!parsedV1) return null;
454
+ return {
455
+ version: 2,
456
+ lastProcessedAt: parsedV1.lastProcessedAt,
457
+ gatewayStartedAt: parsedV1.gatewayStartedAt,
458
+ recentEventIds: []
459
+ };
460
+ }
461
+ async function readNostrBusState(params) {
462
+ const filePath = resolveNostrStatePath(params.accountId, params.env);
463
+ try {
464
+ const raw = await privateFileStore(path.dirname(filePath)).readTextIfExists(path.basename(filePath));
465
+ if (raw === null) return null;
466
+ return safeParseState(raw);
467
+ } catch {
468
+ return null;
469
+ }
470
+ }
471
+ async function writeNostrBusState(params) {
472
+ const filePath = resolveNostrStatePath(params.accountId, params.env);
473
+ const payload = {
474
+ version: STORE_VERSION,
475
+ lastProcessedAt: params.lastProcessedAt,
476
+ gatewayStartedAt: params.gatewayStartedAt,
477
+ recentEventIds: (params.recentEventIds ?? []).filter((x) => typeof x === "string")
478
+ };
479
+ await privateFileStore(path.dirname(filePath)).writeJson(path.basename(filePath), payload, { trailingNewline: true });
480
+ }
481
+ /**
482
+ * Determine the `since` timestamp for subscription.
483
+ * Returns the later of: lastProcessedAt or gatewayStartedAt (both from disk),
484
+ * falling back to `now` for fresh starts.
485
+ */
486
+ function computeSinceTimestamp(state, nowSec = Math.floor(Date.now() / 1e3)) {
487
+ if (!state) return nowSec;
488
+ const candidates = [state.lastProcessedAt, state.gatewayStartedAt].filter((t) => t !== null && t > 0);
489
+ if (candidates.length === 0) return nowSec;
490
+ return Math.max(...candidates);
491
+ }
492
+ function safeParseProfileState(raw) {
493
+ return safeParseJsonWithSchema(NostrProfileStateSchema, raw);
494
+ }
495
+ async function readNostrProfileState(params) {
496
+ const filePath = resolveNostrProfileStatePath(params.accountId, params.env);
497
+ try {
498
+ const raw = await privateFileStore(path.dirname(filePath)).readTextIfExists(path.basename(filePath));
499
+ if (raw === null) return null;
500
+ return safeParseProfileState(raw);
501
+ } catch {
502
+ return null;
503
+ }
504
+ }
505
+ async function writeNostrProfileState(params) {
506
+ const filePath = resolveNostrProfileStatePath(params.accountId, params.env);
507
+ const payload = {
508
+ version: PROFILE_STATE_VERSION,
509
+ lastPublishedAt: params.lastPublishedAt,
510
+ lastPublishedEventId: params.lastPublishedEventId,
511
+ lastPublishResults: params.lastPublishResults
512
+ };
513
+ await privateFileStore(path.dirname(filePath)).writeJson(path.basename(filePath), payload, { trailingNewline: true });
514
+ }
515
+ //#endregion
516
+ //#region extensions/nostr/src/seen-tracker.ts
517
+ /**
518
+ * Create a new seen tracker with LRU eviction and TTL expiration.
519
+ */
520
+ function createSeenTracker(options) {
521
+ const maxEntries = options?.maxEntries ?? 1e5;
522
+ const ttlMs = options?.ttlMs ?? 3600 * 1e3;
523
+ const pruneIntervalMs = options?.pruneIntervalMs ?? 600 * 1e3;
524
+ const entries = /* @__PURE__ */ new Map();
525
+ let head = null;
526
+ let tail = null;
527
+ function moveToFront(id) {
528
+ const entry = entries.get(id);
529
+ if (!entry) return;
530
+ if (head === id) return;
531
+ if (entry.prev) {
532
+ const prevEntry = entries.get(entry.prev);
533
+ if (prevEntry) prevEntry.next = entry.next;
534
+ }
535
+ if (entry.next) {
536
+ const nextEntry = entries.get(entry.next);
537
+ if (nextEntry) nextEntry.prev = entry.prev;
538
+ }
539
+ if (tail === id) tail = entry.prev;
540
+ entry.prev = null;
541
+ entry.next = head;
542
+ if (head) {
543
+ const headEntry = entries.get(head);
544
+ if (headEntry) headEntry.prev = id;
545
+ }
546
+ head = id;
547
+ if (!tail) tail = id;
548
+ }
549
+ function removeFromList(id) {
550
+ const entry = entries.get(id);
551
+ if (!entry) return;
552
+ if (entry.prev) {
553
+ const prevEntry = entries.get(entry.prev);
554
+ if (prevEntry) prevEntry.next = entry.next;
555
+ } else head = entry.next;
556
+ if (entry.next) {
557
+ const nextEntry = entries.get(entry.next);
558
+ if (nextEntry) nextEntry.prev = entry.prev;
559
+ } else tail = entry.prev;
560
+ }
561
+ function evictLRU() {
562
+ if (!tail) return;
563
+ const idToEvict = tail;
564
+ removeFromList(idToEvict);
565
+ entries.delete(idToEvict);
566
+ }
567
+ function insertAtFront(id, seenAt) {
568
+ const newEntry = {
569
+ seenAt,
570
+ prev: null,
571
+ next: head
572
+ };
573
+ if (head) {
574
+ const headEntry = entries.get(head);
575
+ if (headEntry) headEntry.prev = id;
576
+ }
577
+ entries.set(id, newEntry);
578
+ head = id;
579
+ if (!tail) tail = id;
580
+ }
581
+ function pruneExpired() {
582
+ const now = Date.now();
583
+ const toDelete = [];
584
+ for (const [id, entry] of entries) if (now - entry.seenAt > ttlMs) toDelete.push(id);
585
+ for (const id of toDelete) {
586
+ removeFromList(id);
587
+ entries.delete(id);
588
+ }
589
+ }
590
+ let pruneTimer;
591
+ if (pruneIntervalMs > 0) {
592
+ pruneTimer = setInterval(pruneExpired, pruneIntervalMs);
593
+ if (pruneTimer.unref) pruneTimer.unref();
594
+ }
595
+ function add(id) {
596
+ const now = Date.now();
597
+ const existing = entries.get(id);
598
+ if (existing) {
599
+ existing.seenAt = now;
600
+ moveToFront(id);
601
+ return;
602
+ }
603
+ while (entries.size >= maxEntries) evictLRU();
604
+ insertAtFront(id, now);
605
+ }
606
+ function has(id) {
607
+ const entry = entries.get(id);
608
+ if (!entry) {
609
+ add(id);
610
+ return false;
611
+ }
612
+ if (Date.now() - entry.seenAt > ttlMs) {
613
+ removeFromList(id);
614
+ entries.delete(id);
615
+ add(id);
616
+ return false;
617
+ }
618
+ entry.seenAt = Date.now();
619
+ moveToFront(id);
620
+ return true;
621
+ }
622
+ function peek(id) {
623
+ const entry = entries.get(id);
624
+ if (!entry) return false;
625
+ if (Date.now() - entry.seenAt > ttlMs) {
626
+ removeFromList(id);
627
+ entries.delete(id);
628
+ return false;
629
+ }
630
+ return true;
631
+ }
632
+ function deleteEntry(id) {
633
+ if (entries.has(id)) {
634
+ removeFromList(id);
635
+ entries.delete(id);
636
+ }
637
+ }
638
+ function clear() {
639
+ entries.clear();
640
+ head = null;
641
+ tail = null;
642
+ }
643
+ function size() {
644
+ return entries.size;
645
+ }
646
+ function stop() {
647
+ if (pruneTimer) {
648
+ clearInterval(pruneTimer);
649
+ pruneTimer = void 0;
650
+ }
651
+ }
652
+ function seed(ids) {
653
+ const now = Date.now();
654
+ for (let i = ids.length - 1; i >= 0; i--) {
655
+ const id = ids[i];
656
+ if (!entries.has(id) && entries.size < maxEntries) insertAtFront(id, now);
657
+ }
658
+ }
659
+ return {
660
+ has,
661
+ add,
662
+ peek,
663
+ delete: deleteEntry,
664
+ clear,
665
+ size,
666
+ stop,
667
+ seed
668
+ };
669
+ }
670
+ //#endregion
671
+ //#region extensions/nostr/src/nostr-bus.ts
672
+ const STARTUP_LOOKBACK_SEC = 120;
673
+ const MAX_PERSISTED_EVENT_IDS = 5e3;
674
+ const STATE_PERSIST_DEBOUNCE_MS = 5e3;
675
+ const DEFAULT_INBOUND_GUARD_POLICY = createDirectDmPreCryptoGuardPolicy();
676
+ const CIRCUIT_BREAKER_THRESHOLD = 5;
677
+ const CIRCUIT_BREAKER_RESET_MS = 3e4;
678
+ const HEALTH_WINDOW_MS = 6e4;
679
+ function createFixedWindowRateLimiter(params) {
680
+ const windowMs = Math.max(1, Math.floor(params.windowMs));
681
+ const maxRequests = Math.max(1, Math.floor(params.maxRequests));
682
+ const maxTrackedKeys = Math.max(1, Math.floor(params.maxTrackedKeys));
683
+ const state = /* @__PURE__ */ new Map();
684
+ const touch = (key, value) => {
685
+ state.delete(key);
686
+ state.set(key, value);
687
+ };
688
+ const prune = (nowMs) => {
689
+ for (const [key, entry] of state) if (nowMs - entry.windowStartMs >= windowMs) state.delete(key);
690
+ while (state.size > maxTrackedKeys) {
691
+ const oldest = state.keys().next().value;
692
+ if (!oldest) break;
693
+ state.delete(oldest);
694
+ }
695
+ };
696
+ return {
697
+ isRateLimited: (key, nowMs = Date.now()) => {
698
+ if (!key) return false;
699
+ prune(nowMs);
700
+ const existing = state.get(key);
701
+ if (!existing || nowMs - existing.windowStartMs >= windowMs) {
702
+ touch(key, {
703
+ count: 1,
704
+ windowStartMs: nowMs
705
+ });
706
+ return false;
707
+ }
708
+ const nextCount = existing.count + 1;
709
+ touch(key, {
710
+ count: nextCount,
711
+ windowStartMs: existing.windowStartMs
712
+ });
713
+ return nextCount > maxRequests;
714
+ },
715
+ size: () => state.size,
716
+ clear: () => state.clear()
717
+ };
718
+ }
719
+ function createCircuitBreaker(relay, metrics, threshold = CIRCUIT_BREAKER_THRESHOLD, resetMs = CIRCUIT_BREAKER_RESET_MS) {
720
+ const state = {
721
+ state: "closed",
722
+ failures: 0,
723
+ lastFailure: 0,
724
+ lastSuccess: Date.now()
725
+ };
726
+ return {
727
+ canAttempt() {
728
+ if (state.state === "closed") return true;
729
+ if (state.state === "open") {
730
+ if (Date.now() - state.lastFailure >= resetMs) {
731
+ state.state = "half_open";
732
+ metrics.emit("relay.circuit_breaker.half_open", 1, { relay });
733
+ return true;
734
+ }
735
+ return false;
736
+ }
737
+ return true;
738
+ },
739
+ recordSuccess() {
740
+ if (state.state === "half_open") {
741
+ state.state = "closed";
742
+ state.failures = 0;
743
+ metrics.emit("relay.circuit_breaker.close", 1, { relay });
744
+ } else if (state.state === "closed") state.failures = 0;
745
+ state.lastSuccess = Date.now();
746
+ },
747
+ recordFailure() {
748
+ state.failures++;
749
+ state.lastFailure = Date.now();
750
+ if (state.state === "half_open") {
751
+ state.state = "open";
752
+ metrics.emit("relay.circuit_breaker.open", 1, { relay });
753
+ } else if (state.state === "closed" && state.failures >= threshold) {
754
+ state.state = "open";
755
+ metrics.emit("relay.circuit_breaker.open", 1, { relay });
756
+ }
757
+ },
758
+ getState() {
759
+ return state.state;
760
+ }
761
+ };
762
+ }
763
+ function createRelayHealthTracker() {
764
+ const stats = /* @__PURE__ */ new Map();
765
+ function getOrCreate(relay) {
766
+ let s = stats.get(relay);
767
+ if (!s) {
768
+ s = {
769
+ successCount: 0,
770
+ failureCount: 0,
771
+ latencySum: 0,
772
+ latencyCount: 0,
773
+ lastSuccess: 0,
774
+ lastFailure: 0
775
+ };
776
+ stats.set(relay, s);
777
+ }
778
+ return s;
779
+ }
780
+ return {
781
+ recordSuccess(relay, latencyMs) {
782
+ const s = getOrCreate(relay);
783
+ s.successCount++;
784
+ s.latencySum += latencyMs;
785
+ s.latencyCount++;
786
+ s.lastSuccess = Date.now();
787
+ },
788
+ recordFailure(relay) {
789
+ const s = getOrCreate(relay);
790
+ s.failureCount++;
791
+ s.lastFailure = Date.now();
792
+ },
793
+ getScore(relay) {
794
+ const s = stats.get(relay);
795
+ if (!s) return .5;
796
+ const total = s.successCount + s.failureCount;
797
+ if (total === 0) return .5;
798
+ const successRate = s.successCount / total;
799
+ const now = Date.now();
800
+ const recencyBonus = s.lastSuccess > s.lastFailure ? Math.max(0, 1 - (now - s.lastSuccess) / HEALTH_WINDOW_MS) * .2 : 0;
801
+ const avgLatency = s.latencyCount > 0 ? s.latencySum / s.latencyCount : 1e3;
802
+ const latencyPenalty = Math.min(.2, avgLatency / 1e4);
803
+ return Math.max(0, Math.min(1, successRate + recencyBonus - latencyPenalty));
804
+ },
805
+ getSortedRelays(relays) {
806
+ return [...relays].toSorted((a, b) => this.getScore(b) - this.getScore(a));
807
+ }
808
+ };
809
+ }
810
+ /**
811
+ * Start the Nostr DM bus - subscribes to NIP-04 encrypted DMs
812
+ */
813
+ async function startNostrBus(options) {
814
+ const { privateKey, relays = DEFAULT_RELAYS, onMessage, authorizeSender, onError, onEose, onMetric, maxSeenEntries = 1e5, seenTtlMs = 3600 * 1e3 } = options;
815
+ const sk = validatePrivateKey(privateKey);
816
+ const pk = getPublicKey(sk);
817
+ const pool = new SimplePool();
818
+ const accountId = options.accountId ?? pk.slice(0, 16);
819
+ const gatewayStartedAt = Math.floor(Date.now() / 1e3);
820
+ const guardPolicy = createDirectDmPreCryptoGuardPolicy({
821
+ ...DEFAULT_INBOUND_GUARD_POLICY,
822
+ ...options.guardPolicy,
823
+ rateLimit: {
824
+ ...DEFAULT_INBOUND_GUARD_POLICY.rateLimit,
825
+ ...options.guardPolicy?.rateLimit
826
+ }
827
+ });
828
+ const metrics = onMetric ? createMetrics(onMetric) : createNoopMetrics();
829
+ const seen = createSeenTracker({
830
+ maxEntries: maxSeenEntries,
831
+ ttlMs: seenTtlMs
832
+ });
833
+ const circuitBreakers = /* @__PURE__ */ new Map();
834
+ const healthTracker = createRelayHealthTracker();
835
+ for (const relay of relays) circuitBreakers.set(relay, createCircuitBreaker(relay, metrics));
836
+ const state = await readNostrBusState({ accountId });
837
+ const baseSince = computeSinceTimestamp(state, gatewayStartedAt);
838
+ const since = Math.max(0, baseSince - STARTUP_LOOKBACK_SEC);
839
+ if (state?.recentEventIds?.length) seen.seed(state.recentEventIds);
840
+ await writeNostrBusState({
841
+ accountId,
842
+ lastProcessedAt: state?.lastProcessedAt ?? gatewayStartedAt,
843
+ gatewayStartedAt,
844
+ recentEventIds: state?.recentEventIds ?? []
845
+ });
846
+ let pendingWrite;
847
+ let lastProcessedAt = state?.lastProcessedAt ?? gatewayStartedAt;
848
+ let recentEventIds = (state?.recentEventIds ?? []).slice(-MAX_PERSISTED_EVENT_IDS);
849
+ function scheduleStatePersist(eventCreatedAt, eventId) {
850
+ lastProcessedAt = Math.max(lastProcessedAt, eventCreatedAt);
851
+ recentEventIds.push(eventId);
852
+ if (recentEventIds.length > MAX_PERSISTED_EVENT_IDS) recentEventIds = recentEventIds.slice(-MAX_PERSISTED_EVENT_IDS);
853
+ if (pendingWrite) clearTimeout(pendingWrite);
854
+ pendingWrite = setTimeout(() => {
855
+ writeNostrBusState({
856
+ accountId,
857
+ lastProcessedAt,
858
+ gatewayStartedAt,
859
+ recentEventIds
860
+ }).catch((err) => onError?.(err, "persist state"));
861
+ }, STATE_PERSIST_DEBOUNCE_MS);
862
+ }
863
+ const inflight = /* @__PURE__ */ new Set();
864
+ const perSenderRateLimiter = createFixedWindowRateLimiter({
865
+ windowMs: guardPolicy.rateLimit.windowMs,
866
+ maxRequests: guardPolicy.rateLimit.maxPerSenderPerWindow,
867
+ maxTrackedKeys: guardPolicy.rateLimit.maxTrackedSenderKeys
868
+ });
869
+ const globalRateLimiter = createFixedWindowRateLimiter({
870
+ windowMs: guardPolicy.rateLimit.windowMs,
871
+ maxRequests: guardPolicy.rateLimit.maxGlobalPerWindow,
872
+ maxTrackedKeys: 1
873
+ });
874
+ const updateRateLimiterSizeMetric = () => {
875
+ metrics.emit("memory.rate_limiter_entries", perSenderRateLimiter.size() + globalRateLimiter.size());
876
+ };
877
+ async function handleEvent(event) {
878
+ try {
879
+ metrics.emit("event.received");
880
+ if (seen.peek(event.id) || inflight.has(event.id)) {
881
+ metrics.emit("event.duplicate");
882
+ return;
883
+ }
884
+ inflight.add(event.id);
885
+ const markSeen = () => {
886
+ seen.add(event.id);
887
+ metrics.emit("memory.seen_tracker_size", seen.size());
888
+ };
889
+ const rejectAndMarkSeen = (metric) => {
890
+ markSeen();
891
+ metrics.emit(metric);
892
+ };
893
+ if (event.pubkey === pk) {
894
+ rejectAndMarkSeen("event.rejected.self_message");
895
+ return;
896
+ }
897
+ if (event.created_at < since) {
898
+ rejectAndMarkSeen("event.rejected.stale");
899
+ return;
900
+ }
901
+ if (event.created_at > Math.floor(Date.now() / 1e3) + guardPolicy.maxFutureSkewSec) {
902
+ metrics.emit("event.rejected.future");
903
+ return;
904
+ }
905
+ if (!guardPolicy.allowedKinds.includes(event.kind)) {
906
+ rejectAndMarkSeen("event.rejected.wrong_kind");
907
+ return;
908
+ }
909
+ let targetsUs = false;
910
+ for (const t of event.tags) if (t[0] === "p" && t[1] === pk) {
911
+ targetsUs = true;
912
+ break;
913
+ }
914
+ if (!targetsUs) {
915
+ rejectAndMarkSeen("event.rejected.wrong_kind");
916
+ return;
917
+ }
918
+ const replyTo = async (text) => {
919
+ await sendEncryptedDm(pool, sk, event.pubkey, text, relays, metrics, circuitBreakers, healthTracker, onError);
920
+ };
921
+ const rejectIfGlobalRateLimited = () => {
922
+ updateRateLimiterSizeMetric();
923
+ if (globalRateLimiter.isRateLimited("global")) {
924
+ metrics.emit("rate_limit.global");
925
+ metrics.emit("event.rejected.rate_limited");
926
+ updateRateLimiterSizeMetric();
927
+ return true;
928
+ }
929
+ updateRateLimiterSizeMetric();
930
+ return false;
931
+ };
932
+ const rejectIfVerifiedSenderRateLimited = () => {
933
+ updateRateLimiterSizeMetric();
934
+ if (perSenderRateLimiter.isRateLimited(event.pubkey)) {
935
+ metrics.emit("rate_limit.per_sender");
936
+ metrics.emit("event.rejected.rate_limited");
937
+ updateRateLimiterSizeMetric();
938
+ return true;
939
+ }
940
+ updateRateLimiterSizeMetric();
941
+ return false;
942
+ };
943
+ if (Buffer.byteLength(event.content, "utf8") > guardPolicy.maxCiphertextBytes) {
944
+ if (rejectIfGlobalRateLimited()) return;
945
+ rejectAndMarkSeen("event.rejected.oversized_ciphertext");
946
+ return;
947
+ }
948
+ if (rejectIfGlobalRateLimited()) return;
949
+ if (!verifyEvent(event)) {
950
+ rejectAndMarkSeen("event.rejected.invalid_signature");
951
+ onError?.(/* @__PURE__ */ new Error("Invalid signature"), `event ${event.id}`);
952
+ return;
953
+ }
954
+ if (rejectIfVerifiedSenderRateLimited()) return;
955
+ if (authorizeSender) {
956
+ if (await authorizeSender({
957
+ senderPubkey: event.pubkey,
958
+ reply: replyTo
959
+ }) !== "allow") {
960
+ markSeen();
961
+ return;
962
+ }
963
+ }
964
+ let plaintext;
965
+ try {
966
+ plaintext = decrypt(sk, event.pubkey, event.content);
967
+ metrics.emit("decrypt.success");
968
+ } catch (err) {
969
+ markSeen();
970
+ metrics.emit("decrypt.failure");
971
+ metrics.emit("event.rejected.decrypt_failed");
972
+ onError?.(err, `decrypt from ${event.pubkey}`);
973
+ return;
974
+ }
975
+ if (Buffer.byteLength(plaintext, "utf8") > guardPolicy.maxPlaintextBytes) {
976
+ markSeen();
977
+ metrics.emit("event.rejected.oversized_plaintext");
978
+ return;
979
+ }
980
+ await onMessage(event.pubkey, plaintext, replyTo, {
981
+ eventId: event.id,
982
+ createdAt: event.created_at
983
+ });
984
+ markSeen();
985
+ metrics.emit("event.processed");
986
+ scheduleStatePersist(event.created_at, event.id);
987
+ } catch (err) {
988
+ onError?.(err, `event ${event.id}`);
989
+ } finally {
990
+ inflight.delete(event.id);
991
+ }
992
+ }
993
+ const sub = pool.subscribeMany(relays, [{
994
+ kinds: [4],
995
+ "#p": [pk],
996
+ since
997
+ }], {
998
+ onevent: handleEvent,
999
+ oneose: () => {
1000
+ for (const relay of relays) metrics.emit("relay.message.eose", 1, { relay });
1001
+ onEose?.(relays.join(", "));
1002
+ },
1003
+ onclose: (reason) => {
1004
+ for (const relay of relays) {
1005
+ metrics.emit("relay.message.closed", 1, { relay });
1006
+ options.onDisconnect?.(relay);
1007
+ }
1008
+ onError?.(/* @__PURE__ */ new Error(`Subscription closed: ${reason.join(", ")}`), "subscription");
1009
+ }
1010
+ });
1011
+ const sendDm = async (toPubkey, text) => {
1012
+ await sendEncryptedDm(pool, sk, toPubkey, text, relays, metrics, circuitBreakers, healthTracker, onError);
1013
+ };
1014
+ const publishProfile$1 = async (profile) => {
1015
+ const result = await publishProfile(pool, sk, relays, profile, (await readNostrProfileState({ accountId }))?.lastPublishedAt ?? void 0);
1016
+ const publishResults = {};
1017
+ for (const relay of result.successes) publishResults[relay] = "ok";
1018
+ for (const { relay, error } of result.failures) publishResults[relay] = error === "timeout" ? "timeout" : "failed";
1019
+ await writeNostrProfileState({
1020
+ accountId,
1021
+ lastPublishedAt: result.createdAt,
1022
+ lastPublishedEventId: result.eventId,
1023
+ lastPublishResults: publishResults
1024
+ });
1025
+ return result;
1026
+ };
1027
+ const getProfileState = async () => {
1028
+ const state = await readNostrProfileState({ accountId });
1029
+ return {
1030
+ lastPublishedAt: state?.lastPublishedAt ?? null,
1031
+ lastPublishedEventId: state?.lastPublishedEventId ?? null,
1032
+ lastPublishResults: state?.lastPublishResults ?? null
1033
+ };
1034
+ };
1035
+ return {
1036
+ close: () => {
1037
+ sub.close();
1038
+ seen.stop();
1039
+ perSenderRateLimiter.clear();
1040
+ globalRateLimiter.clear();
1041
+ if (pendingWrite) {
1042
+ clearTimeout(pendingWrite);
1043
+ writeNostrBusState({
1044
+ accountId,
1045
+ lastProcessedAt,
1046
+ gatewayStartedAt,
1047
+ recentEventIds
1048
+ }).catch((err) => onError?.(err, "persist state on close"));
1049
+ }
1050
+ },
1051
+ publicKey: pk,
1052
+ sendDm,
1053
+ getMetrics: () => metrics.getSnapshot(),
1054
+ publishProfile: publishProfile$1,
1055
+ getProfileState
1056
+ };
1057
+ }
1058
+ /**
1059
+ * Send an encrypted DM to a pubkey
1060
+ */
1061
+ async function sendEncryptedDm(pool, sk, toPubkey, text, relays, metrics, circuitBreakers, healthTracker, onError) {
1062
+ const reply = finalizeEvent({
1063
+ kind: 4,
1064
+ content: encrypt(sk, toPubkey, text),
1065
+ tags: [["p", toPubkey]],
1066
+ created_at: Math.floor(Date.now() / 1e3)
1067
+ }, sk);
1068
+ const sortedRelays = healthTracker.getSortedRelays(relays);
1069
+ let lastError;
1070
+ for (const relay of sortedRelays) {
1071
+ const cb = circuitBreakers.get(relay);
1072
+ if (cb && !cb.canAttempt()) continue;
1073
+ const startTime = Date.now();
1074
+ try {
1075
+ const [publishPromise] = pool.publish([relay], reply);
1076
+ if (!publishPromise) throw new Error(`Failed to create publish promise for relay ${relay}`);
1077
+ await publishPromise;
1078
+ const latency = Date.now() - startTime;
1079
+ cb?.recordSuccess();
1080
+ healthTracker.recordSuccess(relay, latency);
1081
+ return;
1082
+ } catch (err) {
1083
+ lastError = err;
1084
+ const latency = Date.now() - startTime;
1085
+ cb?.recordFailure();
1086
+ healthTracker.recordFailure(relay);
1087
+ metrics.emit("relay.error", 1, {
1088
+ relay,
1089
+ latency
1090
+ });
1091
+ onError?.(lastError, `publish to ${relay}`);
1092
+ }
1093
+ }
1094
+ throw new Error(`Failed to publish to any relay: ${lastError?.message}`);
1095
+ }
1096
+ //#endregion
1097
+ //#region extensions/nostr/src/gateway.ts
1098
+ const activeBuses = /* @__PURE__ */ new Map();
1099
+ const metricsSnapshots = /* @__PURE__ */ new Map();
1100
+ const ACCESS_GROUP_PREFIX = "accessGroup:";
1101
+ function parseNostrAccessGroupAllowFromEntry(entry) {
1102
+ const trimmed = entry.trim();
1103
+ if (!trimmed.startsWith(ACCESS_GROUP_PREFIX)) return null;
1104
+ return trimmed.slice(12).trim() || null;
1105
+ }
1106
+ function normalizeNostrAllowEntry(entry) {
1107
+ const trimmed = entry.trim();
1108
+ if (!trimmed) return null;
1109
+ if (trimmed === "*") return "*";
1110
+ const accessGroup = parseNostrAccessGroupAllowFromEntry(trimmed);
1111
+ if (accessGroup) return `accessGroup:${accessGroup}`;
1112
+ try {
1113
+ return normalizePubkey(trimmed.replace(/^nostr:/i, ""));
1114
+ } catch {
1115
+ return null;
1116
+ }
1117
+ }
1118
+ function normalizeNostrSenderPubkey(value) {
1119
+ try {
1120
+ return normalizePubkey(value);
1121
+ } catch {
1122
+ return null;
1123
+ }
1124
+ }
1125
+ const nostrIngressIdentity = {
1126
+ key: "nostr-pubkey",
1127
+ normalizeEntry: normalizeNostrAllowEntry,
1128
+ normalizeSubject: normalizeNostrSenderPubkey,
1129
+ sensitivity: "pii",
1130
+ entryIdPrefix: "nostr-entry"
1131
+ };
1132
+ const startNostrGatewayAccount = async (ctx) => {
1133
+ const account = ctx.account;
1134
+ ctx.setStatus({
1135
+ accountId: account.accountId,
1136
+ publicKey: account.publicKey
1137
+ });
1138
+ ctx.log?.info?.(`[${account.accountId}] starting Nostr provider (pubkey: ${account.publicKey})`);
1139
+ if (!account.configured) throw new Error("Nostr private key not configured");
1140
+ const runtime = getNostrRuntime();
1141
+ const pairing = createChannelPairingController({
1142
+ core: runtime,
1143
+ channel: "nostr",
1144
+ accountId: account.accountId
1145
+ });
1146
+ const resolveInboundAccess = async (senderPubkey, rawBody) => await resolveStableChannelMessageIngress({
1147
+ channelId: "nostr",
1148
+ accountId: account.accountId,
1149
+ identity: nostrIngressIdentity,
1150
+ cfg: ctx.cfg,
1151
+ useDefaultPairingStore: true,
1152
+ subject: { stableId: senderPubkey },
1153
+ conversation: {
1154
+ kind: "direct",
1155
+ id: senderPubkey
1156
+ },
1157
+ dmPolicy: account.config.dmPolicy ?? "pairing",
1158
+ allowFrom: account.config.allowFrom,
1159
+ command: runtime.channel.commands.shouldComputeCommandAuthorized(rawBody, ctx.cfg) ? { modeWhenAccessGroupsOff: "configured" } : void 0
1160
+ });
1161
+ let busHandle = null;
1162
+ const authorizeSender = async (input) => {
1163
+ const resolved = await resolveInboundAccess(input.senderId, "");
1164
+ if (resolved.senderAccess.decision === "allow") return "allow";
1165
+ if (resolved.senderAccess.decision === "pairing") {
1166
+ await pairing.issueChallenge({
1167
+ senderId: input.senderId,
1168
+ senderIdLine: `Your Nostr pubkey: ${input.senderId}`,
1169
+ sendPairingReply: input.reply,
1170
+ onCreated: () => {
1171
+ ctx.log?.debug?.(`[${account.accountId}] nostr pairing request sender=${input.senderId}`);
1172
+ },
1173
+ onReplyError: (err) => {
1174
+ ctx.log?.warn?.(`[${account.accountId}] nostr pairing reply failed for ${input.senderId}: ${String(err)}`);
1175
+ }
1176
+ });
1177
+ return "pairing";
1178
+ }
1179
+ ctx.log?.debug?.(`[${account.accountId}] blocked Nostr sender ${input.senderId} (${resolved.senderAccess.reasonCode})`);
1180
+ return "block";
1181
+ };
1182
+ const bus = await startNostrBus({
1183
+ accountId: account.accountId,
1184
+ privateKey: account.privateKey,
1185
+ relays: account.relays,
1186
+ authorizeSender: async ({ senderPubkey, reply }) => await authorizeSender({
1187
+ senderId: senderPubkey,
1188
+ reply
1189
+ }),
1190
+ onMessage: async (senderPubkey, text, reply, meta) => {
1191
+ const resolvedAccess = await resolveInboundAccess(senderPubkey, text);
1192
+ if (resolvedAccess.senderAccess.decision !== "allow") {
1193
+ ctx.log?.warn?.(`[${account.accountId}] dropping Nostr DM after preflight drift (${senderPubkey}, ${resolvedAccess.senderAccess.reasonCode})`);
1194
+ return;
1195
+ }
1196
+ const { dispatchInboundDirectDmWithRuntime } = await import("./inbound-direct-dm-runtime-CeYGU_Fo.js");
1197
+ await dispatchInboundDirectDmWithRuntime({
1198
+ cfg: ctx.cfg,
1199
+ runtime,
1200
+ channel: "nostr",
1201
+ channelLabel: "Nostr",
1202
+ accountId: account.accountId,
1203
+ peer: {
1204
+ kind: "direct",
1205
+ id: senderPubkey
1206
+ },
1207
+ senderId: senderPubkey,
1208
+ senderAddress: `nostr:${senderPubkey}`,
1209
+ recipientAddress: `nostr:${account.publicKey}`,
1210
+ conversationLabel: senderPubkey,
1211
+ rawBody: text,
1212
+ messageId: meta.eventId,
1213
+ timestamp: meta.createdAt * 1e3,
1214
+ commandAuthorized: resolvedAccess.commandAccess.requested ? resolvedAccess.commandAccess.authorized : void 0,
1215
+ deliver: async (payload) => {
1216
+ const outboundText = payload && typeof payload === "object" && "text" in payload ? payload.text ?? "" : "";
1217
+ if (!outboundText.trim()) return;
1218
+ const tableMode = runtime.channel.text.resolveMarkdownTableMode({
1219
+ cfg: ctx.cfg,
1220
+ channel: "nostr",
1221
+ accountId: account.accountId
1222
+ });
1223
+ await reply(runtime.channel.text.convertMarkdownTables(outboundText, tableMode));
1224
+ },
1225
+ onRecordError: (err) => {
1226
+ ctx.log?.error?.(`[${account.accountId}] failed recording Nostr inbound session: ${String(err)}`);
1227
+ },
1228
+ onDispatchError: (err, info) => {
1229
+ ctx.log?.error?.(`[${account.accountId}] Nostr ${info.kind} reply failed: ${String(err)}`);
1230
+ }
1231
+ });
1232
+ },
1233
+ onError: (error, context) => {
1234
+ ctx.log?.error?.(`[${account.accountId}] Nostr error (${context}): ${error.message}`);
1235
+ },
1236
+ onConnect: (relay) => {
1237
+ ctx.log?.debug?.(`[${account.accountId}] Connected to relay: ${relay}`);
1238
+ },
1239
+ onDisconnect: (relay) => {
1240
+ ctx.log?.debug?.(`[${account.accountId}] Disconnected from relay: ${relay}`);
1241
+ },
1242
+ onEose: (relays) => {
1243
+ ctx.log?.debug?.(`[${account.accountId}] EOSE received from relays: ${relays}`);
1244
+ },
1245
+ onMetric: (event) => {
1246
+ if (event.name.startsWith("event.rejected.")) ctx.log?.debug?.(`[${account.accountId}] Metric: ${event.name} ${JSON.stringify(event.labels)}`);
1247
+ else if (event.name === "relay.circuit_breaker.open") ctx.log?.warn?.(`[${account.accountId}] Circuit breaker opened for relay: ${event.labels?.relay}`);
1248
+ else if (event.name === "relay.circuit_breaker.close") ctx.log?.info?.(`[${account.accountId}] Circuit breaker closed for relay: ${event.labels?.relay}`);
1249
+ else if (event.name === "relay.error") ctx.log?.debug?.(`[${account.accountId}] Relay error: ${event.labels?.relay}`);
1250
+ if (busHandle) metricsSnapshots.set(account.accountId, busHandle.getMetrics());
1251
+ }
1252
+ });
1253
+ busHandle = bus;
1254
+ activeBuses.set(account.accountId, bus);
1255
+ ctx.log?.info?.(`[${account.accountId}] Nostr provider started, connected to ${account.relays.length} relay(s)`);
1256
+ return { stop: () => {
1257
+ bus.close();
1258
+ activeBuses.delete(account.accountId);
1259
+ metricsSnapshots.delete(account.accountId);
1260
+ ctx.log?.info?.(`[${account.accountId}] Nostr provider stopped`);
1261
+ } };
1262
+ };
1263
+ const nostrPairingTextAdapter = {
1264
+ idLabel: "nostrPubkey",
1265
+ message: "Your pairing request has been approved!",
1266
+ normalizeAllowEntry: (entry) => {
1267
+ try {
1268
+ return normalizePubkey(entry.trim().replace(/^nostr:/i, ""));
1269
+ } catch {
1270
+ return entry.trim();
1271
+ }
1272
+ },
1273
+ notify: async ({ cfg, id, message, accountId }) => {
1274
+ const bus = activeBuses.get(accountId ?? resolveDefaultNostrAccountId(cfg));
1275
+ if (bus) await bus.sendDm(id, message);
1276
+ }
1277
+ };
1278
+ const nostrOutboundAdapter = {
1279
+ deliveryMode: "direct",
1280
+ textChunkLimit: 4e3,
1281
+ deliveryCapabilities: { durableFinal: {
1282
+ text: true,
1283
+ messageSendingHooks: true
1284
+ } },
1285
+ sendText: async ({ cfg, to, text, accountId }) => {
1286
+ const core = getNostrRuntime();
1287
+ const aid = accountId ?? resolveDefaultNostrAccountId(cfg);
1288
+ const bus = activeBuses.get(aid);
1289
+ if (!bus) throw new Error(`Nostr bus not running for account ${aid}`);
1290
+ const tableMode = core.channel.text.resolveMarkdownTableMode({
1291
+ cfg,
1292
+ channel: "nostr",
1293
+ accountId: aid
1294
+ });
1295
+ const message = core.channel.text.convertMarkdownTables(text ?? "", tableMode);
1296
+ const normalizedTo = normalizePubkey(to);
1297
+ await bus.sendDm(normalizedTo, message);
1298
+ return attachChannelToResult("nostr", {
1299
+ to: normalizedTo,
1300
+ messageId: `nostr-${Date.now()}`
1301
+ });
1302
+ }
1303
+ };
1304
+ function getActiveNostrBuses() {
1305
+ return new Map(activeBuses);
1306
+ }
1307
+ //#endregion
1308
+ //#region extensions/nostr/src/session-route.ts
1309
+ function resolveNostrOutboundSessionRoute(params) {
1310
+ const target = stripChannelTargetPrefix(params.target, "nostr");
1311
+ if (!target) return null;
1312
+ return buildChannelOutboundSessionRoute({
1313
+ cfg: params.cfg,
1314
+ agentId: params.agentId,
1315
+ channel: "nostr",
1316
+ accountId: params.accountId,
1317
+ peer: {
1318
+ kind: "direct",
1319
+ id: target
1320
+ },
1321
+ chatType: "direct",
1322
+ from: `nostr:${target}`,
1323
+ to: `nostr:${target}`
1324
+ });
1325
+ }
1326
+ //#endregion
1327
+ //#region extensions/nostr/src/channel.ts
1328
+ const resolveNostrDmPolicy = createScopedDmSecurityResolver({
1329
+ channelKey: "nostr",
1330
+ resolvePolicy: (account) => account.config.dmPolicy,
1331
+ resolveAllowFrom: (account) => account.config.allowFrom,
1332
+ policyPathSuffix: "dmPolicy",
1333
+ defaultPolicy: "pairing",
1334
+ approveHint: formatPairingApproveHint("nostr"),
1335
+ normalizeEntry: (raw) => {
1336
+ try {
1337
+ return normalizePubkey(raw.trim().replace(/^nostr:/i, ""));
1338
+ } catch {
1339
+ return raw.trim();
1340
+ }
1341
+ }
1342
+ });
1343
+ const nostrConfigAdapter = createTopLevelChannelConfigAdapter({
1344
+ sectionKey: "nostr",
1345
+ resolveAccount: (cfg) => resolveNostrAccount({ cfg }),
1346
+ listAccountIds: listNostrAccountIds,
1347
+ defaultAccountId: resolveDefaultNostrAccountId,
1348
+ deleteMode: "clear-fields",
1349
+ clearBaseFields: [
1350
+ "name",
1351
+ "defaultAccount",
1352
+ "privateKey",
1353
+ "relays",
1354
+ "dmPolicy",
1355
+ "allowFrom",
1356
+ "profile"
1357
+ ],
1358
+ resolveAllowFrom: (account) => account.config.allowFrom,
1359
+ formatAllowFrom: (allowFrom) => allowFrom.map((entry) => String(entry).trim()).filter(Boolean).map((entry) => {
1360
+ if (entry === "*") return "*";
1361
+ try {
1362
+ return normalizePubkey(entry);
1363
+ } catch {
1364
+ return entry;
1365
+ }
1366
+ }).filter(Boolean)
1367
+ });
1368
+ const nostrMessageAdapter = createChannelMessageAdapterFromOutbound({
1369
+ id: "nostr",
1370
+ outbound: nostrOutboundAdapter
1371
+ });
1372
+ const nostrPlugin = createChatChannelPlugin({
1373
+ base: {
1374
+ id: "nostr",
1375
+ meta: {
1376
+ id: "nostr",
1377
+ label: "Nostr",
1378
+ selectionLabel: "Nostr",
1379
+ docsPath: "/channels/nostr",
1380
+ docsLabel: "nostr",
1381
+ blurb: "Decentralized DMs via Nostr relays (NIP-04)",
1382
+ order: 100
1383
+ },
1384
+ capabilities: {
1385
+ chatTypes: ["direct"],
1386
+ media: false
1387
+ },
1388
+ reload: { configPrefixes: ["channels.nostr"] },
1389
+ configSchema: buildChannelConfigSchema(NostrConfigSchema),
1390
+ setup: nostrSetupAdapter,
1391
+ setupWizard: nostrSetupWizard,
1392
+ config: {
1393
+ ...nostrConfigAdapter,
1394
+ isConfigured: (account) => account.configured,
1395
+ describeAccount: (account) => describeAccountSnapshot({
1396
+ account,
1397
+ configured: account.configured,
1398
+ extra: { publicKey: account.publicKey }
1399
+ })
1400
+ },
1401
+ messaging: {
1402
+ targetPrefixes: ["nostr"],
1403
+ normalizeTarget: (target) => {
1404
+ const cleaned = target.trim().replace(/^nostr:/i, "");
1405
+ try {
1406
+ return normalizePubkey(cleaned);
1407
+ } catch {
1408
+ return cleaned;
1409
+ }
1410
+ },
1411
+ targetResolver: {
1412
+ looksLikeId: (input) => {
1413
+ const trimmed = input.trim();
1414
+ return trimmed.startsWith("npub1") || /^[0-9a-fA-F]{64}$/.test(trimmed);
1415
+ },
1416
+ hint: "<npub|hex pubkey|nostr:npub...>"
1417
+ },
1418
+ resolveOutboundSessionRoute: (params) => resolveNostrOutboundSessionRoute(params)
1419
+ },
1420
+ message: nostrMessageAdapter,
1421
+ status: { ...createComputedAccountStatusAdapter({
1422
+ defaultRuntime: createDefaultChannelRuntimeState(DEFAULT_ACCOUNT_ID),
1423
+ collectStatusIssues: (accounts) => collectStatusIssuesFromLastError("nostr", accounts),
1424
+ buildChannelSummary: ({ snapshot }) => buildPassiveChannelStatusSummary(snapshot, { publicKey: snapshot.publicKey ?? null }),
1425
+ resolveAccountSnapshot: ({ account, runtime }) => ({
1426
+ accountId: account.accountId,
1427
+ name: account.name,
1428
+ enabled: account.enabled,
1429
+ configured: account.configured,
1430
+ extra: {
1431
+ publicKey: account.publicKey,
1432
+ profile: account.profile,
1433
+ ...buildTrafficStatusSummary(runtime)
1434
+ }
1435
+ })
1436
+ }) },
1437
+ gateway: { startAccount: startNostrGatewayAccount }
1438
+ },
1439
+ pairing: { text: nostrPairingTextAdapter },
1440
+ security: { resolveDmPolicy: resolveNostrDmPolicy },
1441
+ outbound: nostrOutboundAdapter
1442
+ });
1443
+ /**
1444
+ * Publish a profile (kind:0) for a Nostr account.
1445
+ * @param accountId - Account ID (defaults to "default")
1446
+ * @param profile - Profile data to publish
1447
+ * @returns Publish results with successes and failures
1448
+ * @throws Error if account is not running
1449
+ */
1450
+ async function publishNostrProfile(accountId, profile) {
1451
+ const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
1452
+ const bus = getActiveNostrBuses().get(resolvedAccountId);
1453
+ if (!bus) throw new Error(`Nostr bus not running for account ${resolvedAccountId}`);
1454
+ return bus.publishProfile(profile);
1455
+ }
1456
+ /**
1457
+ * Get profile publish state for a Nostr account.
1458
+ * @param accountId - Account ID (defaults to "default")
1459
+ * @returns Profile publish state or null if account not running
1460
+ */
1461
+ async function getNostrProfileState(accountId = DEFAULT_ACCOUNT_ID) {
1462
+ const bus = getActiveNostrBuses().get(accountId);
1463
+ if (!bus) return null;
1464
+ return bus.getProfileState();
1465
+ }
1466
+ //#endregion
1467
+ export { setNostrRuntime as a, getNostrRuntime as i, nostrPlugin as n, contentToProfile as o, publishNostrProfile as r, getNostrProfileState as t };