@makaio/framework 1.0.0-dev-1783439621927 → 1.0.0-dev-1783615060726

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 (111) hide show
  1. package/dist/.makaio-build.json +2 -2
  2. package/dist/adapters/config/index.d.mts +1 -1
  3. package/dist/adapters/index.d.mts +106 -167
  4. package/dist/adapters/index.mjs +6 -6
  5. package/dist/adapters/node.d.mts +1 -1
  6. package/dist/adapters/node.mjs +4 -4
  7. package/dist/{base-orchestrator-ODRyDBzu.d.mts → base-orchestrator-J1WKAUkF.d.mts} +24 -3
  8. package/dist/bus/index.mjs +1 -1
  9. package/dist/{client-n0OJiTt1.mjs → client-l1Rq5p6X.mjs} +1 -1
  10. package/dist/clients/index.d.mts +30 -0
  11. package/dist/clients/index.mjs +2 -2
  12. package/dist/contracts/adapter/index.d.mts +2 -2
  13. package/dist/contracts/adapter/schemas/session-lineage.d.mts +1 -1
  14. package/dist/contracts/artifact/index.d.mts +1 -1
  15. package/dist/contracts/client/index.d.mts +2 -2
  16. package/dist/contracts/client/index.mjs +1 -1
  17. package/dist/contracts/config/index.d.mts +6 -6
  18. package/dist/contracts/extension/index.d.mts +3 -3
  19. package/dist/contracts/facet/index.d.mts +1 -1
  20. package/dist/contracts/harness/index.d.mts +1 -1
  21. package/dist/contracts/index.d.mts +105 -105
  22. package/dist/contracts/index.mjs +1 -1
  23. package/dist/contracts/materialization/index.d.mts +3 -3
  24. package/dist/contracts/provider/index.d.mts +1 -1
  25. package/dist/contracts/session/index.d.mts +2 -2
  26. package/dist/contracts/session/index.mjs +1 -1
  27. package/dist/contracts/shared/index.d.mts +1 -1
  28. package/dist/contracts/variant/index.d.mts +1 -1
  29. package/dist/contracts/workflow/index.d.mts +2 -2
  30. package/dist/{definition-DpkfJi8v.d.mts → definition-DePb3ke-.d.mts} +1 -1
  31. package/dist/{index-BwGfdbI0.d.mts → index-2fK9iSHI.d.mts} +9 -9
  32. package/dist/{index-DTBQOCar.d.mts → index-BMbmoarE.d.mts} +16 -16
  33. package/dist/{index-DmJ-OpTD.d.mts → index-BSprsrul.d.mts} +82 -44
  34. package/dist/{index-D7Fu3375.d.mts → index-BbQpQ1N3.d.mts} +3 -3
  35. package/dist/{index-B5Uczo3R.d.mts → index-C9FCWOhp.d.mts} +28 -28
  36. package/dist/{index-NkNbYFud.d.mts → index-CaerrEDH.d.mts} +1 -1
  37. package/dist/{index-BvjLe_w9.d.mts → index-Cx1Bm6WD.d.mts} +8 -8
  38. package/dist/{index-CwHP8Jxs.d.mts → index-D8wmMJLi.d.mts} +189 -1
  39. package/dist/{index-CYHWOXUm.d.mts → index-DEzdNQum.d.mts} +1 -1
  40. package/dist/{index-BIZeIA5k.d.mts → index-DKaEpPFS.d.mts} +9 -9
  41. package/dist/{index-DS6kxiFl.d.mts → index-DWu3qrwe.d.mts} +29 -29
  42. package/dist/{index-DFK3tpEY.d.mts → index-DZ14azod.d.mts} +79 -16
  43. package/dist/{index-B3fjN5HX.d.mts → index-DZPNuWMc.d.mts} +4 -4
  44. package/dist/{index-C8k2f_E0.d.mts → index-DoEF9LAc.d.mts} +1 -1
  45. package/dist/{index-Cyi7y_aG.d.mts → index-Qd1Qom8M.d.mts} +16 -16
  46. package/dist/{index-Dtb2cVJz.d.mts → index-S7lj2TLp.d.mts} +81 -81
  47. package/dist/kernel/extension/index.d.mts +1 -1
  48. package/dist/kernel/index.d.mts +2 -2
  49. package/dist/kernel/observability/index.d.mts +1 -1
  50. package/dist/{namespace-JFzrlNs4.d.mts → namespace-CZK2ff3B.d.mts} +5 -5
  51. package/dist/{namespace-DRXQyBe0.d.mts → namespace-Ceg3zkt2.d.mts} +24 -0
  52. package/dist/{namespace-BLER-Qom.d.mts → namespace-CfvtDD_U.d.mts} +2 -2
  53. package/dist/{namespace-6sIu5nBI2.d.mts → namespace-D8P8Sxce2.d.mts} +2 -2
  54. package/dist/{namespace-D4Uf5Mw_.d.mts → namespace-Dc94fHZW.d.mts} +18 -18
  55. package/dist/{namespace-CGxFYDlK.d.mts → namespace-DuUCiVmK.d.mts} +26 -26
  56. package/dist/{namespace-C74bbsdZ.d.mts → namespace-j7vFsmYL.d.mts} +2 -2
  57. package/dist/node/transports/index.d.mts +25 -3
  58. package/dist/node/transports/index.mjs +1 -1
  59. package/dist/package.json +1 -1
  60. package/dist/{schemas-CurUbHy4.d.mts → schemas-BemsLc_V.d.mts} +4 -4
  61. package/dist/{schemas-9S9Y9PHT2.d.mts → schemas-Br-rSxPE2.d.mts} +11 -11
  62. package/dist/{schemas-B_t6oOK-.d.mts → schemas-CoFCV42v.d.mts} +2 -2
  63. package/dist/{schemas-DXeGCbJ9.d.mts → schemas-D512XweP.d.mts} +5 -5
  64. package/dist/{schemas-DnmbwE_V.d.mts → schemas-DWfo0wp4.d.mts} +7 -7
  65. package/dist/{schemas-CW6YsPT4.d.mts → schemas-lnE9YoG7.d.mts} +3 -3
  66. package/dist/services/adapter-subsystem/index.d.mts +2 -2
  67. package/dist/services/adapter-subsystem/namespace.d.mts +1 -1
  68. package/dist/services/agent-runtime/index.d.mts +2 -2
  69. package/dist/services/agent-runtime/namespace.d.mts +1 -1
  70. package/dist/services/agent-runtime/schemas.d.mts +1 -1
  71. package/dist/services/context-rules/index.d.mts +6 -6
  72. package/dist/services/filesystem/namespace.d.mts +6 -6
  73. package/dist/services/filesystem/schemas.d.mts +3 -3
  74. package/dist/services/index.d.mts +43 -43
  75. package/dist/services/index.mjs +1 -1
  76. package/dist/services/log-import/index.mjs +2 -2
  77. package/dist/services/preferences/index.d.mts +2 -2
  78. package/dist/services/preferences/schemas.d.mts +1 -1
  79. package/dist/services/preferences/storage-namespace.d.mts +2 -2
  80. package/dist/services/session/index.d.mts +5 -5
  81. package/dist/services/session/index.mjs +1 -1
  82. package/dist/services/session/messages/namespace.d.mts +1 -1
  83. package/dist/services/session/session-events/namespace.d.mts +1 -1
  84. package/dist/services/session/storage/namespace.d.mts +1 -1
  85. package/dist/services/session/testing/index.mjs +1 -1
  86. package/dist/services/settings/namespace.d.mts +8 -8
  87. package/dist/services/settings/storage/extension-configs/namespace.d.mts +3 -3
  88. package/dist/services/subagent-template/index.d.mts +2 -2
  89. package/dist/services/subagent-template/namespace.d.mts +1 -1
  90. package/dist/services/subagent-template/schemas.d.mts +1 -1
  91. package/dist/services/tool-approval/index.mjs +1 -1
  92. package/dist/services/tools/index.mjs +1 -1
  93. package/dist/services/tray-menu/index.d.mts +2 -2
  94. package/dist/services/tray-menu/namespace.d.mts +1 -1
  95. package/dist/services/tray-menu/schemas.d.mts +1 -1
  96. package/dist/session-CX6QDhi2.mjs +76 -0
  97. package/dist/{session-Dp7z5N1d.mjs → session-D5rVMqmE.mjs} +1 -1
  98. package/dist/{session-lineage-C1M7-O3C.d.mts → session-lineage-NBFNVkUE.d.mts} +1 -1
  99. package/dist/{storage-namespace-BvRF22by.d.mts → storage-namespace-Di1A3DMm.d.mts} +10 -10
  100. package/dist/{tool-approval-service-BIbUSuqg.mjs → tool-approval-service-DEiMKTv9.mjs} +1 -1
  101. package/dist/tools-CGFZkB7F.mjs +1 -0
  102. package/dist/{transition-DYorNHZu.d.mts → transition-CmI3q3FA.d.mts} +1 -1
  103. package/dist/{types-9XCB1aPK.d.mts → types-Dhou-Itn.d.mts} +14 -14
  104. package/dist/{types-N_BOtTqt.d.mts → types-VwMx5_lS.d.mts} +31 -1
  105. package/dist/ui-kernel/index.d.mts +4 -4
  106. package/dist/ui-kernel/pages/namespace.d.mts +4 -4
  107. package/dist/ui-kernel/pages/schemas.d.mts +1 -1
  108. package/dist/workflow-engine/index.d.mts +69 -69
  109. package/package.json +1 -1
  110. package/dist/session-CZUrp7gC.mjs +0 -69
  111. package/dist/tools-Yz8XyiwA.mjs +0 -1
@@ -18,11 +18,11 @@ import { ExtensionWarningEntry, ExtensionWarningEntrySchema } from "@makaio/fram
18
18
  * detail, not an externally observable state.
19
19
  */
20
20
  declare const ComponentStateSchema: z.ZodEnum<{
21
- stopped: "stopped";
22
21
  failed: "failed";
22
+ stopped: "stopped";
23
23
  discovered: "discovered";
24
- skipped: "skipped";
25
24
  active: "active";
25
+ skipped: "skipped";
26
26
  initializing: "initializing";
27
27
  }>;
28
28
  /** Inferred union of all valid component lifecycle states. */
@@ -47,11 +47,11 @@ declare const ComponentInfoSchema: z.ZodObject<{
47
47
  name: z.ZodString;
48
48
  displayName: z.ZodString;
49
49
  state: z.ZodEnum<{
50
- stopped: "stopped";
51
50
  failed: "failed";
51
+ stopped: "stopped";
52
52
  discovered: "discovered";
53
- skipped: "skipped";
54
53
  active: "active";
54
+ skipped: "skipped";
55
55
  initializing: "initializing";
56
56
  }>;
57
57
  error: z.ZodOptional<z.ZodString>;
@@ -68,11 +68,11 @@ declare const ServiceInfoSchema: z.ZodObject<{
68
68
  name: z.ZodString;
69
69
  displayName: z.ZodString;
70
70
  state: z.ZodEnum<{
71
- stopped: "stopped";
72
71
  failed: "failed";
72
+ stopped: "stopped";
73
73
  discovered: "discovered";
74
- skipped: "skipped";
75
74
  active: "active";
75
+ skipped: "skipped";
76
76
  initializing: "initializing";
77
77
  }>;
78
78
  error: z.ZodOptional<z.ZodString>;
@@ -90,11 +90,11 @@ declare const ExtensionInfoSchema: z.ZodObject<{
90
90
  name: z.ZodString;
91
91
  displayName: z.ZodString;
92
92
  state: z.ZodEnum<{
93
- stopped: "stopped";
94
93
  failed: "failed";
94
+ stopped: "stopped";
95
95
  discovered: "discovered";
96
- skipped: "skipped";
97
96
  active: "active";
97
+ skipped: "skipped";
98
98
  initializing: "initializing";
99
99
  }>;
100
100
  error: z.ZodOptional<z.ZodString>;
@@ -138,19 +138,19 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
138
138
  name: z.ZodString;
139
139
  displayName: z.ZodString;
140
140
  from: z.ZodEnum<{
141
- stopped: "stopped";
142
141
  failed: "failed";
142
+ stopped: "stopped";
143
143
  discovered: "discovered";
144
- skipped: "skipped";
145
144
  active: "active";
145
+ skipped: "skipped";
146
146
  initializing: "initializing";
147
147
  }>;
148
148
  to: z.ZodEnum<{
149
- stopped: "stopped";
150
149
  failed: "failed";
150
+ stopped: "stopped";
151
151
  discovered: "discovered";
152
- skipped: "skipped";
153
152
  active: "active";
153
+ skipped: "skipped";
154
154
  initializing: "initializing";
155
155
  }>;
156
156
  error: z.ZodOptional<z.ZodString>;
@@ -181,11 +181,11 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
181
181
  name: z.ZodString;
182
182
  displayName: z.ZodString;
183
183
  state: z.ZodEnum<{
184
- stopped: "stopped";
185
184
  failed: "failed";
185
+ stopped: "stopped";
186
186
  discovered: "discovered";
187
- skipped: "skipped";
188
187
  active: "active";
188
+ skipped: "skipped";
189
189
  initializing: "initializing";
190
190
  }>;
191
191
  error: z.ZodOptional<z.ZodString>;
@@ -219,11 +219,11 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
219
219
  name: z.ZodString;
220
220
  displayName: z.ZodString;
221
221
  state: z.ZodEnum<{
222
- stopped: "stopped";
223
222
  failed: "failed";
223
+ stopped: "stopped";
224
224
  discovered: "discovered";
225
- skipped: "skipped";
226
225
  active: "active";
226
+ skipped: "skipped";
227
227
  initializing: "initializing";
228
228
  }>;
229
229
  error: z.ZodOptional<z.ZodString>;
@@ -488,8 +488,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
488
488
  extensionName: z.ZodString;
489
489
  warnings: z.ZodArray<z.ZodObject<{
490
490
  severity: z.ZodEnum<{
491
- degraded: "degraded";
492
491
  info: "info";
492
+ degraded: "degraded";
493
493
  recommended: "recommended";
494
494
  }>;
495
495
  title: z.ZodString;
@@ -528,8 +528,8 @@ declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel
528
528
  extensionName: z.ZodString;
529
529
  warnings: z.ZodArray<z.ZodObject<{
530
530
  severity: z.ZodEnum<{
531
- degraded: "degraded";
532
531
  info: "info";
532
+ degraded: "degraded";
533
533
  recommended: "recommended";
534
534
  }>;
535
535
  title: z.ZodString;
@@ -593,19 +593,19 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
593
593
  name: z.ZodString;
594
594
  displayName: z.ZodString;
595
595
  from: z.ZodEnum<{
596
- stopped: "stopped";
597
596
  failed: "failed";
597
+ stopped: "stopped";
598
598
  discovered: "discovered";
599
- skipped: "skipped";
600
599
  active: "active";
600
+ skipped: "skipped";
601
601
  initializing: "initializing";
602
602
  }>;
603
603
  to: z.ZodEnum<{
604
- stopped: "stopped";
605
604
  failed: "failed";
605
+ stopped: "stopped";
606
606
  discovered: "discovered";
607
- skipped: "skipped";
608
607
  active: "active";
608
+ skipped: "skipped";
609
609
  initializing: "initializing";
610
610
  }>;
611
611
  error: z.ZodOptional<z.ZodString>;
@@ -636,11 +636,11 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
636
636
  name: z.ZodString;
637
637
  displayName: z.ZodString;
638
638
  state: z.ZodEnum<{
639
- stopped: "stopped";
640
639
  failed: "failed";
640
+ stopped: "stopped";
641
641
  discovered: "discovered";
642
- skipped: "skipped";
643
642
  active: "active";
643
+ skipped: "skipped";
644
644
  initializing: "initializing";
645
645
  }>;
646
646
  error: z.ZodOptional<z.ZodString>;
@@ -674,11 +674,11 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
674
674
  name: z.ZodString;
675
675
  displayName: z.ZodString;
676
676
  state: z.ZodEnum<{
677
- stopped: "stopped";
678
677
  failed: "failed";
678
+ stopped: "stopped";
679
679
  discovered: "discovered";
680
- skipped: "skipped";
681
680
  active: "active";
681
+ skipped: "skipped";
682
682
  initializing: "initializing";
683
683
  }>;
684
684
  error: z.ZodOptional<z.ZodString>;
@@ -943,8 +943,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
943
943
  extensionName: z.ZodString;
944
944
  warnings: z.ZodArray<z.ZodObject<{
945
945
  severity: z.ZodEnum<{
946
- degraded: "degraded";
947
946
  info: "info";
947
+ degraded: "degraded";
948
948
  recommended: "recommended";
949
949
  }>;
950
950
  title: z.ZodString;
@@ -983,8 +983,8 @@ declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fla
983
983
  extensionName: z.ZodString;
984
984
  warnings: z.ZodArray<z.ZodObject<{
985
985
  severity: z.ZodEnum<{
986
- degraded: "degraded";
987
986
  info: "info";
987
+ degraded: "degraded";
988
988
  recommended: "recommended";
989
989
  }>;
990
990
  title: z.ZodString;
@@ -41,9 +41,9 @@ declare const StructuredOutputValidationErrorSchema: z.ZodObject<{
41
41
  * - `enforced` – A structured-output enforcement handler produced conformant output.
42
42
  */
43
43
  declare const StructuredOutputValidationStatusSchema: z.ZodEnum<{
44
- failed: "failed";
45
44
  passed: "passed";
46
45
  enforced: "enforced";
46
+ failed: "failed";
47
47
  }>;
48
48
  /**
49
49
  * Full validation result emitted after a turn completes when a
@@ -140,6 +140,8 @@ declare const HarnessDefinitionCreateSchema: z.ZodObject<{
140
140
  cwd: z.ZodOptional<z.ZodString>;
141
141
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
142
142
  name: z.ZodString;
143
+ adapterName: z.ZodOptional<z.ZodString>;
144
+ clientId: z.ZodOptional<z.ZodString>;
143
145
  nativeTools: z.ZodObject<{
144
146
  enabled: z.ZodArray<z.ZodString>;
145
147
  disabled: z.ZodArray<z.ZodString>;
@@ -148,8 +150,6 @@ declare const HarnessDefinitionCreateSchema: z.ZodObject<{
148
150
  enabled: z.ZodArray<z.ZodString>;
149
151
  disabled: z.ZodArray<z.ZodString>;
150
152
  }, z.core.$strip>;
151
- adapterName: z.ZodOptional<z.ZodString>;
152
- clientId: z.ZodOptional<z.ZodString>;
153
153
  skills: z.ZodOptional<z.ZodObject<{
154
154
  enabled: z.ZodArray<z.ZodString>;
155
155
  disabled: z.ZodArray<z.ZodString>;
@@ -316,6 +316,8 @@ declare const HarnessSchemas: {
316
316
  cwd: z.ZodOptional<z.ZodString>;
317
317
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
318
318
  name: z.ZodString;
319
+ adapterName: z.ZodOptional<z.ZodString>;
320
+ clientId: z.ZodOptional<z.ZodString>;
319
321
  nativeTools: z.ZodObject<{
320
322
  enabled: z.ZodArray<z.ZodString>;
321
323
  disabled: z.ZodArray<z.ZodString>;
@@ -324,8 +326,6 @@ declare const HarnessSchemas: {
324
326
  enabled: z.ZodArray<z.ZodString>;
325
327
  disabled: z.ZodArray<z.ZodString>;
326
328
  }, z.core.$strip>;
327
- adapterName: z.ZodOptional<z.ZodString>;
328
- clientId: z.ZodOptional<z.ZodString>;
329
329
  skills: z.ZodOptional<z.ZodObject<{
330
330
  enabled: z.ZodArray<z.ZodString>;
331
331
  disabled: z.ZodArray<z.ZodString>;
@@ -759,6 +759,8 @@ declare const HarnessNamespace: _$_makaio_core0.BusNamespaceDefinition<"harness"
759
759
  cwd: z.ZodOptional<z.ZodString>;
760
760
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
761
761
  name: z.ZodString;
762
+ adapterName: z.ZodOptional<z.ZodString>;
763
+ clientId: z.ZodOptional<z.ZodString>;
762
764
  nativeTools: z.ZodObject<{
763
765
  enabled: z.ZodArray<z.ZodString>;
764
766
  disabled: z.ZodArray<z.ZodString>;
@@ -767,8 +769,6 @@ declare const HarnessNamespace: _$_makaio_core0.BusNamespaceDefinition<"harness"
767
769
  enabled: z.ZodArray<z.ZodString>;
768
770
  disabled: z.ZodArray<z.ZodString>;
769
771
  }, z.core.$strip>;
770
- adapterName: z.ZodOptional<z.ZodString>;
771
- clientId: z.ZodOptional<z.ZodString>;
772
772
  skills: z.ZodOptional<z.ZodObject<{
773
773
  enabled: z.ZodArray<z.ZodString>;
774
774
  disabled: z.ZodArray<z.ZodString>;
@@ -1202,6 +1202,8 @@ declare const HarnessSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatS
1202
1202
  cwd: z.ZodOptional<z.ZodString>;
1203
1203
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1204
1204
  name: z.ZodString;
1205
+ adapterName: z.ZodOptional<z.ZodString>;
1206
+ clientId: z.ZodOptional<z.ZodString>;
1205
1207
  nativeTools: z.ZodObject<{
1206
1208
  enabled: z.ZodArray<z.ZodString>;
1207
1209
  disabled: z.ZodArray<z.ZodString>;
@@ -1210,8 +1212,6 @@ declare const HarnessSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatS
1210
1212
  enabled: z.ZodArray<z.ZodString>;
1211
1213
  disabled: z.ZodArray<z.ZodString>;
1212
1214
  }, z.core.$strip>;
1213
- adapterName: z.ZodOptional<z.ZodString>;
1214
- clientId: z.ZodOptional<z.ZodString>;
1215
1215
  skills: z.ZodOptional<z.ZodObject<{
1216
1216
  enabled: z.ZodArray<z.ZodString>;
1217
1217
  disabled: z.ZodArray<z.ZodString>;
@@ -3733,6 +3733,194 @@ declare const LogImportTriggerSubjects: _$_makaio_core0.BusSubjects<_$_makaio_co
3733
3733
  * @returns True when content import must be suppressed
3734
3734
  */
3735
3735
  declare function isPolicyDiscoveredObservedSession(session: Pick<IMakaioSession, 'clientId' | 'importStatus'>): boolean;
3736
+ /**
3737
+ * Check whether a stored session is a hook-first tracking stub.
3738
+ *
3739
+ * A tracking stub is the session row created by
3740
+ * `ObservedSessionIngestionService.handleSessionStarted` when the
3741
+ * `SessionStart` hook fires before the suppression gate is populated.
3742
+ * Its fingerprint is:
3743
+ * - `isImported: true` (set by `importUpsert`)
3744
+ * - `importStatus: 'tracking'` (live-followed observed session)
3745
+ * - `clientId` is present (hook-observed, not watcher-discovered)
3746
+ *
3747
+ * This predicate is the single source of truth for stub identification
3748
+ * across reconciliation and diagnostic paths. Externally observed
3749
+ * terminal sessions share this fingerprint, but they never trigger
3750
+ * `client.runtime.started` — the caller discriminates by context.
3751
+ * @param session - Stored session row to inspect
3752
+ * @returns True when the session matches the tracking-stub fingerprint
3753
+ */
3754
+ declare function isTrackingStub(session: Pick<IMakaioSession, 'isImported' | 'importStatus' | 'clientId'>): boolean;
3755
+ /**
3756
+ * Bridges observed client sessions into the canonical session model.
3757
+ *
3758
+ * Responsibilities:
3759
+ * - Register observed sessions on `client.session.started` through the
3760
+ * unified registration seam (`storage:session.importUpsert`), keyed on the
3761
+ * importer's adapter name so hook-first registration and later transcript
3762
+ * imports converge on the same `(source, adapterSessionId)` identity.
3763
+ * - Trigger targeted transcript imports on `client.session.turn.completed`
3764
+ * (`log-import.importFile` when the transcript path is known, discovery
3765
+ * fallback via `log-import.importSession` otherwise).
3766
+ * - Suppress all work for adapter-managed sessions: sessions the managed
3767
+ * orchestration path drives already flow through the orchestrator and must
3768
+ * not be double-ingested (gate fed by `client.runtime.started`).
3769
+ *
3770
+ * Non-responsibilities:
3771
+ * - Holds NO turn state — turn boundaries and content come exclusively from
3772
+ * the transcript reconstruction during import (design Principle 4).
3773
+ * - Never emits `session.*` subjects itself — the turn lifecycle ingestion
3774
+ * seam is the single emitter (design Principle 2).
3775
+ *
3776
+ * The component is client-agnostic: client and importer identities come from
3777
+ * event payloads and the log-import registry, never from hard-coded client
3778
+ * ids. A single subscription per subject on the global `client` namespace
3779
+ * covers every emitting client; `clientId` in the payload is the
3780
+ * discriminator. When no log-import service or no matching importer is
3781
+ * registered (framework-only mode), all work is skipped silently.
3782
+ */
3783
+ declare class ObservedSessionIngestionService {
3784
+ private readonly bus;
3785
+ /**
3786
+ * Adapter session IDs owned by the managed orchestration path.
3787
+ *
3788
+ * FIFO-capped at {@link MANAGED_SESSION_CAP}; insertion order is the
3789
+ * eviction order (mirrors the client services' gate).
3790
+ */
3791
+ private readonly managedAdapterSessionIds;
3792
+ /**
3793
+ * Importer resolutions per client id.
3794
+ *
3795
+ * Importers register at boot and do not un-register mid-session, so this
3796
+ * cache (including misses) is valid for the lifetime of the service instance.
3797
+ */
3798
+ private readonly importerByClientId;
3799
+ /** Client ids already debug-logged as unresolvable (one log per client id). */
3800
+ private readonly unresolvedClientIds;
3801
+ /** Registered optional policy providers; deny/discovered decisions win. */
3802
+ private readonly policyProviders;
3803
+ private readonly cleanups;
3804
+ /**
3805
+ * Create the service and subscribe to the observed-session subjects.
3806
+ * @param bus - Application bus instance
3807
+ */
3808
+ constructor(bus?: IMakaioBus);
3809
+ /** Unsubscribe all bus handlers. */
3810
+ destroy(): void;
3811
+ /**
3812
+ * Record adapter-managed sessions in the suppression gate and reconcile
3813
+ * any hook-first tracking stub.
3814
+ *
3815
+ * Unlike the per-client gates inside the client services, this component
3816
+ * does not filter by `clientId`: it is client-agnostic, and an adapter
3817
+ * session ID marked as managed must suppress observed ingestion regardless
3818
+ * of which client runtime reported it. Non-adapter source layers (e.g.
3819
+ * `'supervisor'`, `'statusline'`) never suppress — they observe sessions
3820
+ * the managed path does not own.
3821
+ *
3822
+ * **Stub reconciliation:** When the `SessionStart` hook fires before this
3823
+ * gate is populated (hook-first ingestion race), `handleSessionStarted`
3824
+ * creates a tracking stub via `importUpsert`. This stub and the live
3825
+ * session row coexist as duplicates. `client.runtime.started` is the
3826
+ * authoritative, guaranteed-to-arrive signal that the adapter session is
3827
+ * managed. On arrival, any existing tracking stub for the same
3828
+ * `(source, adapterSessionId)` is reconciled: deleted when inert, or
3829
+ * preserved when it already carries imported messages (native takeover
3830
+ * of an externally observed session — see the content guard below).
3831
+ *
3832
+ * Externally observed terminal sessions share the same storage fingerprint
3833
+ * (`isImported: true`, `importStatus: 'tracking'`, `clientId` set) but
3834
+ * never trigger `client.runtime.started` for their `adapterSessionId` —
3835
+ * they are observed via hooks only, without a `client.runtime.observe`
3836
+ * preceding them. Therefore `client.runtime.started` itself is the
3837
+ * discriminator: if we receive it for an adapterSessionId, the session is
3838
+ * adapter-managed and any tracking stub is a racy artifact.
3839
+ * @param payload - `client.runtime.started` payload
3840
+ */
3841
+ private handleRuntimeStarted;
3842
+ /**
3843
+ * Reconcile a hook-first tracking stub for a managed adapter session.
3844
+ *
3845
+ * Looks up a tracking stub by `(source, adapterSessionId)` and deletes it
3846
+ * when it carries no imported messages (pure race artifact). Stubs with
3847
+ * content are preserved (native takeover of an externally observed session).
3848
+ * When message storage is unavailable (unhandled lookup), the stub is
3849
+ * preserved defensively to avoid data loss.
3850
+ *
3851
+ * Called from two sites to close the in-flight importUpsert window:
3852
+ * - `handleRuntimeStarted`: runtime side adds to gate, then reconciles.
3853
+ * - `handleSessionStarted`: hook side writes storage, then reconciles
3854
+ * (post-upsert double-check when the gate was populated concurrently).
3855
+ * @param clientId - Client identity for importer resolution
3856
+ * @param adapterSessionId - External adapter session ID to reconcile
3857
+ */
3858
+ private reconcileTrackingStub;
3859
+ /**
3860
+ * Resolve the log-import importer responsible for a client's sessions.
3861
+ *
3862
+ * Bridges the correlation gap between hook identity and import identity:
3863
+ * hooks report the client id (e.g. `'claude-code'`) while the import path
3864
+ * keys sessions on the importer's adapter name. Registrations advertise
3865
+ * their `clientId` via `log-import.listImporters`.
3866
+ *
3867
+ * Graceful absence: `null` means framework-only mode (no log-import
3868
+ * service, or no importer registered for this client) — callers skip
3869
+ * silently. At most one debug log is emitted per unresolved client id.
3870
+ * @param clientId - Stable client id from the observed event payload
3871
+ * @returns Importer adapter name, or `null` when no importer is registered
3872
+ */
3873
+ private resolveImporter;
3874
+ /**
3875
+ * Debug-log an unresolved client id at most once.
3876
+ * @param clientId - Client id that could not be resolved to an importer
3877
+ * @param reason - Why resolution failed
3878
+ */
3879
+ private debugUnresolved;
3880
+ /**
3881
+ * Register an observed session through the unified registration seam.
3882
+ *
3883
+ * Skipped for managed sessions and when no importer is resolvable — a
3884
+ * session that can never receive imported content must not create a
3885
+ * dangling stub. The registration `source` is the importer's adapter name,
3886
+ * NOT the raw client id: the `(source, adapterSessionId)` upsert key must
3887
+ * match what the import path writes, otherwise hook-first registration
3888
+ * would fork the session identity and every import would create a
3889
+ * duplicate session.
3890
+ * @param payload - `client.session.started` payload
3891
+ */
3892
+ private handleSessionStarted;
3893
+ /**
3894
+ * Trigger a targeted transcript import for a completed observed turn.
3895
+ *
3896
+ * Preferred trigger: `log-import.importFile` with the transcript path from
3897
+ * the hook payload (no prior discovery stub required). Fallback when the
3898
+ * payload carries no path: `log-import.importSession`, which requires an
3899
+ * existing discovery stub and throws otherwise — tolerated and
3900
+ * debug-logged, because the polling watcher ingests the turn on its next
3901
+ * pass either way. If hook payloads prove to lack the transcript path at
3902
+ * fire time in practice, resolving the path from the statusline cache is
3903
+ * the candidate follow-up seam.
3904
+ * @param payload - `client.session.turn.completed` payload
3905
+ */
3906
+ private handleTurnCompleted;
3907
+ /**
3908
+ * Evaluate registered policy providers for an observed session.
3909
+ *
3910
+ * No provider means the current default: content tracking. When multiple
3911
+ * providers are present, `discovered` wins so independent policy modules can
3912
+ * only restrict content import, not override each other's deny decisions.
3913
+ * @param input - Observed session identity and importer context
3914
+ * @returns Import status for the registration
3915
+ */
3916
+ private decideImportStatus;
3917
+ /**
3918
+ * Determine whether a completed observed turn may trigger content import.
3919
+ * @param input - Observed turn identity and importer context
3920
+ * @returns True when content import should run
3921
+ */
3922
+ private shouldImportObservedContent;
3923
+ }
3736
3924
  //#endregion
3737
3925
  //#region services/core/src/session/observed-session-ingestion-policy.d.ts
3738
3926
  /** Capability id used for observed-session ingestion policy providers. */
@@ -5416,4 +5604,4 @@ interface NativeLocalityInput {
5416
5604
  */
5417
5605
  declare function evaluateNativeLocality(input: NativeLocalityInput): NativeLocalityVerdict;
5418
5606
  //#endregion
5419
- export { SessionLifecycleEventArgs as $, recoverAgent as $t, SelectTurn as A, createSessionExtensionContext as At, OBSERVED_SESSION_INGESTION_POLICY_CAPABILITY_ID as B, resetBuiltInActionsRegistration as Bt, MessageRoutingSubjects as C, registerDrizzleAgentStorage as Ct, registerMemoryMessageStorage as D, AgentStorageNamespace as Dt, messages as E, registerMemorySessionStorage as Et, EmbeddingIndexManager as F, CONNECTOR_SWAP_DEFAULT_PIPELINE as Ft, unregisterObservedSessionIngestionPolicyProvider as G, AgentContextState as Gt, ObservedSessionIngestionPolicyImportStatus as H, registerGetStatusCountsHandler as Ht, registerDrizzleImportCursorStorage as I, normalizeSelectionString as It, IngestCompletedTurnParams as J, buildTurnInitiator as Jt, LogImportTriggerSubjects as K, ContextWindowTrackerConfig as Kt, importCursors as L, resolveAdapterNameById as Lt, turnsDual as M, assembleForkContext as Mt, registerMemoryTurnStorage as N, FallbackRuntimeOptions as Nt, registerDrizzleMessageStorage as O, AgentStorageSubjects as Ot, registerDrizzleTurnStorage as P, pickFallbackRuntimeOptions as Pt, EventTransform as Q, ensureAgentModel as Qt, importCursorsDual as R, registerListActionsHandler as Rt, MessageRoutingNamespace as S, registerFtsSearchHandler as St, SelectMessage as T, registerDrizzleSessionStorage as Tt, ObservedSessionIngestionPolicyInput as U, registerResumeHandler as Ut, ObservedSessionIngestionPolicyDecision as V, actionRegistry as Vt, registerObservedSessionIngestionPolicyProvider as W, ContextWindowTracker as Wt, IngestTurnMessage as X, buildRecoveryContextWithPipeline as Xt, IngestCompletedTurnResult as Y, RecoveryConfig as Yt, ingestCompletedTurn as Z, ensureAgentCwd as Zt, InsertMessageRouting as _, fetchAgentsBySession as _t, buildSessionContext as a, findTurnByAgent as an, registerMemorySessionEventStorage as at, messageRoutingDual as b, mapRowToSession as bt, kindToBranchKind as c, extractTextContent as cn, sessionEvents as ct, registerSpawningToolCallResolver as d, AdapterRegistry as dn, SessionPreviewMaps as dt, verifyAndRecoverAgents as en, SessionTurnStartedPayload as et, registerCompressLineageResolver as f, ISessionOrchestrator as fn, fetchSessionPreviewMaps as ft, StartTurnOptions as g, SearchSessionRow as gt, MakaioSessionConfig as h, MakaioSessionService as hn, SearchFilters as ht, getFullConversation as i, resolveModelCapabilities as in, registerDrizzleSessionEventStorage as it, turns as j, SessionBridge as jt, InsertTurn as k, SessionExtensionContextImpl as kt, toSessionLineage as l, normalizeToBlocks as ln, sessionEventsDual as lt, MakaioSession as m, registerCoreSessionServiceHandlers as mn, mapToSession as mt, NativeLocalityIntent as n, resolveAdapterId as nn, emitSessionTurnStarted as nt, BuildContextOptions as o, getOrCreateSession as on, InsertSessionEvent as ot, registerParentResolver as p, SessionOrchestrator as pn, mapAgentsBySession as pt, isPolicyDiscoveredObservedSession as q, SessionContextWindowState as qt, evaluateNativeLocality as r, resolveExecutionTarget as rn, registerSessionLifecycleEventWriters as rt, ContextAssemblyResult as s, resolveTargetAgents as sn, SelectSessionEvent as st, NativeLocalityInput as t, buildRecoveryContext as tn, appendSessionLifecycleEvent as tt, registerSessionDiscoveredHandler as u, TurnContextEnricher as un, getSessionAncestorChain as ut, SelectMessageRouting as v, fetchMessageCountsBySession as vt, InsertMessage as w, registerMemoryAgentStorage as wt, registerDrizzleMessageRoutingStorage as x, parseForkTransforms as xt, messageRouting as y, fetchPreviewBySession as yt, IObservedSessionIngestionPolicyProvider as z, registerBuiltInActions as zt };
5607
+ export { ingestCompletedTurn as $, ensureAgentCwd as $t, SelectTurn as A, AgentStorageSubjects as At, OBSERVED_SESSION_INGESTION_POLICY_CAPABILITY_ID as B, registerListActionsHandler as Bt, MessageRoutingSubjects as C, parseForkTransforms as Ct, registerMemoryMessageStorage as D, registerDrizzleSessionStorage as Dt, messages as E, registerMemoryAgentStorage as Et, EmbeddingIndexManager as F, FallbackRuntimeOptions as Ft, unregisterObservedSessionIngestionPolicyProvider as G, registerResumeHandler as Gt, ObservedSessionIngestionPolicyImportStatus as H, resetBuiltInActionsRegistration as Ht, registerDrizzleImportCursorStorage as I, pickFallbackRuntimeOptions as It, isPolicyDiscoveredObservedSession as J, ContextWindowTrackerConfig as Jt, LogImportTriggerSubjects as K, ContextWindowTracker as Kt, importCursors as L, CONNECTOR_SWAP_DEFAULT_PIPELINE as Lt, turnsDual as M, createSessionExtensionContext as Mt, registerMemoryTurnStorage as N, SessionBridge as Nt, registerDrizzleMessageStorage as O, registerMemorySessionStorage as Ot, registerDrizzleTurnStorage as P, assembleForkContext as Pt, IngestTurnMessage as Q, buildRecoveryContextWithPipeline as Qt, importCursorsDual as R, normalizeSelectionString as Rt, MessageRoutingNamespace as S, mapRowToSession as St, SelectMessage as T, registerDrizzleAgentStorage as Tt, ObservedSessionIngestionPolicyInput as U, actionRegistry as Ut, ObservedSessionIngestionPolicyDecision as V, registerBuiltInActions as Vt, registerObservedSessionIngestionPolicyProvider as W, registerGetStatusCountsHandler as Wt, IngestCompletedTurnParams as X, buildTurnInitiator as Xt, isTrackingStub as Y, SessionContextWindowState as Yt, IngestCompletedTurnResult as Z, RecoveryConfig as Zt, InsertMessageRouting as _, MakaioSessionService as _n, SearchFilters as _t, buildSessionContext as a, resolveExecutionTarget as an, registerSessionLifecycleEventWriters as at, messageRoutingDual as b, fetchMessageCountsBySession as bt, kindToBranchKind as c, getOrCreateSession as cn, InsertSessionEvent as ct, registerSpawningToolCallResolver as d, normalizeToBlocks as dn, sessionEventsDual as dt, ensureAgentModel as en, EventTransform as et, registerCompressLineageResolver as f, TurnContextEnricher as fn, getSessionAncestorChain as ft, StartTurnOptions as g, registerCoreSessionServiceHandlers as gn, mapToSession as gt, MakaioSessionConfig as h, SessionOrchestrator as hn, mapAgentsBySession as ht, getFullConversation as i, resolveAdapterId as in, emitSessionTurnStarted as it, turns as j, SessionExtensionContextImpl as jt, InsertTurn as k, AgentStorageNamespace as kt, toSessionLineage as l, resolveTargetAgents as ln, SelectSessionEvent as lt, MakaioSession as m, ISessionOrchestrator as mn, fetchSessionPreviewMaps as mt, NativeLocalityIntent as n, verifyAndRecoverAgents as nn, SessionTurnStartedPayload as nt, BuildContextOptions as o, resolveModelCapabilities as on, registerDrizzleSessionEventStorage as ot, registerParentResolver as p, AdapterRegistry as pn, SessionPreviewMaps as pt, ObservedSessionIngestionService as q, AgentContextState as qt, evaluateNativeLocality as r, buildRecoveryContext as rn, appendSessionLifecycleEvent as rt, ContextAssemblyResult as s, findTurnByAgent as sn, registerMemorySessionEventStorage as st, NativeLocalityInput as t, recoverAgent as tn, SessionLifecycleEventArgs as tt, registerSessionDiscoveredHandler as u, extractTextContent as un, sessionEvents as ut, SelectMessageRouting as v, SearchSessionRow as vt, InsertMessage as w, registerFtsSearchHandler as wt, registerDrizzleMessageRoutingStorage as x, fetchPreviewBySession as xt, messageRouting as y, fetchAgentsBySession as yt, IObservedSessionIngestionPolicyProvider as z, resolveAdapterNameById as zt };
@@ -9,8 +9,8 @@ import { z } from "zod";
9
9
  * - `visible` — Model is usable and shown in the AgentPicker UI.
10
10
  */
11
11
  declare const ModelVisibilitySchema: z.ZodEnum<{
12
- enabled: "enabled";
13
12
  disabled: "disabled";
13
+ enabled: "enabled";
14
14
  visible: "visible";
15
15
  }>;
16
16
  type ModelVisibility = z.infer<typeof ModelVisibilitySchema>;
@@ -1,12 +1,12 @@
1
- import { J as ArtifactLifecycleHookEvent, Y as ArtifactLifecycleHookRegistration$1, z as AnyArtifactKindDefinition } from "./index-DS6kxiFl.mjs";
1
+ import { J as ArtifactLifecycleHookEvent, Y as ArtifactLifecycleHookRegistration$1, z as AnyArtifactKindDefinition } from "./index-DWu3qrwe.mjs";
2
2
  import { A as VersionRange, O as VersionLiteral$1, r as ClientDefinition$1 } from "./definition-CuJvtYeG.mjs";
3
3
  import { c as ProviderDefinitionInput$1, r as ProtocolId$1 } from "./definition-Cllhr9mi.mjs";
4
4
  import { t as RequiredTimeoutConfig } from "./index-CuHqL95P.mjs";
5
- import { V as SessionMessage$1, b as SESSION_EVENT_TYPES, i as MakaioSessionEvent$1 } from "./types-9XCB1aPK.mjs";
6
- import { D as EntityUIConfig, I as FormFieldProps } from "./index-NkNbYFud.mjs";
7
- import { n as ExtensionTransitionRulesContribution, t as ExtensionTransitionActionsContribution, y as WorkflowBlockCollection$1 } from "./transition-DYorNHZu.mjs";
8
- import { l as FacetNamespaceDefinition } from "./index-DTBQOCar.mjs";
9
- import { t as SurfaceBindingDefinition } from "./definition-DpkfJi8v.mjs";
5
+ import { V as SessionMessage$1, b as SESSION_EVENT_TYPES, i as MakaioSessionEvent$1 } from "./types-Dhou-Itn.mjs";
6
+ import { D as EntityUIConfig, I as FormFieldProps } from "./index-CaerrEDH.mjs";
7
+ import { n as ExtensionTransitionRulesContribution, t as ExtensionTransitionActionsContribution, y as WorkflowBlockCollection$1 } from "./transition-CmI3q3FA.mjs";
8
+ import { l as FacetNamespaceDefinition } from "./index-BMbmoarE.mjs";
9
+ import { t as SurfaceBindingDefinition } from "./definition-DePb3ke-.mjs";
10
10
  import { z } from "zod";
11
11
  import { MakaioBusLike, PayloadFilter, RegistrableBusNamespaceDefinition, SubjectSchema } from "@makaio/framework/core";
12
12
  import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
@@ -1615,8 +1615,8 @@ declare const ExtensionWarningActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject
1615
1615
  * - `'degraded'` — the extension is operating in a degraded fallback mode.
1616
1616
  */
1617
1617
  declare const ExtensionWarningSeveritySchema: z.ZodEnum<{
1618
- degraded: "degraded";
1619
1618
  info: "info";
1619
+ degraded: "degraded";
1620
1620
  recommended: "recommended";
1621
1621
  }>;
1622
1622
  /**
@@ -1627,8 +1627,8 @@ declare const ExtensionWarningSeveritySchema: z.ZodEnum<{
1627
1627
  */
1628
1628
  declare const ExtensionWarningSchema: z.ZodObject<{
1629
1629
  severity: z.ZodEnum<{
1630
- degraded: "degraded";
1631
1630
  info: "info";
1631
+ degraded: "degraded";
1632
1632
  recommended: "recommended";
1633
1633
  }>;
1634
1634
  title: z.ZodString;
@@ -1674,8 +1674,8 @@ declare const ExtensionWarningEntrySchema: z.ZodObject<{
1674
1674
  extensionName: z.ZodString;
1675
1675
  warnings: z.ZodArray<z.ZodObject<{
1676
1676
  severity: z.ZodEnum<{
1677
- degraded: "degraded";
1678
1677
  info: "info";
1678
+ degraded: "degraded";
1679
1679
  recommended: "recommended";
1680
1680
  }>;
1681
1681
  title: z.ZodString;