@hassangameryt/freeflow 0.7.1 → 0.7.3

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 (147) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.cursor-plugin/plugin.json +1 -1
  5. package/README.md +153 -128
  6. package/capabilities/cognitive-routing/SKILL.md +126 -274
  7. package/command-surface.json +7 -1
  8. package/gemini-extension.json +1 -1
  9. package/package.json +4 -4
  10. package/pi-extension/dist/cognitive-routing-v2/budget.js +42 -0
  11. package/pi-extension/dist/cognitive-routing-v2/config.js +136 -0
  12. package/pi-extension/dist/cognitive-routing-v2/projection.js +330 -0
  13. package/pi-extension/dist/cognitive-routing-v2/render.js +252 -0
  14. package/pi-extension/dist/cognitive-routing-v2/runtime.js +2181 -0
  15. package/pi-extension/dist/cognitive-routing-v2/schemas.js +173 -0
  16. package/pi-extension/dist/cognitive-routing-v2/state.js +828 -0
  17. package/pi-extension/dist/cognitive-routing-v2/tools.js +60 -0
  18. package/pi-extension/dist/cognitive-routing-v2/types.js +48 -0
  19. package/pi-extension/dist/context-virtualization/runtime.js +29 -7
  20. package/pi-extension/dist/freeflow-context/tool.js +12 -6
  21. package/pi-extension/dist/index.js +302 -626
  22. package/pi-extension/dist/provider-support/astra/adapter.js +110 -0
  23. package/pi-extension/dist/provider-support/astra/history.js +125 -0
  24. package/pi-extension/dist/provider-support/astra/index.js +11 -0
  25. package/pi-extension/dist/provider-support/astra/session-state.js +114 -0
  26. package/pi-extension/dist/provider-support/index.js +4 -0
  27. package/pi-extension/dist/runtime/request-history.js +216 -0
  28. package/pi-extension/dist/runtime/runtime-context.js +85 -16
  29. package/pi-extension/dist/session-sources/events.js +217 -0
  30. package/pi-extension/dist/session-sources/provenance.js +32 -0
  31. package/pi-extension/dist/session-sources/read-only-session.js +148 -0
  32. package/pi-extension/dist/session-sources/sources.js +277 -0
  33. package/pi-extension/dist/settings/settings-ui.js +274 -147
  34. package/pi-extension/src/cognitive-routing-v2/budget.ts +42 -0
  35. package/pi-extension/src/cognitive-routing-v2/config.ts +173 -0
  36. package/pi-extension/src/cognitive-routing-v2/projection.ts +375 -0
  37. package/pi-extension/src/cognitive-routing-v2/render.ts +277 -0
  38. package/pi-extension/src/cognitive-routing-v2/runtime.ts +2241 -0
  39. package/pi-extension/src/cognitive-routing-v2/schemas.ts +180 -0
  40. package/pi-extension/src/cognitive-routing-v2/state.ts +839 -0
  41. package/pi-extension/src/cognitive-routing-v2/tools.ts +62 -0
  42. package/pi-extension/src/cognitive-routing-v2/types.ts +254 -0
  43. package/pi-extension/src/context-virtualization/runtime.ts +30 -8
  44. package/pi-extension/src/freeflow-context/tool.ts +12 -6
  45. package/pi-extension/src/index.ts +308 -675
  46. package/pi-extension/src/provider-support/astra/adapter.ts +108 -0
  47. package/pi-extension/src/provider-support/astra/history.ts +145 -0
  48. package/pi-extension/src/provider-support/astra/index.ts +12 -0
  49. package/pi-extension/src/provider-support/astra/session-state.ts +113 -0
  50. package/pi-extension/src/provider-support/index.ts +5 -0
  51. package/pi-extension/src/runtime/request-history.ts +243 -0
  52. package/pi-extension/src/runtime/runtime-context.ts +100 -17
  53. package/pi-extension/src/session-sources/events.ts +230 -0
  54. package/pi-extension/src/session-sources/provenance.ts +39 -0
  55. package/pi-extension/src/session-sources/read-only-session.ts +170 -0
  56. package/pi-extension/src/session-sources/sources.ts +334 -0
  57. package/pi-extension/src/settings/settings-ui.ts +311 -158
  58. package/pi-extension/tests/cache-reuse/history.test.js +117 -0
  59. package/pi-extension/tests/cache-reuse/native.test.js +91 -0
  60. package/pi-extension/tests/cache-reuse/settings.test.js +211 -0
  61. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +577 -0
  62. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +183 -0
  63. package/pi-extension/tests/cognitive-routing-v2/delegation.test.js +557 -0
  64. package/pi-extension/tests/cognitive-routing-v2/native.test.js +474 -0
  65. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +87 -0
  66. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +300 -0
  67. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +241 -0
  68. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +1034 -0
  69. package/pi-extension/tests/cognitive-routing-v2/render.test.js +244 -0
  70. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +423 -0
  71. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +521 -0
  72. package/pi-extension/tests/cognitive-routing-v2/state.test.js +586 -0
  73. package/pi-extension/tests/context-virtualization/extension.test.js +33 -7
  74. package/pi-extension/tests/context-virtualization/runtime.test.js +17 -3
  75. package/pi-extension/tests/fixtures/routing-native.js +191 -0
  76. package/pi-extension/tests/integration/mode-free-core.test.js +6 -4
  77. package/pi-extension/tests/integration/pi-extension.test.js +655 -59
  78. package/pi-extension/tests/integration/prompt-architecture.test.js +127 -30
  79. package/pi-extension/tests/integration/unaffected-regressions.test.js +78 -11
  80. package/pi-extension/tests/provider-support/astra-boundaries.test.js +75 -0
  81. package/pi-extension/tests/provider-support/astra.test.js +306 -0
  82. package/pi-extension/tests/provider-support/cli.test.js +92 -0
  83. package/pi-extension/tests/provider-support/native.test.js +183 -0
  84. package/plugin.json +1 -1
  85. package/runtime/prompts/cognitive-routing.md +4 -5
  86. package/runtime/prompts/core.md +51 -45
  87. package/runtime/prompts/interaction-contract.md +5 -5
  88. package/skills/action-selection/SKILL.md +57 -97
  89. package/skills/design-for-depth/SKILL.md +58 -193
  90. package/skills/design-for-depth/references/implementation-decisions.md +76 -0
  91. package/skills/diagnose-failure/SKILL.md +64 -196
  92. package/skills/discuss/SKILL.md +64 -123
  93. package/skills/discuss/references/discussion-continuity.md +7 -3
  94. package/skills/execute-work/SKILL.md +69 -88
  95. package/skills/execute-work/references/execute-work-edges.md +9 -3
  96. package/skills/handoff/SKILL.md +44 -54
  97. package/skills/handoff/references/handoff-templates.md +15 -6
  98. package/skills/review-artifact/SKILL.md +80 -127
  99. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
  100. package/skills/review-work/SKILL.md +65 -115
  101. package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
  102. package/skills/simplify-code/SKILL.md +47 -100
  103. package/skills/track-work/SKILL.md +128 -119
  104. package/skills/track-work/references/working-record-format.md +14 -2
  105. package/skills/verify-work/SKILL.md +58 -62
  106. package/skills/verify-work/references/integration-evidence.md +4 -2
  107. package/skills/verify-work/references/test-design.md +89 -0
  108. package/skills/workflow/SKILL.md +73 -119
  109. package/skills/write-plan/SKILL.md +46 -77
  110. package/skills/write-plan/references/plan-shapes.md +5 -5
  111. package/skills/write-spec/SKILL.md +51 -63
  112. package/skills/write-spec/references/artifact-standards.md +2 -2
  113. package/skills/write-spec/references/decision-records.md +3 -2
  114. package/skills/write-spec/references/spec-shapes.md +15 -0
  115. package/pi-extension/dist/cognitive-routing/commands.js +0 -96
  116. package/pi-extension/dist/cognitive-routing/config.js +0 -232
  117. package/pi-extension/dist/cognitive-routing/controller.js +0 -1292
  118. package/pi-extension/dist/cognitive-routing/history.js +0 -451
  119. package/pi-extension/dist/cognitive-routing/host.js +0 -188
  120. package/pi-extension/dist/cognitive-routing/pi-routing-session.js +0 -414
  121. package/pi-extension/dist/cognitive-routing/pi-session-control.js +0 -320
  122. package/pi-extension/dist/cognitive-routing/runtime.js +0 -43
  123. package/pi-extension/dist/cognitive-routing/tool.js +0 -212
  124. package/pi-extension/dist/cognitive-routing/types.js +0 -6
  125. package/pi-extension/src/cognitive-routing/commands.ts +0 -129
  126. package/pi-extension/src/cognitive-routing/config.ts +0 -303
  127. package/pi-extension/src/cognitive-routing/controller.ts +0 -1628
  128. package/pi-extension/src/cognitive-routing/history.ts +0 -650
  129. package/pi-extension/src/cognitive-routing/host.ts +0 -266
  130. package/pi-extension/src/cognitive-routing/pi-routing-session.ts +0 -538
  131. package/pi-extension/src/cognitive-routing/pi-session-control.ts +0 -444
  132. package/pi-extension/src/cognitive-routing/runtime.ts +0 -57
  133. package/pi-extension/src/cognitive-routing/tool.ts +0 -273
  134. package/pi-extension/src/cognitive-routing/types.ts +0 -89
  135. package/pi-extension/tests/cognitive-routing/commands.test.js +0 -134
  136. package/pi-extension/tests/cognitive-routing/controller.test.js +0 -1128
  137. package/pi-extension/tests/cognitive-routing/extension-lifecycle.test.js +0 -1142
  138. package/pi-extension/tests/cognitive-routing/history.test.js +0 -274
  139. package/pi-extension/tests/cognitive-routing/host-identity.test.js +0 -63
  140. package/pi-extension/tests/cognitive-routing/pi-normal-lifecycle.test.js +0 -434
  141. package/pi-extension/tests/cognitive-routing/pi-session-control.test.js +0 -174
  142. package/pi-extension/tests/cognitive-routing/pi-session-history.test.js +0 -91
  143. package/pi-extension/tests/cognitive-routing/profile-resolution.test.js +0 -279
  144. package/pi-extension/tests/cognitive-routing/tool.test.js +0 -230
  145. package/skills/tdd/SKILL.md +0 -143
  146. package/skills/tdd/references/test-design.md +0 -96
  147. /package/pi-extension/tests/{cognitive-routing/host-fixture.js → fixtures/pi-host.js} +0 -0
@@ -1,451 +0,0 @@
1
- import { PI_SESSION_MODEL_STATE_ENTRY, parsePiSessionModelStateCommit } from "./pi-session-control.js";
2
- const COGNITIVE_ROUTING_INTENT_ENTRY = "freeflow-cognitive-routing-intent";
3
- const COGNITIVE_ROUTING_CONTROL_ENTRY = "freeflow-cognitive-routing-control";
4
- const UNKNOWN = "unknown";
5
- function isRecord(value) {
6
- return Boolean(value && typeof value === "object");
7
- }
8
- function stringValue(value) {
9
- return typeof value === "string" && value.length > 0 ? value : undefined;
10
- }
11
- function nullableString(value) {
12
- if (value === null) return null;
13
- return typeof value === "string" ? value : undefined;
14
- }
15
- function profileName(value) {
16
- return value === "standard" || value === "reasoning" ? value : undefined;
17
- }
18
- function pairFrom(value) {
19
- if (!isRecord(value)) return undefined;
20
- const provider = stringValue(value.provider);
21
- const modelId = stringValue(value.modelId ?? value.id);
22
- const thinkingLevel = stringValue(value.thinkingLevel);
23
- if (!provider || !modelId || !thinkingLevel) return undefined;
24
- return { provider, modelId, thinkingLevel };
25
- }
26
- function pairFromEntry(entry) {
27
- return pairFrom({
28
- provider: entry.provider,
29
- modelId: entry.modelId,
30
- thinkingLevel: entry.thinkingLevel,
31
- });
32
- }
33
- function pairsEqual(left, right) {
34
- return (
35
- left?.provider === right?.provider &&
36
- left?.modelId === right?.modelId &&
37
- left?.thinkingLevel === right?.thinkingLevel
38
- );
39
- }
40
- function validTimestamp(value) {
41
- if (typeof value === "string" && !Number.isNaN(Date.parse(value))) return value;
42
- if (typeof value === "number" && Number.isFinite(value)) {
43
- const date = new Date(value);
44
- return Number.isNaN(date.getTime()) ? undefined : date.toISOString();
45
- }
46
- return undefined;
47
- }
48
- function metadataFor(entry, position) {
49
- const raw = isRecord(entry) ? entry : {};
50
- const knownId = stringValue(raw.id);
51
- const parentId = stringValue(raw.parentId);
52
- const timestamp = validTimestamp(raw.timestamp);
53
- const id = knownId ?? `${UNKNOWN}:${position}`;
54
- return {
55
- raw,
56
- position,
57
- id,
58
- ...(parentId ? { parentId } : {}),
59
- ...(timestamp ? { timestamp } : {}),
60
- ...(knownId ? { branchAnchor: knownId } : {}),
61
- };
62
- }
63
- function sourceFrom(value) {
64
- return value === "user" || value === "agent" || value === "system" ? value : "unknown";
65
- }
66
- function versionFrom(value) {
67
- return value === 1 || value === 2 ? value : undefined;
68
- }
69
- function parseIntent(value) {
70
- if (!isRecord(value)) return undefined;
71
- const version = versionFrom(value.version);
72
- const kind =
73
- value.kind === "activation" || value.kind === "profile" || value.kind === "closing" ? value.kind : undefined;
74
- const phase = value.phase === "prepared" || value.phase === "abandoned" ? value.phase : undefined;
75
- const epoch = stringValue(value.epoch);
76
- const correlationId = stringValue(value.correlationId);
77
- const target = pairFrom(value.target);
78
- const returnTarget = pairFrom(value.returnTarget);
79
- if (!version || !kind || !phase || !target || !returnTarget || !epoch || !correlationId) return undefined;
80
- const reason = stringValue(value.reason);
81
- const resumeReason = stringValue(value.resumeReason);
82
- const branchId = nullableString(value.branchId);
83
- const mechanism = stringValue(value.mechanism);
84
- const decisionCorrelationId = stringValue(value.decisionCorrelationId);
85
- const fromPair = pairFrom(value.fromPair);
86
- const profile = profileName(value.profile);
87
- const resumeProfile = profileName(value.resumeProfile);
88
- const fromProfile = profileName(value.fromProfile);
89
- return {
90
- version,
91
- kind,
92
- phase,
93
- control: value.control === "manual" ? "manual" : "automatic",
94
- source: sourceFrom(value.source),
95
- ...(reason ? { reason } : {}),
96
- ...(branchId === undefined ? {} : { branchId }),
97
- epoch,
98
- correlationId,
99
- ...(profile ? { profile } : {}),
100
- ...(resumeProfile ? { resumeProfile } : {}),
101
- ...(value.resumeControl === "automatic" || value.resumeControl === "manual"
102
- ? { resumeControl: value.resumeControl }
103
- : {}),
104
- ...(resumeReason ? { resumeReason } : {}),
105
- target,
106
- returnTarget,
107
- ...(mechanism ? { mechanism } : {}),
108
- ...(decisionCorrelationId ? { decisionCorrelationId } : {}),
109
- ...(fromPair ? { fromPair } : {}),
110
- ...(fromProfile ? { fromProfile } : {}),
111
- };
112
- }
113
- function parseControl(value) {
114
- if (!isRecord(value)) return undefined;
115
- const version = versionFrom(value.version);
116
- if (!version || value.control !== "automatic") return undefined;
117
- const reason = stringValue(value.reason);
118
- const branchId = nullableString(value.branchId);
119
- const epoch = stringValue(value.epoch);
120
- const mechanism = stringValue(value.mechanism);
121
- return {
122
- version,
123
- control: "automatic",
124
- source: value.source === "user" ? "user" : "unknown",
125
- ...(reason ? { reason } : {}),
126
- ...(branchId === undefined ? {} : { branchId }),
127
- ...(epoch ? { epoch } : {}),
128
- ...(mechanism ? { mechanism } : {}),
129
- };
130
- }
131
- function eventBase(id, metadata) {
132
- return {
133
- id,
134
- ...(metadata.timestamp ? { timestamp: metadata.timestamp } : {}),
135
- jsonlPosition: metadata.position,
136
- entryId: metadata.id,
137
- ...(metadata.parentId ? { parentId: metadata.parentId } : {}),
138
- ...(metadata.branchAnchor ? { branchAnchor: metadata.branchAnchor } : {}),
139
- };
140
- }
141
- function profileForPair(pair, options) {
142
- if (!pair) return undefined;
143
- if (options.profileForPair) return options.profileForPair(pair);
144
- for (const profile of ["standard", "reasoning"]) {
145
- if (pairsEqual(pair, options.profilePairs?.[profile])) return profile;
146
- }
147
- return undefined;
148
- }
149
- function intentClassification(intent) {
150
- if (intent.kind === "profile")
151
- return intent.source === "user" || intent.source === "agent" ? "semantic-switch" : "lifecycle-replay";
152
- if (intent.kind === "closing") return "return-target-restore";
153
- return ["reload-restore", "recovery", "session-tree", "session-compact"].includes(intent.mechanism ?? "")
154
- ? "lifecycle-replay"
155
- : "initialization";
156
- }
157
- function lifecycleDecisionSource(intent, semanticSources) {
158
- if (intent.kind === "profile" && (intent.source === "user" || intent.source === "agent")) return intent.source;
159
- if (intent.decisionCorrelationId && semanticSources.get(intent.decisionCorrelationId)) {
160
- return semanticSources.get(intent.decisionCorrelationId);
161
- }
162
- if (intent.kind === "profile" || intent.source === "unknown") return "unknown";
163
- return "none";
164
- }
165
- function metadataIntegrity(intent, semanticSources) {
166
- if (intent.version === 1) return { integrity: "unknown" };
167
- if (!intent.mechanism) return { integrity: "anomaly", anomalyReason: "mechanism_missing" };
168
- if (!intent.fromPair) return { integrity: "anomaly", anomalyReason: "from_pair_missing" };
169
- if (intent.kind === "profile") {
170
- if (!intent.decisionCorrelationId) return { integrity: "anomaly", anomalyReason: "decision_correlation_missing" };
171
- if (intent.source === "user" || intent.source === "agent") {
172
- if (intent.decisionCorrelationId !== intent.correlationId) {
173
- return { integrity: "anomaly", anomalyReason: "semantic_decision_correlation_mismatch" };
174
- }
175
- } else if (!semanticSources.has(intent.decisionCorrelationId)) {
176
- return { integrity: "anomaly", anomalyReason: "lifecycle_decision_unresolved" };
177
- }
178
- }
179
- return { integrity: "valid" };
180
- }
181
- function intentEvent(
182
- record,
183
- representative,
184
- host,
185
- options,
186
- semanticSources,
187
- outcome,
188
- integrity,
189
- changed,
190
- anomalyReason,
191
- ) {
192
- const intent = record.prepared.intent;
193
- const metadata = metadataIntegrity(intent, semanticSources);
194
- const effectiveIntegrity = metadata.integrity === "anomaly" ? "anomaly" : integrity;
195
- const classification = intentClassification(intent);
196
- const from = intent.fromProfile ?? profileForPair(intent.fromPair, options);
197
- const to = intent.profile ?? profileForPair(intent.target, options);
198
- return {
199
- ...eventBase(`intent:${record.prepared.metadata.id}`, representative),
200
- classification,
201
- decisionSource: lifecycleDecisionSource(intent, semanticSources),
202
- ...(intent.mechanism ? { mechanism: intent.mechanism } : {}),
203
- outcome,
204
- changed,
205
- integrity: effectiveIntegrity,
206
- ...(from ? { from } : {}),
207
- ...(to ? { to } : {}),
208
- ...(intent.control ? { control: intent.control } : {}),
209
- ...(intent.reason ? { reason: intent.reason } : {}),
210
- epoch: intent.epoch,
211
- correlationId: intent.correlationId,
212
- ...(intent.decisionCorrelationId ? { decisionCorrelationId: intent.decisionCorrelationId } : {}),
213
- ...(host?.hostOrigin === undefined ? {} : { hostOrigin: host.hostOrigin }),
214
- ...(anomalyReason || metadata.anomalyReason ? { anomalyReason: anomalyReason ?? metadata.anomalyReason } : {}),
215
- representativePosition: representative.position,
216
- };
217
- }
218
- function controlEvent(metadata, control) {
219
- const integrity = control.version === 1 ? "unknown" : control.mechanism ? "valid" : "anomaly";
220
- const anomalyReason = control.version === 2 && !control.mechanism ? "mechanism_missing" : undefined;
221
- return {
222
- ...eventBase(`control:${metadata.id}`, metadata),
223
- classification: "control-only",
224
- decisionSource: control.source,
225
- ...(control.mechanism ? { mechanism: control.mechanism } : {}),
226
- outcome: "completed",
227
- changed: false,
228
- integrity,
229
- control: "automatic",
230
- ...(control.reason ? { reason: control.reason } : {}),
231
- ...(control.epoch ? { epoch: control.epoch } : {}),
232
- ...(anomalyReason ? { anomalyReason } : {}),
233
- representativePosition: metadata.position,
234
- };
235
- }
236
- function hostEvent(host, integrity, anomalyReason) {
237
- return {
238
- ...eventBase(`host:${host.metadata.id}`, host.metadata),
239
- classification: "external-host-change",
240
- decisionSource: "none",
241
- outcome: "external",
242
- changed: "unknown",
243
- integrity,
244
- ...(host.correlationId ? { correlationId: host.correlationId } : {}),
245
- ...(host.hostOrigin === undefined ? {} : { hostOrigin: host.hostOrigin }),
246
- ...(anomalyReason ? { anomalyReason } : {}),
247
- representativePosition: host.metadata.position,
248
- };
249
- }
250
- function activeEntryIds(entries) {
251
- return new Set(
252
- (Array.isArray(entries) ? entries : [])
253
- .map((entry, index) => metadataFor(entry, index).id)
254
- .filter((id) => !id.startsWith(`${UNKNOWN}:`)),
255
- );
256
- }
257
- function normalizeLimit(limit) {
258
- if (!Number.isInteger(limit)) return 20;
259
- return Math.max(1, Math.min(100, limit));
260
- }
261
- function currentState(current) {
262
- return {
263
- control: current?.control === "automatic" || current?.control === "manual" ? current.control : "unavailable",
264
- profile: current?.profile === "standard" || current?.profile === "reasoning" ? current.profile : "unavailable",
265
- };
266
- }
267
- export function projectCognitiveRoutingHistory(entries, options = {}) {
268
- const intentRecords = new Map();
269
- const controls = [];
270
- const hosts = [];
271
- const semanticSources = new Map();
272
- entries.forEach((entry, position) => {
273
- const metadata = metadataFor(entry, position);
274
- if (!isRecord(entry)) return;
275
- if (entry.type === "custom" && entry.customType === COGNITIVE_ROUTING_INTENT_ENTRY) {
276
- const parsed = parseIntent(entry.data);
277
- if (!parsed) return;
278
- if (parsed.phase === "abandoned") {
279
- const existing = intentRecords.get(parsed.correlationId);
280
- if (existing) existing.abandonment = { metadata, intent: parsed };
281
- return;
282
- }
283
- const existing = intentRecords.get(parsed.correlationId);
284
- if (existing) {
285
- existing.conflict = true;
286
- } else {
287
- intentRecords.set(parsed.correlationId, { prepared: { metadata, intent: parsed }, conflict: false });
288
- if (parsed.kind === "profile" && (parsed.source === "user" || parsed.source === "agent")) {
289
- semanticSources.set(parsed.correlationId, parsed.source);
290
- }
291
- }
292
- return;
293
- }
294
- if (entry.type === "custom" && entry.customType === COGNITIVE_ROUTING_CONTROL_ENTRY) {
295
- const parsed = parseControl(entry.data);
296
- if (parsed) controls.push({ metadata, control: parsed });
297
- return;
298
- }
299
- if (entry.type === "custom" && entry.customType === PI_SESSION_MODEL_STATE_ENTRY) {
300
- const parsed = parsePiSessionModelStateCommit(entry.data);
301
- if (!parsed || parsed.phase !== "committed" || parsed.status !== "applied") return;
302
- hosts.push({
303
- metadata,
304
- pair: parsed.target,
305
- correlationId: parsed.correlationId,
306
- hostOrigin: parsed.origin,
307
- });
308
- return;
309
- }
310
- if (entry.type === "model_state_change") {
311
- const correlationId = stringValue(entry.correlationId);
312
- hosts.push({
313
- metadata,
314
- pair: pairFromEntry(entry),
315
- ...(correlationId ? { correlationId } : {}),
316
- ...(entry.origin === undefined
317
- ? entry.hostOrigin === undefined
318
- ? {}
319
- : { hostOrigin: entry.hostOrigin }
320
- : { hostOrigin: entry.origin }),
321
- });
322
- }
323
- });
324
- const usedHostPositions = new Set();
325
- const events = [];
326
- const activeEpochs = new Set();
327
- let completedClosing = false;
328
- for (const record of intentRecords.values()) {
329
- const intent = record.prepared.intent;
330
- const correlatedHosts = hosts.filter((host) => host.correlationId === intent.correlationId);
331
- const matchingHosts = correlatedHosts.filter((host) => pairsEqual(host.pair, intent.target));
332
- correlatedHosts.forEach((host) => usedHostPositions.add(host.metadata.position));
333
- const metadata = metadataIntegrity(intent, semanticSources);
334
- if (intent.kind === "closing" && matchingHosts.length > 0) completedClosing = true;
335
- if (record.abandonment) {
336
- events.push(
337
- intentEvent(
338
- record,
339
- record.abandonment.metadata,
340
- undefined,
341
- options,
342
- semanticSources,
343
- "abandoned",
344
- record.conflict ? "anomaly" : metadata.integrity,
345
- "unknown",
346
- record.conflict ? "duplicate_intent" : metadata.anomalyReason,
347
- ),
348
- );
349
- continue;
350
- }
351
- if (intent.kind !== "closing") activeEpochs.add(intent.epoch);
352
- if (matchingHosts.length > 0) {
353
- const representative = matchingHosts.at(-1);
354
- const changed = intent.fromPair ? !pairsEqual(intent.fromPair, representative.pair) : "unknown";
355
- const duplicateReason = record.conflict
356
- ? "duplicate_intent"
357
- : correlatedHosts.length > 1
358
- ? "conflicting_host_results"
359
- : undefined;
360
- events.push(
361
- intentEvent(
362
- record,
363
- representative.metadata,
364
- representative,
365
- options,
366
- semanticSources,
367
- "completed",
368
- duplicateReason ? "anomaly" : changed === "unknown" ? "unknown" : metadata.integrity,
369
- changed,
370
- duplicateReason,
371
- ),
372
- );
373
- continue;
374
- }
375
- events.push(
376
- intentEvent(
377
- record,
378
- record.prepared.metadata,
379
- undefined,
380
- options,
381
- semanticSources,
382
- "unresolved",
383
- record.conflict || correlatedHosts.length > 0 || metadata.integrity === "anomaly" ? "anomaly" : "unknown",
384
- "unknown",
385
- record.conflict
386
- ? "duplicate_intent"
387
- : correlatedHosts.length > 0
388
- ? "host_target_mismatch"
389
- : metadata.anomalyReason,
390
- ),
391
- );
392
- }
393
- for (const item of controls) events.push(controlEvent(item.metadata, item.control));
394
- const routingOwnsHost = activeEpochs.size > 0 && !completedClosing;
395
- for (const host of hosts) {
396
- if (usedHostPositions.has(host.metadata.position)) continue;
397
- events.push(
398
- hostEvent(
399
- host,
400
- host.correlationId || routingOwnsHost ? "anomaly" : "valid",
401
- host.correlationId ? "correlation_unresolved" : routingOwnsHost ? "host_change_during_routing" : undefined,
402
- ),
403
- );
404
- }
405
- const scope = options.scope ?? "session";
406
- const activeIds = activeEntryIds(options.branchEntries);
407
- const scoped = events.filter((event) => scope !== "active-branch" || activeIds.has(event.entryId));
408
- const summary = {
409
- ...(scoped
410
- .filter((event) => event.classification === "semantic-switch")
411
- .sort((left, right) => left.representativePosition - right.representativePosition)
412
- .at(-1)?.id
413
- ? {
414
- latestSemanticEventId: scoped
415
- .filter((event) => event.classification === "semantic-switch")
416
- .sort((left, right) => left.representativePosition - right.representativePosition)
417
- .at(-1)?.id,
418
- }
419
- : {}),
420
- ...(scoped
421
- .filter((event) => event.outcome === "completed" && event.classification !== "control-only")
422
- .sort((left, right) => left.representativePosition - right.representativePosition)
423
- .at(-1)?.id
424
- ? {
425
- latestCompletedEventId: scoped
426
- .filter((event) => event.outcome === "completed" && event.classification !== "control-only")
427
- .sort((left, right) => left.representativePosition - right.representativePosition)
428
- .at(-1)?.id,
429
- }
430
- : {}),
431
- unresolvedCount: scoped.filter((event) => event.outcome === "unresolved").length,
432
- anomalyCount: scoped.filter((event) => event.integrity === "anomaly").length,
433
- };
434
- const visible = (options.anomaliesOnly ? scoped.filter((event) => event.integrity === "anomaly") : scoped)
435
- .sort((left, right) => right.representativePosition - left.representativePosition)
436
- .slice(0, normalizeLimit(options.limit))
437
- .map(({ representativePosition: _representativePosition, ...event }) => event);
438
- return { current: currentState(options.current), summary, events: visible };
439
- }
440
- export function readCognitiveRoutingHistory(context, options = {}) {
441
- let entries = [];
442
- let branchEntries = [];
443
- try {
444
- entries = context?.sessionManager?.getEntries?.() ?? [];
445
- branchEntries = context?.sessionManager?.getBranch?.() ?? entries;
446
- } catch {
447
- entries = [];
448
- branchEntries = [];
449
- }
450
- return projectCognitiveRoutingHistory(entries, { ...options, branchEntries });
451
- }
@@ -1,188 +0,0 @@
1
- import { COGNITIVE_ROUTING_PROFILE_NAMES } from "./types.js";
2
- const THINKING_LEVEL_ORDER = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
3
- const THINKING_LEVELS = new Set(THINKING_LEVEL_ORDER);
4
- function isRecord(value) {
5
- return typeof value === "object" && value !== null;
6
- }
7
- function isFunction(value) {
8
- return typeof value === "function";
9
- }
10
- function parseThinkingLevelMap(value) {
11
- if (!isRecord(value)) return undefined;
12
- const map = {};
13
- for (const [key, entry] of Object.entries(value)) {
14
- if (entry === null) map[key] = null;
15
- else if (entry === undefined) map[key] = undefined;
16
- else if (typeof entry === "string") map[key] = entry;
17
- }
18
- return map;
19
- }
20
- function parseModel(value) {
21
- if (!isRecord(value) || typeof value.provider !== "string" || typeof value.id !== "string") return undefined;
22
- const thinkingLevelMap = parseThinkingLevelMap(value.thinkingLevelMap);
23
- return {
24
- ...value,
25
- provider: value.provider,
26
- id: value.id,
27
- reasoning: typeof value.reasoning === "boolean" ? value.reasoning : undefined,
28
- ...(thinkingLevelMap ? { thinkingLevelMap } : {}),
29
- };
30
- }
31
- function modelRegistry(host) {
32
- if (!isRecord(host)) return undefined;
33
- const candidateValue = host.modelRegistry ?? host;
34
- if (!isRecord(candidateValue)) return undefined;
35
- const candidate = candidateValue;
36
- if (!isFunction(candidate.find) || !isFunction(candidate.getApiKeyAndHeaders)) return undefined;
37
- const find = candidate.find;
38
- const getApiKeyAndHeaders = candidate.getApiKeyAndHeaders;
39
- const clamp = isFunction(candidate.clampThinkingLevel) ? candidate.clampThinkingLevel : undefined;
40
- return {
41
- find: (provider, modelId) => parseModel(find.call(candidate, provider, modelId)),
42
- getApiKeyAndHeaders: (model) => getApiKeyAndHeaders.call(candidate, model),
43
- ...(clamp
44
- ? {
45
- clampThinkingLevel: (model, level) => clamp.call(candidate, model, level),
46
- }
47
- : {}),
48
- };
49
- }
50
- export function supportsCognitiveRoutingModelRegistry(host) {
51
- return modelRegistry(host) !== undefined;
52
- }
53
- function supportedThinkingLevels(model) {
54
- if (!model.reasoning) return ["off"];
55
- return THINKING_LEVEL_ORDER.filter((level) => {
56
- const mapped = model.thinkingLevelMap?.[level];
57
- if (mapped === null) return false;
58
- if (level === "xhigh" || level === "max") return mapped !== undefined;
59
- return true;
60
- });
61
- }
62
- function clampThinkingLevel(model, requested) {
63
- const availableLevels = supportedThinkingLevels(model);
64
- if (availableLevels.includes(requested)) return requested;
65
- const requestedIndex = THINKING_LEVEL_ORDER.indexOf(requested);
66
- if (requestedIndex < 0) return availableLevels[0] ?? "off";
67
- for (let index = requestedIndex; index < THINKING_LEVEL_ORDER.length; index += 1) {
68
- const candidate = THINKING_LEVEL_ORDER[index];
69
- if (availableLevels.includes(candidate)) return candidate;
70
- }
71
- for (let index = requestedIndex - 1; index >= 0; index -= 1) {
72
- const candidate = THINKING_LEVEL_ORDER[index];
73
- if (availableLevels.includes(candidate)) return candidate;
74
- }
75
- return availableLevels[0] ?? "off";
76
- }
77
- function resolveEffectiveThinkingLevel(registry, model, requested) {
78
- if (registry.clampThinkingLevel) return registry.clampThinkingLevel(model, requested);
79
- return clampThinkingLevel(model, requested);
80
- }
81
- function blocking(code, message, profile) {
82
- return { code, message, ...(profile ? { profile } : {}) };
83
- }
84
- function modelIdentity(model) {
85
- if (!model || typeof model !== "object") return undefined;
86
- const provider = "provider" in model ? model.provider : undefined;
87
- const id = "id" in model ? model.id : undefined;
88
- return typeof provider === "string" && typeof id === "string" ? `${provider}/${id}` : undefined;
89
- }
90
- function isWeakened(requested, effective) {
91
- const requestedIndex = THINKING_LEVEL_ORDER.indexOf(requested);
92
- const effectiveIndex = THINKING_LEVEL_ORDER.indexOf(effective);
93
- return effectiveIndex >= 0 && requestedIndex >= 0 && effectiveIndex < requestedIndex;
94
- }
95
- export async function preflightCognitiveRoutingProfiles(config, host) {
96
- const registry = modelRegistry(host);
97
- if (!registry) {
98
- return {
99
- effective: false,
100
- resolvedProfiles: {},
101
- blockingReason: blocking("host_unsupported", "Pi does not expose the required Cognitive Routing host controls"),
102
- };
103
- }
104
- const resolvedProfiles = {};
105
- const resolvedIdentities = {};
106
- for (const name of COGNITIVE_ROUTING_PROFILE_NAMES) {
107
- const profile = config.profiles[name];
108
- if (!profile) {
109
- return {
110
- effective: false,
111
- resolvedProfiles,
112
- blockingReason: blocking("profile_missing", `Cognitive Routing profile is missing: ${name}`, name),
113
- };
114
- }
115
- const model = registry.find(profile.provider, profile.model);
116
- if (!model) {
117
- return {
118
- effective: false,
119
- resolvedProfiles,
120
- blockingReason: blocking(
121
- "profile_unavailable",
122
- `Cognitive Routing profile is unavailable: ${profile.provider}/${profile.model}`,
123
- name,
124
- ),
125
- };
126
- }
127
- let auth;
128
- try {
129
- auth = await registry.getApiKeyAndHeaders(model);
130
- } catch (error) {
131
- auth = { ok: false, error: error instanceof Error ? error.message : String(error) };
132
- }
133
- if (!auth.ok) {
134
- return {
135
- effective: false,
136
- resolvedProfiles,
137
- blockingReason: blocking(
138
- "profile_unauthenticated",
139
- `Cognitive Routing profile is not authenticated: ${profile.provider}/${profile.model}${auth.error ? ` (${auth.error})` : ""}`,
140
- name,
141
- ),
142
- };
143
- }
144
- const effectiveThinkingLevel = resolveEffectiveThinkingLevel(registry, model, profile.thinkingLevel);
145
- if (!THINKING_LEVELS.has(effectiveThinkingLevel)) {
146
- return {
147
- effective: false,
148
- resolvedProfiles,
149
- blockingReason: blocking(
150
- "host_unsupported",
151
- `Pi returned an invalid effective thinking level for ${profile.provider}/${profile.model}`,
152
- name,
153
- ),
154
- };
155
- }
156
- if (isWeakened(profile.thinkingLevel, effectiveThinkingLevel)) {
157
- return {
158
- effective: false,
159
- resolvedProfiles,
160
- blockingReason: blocking(
161
- "profile_clamped",
162
- `Cognitive Routing profile is weakened by thinking-level clamping: ${profile.provider}/${profile.model}`,
163
- name,
164
- ),
165
- };
166
- }
167
- resolvedProfiles[name] = {
168
- ...profile,
169
- effectiveThinkingLevel,
170
- };
171
- resolvedIdentities[name] = modelIdentity(model);
172
- }
173
- const standard = resolvedProfiles.standard;
174
- const reasoning = resolvedProfiles.reasoning;
175
- if (
176
- standard &&
177
- reasoning &&
178
- resolvedIdentities.standard === resolvedIdentities.reasoning &&
179
- standard.effectiveThinkingLevel === reasoning.effectiveThinkingLevel
180
- ) {
181
- return {
182
- effective: false,
183
- resolvedProfiles,
184
- blockingReason: blocking("profiles_identical", "Cognitive Routing profiles resolve to the same effective pair"),
185
- };
186
- }
187
- return { effective: true, resolvedProfiles };
188
- }