instar 1.3.373 → 1.3.375
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.
- package/dist/commands/server.d.ts +6 -0
- package/dist/commands/server.d.ts.map +1 -1
- package/dist/commands/server.js +42 -4
- package/dist/commands/server.js.map +1 -1
- package/dist/server/AgentServer.d.ts +9 -0
- package/dist/server/AgentServer.d.ts.map +1 -1
- package/dist/server/AgentServer.js +10 -0
- package/dist/server/AgentServer.js.map +1 -1
- package/dist/server/routes.d.ts.map +1 -1
- package/dist/server/routes.js +69 -0
- package/dist/server/routes.js.map +1 -1
- package/dist/users/TopicOperatorStore.d.ts.map +1 -1
- package/dist/users/TopicOperatorStore.js +8 -0
- package/dist/users/TopicOperatorStore.js.map +1 -1
- package/package.json +1 -1
- package/src/data/builtin-manifest.json +47 -47
- package/upgrades/1.3.375.md +88 -0
- package/upgrades/side-effects/topic-operator-polling-bind-inc2e.md +62 -0
- package/upgrades/side-effects/transfer-place-half-journal.md +74 -0
- package/upgrades/topic-operator-polling-bind-inc2e.eli16.md +56 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"TopicOperatorStore.d.ts","sourceRoot":"","sources":["../../src/users/TopicOperatorStore.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAErF,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACrD,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;uEACmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,KAAK,CAA8C;gBAE/C,QAAQ,EAAE,MAAM;IAI5B,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,IAAI;IAMZ;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/E,aAAa,GAAG,IAAI;
|
|
1
|
+
{"version":3,"file":"TopicOperatorStore.d.ts","sourceRoot":"","sources":["../../src/users/TopicOperatorStore.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAErF,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACrD,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;uEACmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,KAAK,CAA8C;gBAE/C,QAAQ,EAAE,MAAM;IAI5B,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,IAAI;IAMZ;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/E,aAAa,GAAG,IAAI;IAwBvB,4DAA4D;IAC5D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,IAAI;IAI3D;oFACgF;IAChF,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAKrE,mCAAmC;IACnC,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IAIpC;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;CAY7D"}
|
|
@@ -66,6 +66,14 @@ export class TopicOperatorStore {
|
|
|
66
66
|
boundAt: input.boundAt ?? '',
|
|
67
67
|
boundFrom: 'authenticated-inbound',
|
|
68
68
|
};
|
|
69
|
+
// Idempotency guard: both inbound ingress paths (lifeline-forward #909 and
|
|
70
|
+
// the polling seam, increment 2e) re-bind on EVERY message from the operator.
|
|
71
|
+
// When the stored record is already identical, skip the disk write — the
|
|
72
|
+
// re-bind is then a pure read, not a per-message file rewrite.
|
|
73
|
+
const existing = this.load()[String(topicId)];
|
|
74
|
+
if (existing && JSON.stringify(existing) === JSON.stringify(record)) {
|
|
75
|
+
return existing;
|
|
76
|
+
}
|
|
69
77
|
const map = { ...this.load() };
|
|
70
78
|
map[String(topicId)] = record;
|
|
71
79
|
this.save(map);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"TopicOperatorStore.js","sourceRoot":"","sources":["../../src/users/TopicOperatorStore.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"TopicOperatorStore.js","sourceRoot":"","sources":["../../src/users/TopicOperatorStore.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "./builtin-manifest.schema.json",
|
|
3
3
|
"schemaVersion": 1,
|
|
4
|
-
"generatedAt": "2026-06-
|
|
5
|
-
"instarVersion": "1.3.
|
|
4
|
+
"generatedAt": "2026-06-06T17:27:52.711Z",
|
|
5
|
+
"instarVersion": "1.3.375",
|
|
6
6
|
"entryCount": 199,
|
|
7
7
|
"entries": {
|
|
8
8
|
"hook:session-start": {
|
|
@@ -418,7 +418,7 @@
|
|
|
418
418
|
"type": "route-group",
|
|
419
419
|
"domain": "monitoring",
|
|
420
420
|
"sourcePath": "src/server/routes.ts",
|
|
421
|
-
"contentHash": "
|
|
421
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
422
422
|
"since": "2025-01-01"
|
|
423
423
|
},
|
|
424
424
|
"route-group:agents": {
|
|
@@ -426,7 +426,7 @@
|
|
|
426
426
|
"type": "route-group",
|
|
427
427
|
"domain": "sessions",
|
|
428
428
|
"sourcePath": "src/server/routes.ts",
|
|
429
|
-
"contentHash": "
|
|
429
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
430
430
|
"since": "2025-01-01"
|
|
431
431
|
},
|
|
432
432
|
"route-group:backups": {
|
|
@@ -434,7 +434,7 @@
|
|
|
434
434
|
"type": "route-group",
|
|
435
435
|
"domain": "operations",
|
|
436
436
|
"sourcePath": "src/server/routes.ts",
|
|
437
|
-
"contentHash": "
|
|
437
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
438
438
|
"since": "2025-01-01"
|
|
439
439
|
},
|
|
440
440
|
"route-group:git": {
|
|
@@ -442,7 +442,7 @@
|
|
|
442
442
|
"type": "route-group",
|
|
443
443
|
"domain": "coordination",
|
|
444
444
|
"sourcePath": "src/server/routes.ts",
|
|
445
|
-
"contentHash": "
|
|
445
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
446
446
|
"since": "2025-01-01"
|
|
447
447
|
},
|
|
448
448
|
"route-group:memory": {
|
|
@@ -450,7 +450,7 @@
|
|
|
450
450
|
"type": "route-group",
|
|
451
451
|
"domain": "memory",
|
|
452
452
|
"sourcePath": "src/server/routes.ts",
|
|
453
|
-
"contentHash": "
|
|
453
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
454
454
|
"since": "2025-01-01"
|
|
455
455
|
},
|
|
456
456
|
"route-group:semantic": {
|
|
@@ -458,7 +458,7 @@
|
|
|
458
458
|
"type": "route-group",
|
|
459
459
|
"domain": "memory",
|
|
460
460
|
"sourcePath": "src/server/routes.ts",
|
|
461
|
-
"contentHash": "
|
|
461
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
462
462
|
"since": "2025-01-01"
|
|
463
463
|
},
|
|
464
464
|
"route-group:status": {
|
|
@@ -466,7 +466,7 @@
|
|
|
466
466
|
"type": "route-group",
|
|
467
467
|
"domain": "monitoring",
|
|
468
468
|
"sourcePath": "src/server/routes.ts",
|
|
469
|
-
"contentHash": "
|
|
469
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
470
470
|
"since": "2025-01-01"
|
|
471
471
|
},
|
|
472
472
|
"route-group:capabilities": {
|
|
@@ -474,7 +474,7 @@
|
|
|
474
474
|
"type": "route-group",
|
|
475
475
|
"domain": "mapping",
|
|
476
476
|
"sourcePath": "src/server/routes.ts",
|
|
477
|
-
"contentHash": "
|
|
477
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
478
478
|
"since": "2025-01-01"
|
|
479
479
|
},
|
|
480
480
|
"route-group:project-map": {
|
|
@@ -482,7 +482,7 @@
|
|
|
482
482
|
"type": "route-group",
|
|
483
483
|
"domain": "mapping",
|
|
484
484
|
"sourcePath": "src/server/routes.ts",
|
|
485
|
-
"contentHash": "
|
|
485
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
486
486
|
"since": "2025-01-01"
|
|
487
487
|
},
|
|
488
488
|
"route-group:coherence": {
|
|
@@ -490,7 +490,7 @@
|
|
|
490
490
|
"type": "route-group",
|
|
491
491
|
"domain": "coherence",
|
|
492
492
|
"sourcePath": "src/server/routes.ts",
|
|
493
|
-
"contentHash": "
|
|
493
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
494
494
|
"since": "2025-01-01"
|
|
495
495
|
},
|
|
496
496
|
"route-group:topic-bindings": {
|
|
@@ -498,7 +498,7 @@
|
|
|
498
498
|
"type": "route-group",
|
|
499
499
|
"domain": "sessions",
|
|
500
500
|
"sourcePath": "src/server/routes.ts",
|
|
501
|
-
"contentHash": "
|
|
501
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
502
502
|
"since": "2025-01-01"
|
|
503
503
|
},
|
|
504
504
|
"route-group:context": {
|
|
@@ -506,7 +506,7 @@
|
|
|
506
506
|
"type": "route-group",
|
|
507
507
|
"domain": "context",
|
|
508
508
|
"sourcePath": "src/server/routes.ts",
|
|
509
|
-
"contentHash": "
|
|
509
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
510
510
|
"since": "2025-01-01"
|
|
511
511
|
},
|
|
512
512
|
"route-group:scope-coherence": {
|
|
@@ -514,7 +514,7 @@
|
|
|
514
514
|
"type": "route-group",
|
|
515
515
|
"domain": "coherence",
|
|
516
516
|
"sourcePath": "src/server/routes.ts",
|
|
517
|
-
"contentHash": "
|
|
517
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
518
518
|
"since": "2025-01-01"
|
|
519
519
|
},
|
|
520
520
|
"route-group:canonical-state": {
|
|
@@ -522,7 +522,7 @@
|
|
|
522
522
|
"type": "route-group",
|
|
523
523
|
"domain": "state",
|
|
524
524
|
"sourcePath": "src/server/routes.ts",
|
|
525
|
-
"contentHash": "
|
|
525
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
526
526
|
"since": "2025-01-01"
|
|
527
527
|
},
|
|
528
528
|
"route-group:ci": {
|
|
@@ -530,7 +530,7 @@
|
|
|
530
530
|
"type": "route-group",
|
|
531
531
|
"domain": "monitoring",
|
|
532
532
|
"sourcePath": "src/server/routes.ts",
|
|
533
|
-
"contentHash": "
|
|
533
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
534
534
|
"since": "2025-01-01"
|
|
535
535
|
},
|
|
536
536
|
"route-group:sessions": {
|
|
@@ -538,7 +538,7 @@
|
|
|
538
538
|
"type": "route-group",
|
|
539
539
|
"domain": "sessions",
|
|
540
540
|
"sourcePath": "src/server/routes.ts",
|
|
541
|
-
"contentHash": "
|
|
541
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
542
542
|
"since": "2025-01-01"
|
|
543
543
|
},
|
|
544
544
|
"route-group:jobs": {
|
|
@@ -546,7 +546,7 @@
|
|
|
546
546
|
"type": "route-group",
|
|
547
547
|
"domain": "scheduling",
|
|
548
548
|
"sourcePath": "src/server/routes.ts",
|
|
549
|
-
"contentHash": "
|
|
549
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
550
550
|
"since": "2025-01-01"
|
|
551
551
|
},
|
|
552
552
|
"route-group:skip-ledger": {
|
|
@@ -554,7 +554,7 @@
|
|
|
554
554
|
"type": "route-group",
|
|
555
555
|
"domain": "scheduling",
|
|
556
556
|
"sourcePath": "src/server/routes.ts",
|
|
557
|
-
"contentHash": "
|
|
557
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
558
558
|
"since": "2025-01-01"
|
|
559
559
|
},
|
|
560
560
|
"route-group:telegram": {
|
|
@@ -562,7 +562,7 @@
|
|
|
562
562
|
"type": "route-group",
|
|
563
563
|
"domain": "communication",
|
|
564
564
|
"sourcePath": "src/server/routes.ts",
|
|
565
|
-
"contentHash": "
|
|
565
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
566
566
|
"since": "2025-01-01"
|
|
567
567
|
},
|
|
568
568
|
"route-group:attention": {
|
|
@@ -570,7 +570,7 @@
|
|
|
570
570
|
"type": "route-group",
|
|
571
571
|
"domain": "communication",
|
|
572
572
|
"sourcePath": "src/server/routes.ts",
|
|
573
|
-
"contentHash": "
|
|
573
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
574
574
|
"since": "2025-01-01"
|
|
575
575
|
},
|
|
576
576
|
"route-group:relationships": {
|
|
@@ -578,7 +578,7 @@
|
|
|
578
578
|
"type": "route-group",
|
|
579
579
|
"domain": "relationships",
|
|
580
580
|
"sourcePath": "src/server/routes.ts",
|
|
581
|
-
"contentHash": "
|
|
581
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
582
582
|
"since": "2025-01-01"
|
|
583
583
|
},
|
|
584
584
|
"route-group:feedback": {
|
|
@@ -586,7 +586,7 @@
|
|
|
586
586
|
"type": "route-group",
|
|
587
587
|
"domain": "feedback",
|
|
588
588
|
"sourcePath": "src/server/routes.ts",
|
|
589
|
-
"contentHash": "
|
|
589
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
590
590
|
"since": "2025-01-01"
|
|
591
591
|
},
|
|
592
592
|
"route-group:updates": {
|
|
@@ -594,7 +594,7 @@
|
|
|
594
594
|
"type": "route-group",
|
|
595
595
|
"domain": "updates",
|
|
596
596
|
"sourcePath": "src/server/routes.ts",
|
|
597
|
-
"contentHash": "
|
|
597
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
598
598
|
"since": "2025-01-01"
|
|
599
599
|
},
|
|
600
600
|
"route-group:dispatches": {
|
|
@@ -602,7 +602,7 @@
|
|
|
602
602
|
"type": "route-group",
|
|
603
603
|
"domain": "dispatches",
|
|
604
604
|
"sourcePath": "src/server/routes.ts",
|
|
605
|
-
"contentHash": "
|
|
605
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
606
606
|
"since": "2025-01-01"
|
|
607
607
|
},
|
|
608
608
|
"route-group:quota": {
|
|
@@ -610,7 +610,7 @@
|
|
|
610
610
|
"type": "route-group",
|
|
611
611
|
"domain": "monitoring",
|
|
612
612
|
"sourcePath": "src/server/routes.ts",
|
|
613
|
-
"contentHash": "
|
|
613
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
614
614
|
"since": "2025-01-01"
|
|
615
615
|
},
|
|
616
616
|
"route-group:publishing": {
|
|
@@ -618,7 +618,7 @@
|
|
|
618
618
|
"type": "route-group",
|
|
619
619
|
"domain": "publishing",
|
|
620
620
|
"sourcePath": "src/server/routes.ts",
|
|
621
|
-
"contentHash": "
|
|
621
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
622
622
|
"since": "2025-01-01"
|
|
623
623
|
},
|
|
624
624
|
"route-group:private-views": {
|
|
@@ -626,7 +626,7 @@
|
|
|
626
626
|
"type": "route-group",
|
|
627
627
|
"domain": "publishing",
|
|
628
628
|
"sourcePath": "src/server/routes.ts",
|
|
629
|
-
"contentHash": "
|
|
629
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
630
630
|
"since": "2025-01-01"
|
|
631
631
|
},
|
|
632
632
|
"route-group:tunnel": {
|
|
@@ -634,7 +634,7 @@
|
|
|
634
634
|
"type": "route-group",
|
|
635
635
|
"domain": "networking",
|
|
636
636
|
"sourcePath": "src/server/routes.ts",
|
|
637
|
-
"contentHash": "
|
|
637
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
638
638
|
"since": "2025-01-01"
|
|
639
639
|
},
|
|
640
640
|
"route-group:events": {
|
|
@@ -642,7 +642,7 @@
|
|
|
642
642
|
"type": "route-group",
|
|
643
643
|
"domain": "networking",
|
|
644
644
|
"sourcePath": "src/server/routes.ts",
|
|
645
|
-
"contentHash": "
|
|
645
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
646
646
|
"since": "2025-01-01"
|
|
647
647
|
},
|
|
648
648
|
"route-group:evolution": {
|
|
@@ -650,7 +650,7 @@
|
|
|
650
650
|
"type": "route-group",
|
|
651
651
|
"domain": "evolution",
|
|
652
652
|
"sourcePath": "src/server/routes.ts",
|
|
653
|
-
"contentHash": "
|
|
653
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
654
654
|
"since": "2025-01-01"
|
|
655
655
|
},
|
|
656
656
|
"route-group:watchdog": {
|
|
@@ -658,7 +658,7 @@
|
|
|
658
658
|
"type": "route-group",
|
|
659
659
|
"domain": "monitoring",
|
|
660
660
|
"sourcePath": "src/server/routes.ts",
|
|
661
|
-
"contentHash": "
|
|
661
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
662
662
|
"since": "2025-01-01"
|
|
663
663
|
},
|
|
664
664
|
"route-group:topic-memory": {
|
|
@@ -666,7 +666,7 @@
|
|
|
666
666
|
"type": "route-group",
|
|
667
667
|
"domain": "memory",
|
|
668
668
|
"sourcePath": "src/server/routes.ts",
|
|
669
|
-
"contentHash": "
|
|
669
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
670
670
|
"since": "2025-01-01"
|
|
671
671
|
},
|
|
672
672
|
"route-group:state-sync": {
|
|
@@ -674,7 +674,7 @@
|
|
|
674
674
|
"type": "route-group",
|
|
675
675
|
"domain": "coordination",
|
|
676
676
|
"sourcePath": "src/server/routes.ts",
|
|
677
|
-
"contentHash": "
|
|
677
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
678
678
|
"since": "2025-01-01"
|
|
679
679
|
},
|
|
680
680
|
"route-group:intent": {
|
|
@@ -682,7 +682,7 @@
|
|
|
682
682
|
"type": "route-group",
|
|
683
683
|
"domain": "intent",
|
|
684
684
|
"sourcePath": "src/server/routes.ts",
|
|
685
|
-
"contentHash": "
|
|
685
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
686
686
|
"since": "2025-01-01"
|
|
687
687
|
},
|
|
688
688
|
"route-group:triage": {
|
|
@@ -690,7 +690,7 @@
|
|
|
690
690
|
"type": "route-group",
|
|
691
691
|
"domain": "safety",
|
|
692
692
|
"sourcePath": "src/server/routes.ts",
|
|
693
|
-
"contentHash": "
|
|
693
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
694
694
|
"since": "2025-01-01"
|
|
695
695
|
},
|
|
696
696
|
"route-group:operations": {
|
|
@@ -698,7 +698,7 @@
|
|
|
698
698
|
"type": "route-group",
|
|
699
699
|
"domain": "safety",
|
|
700
700
|
"sourcePath": "src/server/routes.ts",
|
|
701
|
-
"contentHash": "
|
|
701
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
702
702
|
"since": "2025-01-01"
|
|
703
703
|
},
|
|
704
704
|
"route-group:sentinel": {
|
|
@@ -706,7 +706,7 @@
|
|
|
706
706
|
"type": "route-group",
|
|
707
707
|
"domain": "safety",
|
|
708
708
|
"sourcePath": "src/server/routes.ts",
|
|
709
|
-
"contentHash": "
|
|
709
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
710
710
|
"since": "2025-01-01"
|
|
711
711
|
},
|
|
712
712
|
"route-group:trust": {
|
|
@@ -714,7 +714,7 @@
|
|
|
714
714
|
"type": "route-group",
|
|
715
715
|
"domain": "safety",
|
|
716
716
|
"sourcePath": "src/server/routes.ts",
|
|
717
|
-
"contentHash": "
|
|
717
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
718
718
|
"since": "2025-01-01"
|
|
719
719
|
},
|
|
720
720
|
"route-group:monitoring": {
|
|
@@ -722,7 +722,7 @@
|
|
|
722
722
|
"type": "route-group",
|
|
723
723
|
"domain": "monitoring",
|
|
724
724
|
"sourcePath": "src/server/routes.ts",
|
|
725
|
-
"contentHash": "
|
|
725
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
726
726
|
"since": "2025-01-01"
|
|
727
727
|
},
|
|
728
728
|
"route-group:commitments": {
|
|
@@ -730,7 +730,7 @@
|
|
|
730
730
|
"type": "route-group",
|
|
731
731
|
"domain": "commitments",
|
|
732
732
|
"sourcePath": "src/server/routes.ts",
|
|
733
|
-
"contentHash": "
|
|
733
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
734
734
|
"since": "2025-01-01"
|
|
735
735
|
},
|
|
736
736
|
"route-group:episodes": {
|
|
@@ -738,7 +738,7 @@
|
|
|
738
738
|
"type": "route-group",
|
|
739
739
|
"domain": "memory",
|
|
740
740
|
"sourcePath": "src/server/routes.ts",
|
|
741
|
-
"contentHash": "
|
|
741
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
742
742
|
"since": "2025-01-01"
|
|
743
743
|
},
|
|
744
744
|
"route-group:messages": {
|
|
@@ -746,7 +746,7 @@
|
|
|
746
746
|
"type": "route-group",
|
|
747
747
|
"domain": "coordination",
|
|
748
748
|
"sourcePath": "src/server/routes.ts",
|
|
749
|
-
"contentHash": "
|
|
749
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
750
750
|
"since": "2025-01-01"
|
|
751
751
|
},
|
|
752
752
|
"route-group:system-reviews": {
|
|
@@ -754,7 +754,7 @@
|
|
|
754
754
|
"type": "route-group",
|
|
755
755
|
"domain": "monitoring",
|
|
756
756
|
"sourcePath": "src/server/routes.ts",
|
|
757
|
-
"contentHash": "
|
|
757
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
758
758
|
"since": "2025-01-01"
|
|
759
759
|
},
|
|
760
760
|
"route-group:machine-mesh": {
|
|
@@ -770,7 +770,7 @@
|
|
|
770
770
|
"type": "route-group",
|
|
771
771
|
"domain": "security",
|
|
772
772
|
"sourcePath": "src/server/routes.ts",
|
|
773
|
-
"contentHash": "
|
|
773
|
+
"contentHash": "0c773d13455cad3b10e084501775f77ca5970e94b381f34af58ce2bddc8e94db",
|
|
774
774
|
"since": "2025-01-01"
|
|
775
775
|
},
|
|
776
776
|
"cli:init": {
|
|
@@ -1506,7 +1506,7 @@
|
|
|
1506
1506
|
"type": "subsystem",
|
|
1507
1507
|
"domain": "server",
|
|
1508
1508
|
"sourcePath": "src/server/AgentServer.ts",
|
|
1509
|
-
"contentHash": "
|
|
1509
|
+
"contentHash": "4b3de410b5b3d64bf7545f9323689637b9b83ecb42a43c6e5d7c41ce81a340f6",
|
|
1510
1510
|
"since": "2025-01-01"
|
|
1511
1511
|
},
|
|
1512
1512
|
"subsystem:session-manager": {
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Upgrade Guide — vNEXT
|
|
2
|
+
|
|
3
|
+
<!-- assembled-by: assemble-next-md -->
|
|
4
|
+
<!-- bump: patch -->
|
|
5
|
+
|
|
6
|
+
## What Changed
|
|
7
|
+
|
|
8
|
+
The verified topic operator is now recorded automatically on BOTH inbound
|
|
9
|
+
ingress paths (Know Your Principal standard, security-build increment 2e — the
|
|
10
|
+
final operator-binding gap). Increment 2d covered only the lifeline-forward
|
|
11
|
+
route; the adapter long-poll (no-lifeline) path never bound. The bind now lives
|
|
12
|
+
at the shared `onTopicMessage` seam (`wireTelegramRouting`), guarded by
|
|
13
|
+
`isAuthorizedSender` — load-bearing there, because the seam also fires for
|
|
14
|
+
unauthorized senders. The seam resolves the server's own store instance
|
|
15
|
+
late-bound (a second instance on the same file would lose updates between the
|
|
16
|
+
two in-memory caches), and `TopicOperatorStore.setOperator` now skips the disk
|
|
17
|
+
write when the record is unchanged (per-message re-binds become pure reads).
|
|
18
|
+
|
|
19
|
+
`POST /pool/transfer` of a QUIET topic (never-seen or released ownership
|
|
20
|
+
record) previously journaled NOTHING: the placement pin is router-local and
|
|
21
|
+
the handler's release half only fires when the router itself held ownership.
|
|
22
|
+
The pinned-to machine therefore could never prove the topic was its to serve —
|
|
23
|
+
its working-set fetch reflex answered `not-owner` even after the #926 (pin
|
|
24
|
+
fallback) and #930 (journal-placement fallback) read-side fixes deployed,
|
|
25
|
+
because no machine ever PRODUCED the evidence those fallbacks read (coherence
|
|
26
|
+
live-proof finding #5, proven on v1.3.372).
|
|
27
|
+
|
|
28
|
+
The transfer handler now lands the PLACE half: it CASes `place→claim` for the
|
|
29
|
+
target as one synchronous pair (the bug-#11 confirmClaim precedent — the
|
|
30
|
+
record never rests at `placing`, the shape that queues every later message as
|
|
31
|
+
ownership-contention), and each landed CAS journals a topic-placement entry at
|
|
32
|
+
its real epoch (§3.3 call-site pairing) so the evidence replicates to the
|
|
33
|
+
target machine. A resting `placing` record naming the target is repaired via
|
|
34
|
+
claim. An active record held by a non-target machine is never stolen; any
|
|
35
|
+
other in-flight shape is left strictly untouched.
|
|
36
|
+
|
|
37
|
+
## What to Tell Your User
|
|
38
|
+
|
|
39
|
+
Nothing user-facing changes. Foundation wiring (experimental) for the identity
|
|
40
|
+
isolation security work: the agent now learns its verified operator from
|
|
41
|
+
authorized inbound messages no matter how its Telegram connection is set up.
|
|
42
|
+
Only authorized senders are ever recorded, and a recording failure never
|
|
43
|
+
affects message handling.
|
|
44
|
+
|
|
45
|
+
Nothing proactively — this is internal coherence plumbing. If they previously
|
|
46
|
+
moved a quiet conversation between machines and the receiving machine couldn't
|
|
47
|
+
fetch its files, that path now works: the move itself writes the ownership
|
|
48
|
+
record and it travels to the receiving machine automatically.
|
|
49
|
+
|
|
50
|
+
- audience: agent-only
|
|
51
|
+
- maturity: stable
|
|
52
|
+
|
|
53
|
+
## Summary of New Capabilities
|
|
54
|
+
|
|
55
|
+
- Operator auto-bind at the `onTopicMessage` convergence seam (covers the
|
|
56
|
+
polling path; authorized senders only; fail-soft; pre-boot messages bind
|
|
57
|
+
nothing, fail-safe).
|
|
58
|
+
- `AgentServer.getTopicOperatorStore()` — public accessor for the seam's
|
|
59
|
+
late-bound store resolution.
|
|
60
|
+
- `TopicOperatorStore.setOperator` idempotency: identical record → no disk
|
|
61
|
+
write.
|
|
62
|
+
|
|
63
|
+
- Quiet-topic transfers journal ownership evidence (place + claim halves, real
|
|
64
|
+
epochs, `reason: 'user-move'`) that replicates to the pinned-to machine —
|
|
65
|
+
unblocking its working-set fetch reflex (#930 fallback finally has a producer).
|
|
66
|
+
- Half-placed leftovers (resting `placing` records naming the target) are
|
|
67
|
+
repaired on the next transfer of that topic.
|
|
68
|
+
- `POST /pool/transfer` response gains `placedOwnership` (whether confirmed
|
|
69
|
+
ownership landed on the target as part of the move).
|
|
70
|
+
|
|
71
|
+
## Evidence
|
|
72
|
+
|
|
73
|
+
Verified by 6 Tier-1 unit tests (`topic-operator-polling-bind`: authorized
|
|
74
|
+
binds, unauthorized Caroline refusal, null store / getter throw / setOperator
|
|
75
|
+
throw all fail-soft with routing continuing, missing uid no-op), 2 Tier-1 store
|
|
76
|
+
tests (idempotent skip both sides), and 3 Tier-2 integration tests
|
|
77
|
+
(`topic-operator-polling-bind`: full Caroline replay through the seam,
|
|
78
|
+
single-instance no-clobber across two topics on disk, pre-construction →
|
|
79
|
+
post-construction lifecycle). All 60 existing topic-operator/session-context
|
|
80
|
+
canaries and 13 e2e lifecycle tests stay green. Clean `tsc --noEmit`.
|
|
81
|
+
|
|
82
|
+
- `tests/integration/pool-placement-transfer-routes.test.ts` — 6 new boundary
|
|
83
|
+
tests: quiet/never-seen (both halves journaled, record lands `active`),
|
|
84
|
+
self-owned (release + place + confirm, 3 entries), active-other (never
|
|
85
|
+
stolen), active-target (no-op, no epoch bump), resting-placing-target
|
|
86
|
+
(claim repair), placing-other (strictly untouched). 17/17 in file.
|
|
87
|
+
- `lint-cas-emit-placement` clean — 8 CAS call sites, all paired.
|
|
88
|
+
- Typecheck clean; full suite green on pre-push.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Side-effects review — Topic Operator polling-path auto-bind (Know Your Principal #898, increment 2e)
|
|
2
|
+
|
|
3
|
+
## What this change does
|
|
4
|
+
Closes the auto-bind gap #909 documented: the adapter long-poll (no-lifeline)
|
|
5
|
+
ingress path never bound the verified operator. The bind now lives at the
|
|
6
|
+
`onTopicMessage` seam in `wireTelegramRouting` (src/commands/server.ts) — the
|
|
7
|
+
convergence point BOTH ingress paths reach — so a no-lifeline install learns its
|
|
8
|
+
operator too. Three coordinated pieces:
|
|
9
|
+
|
|
10
|
+
- `wireTelegramRouting` gains a late-bound `getTopicOperatorStore` parameter
|
|
11
|
+
(the `getHubDeps` precedent in the same function) and an additive bind block
|
|
12
|
+
early in the callback: an AUTHENTICATED + AUTHORIZED sender is recorded as the
|
|
13
|
+
topic's verified operator.
|
|
14
|
+
- `AgentServer.getTopicOperatorStore()` — public read-only accessor so the seam
|
|
15
|
+
resolves the server's OWN store instance at message-time.
|
|
16
|
+
- `TopicOperatorStore.setOperator` idempotency guard: an identical record skips
|
|
17
|
+
the disk write (both paths re-bind per message; unchanged = pure read).
|
|
18
|
+
|
|
19
|
+
## The load-bearing security property
|
|
20
|
+
The seam fires for unauthorized senders too — the lifeline path only skips its
|
|
21
|
+
own bind, it does not drop the message. So the `isAuthorizedSender` check INSIDE
|
|
22
|
+
the seam bind is load-bearing: without it, an unauthorized group member could
|
|
23
|
+
seat themselves as operator (the cross-principal "Caroline" bug). The
|
|
24
|
+
integration Caroline replay proves the refusal — an unauthorized sender with
|
|
25
|
+
`firstName: "Caroline"` cannot displace the bound operator.
|
|
26
|
+
|
|
27
|
+
## Why the SAME store instance (the lost-update hazard)
|
|
28
|
+
`TopicOperatorStore` caches its map in memory (`this.cache`). A second instance
|
|
29
|
+
on the same file would hold a divergent cache: a record written through one
|
|
30
|
+
instance disappears from the other's next full-map save. The original Inc-2e
|
|
31
|
+
scout suggested constructing a fresh store inside the callback — that design is
|
|
32
|
+
REJECTED here for exactly this reason. Instead the seam resolves
|
|
33
|
+
`AgentServer.getTopicOperatorStore()` late-bound (module-level `_agentServerRef`
|
|
34
|
+
assigned right after construction; the server is built long after routing is
|
|
35
|
+
wired). The integration no-clobber test pins the invariant.
|
|
36
|
+
|
|
37
|
+
## Blast radius (hot path — reviewed carefully)
|
|
38
|
+
- **Additive + fail-soft.** The bind block is wrapped in try/catch; a getter
|
|
39
|
+
error, store error, or missing uid logs and falls through — message routing
|
|
40
|
+
is never affected. Proven by unit tests (getter throws / setOperator throws /
|
|
41
|
+
null store → handleCommand still runs).
|
|
42
|
+
- **Pre-construction window.** Messages arriving before `_agentServerRef` is
|
|
43
|
+
assigned bind nothing (getter → null). Fail-safe: no binding means "unknown",
|
|
44
|
+
never a wrong operator. Lifecycle test covers the transition.
|
|
45
|
+
- **Lifeline double-bind.** On the lifeline path both the routes-side bind
|
|
46
|
+
(#909) and the seam bind run — same instance, same record; the new
|
|
47
|
+
idempotency guard makes the second a no-op read.
|
|
48
|
+
- **Disk-write reduction (behavior change, benign).** `setOperator` with a
|
|
49
|
+
byte-identical record no longer rewrites the file. Callers only ever read the
|
|
50
|
+
returned record or the store state — both unchanged. Existing store tests
|
|
51
|
+
(12) stay green; 2 new tests pin both sides (identical skips, changed
|
|
52
|
+
writes).
|
|
53
|
+
- **No new route / config key / dependency.** `wireTelegramRouting` is now
|
|
54
|
+
exported (test seam only; no runtime caller change beyond the two existing
|
|
55
|
+
callsites gaining the getter argument).
|
|
56
|
+
|
|
57
|
+
## No-allowlist trust model (unchanged, documented)
|
|
58
|
+
`isAuthorizedSender` semantics are #909's: with no `authorizedUserIds`
|
|
59
|
+
allowlist, every authenticated sender is accepted, so the operator is the
|
|
60
|
+
most-recent authenticated sender. Consistent with the existing trust model;
|
|
61
|
+
the uid is Telegram-authenticated, never a content name
|
|
62
|
+
(`TopicOperatorStore.setOperator` enforces that by construction, #904).
|