@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.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/README.md +153 -128
- package/capabilities/cognitive-routing/SKILL.md +126 -274
- package/command-surface.json +7 -1
- package/gemini-extension.json +1 -1
- package/package.json +4 -4
- package/pi-extension/dist/cognitive-routing-v2/budget.js +42 -0
- package/pi-extension/dist/cognitive-routing-v2/config.js +136 -0
- package/pi-extension/dist/cognitive-routing-v2/projection.js +330 -0
- package/pi-extension/dist/cognitive-routing-v2/render.js +252 -0
- package/pi-extension/dist/cognitive-routing-v2/runtime.js +2181 -0
- package/pi-extension/dist/cognitive-routing-v2/schemas.js +173 -0
- package/pi-extension/dist/cognitive-routing-v2/state.js +828 -0
- package/pi-extension/dist/cognitive-routing-v2/tools.js +60 -0
- package/pi-extension/dist/cognitive-routing-v2/types.js +48 -0
- package/pi-extension/dist/context-virtualization/runtime.js +29 -7
- package/pi-extension/dist/freeflow-context/tool.js +12 -6
- package/pi-extension/dist/index.js +302 -626
- package/pi-extension/dist/provider-support/astra/adapter.js +110 -0
- package/pi-extension/dist/provider-support/astra/history.js +125 -0
- package/pi-extension/dist/provider-support/astra/index.js +11 -0
- package/pi-extension/dist/provider-support/astra/session-state.js +114 -0
- package/pi-extension/dist/provider-support/index.js +4 -0
- package/pi-extension/dist/runtime/request-history.js +216 -0
- package/pi-extension/dist/runtime/runtime-context.js +85 -16
- package/pi-extension/dist/session-sources/events.js +217 -0
- package/pi-extension/dist/session-sources/provenance.js +32 -0
- package/pi-extension/dist/session-sources/read-only-session.js +148 -0
- package/pi-extension/dist/session-sources/sources.js +277 -0
- package/pi-extension/dist/settings/settings-ui.js +274 -147
- package/pi-extension/src/cognitive-routing-v2/budget.ts +42 -0
- package/pi-extension/src/cognitive-routing-v2/config.ts +173 -0
- package/pi-extension/src/cognitive-routing-v2/projection.ts +375 -0
- package/pi-extension/src/cognitive-routing-v2/render.ts +277 -0
- package/pi-extension/src/cognitive-routing-v2/runtime.ts +2241 -0
- package/pi-extension/src/cognitive-routing-v2/schemas.ts +180 -0
- package/pi-extension/src/cognitive-routing-v2/state.ts +839 -0
- package/pi-extension/src/cognitive-routing-v2/tools.ts +62 -0
- package/pi-extension/src/cognitive-routing-v2/types.ts +254 -0
- package/pi-extension/src/context-virtualization/runtime.ts +30 -8
- package/pi-extension/src/freeflow-context/tool.ts +12 -6
- package/pi-extension/src/index.ts +308 -675
- package/pi-extension/src/provider-support/astra/adapter.ts +108 -0
- package/pi-extension/src/provider-support/astra/history.ts +145 -0
- package/pi-extension/src/provider-support/astra/index.ts +12 -0
- package/pi-extension/src/provider-support/astra/session-state.ts +113 -0
- package/pi-extension/src/provider-support/index.ts +5 -0
- package/pi-extension/src/runtime/request-history.ts +243 -0
- package/pi-extension/src/runtime/runtime-context.ts +100 -17
- package/pi-extension/src/session-sources/events.ts +230 -0
- package/pi-extension/src/session-sources/provenance.ts +39 -0
- package/pi-extension/src/session-sources/read-only-session.ts +170 -0
- package/pi-extension/src/session-sources/sources.ts +334 -0
- package/pi-extension/src/settings/settings-ui.ts +311 -158
- package/pi-extension/tests/cache-reuse/history.test.js +117 -0
- package/pi-extension/tests/cache-reuse/native.test.js +91 -0
- package/pi-extension/tests/cache-reuse/settings.test.js +211 -0
- package/pi-extension/tests/cognitive-routing-v2/communication.test.js +577 -0
- package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +183 -0
- package/pi-extension/tests/cognitive-routing-v2/delegation.test.js +557 -0
- package/pi-extension/tests/cognitive-routing-v2/native.test.js +474 -0
- package/pi-extension/tests/cognitive-routing-v2/performance.test.js +87 -0
- package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +300 -0
- package/pi-extension/tests/cognitive-routing-v2/projection.test.js +241 -0
- package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +1034 -0
- package/pi-extension/tests/cognitive-routing-v2/render.test.js +244 -0
- package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +423 -0
- package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +521 -0
- package/pi-extension/tests/cognitive-routing-v2/state.test.js +586 -0
- package/pi-extension/tests/context-virtualization/extension.test.js +33 -7
- package/pi-extension/tests/context-virtualization/runtime.test.js +17 -3
- package/pi-extension/tests/fixtures/routing-native.js +191 -0
- package/pi-extension/tests/integration/mode-free-core.test.js +6 -4
- package/pi-extension/tests/integration/pi-extension.test.js +655 -59
- package/pi-extension/tests/integration/prompt-architecture.test.js +127 -30
- package/pi-extension/tests/integration/unaffected-regressions.test.js +78 -11
- package/pi-extension/tests/provider-support/astra-boundaries.test.js +75 -0
- package/pi-extension/tests/provider-support/astra.test.js +306 -0
- package/pi-extension/tests/provider-support/cli.test.js +92 -0
- package/pi-extension/tests/provider-support/native.test.js +183 -0
- package/plugin.json +1 -1
- package/runtime/prompts/cognitive-routing.md +4 -5
- package/runtime/prompts/core.md +51 -45
- package/runtime/prompts/interaction-contract.md +5 -5
- package/skills/action-selection/SKILL.md +57 -97
- package/skills/design-for-depth/SKILL.md +58 -193
- package/skills/design-for-depth/references/implementation-decisions.md +76 -0
- package/skills/diagnose-failure/SKILL.md +64 -196
- package/skills/discuss/SKILL.md +64 -123
- package/skills/discuss/references/discussion-continuity.md +7 -3
- package/skills/execute-work/SKILL.md +69 -88
- package/skills/execute-work/references/execute-work-edges.md +9 -3
- package/skills/handoff/SKILL.md +44 -54
- package/skills/handoff/references/handoff-templates.md +15 -6
- package/skills/review-artifact/SKILL.md +80 -127
- package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
- package/skills/review-work/SKILL.md +65 -115
- package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
- package/skills/simplify-code/SKILL.md +47 -100
- package/skills/track-work/SKILL.md +128 -119
- package/skills/track-work/references/working-record-format.md +14 -2
- package/skills/verify-work/SKILL.md +58 -62
- package/skills/verify-work/references/integration-evidence.md +4 -2
- package/skills/verify-work/references/test-design.md +89 -0
- package/skills/workflow/SKILL.md +73 -119
- package/skills/write-plan/SKILL.md +46 -77
- package/skills/write-plan/references/plan-shapes.md +5 -5
- package/skills/write-spec/SKILL.md +51 -63
- package/skills/write-spec/references/artifact-standards.md +2 -2
- package/skills/write-spec/references/decision-records.md +3 -2
- package/skills/write-spec/references/spec-shapes.md +15 -0
- package/pi-extension/dist/cognitive-routing/commands.js +0 -96
- package/pi-extension/dist/cognitive-routing/config.js +0 -232
- package/pi-extension/dist/cognitive-routing/controller.js +0 -1292
- package/pi-extension/dist/cognitive-routing/history.js +0 -451
- package/pi-extension/dist/cognitive-routing/host.js +0 -188
- package/pi-extension/dist/cognitive-routing/pi-routing-session.js +0 -414
- package/pi-extension/dist/cognitive-routing/pi-session-control.js +0 -320
- package/pi-extension/dist/cognitive-routing/runtime.js +0 -43
- package/pi-extension/dist/cognitive-routing/tool.js +0 -212
- package/pi-extension/dist/cognitive-routing/types.js +0 -6
- package/pi-extension/src/cognitive-routing/commands.ts +0 -129
- package/pi-extension/src/cognitive-routing/config.ts +0 -303
- package/pi-extension/src/cognitive-routing/controller.ts +0 -1628
- package/pi-extension/src/cognitive-routing/history.ts +0 -650
- package/pi-extension/src/cognitive-routing/host.ts +0 -266
- package/pi-extension/src/cognitive-routing/pi-routing-session.ts +0 -538
- package/pi-extension/src/cognitive-routing/pi-session-control.ts +0 -444
- package/pi-extension/src/cognitive-routing/runtime.ts +0 -57
- package/pi-extension/src/cognitive-routing/tool.ts +0 -273
- package/pi-extension/src/cognitive-routing/types.ts +0 -89
- package/pi-extension/tests/cognitive-routing/commands.test.js +0 -134
- package/pi-extension/tests/cognitive-routing/controller.test.js +0 -1128
- package/pi-extension/tests/cognitive-routing/extension-lifecycle.test.js +0 -1142
- package/pi-extension/tests/cognitive-routing/history.test.js +0 -274
- package/pi-extension/tests/cognitive-routing/host-identity.test.js +0 -63
- package/pi-extension/tests/cognitive-routing/pi-normal-lifecycle.test.js +0 -434
- package/pi-extension/tests/cognitive-routing/pi-session-control.test.js +0 -174
- package/pi-extension/tests/cognitive-routing/pi-session-history.test.js +0 -91
- package/pi-extension/tests/cognitive-routing/profile-resolution.test.js +0 -279
- package/pi-extension/tests/cognitive-routing/tool.test.js +0 -230
- package/skills/tdd/SKILL.md +0 -143
- package/skills/tdd/references/test-design.md +0 -96
- /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
|
-
}
|