@hassangameryt/freeflow 0.7.0 → 0.7.2

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 (136) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +2 -1
  3. package/.codex-plugin/plugin.json +2 -2
  4. package/.cursor-plugin/plugin.json +25 -0
  5. package/README.md +57 -26
  6. package/capabilities/cognitive-routing/SKILL.md +94 -311
  7. package/com.github.copilot/hooks/hooks.json +11 -0
  8. package/command-surface.json +7 -1
  9. package/gemini-extension.json +5 -0
  10. package/hooks/adapters/claude-session-start.mjs +16 -0
  11. package/hooks/adapters/codex-session-start.mjs +16 -0
  12. package/hooks/adapters/copilot-session-start.mjs +13 -0
  13. package/hooks/adapters/cursor-session-start.mjs +13 -0
  14. package/hooks/adapters/gemini-session-start.mjs +15 -0
  15. package/hooks/claude/hooks.json +18 -0
  16. package/hooks/codex/hooks.json +18 -0
  17. package/hooks/cursor/hooks.json +9 -0
  18. package/hooks/freeflow-runtime-context.mjs +3 -215
  19. package/hooks/hooks.json +4 -5
  20. package/hooks/shared/runtime-context.mjs +210 -0
  21. package/hooks/tests/check-host-adapters.test.mjs +82 -0
  22. package/hooks/tests/check-runtime-context-hook.sh +34 -3
  23. package/package.json +20 -6
  24. package/pi-extension/dist/cognitive-routing-v2/budget.js +42 -0
  25. package/pi-extension/dist/cognitive-routing-v2/config.js +120 -0
  26. package/pi-extension/dist/cognitive-routing-v2/projection.js +321 -0
  27. package/pi-extension/dist/cognitive-routing-v2/render.js +231 -0
  28. package/pi-extension/dist/cognitive-routing-v2/runtime.js +1585 -0
  29. package/pi-extension/dist/cognitive-routing-v2/schemas.js +107 -0
  30. package/pi-extension/dist/cognitive-routing-v2/state.js +612 -0
  31. package/pi-extension/dist/cognitive-routing-v2/tools.js +91 -0
  32. package/pi-extension/dist/cognitive-routing-v2/types.js +44 -0
  33. package/pi-extension/dist/freeflow-context/tool.js +5 -0
  34. package/pi-extension/dist/index.js +279 -624
  35. package/pi-extension/dist/runtime/runtime-context.js +63 -13
  36. package/pi-extension/dist/session-sources/events.js +195 -0
  37. package/pi-extension/dist/session-sources/read-only-session.js +148 -0
  38. package/pi-extension/dist/session-sources/sources.js +233 -0
  39. package/pi-extension/dist/settings/settings-ui.js +44 -117
  40. package/pi-extension/src/cognitive-routing-v2/budget.ts +42 -0
  41. package/pi-extension/src/cognitive-routing-v2/config.ts +143 -0
  42. package/pi-extension/src/cognitive-routing-v2/projection.ts +365 -0
  43. package/pi-extension/src/cognitive-routing-v2/render.ts +256 -0
  44. package/pi-extension/src/cognitive-routing-v2/runtime.ts +1634 -0
  45. package/pi-extension/src/cognitive-routing-v2/schemas.ts +109 -0
  46. package/pi-extension/src/cognitive-routing-v2/state.ts +622 -0
  47. package/pi-extension/src/cognitive-routing-v2/tools.ts +93 -0
  48. package/pi-extension/src/cognitive-routing-v2/types.ts +222 -0
  49. package/pi-extension/src/freeflow-context/tool.ts +5 -0
  50. package/pi-extension/src/index.ts +285 -674
  51. package/pi-extension/src/runtime/runtime-context.ts +75 -14
  52. package/pi-extension/src/session-sources/events.ts +208 -0
  53. package/pi-extension/src/session-sources/read-only-session.ts +170 -0
  54. package/pi-extension/src/session-sources/sources.ts +263 -0
  55. package/pi-extension/src/settings/settings-ui.ts +54 -131
  56. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +484 -0
  57. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +183 -0
  58. package/pi-extension/tests/cognitive-routing-v2/native.test.js +441 -0
  59. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +87 -0
  60. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +245 -0
  61. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +241 -0
  62. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +236 -0
  63. package/pi-extension/tests/cognitive-routing-v2/render.test.js +230 -0
  64. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +153 -0
  65. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +521 -0
  66. package/pi-extension/tests/cognitive-routing-v2/state.test.js +275 -0
  67. package/pi-extension/tests/context-virtualization/extension.test.js +16 -0
  68. package/pi-extension/tests/fixtures/routing-native.js +188 -0
  69. package/pi-extension/tests/integration/mode-free-core.test.js +3 -2
  70. package/pi-extension/tests/integration/pi-extension.test.js +154 -37
  71. package/pi-extension/tests/integration/prompt-architecture.test.js +87 -6
  72. package/pi-extension/tests/integration/unaffected-regressions.test.js +77 -10
  73. package/plugin.json +33 -0
  74. package/runtime/prompts/cognitive-routing.md +4 -5
  75. package/runtime/prompts/core.md +51 -45
  76. package/runtime/prompts/interaction-contract.md +5 -5
  77. package/skills/action-selection/SKILL.md +57 -97
  78. package/skills/design-for-depth/SKILL.md +58 -193
  79. package/skills/design-for-depth/references/implementation-decisions.md +76 -0
  80. package/skills/diagnose-failure/SKILL.md +64 -196
  81. package/skills/discuss/SKILL.md +64 -123
  82. package/skills/discuss/references/discussion-continuity.md +7 -3
  83. package/skills/execute-work/SKILL.md +69 -88
  84. package/skills/execute-work/references/execute-work-edges.md +9 -3
  85. package/skills/handoff/SKILL.md +44 -54
  86. package/skills/handoff/references/handoff-templates.md +15 -6
  87. package/skills/review-artifact/SKILL.md +80 -127
  88. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
  89. package/skills/review-work/SKILL.md +65 -115
  90. package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
  91. package/skills/simplify-code/SKILL.md +47 -100
  92. package/skills/track-work/SKILL.md +128 -119
  93. package/skills/track-work/references/working-record-format.md +14 -2
  94. package/skills/verify-work/SKILL.md +58 -62
  95. package/skills/verify-work/references/integration-evidence.md +4 -2
  96. package/skills/verify-work/references/test-design.md +89 -0
  97. package/skills/workflow/SKILL.md +73 -119
  98. package/skills/write-plan/SKILL.md +46 -77
  99. package/skills/write-plan/references/plan-shapes.md +5 -5
  100. package/skills/write-spec/SKILL.md +51 -63
  101. package/skills/write-spec/references/artifact-standards.md +2 -2
  102. package/skills/write-spec/references/decision-records.md +3 -2
  103. package/skills/write-spec/references/spec-shapes.md +15 -0
  104. package/pi-extension/dist/cognitive-routing/commands.js +0 -96
  105. package/pi-extension/dist/cognitive-routing/config.js +0 -232
  106. package/pi-extension/dist/cognitive-routing/controller.js +0 -1292
  107. package/pi-extension/dist/cognitive-routing/history.js +0 -451
  108. package/pi-extension/dist/cognitive-routing/host.js +0 -188
  109. package/pi-extension/dist/cognitive-routing/pi-routing-session.js +0 -414
  110. package/pi-extension/dist/cognitive-routing/pi-session-control.js +0 -320
  111. package/pi-extension/dist/cognitive-routing/runtime.js +0 -43
  112. package/pi-extension/dist/cognitive-routing/tool.js +0 -212
  113. package/pi-extension/dist/cognitive-routing/types.js +0 -6
  114. package/pi-extension/src/cognitive-routing/commands.ts +0 -129
  115. package/pi-extension/src/cognitive-routing/config.ts +0 -303
  116. package/pi-extension/src/cognitive-routing/controller.ts +0 -1628
  117. package/pi-extension/src/cognitive-routing/history.ts +0 -650
  118. package/pi-extension/src/cognitive-routing/host.ts +0 -266
  119. package/pi-extension/src/cognitive-routing/pi-routing-session.ts +0 -538
  120. package/pi-extension/src/cognitive-routing/pi-session-control.ts +0 -444
  121. package/pi-extension/src/cognitive-routing/runtime.ts +0 -57
  122. package/pi-extension/src/cognitive-routing/tool.ts +0 -273
  123. package/pi-extension/src/cognitive-routing/types.ts +0 -89
  124. package/pi-extension/tests/cognitive-routing/commands.test.js +0 -134
  125. package/pi-extension/tests/cognitive-routing/controller.test.js +0 -1128
  126. package/pi-extension/tests/cognitive-routing/extension-lifecycle.test.js +0 -1142
  127. package/pi-extension/tests/cognitive-routing/history.test.js +0 -274
  128. package/pi-extension/tests/cognitive-routing/host-identity.test.js +0 -63
  129. package/pi-extension/tests/cognitive-routing/pi-normal-lifecycle.test.js +0 -434
  130. package/pi-extension/tests/cognitive-routing/pi-session-control.test.js +0 -174
  131. package/pi-extension/tests/cognitive-routing/pi-session-history.test.js +0 -91
  132. package/pi-extension/tests/cognitive-routing/profile-resolution.test.js +0 -279
  133. package/pi-extension/tests/cognitive-routing/tool.test.js +0 -230
  134. package/skills/tdd/SKILL.md +0 -143
  135. package/skills/tdd/references/test-design.md +0 -96
  136. /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
- }