@hassangameryt/freeflow 0.7.2 → 0.8.0
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/NOTICE +14 -0
- package/README.md +151 -136
- package/capabilities/cognitive-routing/SKILL.md +110 -96
- package/capabilities/cognitive-routing/references/both-mode.md +36 -0
- package/capabilities/cognitive-routing/references/executor-mode.md +48 -0
- package/capabilities/cognitive-routing/references/helper-mode.md +47 -0
- package/capabilities/compaction/SKILL.md +49 -0
- package/capabilities/compaction/references/summary-format.md +239 -0
- package/command-surface.json +4 -0
- package/gemini-extension.json +1 -1
- package/hooks/shared/runtime-context.mjs +28 -30
- package/licenses/Apache-2.0.txt +55 -0
- package/package.json +22 -9
- package/pi-extension/README.md +41 -0
- package/pi-extension/dist/cognitive-routing/assembler.js +393 -0
- package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/config.js +40 -21
- package/pi-extension/dist/cognitive-routing/economics.js +45 -0
- package/pi-extension/dist/cognitive-routing/event-schema.js +388 -0
- package/pi-extension/dist/cognitive-routing/event-store.js +280 -0
- package/pi-extension/dist/cognitive-routing/gate.js +241 -0
- package/pi-extension/dist/cognitive-routing/handlers.js +899 -0
- package/pi-extension/dist/cognitive-routing/handoffs.js +350 -0
- package/pi-extension/dist/cognitive-routing/model-control.js +467 -0
- package/pi-extension/dist/cognitive-routing/projection.js +503 -0
- package/pi-extension/dist/cognitive-routing/provenance.js +81 -0
- package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/render.js +31 -10
- package/pi-extension/dist/cognitive-routing/runtime.js +396 -0
- package/pi-extension/dist/cognitive-routing/schemas.js +209 -0
- package/pi-extension/dist/cognitive-routing/session.js +221 -0
- package/pi-extension/dist/cognitive-routing/sources.js +291 -0
- package/pi-extension/dist/cognitive-routing/state.js +487 -0
- package/pi-extension/dist/cognitive-routing/status.js +80 -0
- package/pi-extension/dist/cognitive-routing/tools.js +60 -0
- package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/types.js +10 -12
- package/pi-extension/dist/compaction/carry.js +191 -0
- package/pi-extension/dist/compaction/config.js +22 -0
- package/pi-extension/dist/compaction/controller.js +471 -0
- package/pi-extension/dist/compaction/harness.js +77 -0
- package/pi-extension/dist/compaction/results.js +158 -0
- package/pi-extension/dist/compaction/thresholds.js +35 -0
- package/pi-extension/dist/compaction/tool.js +57 -0
- package/pi-extension/dist/host/branch.js +13 -0
- package/pi-extension/dist/host/canonical.js +12 -0
- package/pi-extension/dist/host/catalog.js +77 -0
- package/pi-extension/dist/host/config.js +374 -0
- package/pi-extension/dist/host/projection-tags.js +60 -0
- package/pi-extension/dist/host/prompts.js +82 -0
- package/pi-extension/dist/{session-sources → host}/read-only-session.js +112 -1
- package/pi-extension/dist/host/request-history.js +298 -0
- package/pi-extension/dist/host/runtime-state.js +189 -0
- package/pi-extension/dist/host/settings/freeflow-command.js +1570 -0
- package/pi-extension/dist/{settings/settings-tui.js → host/settings/settings-view.js} +186 -73
- package/pi-extension/dist/host/staging.js +28 -0
- package/pi-extension/dist/host/status.js +101 -0
- package/pi-extension/dist/index.js +441 -170
- package/pi-extension/dist/provider-support/cache/anchor.js +21 -0
- package/pi-extension/dist/provider-support/cache/anthropic.js +102 -0
- package/pi-extension/dist/provider-support/cache/health.js +73 -0
- package/pi-extension/dist/provider-support/cache/index.js +58 -0
- package/pi-extension/dist/provider-support/cache/keepalive.js +210 -0
- package/pi-extension/dist/provider-support/cache/monitor.js +17 -0
- package/pi-extension/dist/provider-support/cache/openai-responses.js +48 -0
- package/pi-extension/dist/provider-support/effort.js +13 -0
- package/pi-extension/dist/provider-support/index.js +45 -0
- package/pi-extension/dist/provider-support/openai/adapter.js +127 -0
- package/pi-extension/dist/provider-support/openai/history.js +127 -0
- package/pi-extension/dist/provider-support/openai/index.js +15 -0
- package/pi-extension/dist/provider-support/openai/session-state.js +105 -0
- package/pi-extension/dist/provider-support/routes.js +17 -0
- package/pi-extension/dist/tool-execution/apply-patch/grammar.js +23 -0
- package/pi-extension/dist/tool-execution/apply-patch/match.js +38 -0
- package/pi-extension/dist/tool-execution/apply-patch/parser.js +177 -0
- package/pi-extension/dist/tool-execution/apply-patch/plan.js +201 -0
- package/pi-extension/dist/tool-execution/apply-patch/tool.js +84 -0
- package/pi-extension/dist/tool-execution/background.js +238 -0
- package/pi-extension/dist/tool-execution/bash-guard.js +23 -0
- package/pi-extension/dist/tool-execution/config.js +22 -0
- package/pi-extension/dist/tool-execution/edit-messages.js +120 -0
- package/pi-extension/dist/tool-execution/file-state.js +138 -0
- package/pi-extension/dist/tool-execution/file-tracking.js +143 -0
- package/pi-extension/dist/tool-execution/prompt.js +54 -0
- package/pi-extension/dist/tool-execution/tools.js +16 -0
- package/pi-extension/freeflow/README.md +9 -0
- package/plugin.json +1 -1
- package/runtime/prompts/cognitive-routing.md +4 -4
- package/runtime/prompts/core.md +22 -75
- package/runtime/prompts/interaction-contract.md +15 -8
- package/runtime/prompts/tool-execution.md +38 -0
- package/runtime/prompts/working-method.md +108 -0
- package/skills/action-selection/SKILL.md +39 -47
- package/skills/action-selection/references/trajectory-stalls.md +2 -0
- package/skills/bypass/SKILL.md +2 -2
- package/skills/commit-work/SKILL.md +31 -83
- package/skills/commit-work/references/git-state-edges.md +1 -1
- package/skills/commit-work/references/simple-push.md +2 -0
- package/skills/commit-work/references/staging-decisions.md +1 -1
- package/skills/decision-gate/SKILL.md +31 -50
- package/skills/design-for-depth/SKILL.md +44 -53
- package/skills/design-for-depth/references/design-pressure-signals.md +46 -144
- package/skills/design-for-depth/references/implementation-decisions.md +4 -4
- package/skills/design-for-depth/references/interface-design-loop.md +5 -36
- package/skills/design-for-depth/references/module-and-dependency-design.md +2 -32
- package/skills/design-for-depth/references/state-and-failure-boundaries.md +2 -13
- package/skills/diagnose-failure/SKILL.md +39 -24
- package/skills/diagnose-failure/references/diagnostic-loop-catalog.md +2 -0
- package/skills/diagnose-failure/references/flaky-and-performance-diagnosis.md +2 -2
- package/skills/discuss/SKILL.md +37 -13
- package/skills/discuss/references/discussion-continuity.md +7 -27
- package/skills/evaluate-skill/SKILL.md +49 -80
- package/skills/evaluate-skill/references/evaluation-definition-schema.md +35 -5
- package/skills/evaluate-skill/references/evaluation-design.md +14 -14
- package/skills/evaluate-skill/references/execution-and-evidence.md +26 -5
- package/skills/evaluate-skill/references/review-and-revision.md +3 -1
- package/skills/evaluate-skill/scripts/lib/definitions.mjs +49 -8
- package/skills/evaluate-skill/scripts/lib/pi.mjs +14 -7
- package/skills/evaluate-skill/scripts/lib/review.mjs +196 -0
- package/skills/evaluate-skill/scripts/lib/runner.mjs +45 -8
- package/skills/evaluate-skill/scripts/lib/sandbox.mjs +2 -0
- package/skills/evaluate-skill/scripts/lib/trials.mjs +103 -0
- package/skills/evaluate-skill/scripts/lib/view.mjs +67 -1
- package/skills/evaluate-skill/scripts/pi-command-tool.mjs +144 -0
- package/skills/evaluate-skill/scripts/pi-guard.mjs +30 -13
- package/skills/evaluate-skill/scripts/skill-eval.mjs +114 -34
- package/skills/execute-work/SKILL.md +41 -9
- package/skills/execute-work/references/code-practices.md +2 -0
- package/skills/execute-work/references/execute-work-edges.md +11 -1
- package/skills/handoff/SKILL.md +1 -1
- package/skills/handoff/references/handoff-templates.md +1 -1
- package/skills/review-artifact/SKILL.md +42 -41
- package/skills/review-artifact/references/adjudicate-artifact-review.md +1 -1
- package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
- package/skills/review-work/SKILL.md +38 -32
- package/skills/review-work/references/adjudicate-work-review.md +1 -1
- package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
- package/skills/review-work/references/security-risk-lens.md +2 -4
- package/skills/setup-freeflow/SKILL.md +3 -1
- package/skills/setup-freeflow/references/activation-contract.md +7 -13
- package/skills/setup-freeflow/references/host-setup.md +3 -3
- package/skills/track-work/SKILL.md +113 -161
- package/skills/track-work/references/working-record-format.md +189 -350
- package/skills/track-work/scripts/lib/document.mjs +62 -6
- package/skills/track-work/scripts/lib/format.mjs +16 -1
- package/skills/track-work/scripts/lib/store.mjs +9 -8
- package/skills/track-work/scripts/lib/transitions.mjs +79 -4
- package/skills/track-work/scripts/working-record.mjs +34 -12
- package/skills/verify-work/SKILL.md +29 -20
- package/skills/verify-work/references/browser-runtime-evidence.md +1 -5
- package/skills/verify-work/references/integration-evidence.md +2 -0
- package/skills/verify-work/references/performance-evidence.md +3 -1
- package/skills/verify-work/references/test-design.md +3 -1
- package/skills/workflow/SKILL.md +65 -21
- package/skills/workflow/references/domain-skill-composition.md +5 -3
- package/skills/write-docs/SKILL.md +83 -0
- package/skills/write-docs/references/documentation-shapes.md +119 -0
- package/skills/write-docs/scripts/docs-check.mjs +139 -0
- package/skills/write-plan/SKILL.md +40 -40
- package/skills/write-plan/references/plan-shapes.md +1 -1
- package/skills/write-skill/SKILL.md +107 -147
- package/skills/write-skill/references/activation-boundaries.md +2 -0
- package/skills/write-skill/references/agent-first-instructions.md +22 -10
- package/skills/write-skill/references/progressive-disclosure.md +4 -2
- package/skills/write-skill/references/skill-dependency-graphs.md +2 -0
- package/skills/write-skill/scripts/lib/similarity.mjs +56 -0
- package/skills/write-skill/scripts/skill-author.mjs +18 -2
- package/skills/write-spec/SKILL.md +34 -41
- package/skills/write-spec/references/artifact-standards.md +1 -1
- package/skills/write-spec/references/decision-records.md +2 -0
- package/skills/write-spec/references/spec-shapes.md +1 -1
- package/capabilities/context-virtualization/SKILL.md +0 -103
- package/capabilities/conversation-history/SKILL.md +0 -53
- package/hooks/tests/check-host-adapters.test.mjs +0 -82
- package/hooks/tests/check-runtime-context-hook.sh +0 -212
- package/pi-extension/dist/cognitive-routing-v2/projection.js +0 -321
- package/pi-extension/dist/cognitive-routing-v2/runtime.js +0 -1585
- package/pi-extension/dist/cognitive-routing-v2/schemas.js +0 -107
- package/pi-extension/dist/cognitive-routing-v2/state.js +0 -612
- package/pi-extension/dist/cognitive-routing-v2/tools.js +0 -91
- package/pi-extension/dist/context-virtualization/commands.js +0 -89
- package/pi-extension/dist/context-virtualization/projector.js +0 -42
- package/pi-extension/dist/context-virtualization/runtime.js +0 -356
- package/pi-extension/dist/context-virtualization/state.js +0 -57
- package/pi-extension/dist/context-virtualization/types.js +0 -10
- package/pi-extension/dist/conversation-history/passages.js +0 -66
- package/pi-extension/dist/conversation-history/ranking.js +0 -105
- package/pi-extension/dist/conversation-history/runtime.js +0 -226
- package/pi-extension/dist/conversation-history/search.js +0 -56
- package/pi-extension/dist/conversation-history/types.js +0 -1
- package/pi-extension/dist/freeflow-context/resolver.js +0 -120
- package/pi-extension/dist/freeflow-context/runtime.js +0 -80
- package/pi-extension/dist/freeflow-context/source-projector.js +0 -95
- package/pi-extension/dist/freeflow-context/tool.js +0 -313
- package/pi-extension/dist/freeflow-context/types.js +0 -12
- package/pi-extension/dist/freeflow-context/visibility.js +0 -28
- package/pi-extension/dist/integrations/mcp-config.js +0 -29
- package/pi-extension/dist/runtime/runtime-context.js +0 -735
- package/pi-extension/dist/runtime/runtime-identity.js +0 -5
- package/pi-extension/dist/session-sources/events.js +0 -195
- package/pi-extension/dist/session-sources/sources.js +0 -233
- package/pi-extension/dist/settings/settings-ui.js +0 -1160
- package/pi-extension/dist/ui/text-component.js +0 -57
- package/pi-extension/src/cognitive-routing-v2/budget.ts +0 -42
- package/pi-extension/src/cognitive-routing-v2/config.ts +0 -143
- package/pi-extension/src/cognitive-routing-v2/projection.ts +0 -365
- package/pi-extension/src/cognitive-routing-v2/render.ts +0 -256
- package/pi-extension/src/cognitive-routing-v2/runtime.ts +0 -1634
- package/pi-extension/src/cognitive-routing-v2/schemas.ts +0 -109
- package/pi-extension/src/cognitive-routing-v2/state.ts +0 -622
- package/pi-extension/src/cognitive-routing-v2/tools.ts +0 -93
- package/pi-extension/src/cognitive-routing-v2/types.ts +0 -222
- package/pi-extension/src/context-virtualization/commands.ts +0 -111
- package/pi-extension/src/context-virtualization/projector.ts +0 -62
- package/pi-extension/src/context-virtualization/runtime.ts +0 -406
- package/pi-extension/src/context-virtualization/state.ts +0 -79
- package/pi-extension/src/context-virtualization/types.ts +0 -92
- package/pi-extension/src/conversation-history/passages.ts +0 -81
- package/pi-extension/src/conversation-history/ranking.ts +0 -155
- package/pi-extension/src/conversation-history/runtime.ts +0 -250
- package/pi-extension/src/conversation-history/search.ts +0 -79
- package/pi-extension/src/conversation-history/types.ts +0 -31
- package/pi-extension/src/freeflow-context/resolver.ts +0 -139
- package/pi-extension/src/freeflow-context/runtime.ts +0 -100
- package/pi-extension/src/freeflow-context/source-projector.ts +0 -106
- package/pi-extension/src/freeflow-context/tool.ts +0 -365
- package/pi-extension/src/freeflow-context/types.ts +0 -70
- package/pi-extension/src/freeflow-context/visibility.ts +0 -53
- package/pi-extension/src/index.ts +0 -368
- package/pi-extension/src/integrations/mcp-config.ts +0 -32
- package/pi-extension/src/runtime/runtime-context.ts +0 -838
- package/pi-extension/src/runtime/runtime-identity.ts +0 -8
- package/pi-extension/src/session-sources/events.ts +0 -208
- package/pi-extension/src/session-sources/read-only-session.ts +0 -170
- package/pi-extension/src/session-sources/sources.ts +0 -263
- package/pi-extension/src/settings/settings-tui.ts +0 -501
- package/pi-extension/src/settings/settings-ui.ts +0 -1422
- package/pi-extension/src/ui/text-component.ts +0 -66
- package/pi-extension/tests/cognitive-routing-v2/communication.test.js +0 -484
- package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +0 -183
- package/pi-extension/tests/cognitive-routing-v2/native.test.js +0 -441
- package/pi-extension/tests/cognitive-routing-v2/performance.test.js +0 -87
- package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +0 -245
- package/pi-extension/tests/cognitive-routing-v2/projection.test.js +0 -241
- package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +0 -236
- package/pi-extension/tests/cognitive-routing-v2/render.test.js +0 -230
- package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +0 -153
- package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +0 -521
- package/pi-extension/tests/cognitive-routing-v2/state.test.js +0 -275
- package/pi-extension/tests/context-virtualization/extension.test.js +0 -765
- package/pi-extension/tests/context-virtualization/projector.test.js +0 -110
- package/pi-extension/tests/context-virtualization/runtime.test.js +0 -216
- package/pi-extension/tests/conversation-history/runtime.test.js +0 -98
- package/pi-extension/tests/conversation-history/search.test.js +0 -97
- package/pi-extension/tests/fixtures/pi-host.js +0 -4
- package/pi-extension/tests/fixtures/routing-native.js +0 -188
- package/pi-extension/tests/integration/mode-free-core.test.js +0 -219
- package/pi-extension/tests/integration/pi-extension.test.js +0 -968
- package/pi-extension/tests/integration/prompt-architecture.test.js +0 -431
- package/pi-extension/tests/integration/unaffected-regressions.test.js +0 -478
- package/pi-extension/tests/settings/settings-tui.test.js +0 -243
- package/pi-extension/tsconfig.json +0 -16
- package/runtime/prompts/context-virtualization.md +0 -3
- package/runtime/prompts/conversation-history.md +0 -3
- package/skills/design-for-depth/references/software-design-philosophy.md +0 -202
- /package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/budget.js +0 -0
|
@@ -1,91 +0,0 @@
|
|
|
1
|
-
import { ROUTING_TOOLS } from "./runtime.js";
|
|
2
|
-
import { ROUTING_SCHEMAS, matches, schemaForProfile } from "./schemas.js";
|
|
3
|
-
export { ROUTING_SCHEMAS } from "./schemas.js";
|
|
4
|
-
import { renderRoutingCall, renderRoutingResult } from "./render.js";
|
|
5
|
-
const descriptions = {
|
|
6
|
-
freeflow_delegate:
|
|
7
|
-
"Save a supported assignment contract and request Executor execution. Explicit replace supersedes a quiescent outstanding assignment in the same unit.",
|
|
8
|
-
freeflow_return:
|
|
9
|
-
"Save or revise the actual assignment report, or retry its saved handoff without resubmitting text. Returning does not accept or close the unit.",
|
|
10
|
-
freeflow_unit:
|
|
11
|
-
"Inspect current responsibility, paginated work history, or exact saved contract/report details. Coordinator can also restore a suspended assessment or close a unit without clearing its history.",
|
|
12
|
-
freeflow_project:
|
|
13
|
-
"Inspect current selection and scoped candidates, then add or remove completed exposed Executor sources. #text refs select exact visible assistant text; plain refs retain whole-native meaning. Eligibility and target readiness are distinct.",
|
|
14
|
-
};
|
|
15
|
-
const guidance = {
|
|
16
|
-
freeflow_delegate: [
|
|
17
|
-
"freeflow_delegate is Coordinator-only under Automatic control. Put the contract in the input. Use replace only for explicit same-unit replacement; do not supply IDs.",
|
|
18
|
-
],
|
|
19
|
-
freeflow_return: [
|
|
20
|
-
"freeflow_return submit saves/revises the actual report; retry completes the saved return without text. Stop ordinary task work after reportSaved. Keep the handoff last; do not batch it with new task tools.",
|
|
21
|
-
],
|
|
22
|
-
freeflow_unit: [
|
|
23
|
-
"freeflow_unit inspect defaults to current state; view history returns work refs and view detail with ref reads saved contracts/reports. Coordinator assess restores a suspended evidence obligation; close changes work status without clearing communication or completing a Working Record task.",
|
|
24
|
-
],
|
|
25
|
-
freeflow_project: [
|
|
26
|
-
"freeflow_project inspect shows selection and scoped candidates. Use history scope for earlier exposed evidence. #text refs select exact visible assistant text; plain refs retain whole-native meaning. Select actual result bodies for execution claims, not merely calls. Correct or explicitly withdraw unresolved items with a limitation. Known previously exposed bodies resolve automatically; target-representation gaps are not successful delivery.",
|
|
27
|
-
],
|
|
28
|
-
};
|
|
29
|
-
const unitDefinitions = new WeakMap();
|
|
30
|
-
export function registerRoutingTools(pi, runtime) {
|
|
31
|
-
for (const name of ROUTING_TOOLS) {
|
|
32
|
-
const definition = {
|
|
33
|
-
name,
|
|
34
|
-
label: name.replace("freeflow_", "Routing "),
|
|
35
|
-
description: descriptions[name],
|
|
36
|
-
parameters: ROUTING_SCHEMAS[name],
|
|
37
|
-
executionMode: "sequential",
|
|
38
|
-
promptGuidelines: guidance[name],
|
|
39
|
-
renderCall: (args, _theme, context) => renderRoutingCall(name, args, context),
|
|
40
|
-
renderResult: (result, options, _theme, context) => renderRoutingResult(result, options, name, context),
|
|
41
|
-
async execute(id, input, signal, _update, ctx) {
|
|
42
|
-
if (!matches(input, ROUTING_SCHEMAS[name]))
|
|
43
|
-
throw new Error("Invalid routing arguments; no operation accepted.");
|
|
44
|
-
return runtime.invoke(name, id, input, signal, ctx);
|
|
45
|
-
},
|
|
46
|
-
};
|
|
47
|
-
pi.registerTool(definition);
|
|
48
|
-
if (name === "freeflow_unit") unitDefinitions.set(pi, { definition });
|
|
49
|
-
}
|
|
50
|
-
}
|
|
51
|
-
export function applyRoutingToolVisibility(pi, runtime, available) {
|
|
52
|
-
if (!pi.getActiveTools || !pi.setActiveTools) return;
|
|
53
|
-
const current = new Set(pi.getActiveTools());
|
|
54
|
-
const state = runtime.state();
|
|
55
|
-
const unit = unitDefinitions.get(pi);
|
|
56
|
-
const coordinator = state.effective && state.controlMode === "automatic" && state.activeProfile === "coordinator";
|
|
57
|
-
const signature = coordinator ? "coordinator" : "inspection";
|
|
58
|
-
if (unit && unit.signature !== signature) {
|
|
59
|
-
pi.registerTool({
|
|
60
|
-
...unit.definition,
|
|
61
|
-
description: coordinator
|
|
62
|
-
? unit.definition.description
|
|
63
|
-
: "Inspect current routing responsibility, work history, or exact saved contract/report detail. This profile cannot assess or close units.",
|
|
64
|
-
promptGuidelines: coordinator
|
|
65
|
-
? unit.definition.promptGuidelines
|
|
66
|
-
: [
|
|
67
|
-
"freeflow_unit inspect reads current state, view history lists work refs, and view detail with ref reads historical communication. Historical content is not current permission.",
|
|
68
|
-
],
|
|
69
|
-
parameters: schemaForProfile("freeflow_unit", coordinator),
|
|
70
|
-
});
|
|
71
|
-
unit.signature = signature;
|
|
72
|
-
}
|
|
73
|
-
for (const name of ROUTING_TOOLS) {
|
|
74
|
-
const enabled =
|
|
75
|
-
available &&
|
|
76
|
-
(name === "freeflow_unit" ||
|
|
77
|
-
(state.effective &&
|
|
78
|
-
state.controlMode === "automatic" &&
|
|
79
|
-
(name === "freeflow_delegate"
|
|
80
|
-
? state.activeProfile === "coordinator"
|
|
81
|
-
: state.activeProfile === "executor"))) &&
|
|
82
|
-
(name !== "freeflow_project" || runtime.projectionEnabled);
|
|
83
|
-
if (enabled) current.add(name);
|
|
84
|
-
else current.delete(name);
|
|
85
|
-
}
|
|
86
|
-
// Retired experimental tools must never remain available beside the replacement.
|
|
87
|
-
current.delete("freeflow_switch_profile");
|
|
88
|
-
current.delete("freeflow_cognitive_routing_history");
|
|
89
|
-
const next = [...current];
|
|
90
|
-
if (JSON.stringify(next) !== JSON.stringify(pi.getActiveTools())) pi.setActiveTools(next);
|
|
91
|
-
}
|
|
@@ -1,89 +0,0 @@
|
|
|
1
|
-
function formatStatus(status, features) {
|
|
2
|
-
if (!status.available) {
|
|
3
|
-
return `Freeflow Context: unavailable${status.unavailableReason ? ` (${status.unavailableReason})` : ""}`;
|
|
4
|
-
}
|
|
5
|
-
return [
|
|
6
|
-
"Freeflow Context: available",
|
|
7
|
-
`Context Virtualization: ${features.contextVirtualization ? "enabled" : "disabled"}`,
|
|
8
|
-
`Conversation History: ${features.conversationHistory ? "enabled" : "disabled"}`,
|
|
9
|
-
`Session: ${status.sessionId}`,
|
|
10
|
-
`Branch: ${status.branchLeafId ?? "root"}`,
|
|
11
|
-
`Projections: full=${status.counts.full}, archived=${status.counts.archived}, retained=${status.counts.retained}`,
|
|
12
|
-
`Characters: original=${status.originalCharacters.toLocaleString("en-US")}, projected=${status.projectedCharacters.toLocaleString("en-US")}`,
|
|
13
|
-
`Availability: history-only=${status.historyOnly}, unresolved=${status.unresolved}`,
|
|
14
|
-
].join("\n");
|
|
15
|
-
}
|
|
16
|
-
function formatList(status) {
|
|
17
|
-
if (!status.available) return formatStatus(status, { contextVirtualization: true, conversationHistory: false });
|
|
18
|
-
const items = status.items.filter((item) => item.mode === "archived");
|
|
19
|
-
if (items.length === 0) return "Context Virtualization: no archived projections in the active session branch.";
|
|
20
|
-
const lines = ["Context Virtualization: archived projections"];
|
|
21
|
-
for (const item of items) {
|
|
22
|
-
lines.push(
|
|
23
|
-
"",
|
|
24
|
-
`Ref: ${item.ref}`,
|
|
25
|
-
`Tool: ${item.toolName ?? "tool"}`,
|
|
26
|
-
`State: ${item.retained === undefined ? "archived" : "retained"}`,
|
|
27
|
-
`Original: ${item.originalCharacters.toLocaleString("en-US")} characters`,
|
|
28
|
-
`Projected: ${item.projectedCharacters.toLocaleString("en-US")} characters`,
|
|
29
|
-
`Availability: ${item.availability}`,
|
|
30
|
-
);
|
|
31
|
-
if (item.retained !== undefined) lines.push(`Retained: ${item.retained}`);
|
|
32
|
-
}
|
|
33
|
-
return lines.join("\n");
|
|
34
|
-
}
|
|
35
|
-
function refsFromArgs(args) {
|
|
36
|
-
return args
|
|
37
|
-
.split(/[\s,]+/)
|
|
38
|
-
.map((value) => value.trim())
|
|
39
|
-
.filter(Boolean);
|
|
40
|
-
}
|
|
41
|
-
export async function handleContextCommand(args, ctx, runtime, enabled, conversationHistoryEnabled = false) {
|
|
42
|
-
const input = (args ?? "status").trim();
|
|
43
|
-
const [action = "status", ...rest] = input.split(/\s+/);
|
|
44
|
-
const normalized = action.toLowerCase();
|
|
45
|
-
if (!runtime) {
|
|
46
|
-
ctx.ui.notify("Context Virtualization is unavailable for this session.", "warning");
|
|
47
|
-
return { changed: false, error: "unavailable" };
|
|
48
|
-
}
|
|
49
|
-
if (normalized === "status") {
|
|
50
|
-
const status = await runtime.status();
|
|
51
|
-
ctx.ui.notify(
|
|
52
|
-
formatStatus(status, { contextVirtualization: enabled, conversationHistory: conversationHistoryEnabled }),
|
|
53
|
-
enabled || conversationHistoryEnabled ? "info" : "warning",
|
|
54
|
-
);
|
|
55
|
-
return { changed: false, status };
|
|
56
|
-
}
|
|
57
|
-
if (normalized === "list") {
|
|
58
|
-
const status = await runtime.status();
|
|
59
|
-
ctx.ui.notify(formatList(status), enabled ? "info" : "warning");
|
|
60
|
-
return { changed: false, status };
|
|
61
|
-
}
|
|
62
|
-
if (normalized === "restore") {
|
|
63
|
-
const refs = refsFromArgs(rest.join(" "));
|
|
64
|
-
if (!enabled) {
|
|
65
|
-
ctx.ui.notify("Context Virtualization is disabled by configuration; no projection state was changed.", "warning");
|
|
66
|
-
return { changed: false, error: "disabled" };
|
|
67
|
-
}
|
|
68
|
-
const result = await runtime.restore(refs, "user");
|
|
69
|
-
ctx.ui.notify(
|
|
70
|
-
result.message ?? `${result.status}: ${result.operation}`,
|
|
71
|
-
result.status === "ok" ? "info" : "warning",
|
|
72
|
-
);
|
|
73
|
-
return { changed: result.status === "ok", result };
|
|
74
|
-
}
|
|
75
|
-
if (normalized === "reset" && rest.join(" ").toLowerCase() === "all") {
|
|
76
|
-
if (!enabled) {
|
|
77
|
-
ctx.ui.notify("Context Virtualization is disabled by configuration; no projection state was changed.", "warning");
|
|
78
|
-
return { changed: false, error: "disabled" };
|
|
79
|
-
}
|
|
80
|
-
const result = await runtime.reset();
|
|
81
|
-
ctx.ui.notify(
|
|
82
|
-
result.message ?? `${result.status}: ${result.operation}`,
|
|
83
|
-
result.status === "ok" ? "info" : "warning",
|
|
84
|
-
);
|
|
85
|
-
return { changed: result.status === "ok", result };
|
|
86
|
-
}
|
|
87
|
-
ctx.ui.notify("Usage: /freeflow context [status|list|restore <ctx:entryId>...|reset all]", "warning");
|
|
88
|
-
return { changed: false, error: "invalid_action" };
|
|
89
|
-
}
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
import { CONTEXT_REF_PREFIX, contextRefForEntry } from "./types.js";
|
|
2
|
-
export function contentCharacters(content) {
|
|
3
|
-
if (typeof content === "string") return content.length;
|
|
4
|
-
if (!Array.isArray(content)) return 0;
|
|
5
|
-
return content.reduce((total, part) => {
|
|
6
|
-
if (part?.type === "text" && typeof part.text === "string") return total + part.text.length;
|
|
7
|
-
if (part?.type === "image") return total + 16;
|
|
8
|
-
return total;
|
|
9
|
-
}, 0);
|
|
10
|
-
}
|
|
11
|
-
export function contextMarker(source) {
|
|
12
|
-
return {
|
|
13
|
-
type: "text",
|
|
14
|
-
text: `[context-ref: ${contextRefForEntry(source.entryId)}]`,
|
|
15
|
-
};
|
|
16
|
-
}
|
|
17
|
-
export function archiveContent(source, retained) {
|
|
18
|
-
const marker = `[context archived: ${contextRefForEntry(source.entryId)}]`;
|
|
19
|
-
if (!retained) return marker;
|
|
20
|
-
return `${marker}\n\n<retained-context>\n${retained}\n</retained-context>`;
|
|
21
|
-
}
|
|
22
|
-
export function fullContent(source, content = []) {
|
|
23
|
-
return [...content, contextMarker(source)];
|
|
24
|
-
}
|
|
25
|
-
export function projectedContent(source, content, projection) {
|
|
26
|
-
if (projection.mode === "archived") {
|
|
27
|
-
return [{ type: "text", text: archiveContent(source, projection.retained) }];
|
|
28
|
-
}
|
|
29
|
-
return fullContent(source, Array.isArray(content) ? content : [{ type: "text", text: String(content ?? "") }]);
|
|
30
|
-
}
|
|
31
|
-
export function projectToolResultMessage(message, source, projection) {
|
|
32
|
-
return {
|
|
33
|
-
...message,
|
|
34
|
-
content: projectedContent(source, message.content, projection),
|
|
35
|
-
};
|
|
36
|
-
}
|
|
37
|
-
export function projectedCharacters(source, message, projection) {
|
|
38
|
-
return contentCharacters(projectedContent(source, message?.content, projection));
|
|
39
|
-
}
|
|
40
|
-
export function sourceReference(source) {
|
|
41
|
-
return `${CONTEXT_REF_PREFIX}${source.entryId}`;
|
|
42
|
-
}
|
|
@@ -1,356 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
CONTEXT_PROJECTION_ENTRY,
|
|
3
|
-
CONTEXT_PROJECTION_VERSION,
|
|
4
|
-
contextRefForEntry,
|
|
5
|
-
entryIdFromContextRef,
|
|
6
|
-
} from "./types.js";
|
|
7
|
-
import { FreeflowContextRuntime } from "../freeflow-context/runtime.js";
|
|
8
|
-
import { contentCharacters, projectToolResultMessage, projectedCharacters } from "./projector.js";
|
|
9
|
-
import { replayProjectionEntries } from "./state.js";
|
|
10
|
-
function cloneSource(source) {
|
|
11
|
-
return { ...source };
|
|
12
|
-
}
|
|
13
|
-
function sourceProjection(state) {
|
|
14
|
-
if (!state || state.mode === "full") return { mode: "full" };
|
|
15
|
-
return state.retained === undefined ? { mode: "archived" } : { mode: "archived", retained: state.retained };
|
|
16
|
-
}
|
|
17
|
-
function safeJsonEqual(left, right) {
|
|
18
|
-
try {
|
|
19
|
-
return JSON.stringify(left) === JSON.stringify(right);
|
|
20
|
-
} catch {
|
|
21
|
-
return false;
|
|
22
|
-
}
|
|
23
|
-
}
|
|
24
|
-
function isDuplicate(values) {
|
|
25
|
-
const seen = new Set();
|
|
26
|
-
for (const value of values) {
|
|
27
|
-
if (seen.has(value)) return value;
|
|
28
|
-
seen.add(value);
|
|
29
|
-
}
|
|
30
|
-
return undefined;
|
|
31
|
-
}
|
|
32
|
-
export class ContextVirtualizationRuntime {
|
|
33
|
-
pi;
|
|
34
|
-
freeflowContext;
|
|
35
|
-
ctx;
|
|
36
|
-
sessionId = "current";
|
|
37
|
-
branchLeafId;
|
|
38
|
-
projectionState = new Map();
|
|
39
|
-
available = true;
|
|
40
|
-
unavailableReason;
|
|
41
|
-
mutationQueue = Promise.resolve();
|
|
42
|
-
constructor(pi, ctx, freeflowContext = new FreeflowContextRuntime(ctx)) {
|
|
43
|
-
this.pi = pi;
|
|
44
|
-
this.ctx = ctx;
|
|
45
|
-
this.freeflowContext = freeflowContext;
|
|
46
|
-
}
|
|
47
|
-
setContext(ctx) {
|
|
48
|
-
this.ctx = ctx;
|
|
49
|
-
this.freeflowContext.setContext(ctx);
|
|
50
|
-
}
|
|
51
|
-
async recover(ctx = this.ctx, options = {}) {
|
|
52
|
-
this.ctx = ctx;
|
|
53
|
-
this.freeflowContext.setContext(ctx);
|
|
54
|
-
try {
|
|
55
|
-
this.sessionId = this.freeflowContext.sessionId();
|
|
56
|
-
this.branchLeafId = this.freeflowContext.branchLeafId();
|
|
57
|
-
this.projectionState = replayProjectionEntries(this.freeflowContext.branchEntries(), this.sessionId);
|
|
58
|
-
if (!options.preserveRequest) this.freeflowContext.clearRequest();
|
|
59
|
-
this.available = true;
|
|
60
|
-
this.unavailableReason = undefined;
|
|
61
|
-
return true;
|
|
62
|
-
} catch (error) {
|
|
63
|
-
this.available = false;
|
|
64
|
-
this.unavailableReason = error instanceof Error ? error.message : String(error);
|
|
65
|
-
this.freeflowContext.clearRequest();
|
|
66
|
-
return false;
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
isAvailable() {
|
|
70
|
-
return this.available;
|
|
71
|
-
}
|
|
72
|
-
isSourceFullyProjected(entryId) {
|
|
73
|
-
if (!this.available) return true;
|
|
74
|
-
const projection = this.projectionState.get(entryId);
|
|
75
|
-
return !projection || projection.mode === "full";
|
|
76
|
-
}
|
|
77
|
-
async project(messages, enabled) {
|
|
78
|
-
if (!enabled) {
|
|
79
|
-
this.freeflowContext.clearRequest();
|
|
80
|
-
return { messages, changed: false, available: true };
|
|
81
|
-
}
|
|
82
|
-
if (!(await this.recover(this.ctx))) {
|
|
83
|
-
return { messages, changed: false, available: false };
|
|
84
|
-
}
|
|
85
|
-
const sourcesByToolCallId = this.freeflowContext.resolver.toolResultSources();
|
|
86
|
-
const refs = new Map();
|
|
87
|
-
let changed = false;
|
|
88
|
-
const projected = messages.map((message) => {
|
|
89
|
-
if (message?.role !== "toolResult" || typeof message.toolCallId !== "string") return message;
|
|
90
|
-
const source = sourcesByToolCallId.get(message.toolCallId);
|
|
91
|
-
if (!source) return message;
|
|
92
|
-
const ref = contextRefForEntry(source.source.entryId);
|
|
93
|
-
refs.set(ref, source);
|
|
94
|
-
const state = this.projectionState.get(source.source.entryId);
|
|
95
|
-
const projection = sourceProjection(state);
|
|
96
|
-
const nextMessage = projectToolResultMessage(message, source.source, projection);
|
|
97
|
-
if (!safeJsonEqual(nextMessage.content, message.content)) changed = true;
|
|
98
|
-
return nextMessage;
|
|
99
|
-
});
|
|
100
|
-
const request = this.freeflowContext.recordRequest(refs);
|
|
101
|
-
return {
|
|
102
|
-
messages: changed ? projected : messages,
|
|
103
|
-
changed,
|
|
104
|
-
available: true,
|
|
105
|
-
generation: request.generation,
|
|
106
|
-
};
|
|
107
|
-
}
|
|
108
|
-
async archive(targets) {
|
|
109
|
-
try {
|
|
110
|
-
return await this.enqueue(() => this.archiveNow(targets));
|
|
111
|
-
} catch (error) {
|
|
112
|
-
return this.rejected("archive", `persistence_failed:${error instanceof Error ? error.message : String(error)}`);
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
async restore(refs, actor = "model") {
|
|
116
|
-
try {
|
|
117
|
-
return await this.enqueue(() => this.restoreNow(refs, actor));
|
|
118
|
-
} catch (error) {
|
|
119
|
-
return this.rejected("restore", `persistence_failed:${error instanceof Error ? error.message : String(error)}`);
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
async reset() {
|
|
123
|
-
try {
|
|
124
|
-
return await this.enqueue(async () => {
|
|
125
|
-
if (!this.available) return this.unavailable("reset");
|
|
126
|
-
const journal = {
|
|
127
|
-
version: CONTEXT_PROJECTION_VERSION,
|
|
128
|
-
actor: "user",
|
|
129
|
-
reset: "all",
|
|
130
|
-
};
|
|
131
|
-
await this.persist(journal);
|
|
132
|
-
this.projectionState.clear();
|
|
133
|
-
return {
|
|
134
|
-
status: "ok",
|
|
135
|
-
operation: "reset",
|
|
136
|
-
changed: ["all"],
|
|
137
|
-
message: "All context projection decisions were reset on the active branch.",
|
|
138
|
-
};
|
|
139
|
-
});
|
|
140
|
-
} catch (error) {
|
|
141
|
-
return this.rejected("reset", `persistence_failed:${error instanceof Error ? error.message : String(error)}`);
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
async status(limit = 50) {
|
|
145
|
-
if (!this.available) {
|
|
146
|
-
return {
|
|
147
|
-
available: false,
|
|
148
|
-
unavailableReason: this.unavailableReason,
|
|
149
|
-
sessionId: this.sessionId,
|
|
150
|
-
branchLeafId: this.branchLeafId,
|
|
151
|
-
counts: { full: 0, archived: 0, retained: 0 },
|
|
152
|
-
originalCharacters: 0,
|
|
153
|
-
projectedCharacters: 0,
|
|
154
|
-
historyOnly: 0,
|
|
155
|
-
unresolved: 0,
|
|
156
|
-
items: [],
|
|
157
|
-
};
|
|
158
|
-
}
|
|
159
|
-
if (!(await this.recover(this.ctx, { preserveRequest: true }))) {
|
|
160
|
-
return this.status(limit);
|
|
161
|
-
}
|
|
162
|
-
const branchSources = this.freeflowContext.resolver.sourcesByEntryId();
|
|
163
|
-
const activeIds = this.freeflowContext.resolver.activeToolResultIds();
|
|
164
|
-
const items = [];
|
|
165
|
-
for (const source of branchSources.values()) {
|
|
166
|
-
const state = this.projectionState.get(source.source.entryId);
|
|
167
|
-
const projection = sourceProjection(state);
|
|
168
|
-
items.push(this.listItem(source, projection, activeIds.has(source.source.entryId) ? "active" : "history-only"));
|
|
169
|
-
}
|
|
170
|
-
for (const state of this.projectionState.values()) {
|
|
171
|
-
if (branchSources.has(state.source.entryId)) continue;
|
|
172
|
-
const projection = sourceProjection(state);
|
|
173
|
-
items.push({
|
|
174
|
-
ref: contextRefForEntry(state.source.entryId),
|
|
175
|
-
entryId: state.source.entryId,
|
|
176
|
-
toolCallId: state.source.toolCallId,
|
|
177
|
-
toolName: state.source.toolName,
|
|
178
|
-
mode: projection.mode,
|
|
179
|
-
...(projection.mode === "archived" && projection.retained !== undefined
|
|
180
|
-
? { retained: projection.retained }
|
|
181
|
-
: {}),
|
|
182
|
-
originalCharacters: 0,
|
|
183
|
-
projectedCharacters: projection.mode === "archived" ? contentCharacters(projection.retained ?? "") : 0,
|
|
184
|
-
availability: "unresolved",
|
|
185
|
-
});
|
|
186
|
-
}
|
|
187
|
-
const counts = { full: 0, archived: 0, retained: 0 };
|
|
188
|
-
let originalCharacters = 0;
|
|
189
|
-
let projectedCharactersTotal = 0;
|
|
190
|
-
let historyOnly = 0;
|
|
191
|
-
let unresolved = 0;
|
|
192
|
-
for (const item of items) {
|
|
193
|
-
if (item.mode === "full") counts.full += 1;
|
|
194
|
-
else {
|
|
195
|
-
counts.archived += 1;
|
|
196
|
-
if (item.retained !== undefined) counts.retained += 1;
|
|
197
|
-
}
|
|
198
|
-
originalCharacters += item.originalCharacters;
|
|
199
|
-
projectedCharactersTotal += item.projectedCharacters;
|
|
200
|
-
if (item.availability === "history-only") historyOnly += 1;
|
|
201
|
-
if (item.availability === "unresolved") unresolved += 1;
|
|
202
|
-
}
|
|
203
|
-
return {
|
|
204
|
-
available: true,
|
|
205
|
-
sessionId: this.sessionId,
|
|
206
|
-
branchLeafId: this.branchLeafId,
|
|
207
|
-
counts,
|
|
208
|
-
originalCharacters,
|
|
209
|
-
projectedCharacters: projectedCharactersTotal,
|
|
210
|
-
historyOnly,
|
|
211
|
-
unresolved,
|
|
212
|
-
items: items.slice(-Math.max(1, limit)),
|
|
213
|
-
};
|
|
214
|
-
}
|
|
215
|
-
async archiveNow(targets) {
|
|
216
|
-
if (!this.available) return this.unavailable("archive");
|
|
217
|
-
if (!Array.isArray(targets) || targets.length === 0) {
|
|
218
|
-
return this.rejected("archive", "targets_required");
|
|
219
|
-
}
|
|
220
|
-
const normalizedRefs = targets.map((target) =>
|
|
221
|
-
target && typeof target === "object" ? entryIdFromContextRef(target.ref) : undefined,
|
|
222
|
-
);
|
|
223
|
-
const duplicate = isDuplicate(
|
|
224
|
-
normalizedRefs.flatMap((ref) => (ref === undefined ? [] : [contextRefForEntry(ref)])),
|
|
225
|
-
);
|
|
226
|
-
if (duplicate) return this.rejected("archive", `duplicate_reference:${duplicate}`);
|
|
227
|
-
const latestRequest = this.freeflowContext.latestRequest();
|
|
228
|
-
if (!latestRequest) return this.rejected("archive", "no_consumed_context_request");
|
|
229
|
-
const changes = [];
|
|
230
|
-
const retainedMeaning = {};
|
|
231
|
-
for (let index = 0; index < targets.length; index += 1) {
|
|
232
|
-
const target = targets[index];
|
|
233
|
-
if (!target || typeof target !== "object") return this.rejected("archive", `target_${index}_must_be_object`);
|
|
234
|
-
const ref = normalizedRefs[index];
|
|
235
|
-
if (!ref) return this.rejected("archive", `target_${index}_invalid_reference`);
|
|
236
|
-
const normalizedRef = contextRefForEntry(ref);
|
|
237
|
-
const source = latestRequest.refs.get(normalizedRef);
|
|
238
|
-
if (!source) return this.rejected("archive", `target_not_in_consumed_context:${normalizedRef}`);
|
|
239
|
-
const retainedValue = target.retained;
|
|
240
|
-
if (retainedValue !== undefined && (typeof retainedValue !== "string" || retainedValue.trim() === "")) {
|
|
241
|
-
return this.rejected("archive", `target_${index}_retained_must_be_non_empty`);
|
|
242
|
-
}
|
|
243
|
-
const retained = typeof retainedValue === "string" ? retainedValue.trim() : undefined;
|
|
244
|
-
changes.push({
|
|
245
|
-
source: cloneSource(source.source),
|
|
246
|
-
projection: retained === undefined ? { mode: "archived" } : { mode: "archived", retained },
|
|
247
|
-
});
|
|
248
|
-
if (retained !== undefined) retainedMeaning[normalizedRef] = retained;
|
|
249
|
-
}
|
|
250
|
-
await this.persist({ version: CONTEXT_PROJECTION_VERSION, actor: "model", changes });
|
|
251
|
-
for (const change of changes) {
|
|
252
|
-
this.projectionState.set(change.source.entryId, {
|
|
253
|
-
source: cloneSource(change.source),
|
|
254
|
-
...change.projection,
|
|
255
|
-
});
|
|
256
|
-
}
|
|
257
|
-
return {
|
|
258
|
-
status: "ok",
|
|
259
|
-
operation: "archive",
|
|
260
|
-
changed: changes.map((change) => contextRefForEntry(change.source.entryId)),
|
|
261
|
-
message: `Archived ${changes.length} tool result${changes.length === 1 ? "" : "s"} from future context projections.`,
|
|
262
|
-
...(Object.keys(retainedMeaning).length > 0 ? { retained: retainedMeaning } : {}),
|
|
263
|
-
};
|
|
264
|
-
}
|
|
265
|
-
async restoreNow(refs, actor) {
|
|
266
|
-
if (!this.available) return this.unavailable("restore");
|
|
267
|
-
if (!Array.isArray(refs) || refs.length === 0) return this.rejected("restore", "refs_required");
|
|
268
|
-
const normalizedRefs = refs.map((ref) => entryIdFromContextRef(ref));
|
|
269
|
-
const duplicate = isDuplicate(
|
|
270
|
-
normalizedRefs.flatMap((ref) => (ref === undefined ? [] : [contextRefForEntry(ref)])),
|
|
271
|
-
);
|
|
272
|
-
if (duplicate) return this.rejected("restore", `duplicate_reference:${duplicate}`);
|
|
273
|
-
const changes = [];
|
|
274
|
-
const availability = {};
|
|
275
|
-
const activeIds = this.freeflowContext.resolver.activeToolResultIds();
|
|
276
|
-
const latestRequest = this.freeflowContext.latestRequest();
|
|
277
|
-
for (let index = 0; index < refs.length; index += 1) {
|
|
278
|
-
const ref = normalizedRefs[index];
|
|
279
|
-
if (!ref) return this.rejected("restore", `ref_${index}_invalid_reference`);
|
|
280
|
-
const normalizedRef = contextRefForEntry(ref);
|
|
281
|
-
const current = this.projectionState.get(ref);
|
|
282
|
-
if (!current) return this.rejected("restore", `reference_not_archived:${normalizedRef}`);
|
|
283
|
-
if (actor === "model" && !latestRequest?.refs.has(normalizedRef)) {
|
|
284
|
-
return this.rejected("restore", `target_not_in_consumed_context:${normalizedRef}`);
|
|
285
|
-
}
|
|
286
|
-
changes.push({ source: cloneSource(current.source), projection: { mode: "full" } });
|
|
287
|
-
let availabilityValue;
|
|
288
|
-
if (latestRequest?.refs.has(normalizedRef) || activeIds.has(current.source.entryId)) {
|
|
289
|
-
availabilityValue = "active";
|
|
290
|
-
} else {
|
|
291
|
-
availabilityValue = "history-only";
|
|
292
|
-
}
|
|
293
|
-
availability[normalizedRef] = availabilityValue;
|
|
294
|
-
}
|
|
295
|
-
await this.persist({ version: CONTEXT_PROJECTION_VERSION, actor, changes });
|
|
296
|
-
for (const change of changes) {
|
|
297
|
-
this.projectionState.set(change.source.entryId, {
|
|
298
|
-
source: cloneSource(change.source),
|
|
299
|
-
mode: "full",
|
|
300
|
-
});
|
|
301
|
-
}
|
|
302
|
-
return {
|
|
303
|
-
status: "ok",
|
|
304
|
-
operation: "restore",
|
|
305
|
-
changed: changes.map((change) => contextRefForEntry(change.source.entryId)),
|
|
306
|
-
availability,
|
|
307
|
-
message: `Restored ${changes.length} projection${changes.length === 1 ? "" : "s"} to full content.`,
|
|
308
|
-
};
|
|
309
|
-
}
|
|
310
|
-
listItem(source, projection, availability) {
|
|
311
|
-
const item = {
|
|
312
|
-
ref: contextRefForEntry(source.source.entryId),
|
|
313
|
-
entryId: source.source.entryId,
|
|
314
|
-
toolCallId: source.source.toolCallId,
|
|
315
|
-
toolName: source.source.toolName,
|
|
316
|
-
mode: projection.mode,
|
|
317
|
-
originalCharacters: contentCharacters(source.message?.content),
|
|
318
|
-
projectedCharacters: projectedCharacters(source.source, source.message, projection),
|
|
319
|
-
availability,
|
|
320
|
-
};
|
|
321
|
-
if (projection.mode === "archived" && projection.retained !== undefined) {
|
|
322
|
-
item.retained = projection.retained;
|
|
323
|
-
}
|
|
324
|
-
return item;
|
|
325
|
-
}
|
|
326
|
-
rejected(operation, message) {
|
|
327
|
-
return { status: "rejected", operation, changed: [], message };
|
|
328
|
-
}
|
|
329
|
-
unavailable(operation) {
|
|
330
|
-
return {
|
|
331
|
-
status: "unavailable",
|
|
332
|
-
operation,
|
|
333
|
-
changed: [],
|
|
334
|
-
message: this.unavailableReason ?? "context_virtualization_unavailable",
|
|
335
|
-
};
|
|
336
|
-
}
|
|
337
|
-
persist(journal) {
|
|
338
|
-
let append;
|
|
339
|
-
if (typeof this.pi?.appendEntryDurable === "function") {
|
|
340
|
-
append = this.pi.appendEntryDurable;
|
|
341
|
-
} else if (typeof this.pi?.appendEntry === "function") {
|
|
342
|
-
append = this.pi.appendEntry;
|
|
343
|
-
}
|
|
344
|
-
if (!append) throw new Error("The Pi host does not expose a session entry persistence method.");
|
|
345
|
-
const result = append.call(this.pi, CONTEXT_PROJECTION_ENTRY, journal);
|
|
346
|
-
if (result && typeof result.then === "function") return result;
|
|
347
|
-
}
|
|
348
|
-
enqueue(task) {
|
|
349
|
-
const run = this.mutationQueue.then(task);
|
|
350
|
-
this.mutationQueue = run.then(
|
|
351
|
-
() => undefined,
|
|
352
|
-
() => undefined,
|
|
353
|
-
);
|
|
354
|
-
return run;
|
|
355
|
-
}
|
|
356
|
-
}
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
import { CONTEXT_PROJECTION_ENTRY, CONTEXT_PROJECTION_VERSION, isRecord } from "./types.js";
|
|
2
|
-
function isProjection(value) {
|
|
3
|
-
if (!isRecord(value) || (value.mode !== "full" && value.mode !== "archived")) return false;
|
|
4
|
-
if (value.mode === "archived" && value.retained !== undefined && typeof value.retained !== "string") return false;
|
|
5
|
-
return true;
|
|
6
|
-
}
|
|
7
|
-
function isJournal(value) {
|
|
8
|
-
if (!isRecord(value) || value.version !== CONTEXT_PROJECTION_VERSION) return false;
|
|
9
|
-
if (value.actor !== "model" && value.actor !== "user") return false;
|
|
10
|
-
if (value.reset !== undefined && value.reset !== "all") return false;
|
|
11
|
-
if (value.changes !== undefined && !Array.isArray(value.changes)) return false;
|
|
12
|
-
return true;
|
|
13
|
-
}
|
|
14
|
-
export function replayProjectionEntries(entries, sessionId) {
|
|
15
|
-
const state = new Map();
|
|
16
|
-
for (const entry of entries) {
|
|
17
|
-
if (entry?.type !== "custom" || entry.customType !== CONTEXT_PROJECTION_ENTRY) continue;
|
|
18
|
-
const data = entry.data;
|
|
19
|
-
if (!isJournal(data)) continue;
|
|
20
|
-
if (data.reset === "all") {
|
|
21
|
-
state.clear();
|
|
22
|
-
}
|
|
23
|
-
for (const change of data.changes ?? []) {
|
|
24
|
-
if (!isRecord(change) || !isRecord(change.source) || !isProjection(change.projection)) continue;
|
|
25
|
-
if (change.source.sessionId !== sessionId || typeof change.source.entryId !== "string") continue;
|
|
26
|
-
if (change.projection.mode === "archived" && change.projection.retained !== undefined) {
|
|
27
|
-
state.set(change.source.entryId, {
|
|
28
|
-
source: { ...change.source },
|
|
29
|
-
mode: "archived",
|
|
30
|
-
retained: change.projection.retained,
|
|
31
|
-
});
|
|
32
|
-
} else if (change.projection.mode === "archived") {
|
|
33
|
-
state.set(change.source.entryId, {
|
|
34
|
-
source: { ...change.source },
|
|
35
|
-
mode: "archived",
|
|
36
|
-
});
|
|
37
|
-
} else {
|
|
38
|
-
state.set(change.source.entryId, {
|
|
39
|
-
source: { ...change.source },
|
|
40
|
-
mode: "full",
|
|
41
|
-
});
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
}
|
|
45
|
-
return state;
|
|
46
|
-
}
|
|
47
|
-
export function cloneProjectionState(state) {
|
|
48
|
-
return new Map(
|
|
49
|
-
[...state.entries()].map(([entryId, projection]) => [
|
|
50
|
-
entryId,
|
|
51
|
-
{
|
|
52
|
-
...projection,
|
|
53
|
-
source: { ...projection.source },
|
|
54
|
-
},
|
|
55
|
-
]),
|
|
56
|
-
);
|
|
57
|
-
}
|
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
export { CONTEXT_REF_PREFIX, contextRefForEntry, entryIdFromContextRef } from "../freeflow-context/types.js";
|
|
2
|
-
export const CONTEXT_PROJECTION_ENTRY = "freeflow-context-projection";
|
|
3
|
-
export const CONTEXT_PROJECTION_VERSION = 1;
|
|
4
|
-
export function isRecord(value) {
|
|
5
|
-
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
6
|
-
}
|
|
7
|
-
export function projectionCharacters(projection) {
|
|
8
|
-
if (projection.mode === "full") return 0;
|
|
9
|
-
return projection.retained?.length ?? 0;
|
|
10
|
-
}
|