@mnemonik/shared 7.92.15 → 7.92.17
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/dist/contextBudget.d.ts +11 -3
- package/dist/contextBudget.d.ts.map +1 -1
- package/dist/contextBudget.js +66 -1
- package/dist/contextBudget.js.map +1 -1
- package/package.json +1 -1
- package/src/contextBudget.ts +73 -3
package/dist/contextBudget.d.ts
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
export { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
|
|
2
2
|
export type ContextBudgetUnits = 'characters' | 'utf8-bytes';
|
|
3
|
+
export declare const REFLEX_NOTE_BUDGET_BYTES: {
|
|
4
|
+
readonly claude_code: 6000;
|
|
5
|
+
readonly codex: 6000;
|
|
6
|
+
readonly cursor: 6000;
|
|
7
|
+
readonly grok: 6000;
|
|
8
|
+
readonly vscode: 6000;
|
|
9
|
+
};
|
|
3
10
|
export interface ContextBudgetItem {
|
|
4
11
|
/** Exact text emitted when the item fits in full. */
|
|
5
12
|
text: string;
|
|
@@ -16,16 +23,17 @@ export type ContextBudgetPiece = string | ContextBudgetItem;
|
|
|
16
23
|
export interface BudgetedContextFit {
|
|
17
24
|
value: string;
|
|
18
25
|
fullyDeliveredItems: number;
|
|
19
|
-
/**
|
|
26
|
+
/** Index of the one memory item whose head was delivered, when present. */
|
|
20
27
|
partialItemIndex: number | null;
|
|
21
|
-
/**
|
|
28
|
+
/** Units delivered from the partial memory item, excluding its marker. */
|
|
22
29
|
partialUnitsDelivered: number;
|
|
23
30
|
}
|
|
24
31
|
/** Measure rendered context in the host's native budget unit. */
|
|
25
32
|
export declare function measureContext(text: string, units?: ContextBudgetUnits): number;
|
|
26
33
|
/**
|
|
27
34
|
* Compose ordered items within a fixed budget. Full items are emitted exactly;
|
|
28
|
-
* the first item that does not fit and every later item are shed.
|
|
35
|
+
* the first item that does not fit and every later item are shed. The first
|
|
36
|
+
* shed memory keeps a bounded head plus its retrieval marker; later shed items
|
|
29
37
|
* share one trailing marker containing only their explicit retrieval routes.
|
|
30
38
|
* Items without a route leave no agent-visible stub.
|
|
31
39
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,
|
|
1
|
+
{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,eAAO,MAAM,wBAAwB;aACnC,WAAW,EAAE,IAAK;aAClB,KAAK,EAAE,IAAK;aACZ,MAAM,EAAE,IAAK;aACb,IAAI,EAAE,IAAK;aACX,MAAM,EAAE,IAAK;CACL,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AA8CD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,MAAM,CAE7F;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,GACA,kBAAkB,CA6FpB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,iBAAiB,EAAE,CAMrB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClF,MAAM,CAIR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}
|
package/dist/contextBudget.js
CHANGED
|
@@ -1,7 +1,17 @@
|
|
|
1
1
|
import { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
|
|
2
2
|
export { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
|
|
3
|
+
export const REFLEX_NOTE_BUDGET_BYTES = {
|
|
4
|
+
claude_code: 6_000,
|
|
5
|
+
codex: 6_000,
|
|
6
|
+
cursor: 6_000,
|
|
7
|
+
grok: 6_000,
|
|
8
|
+
vscode: 6_000,
|
|
9
|
+
};
|
|
3
10
|
const JOINER = '\n\n';
|
|
4
11
|
const NOT_REACHED_PREFIX = '… not reached: ';
|
|
12
|
+
function truncatedMemoryMarker(memoryId) {
|
|
13
|
+
return `… [truncated; memory_get ${memoryId} for the rest]`;
|
|
14
|
+
}
|
|
5
15
|
function itemMemoryIds(item) {
|
|
6
16
|
if (item.memoryIds && item.memoryIds.length > 0)
|
|
7
17
|
return item.memoryIds;
|
|
@@ -25,13 +35,28 @@ function joinSections(sections) {
|
|
|
25
35
|
.filter((section) => section !== null && section.length > 0)
|
|
26
36
|
.join(JOINER);
|
|
27
37
|
}
|
|
38
|
+
function contextHead(text, budget, units) {
|
|
39
|
+
if (budget <= 0)
|
|
40
|
+
return '';
|
|
41
|
+
const characters = [];
|
|
42
|
+
let used = 0;
|
|
43
|
+
for (const character of text) {
|
|
44
|
+
const size = measureContext(character, units);
|
|
45
|
+
if (used + size > budget)
|
|
46
|
+
break;
|
|
47
|
+
characters.push(character);
|
|
48
|
+
used += size;
|
|
49
|
+
}
|
|
50
|
+
return characters.join('');
|
|
51
|
+
}
|
|
28
52
|
/** Measure rendered context in the host's native budget unit. */
|
|
29
53
|
export function measureContext(text, units = 'characters') {
|
|
30
54
|
return units === 'utf8-bytes' ? Buffer.byteLength(text, 'utf8') : text.length;
|
|
31
55
|
}
|
|
32
56
|
/**
|
|
33
57
|
* Compose ordered items within a fixed budget. Full items are emitted exactly;
|
|
34
|
-
* the first item that does not fit and every later item are shed.
|
|
58
|
+
* the first item that does not fit and every later item are shed. The first
|
|
59
|
+
* shed memory keeps a bounded head plus its retrieval marker; later shed items
|
|
35
60
|
* share one trailing marker containing only their explicit retrieval routes.
|
|
36
61
|
* Items without a route leave no agent-visible stub.
|
|
37
62
|
*/
|
|
@@ -63,6 +88,46 @@ export function fitContextItems(items, opts) {
|
|
|
63
88
|
accepted.push(item.text);
|
|
64
89
|
continue;
|
|
65
90
|
}
|
|
91
|
+
if (item.memoryId) {
|
|
92
|
+
const marker = truncatedMemoryMarker(item.memoryId);
|
|
93
|
+
const laterPointer = notReachedPointer(later);
|
|
94
|
+
const markerOnly = joinSections([
|
|
95
|
+
...accepted,
|
|
96
|
+
marker,
|
|
97
|
+
...suffix.map((entry) => entry.text),
|
|
98
|
+
laterPointer,
|
|
99
|
+
]);
|
|
100
|
+
if (measureContext(markerOnly, units) <= opts.budget) {
|
|
101
|
+
const headBudget = opts.budget - measureContext(markerOnly, units) - measureContext('\n', units);
|
|
102
|
+
const head = contextHead(item.text, headBudget, units);
|
|
103
|
+
return {
|
|
104
|
+
value: head.length > 0
|
|
105
|
+
? joinSections([
|
|
106
|
+
...accepted,
|
|
107
|
+
`${head}\n${marker}`,
|
|
108
|
+
...suffix.map((entry) => entry.text),
|
|
109
|
+
laterPointer,
|
|
110
|
+
])
|
|
111
|
+
: markerOnly,
|
|
112
|
+
fullyDeliveredItems: index,
|
|
113
|
+
partialItemIndex: index,
|
|
114
|
+
partialUnitsDelivered: measureContext(head, units),
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
const fullItemWithoutPointer = joinSections([
|
|
118
|
+
...accepted,
|
|
119
|
+
item.text,
|
|
120
|
+
...suffix.map((entry) => entry.text),
|
|
121
|
+
]);
|
|
122
|
+
if (measureContext(fullItemWithoutPointer, units) <= opts.budget) {
|
|
123
|
+
return {
|
|
124
|
+
value: fullItemWithoutPointer,
|
|
125
|
+
fullyDeliveredItems: index + 1,
|
|
126
|
+
partialItemIndex: null,
|
|
127
|
+
partialUnitsDelivered: 0,
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
}
|
|
66
131
|
const withoutPointer = joinSections([...accepted, ...suffix.map((entry) => entry.text)]);
|
|
67
132
|
const withPointer = joinSections([
|
|
68
133
|
...accepted,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contextBudget.js","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"contextBudget.js","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/src/contextBudget.ts
CHANGED
|
@@ -4,6 +4,14 @@ export { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
|
|
|
4
4
|
|
|
5
5
|
export type ContextBudgetUnits = 'characters' | 'utf8-bytes';
|
|
6
6
|
|
|
7
|
+
export const REFLEX_NOTE_BUDGET_BYTES = {
|
|
8
|
+
claude_code: 6_000,
|
|
9
|
+
codex: 6_000,
|
|
10
|
+
cursor: 6_000,
|
|
11
|
+
grok: 6_000,
|
|
12
|
+
vscode: 6_000,
|
|
13
|
+
} as const;
|
|
14
|
+
|
|
7
15
|
export interface ContextBudgetItem {
|
|
8
16
|
/** Exact text emitted when the item fits in full. */
|
|
9
17
|
text: string;
|
|
@@ -22,15 +30,19 @@ export type ContextBudgetPiece = string | ContextBudgetItem;
|
|
|
22
30
|
export interface BudgetedContextFit {
|
|
23
31
|
value: string;
|
|
24
32
|
fullyDeliveredItems: number;
|
|
25
|
-
/**
|
|
33
|
+
/** Index of the one memory item whose head was delivered, when present. */
|
|
26
34
|
partialItemIndex: number | null;
|
|
27
|
-
/**
|
|
35
|
+
/** Units delivered from the partial memory item, excluding its marker. */
|
|
28
36
|
partialUnitsDelivered: number;
|
|
29
37
|
}
|
|
30
38
|
|
|
31
39
|
const JOINER = '\n\n';
|
|
32
40
|
const NOT_REACHED_PREFIX = '… not reached: ';
|
|
33
41
|
|
|
42
|
+
function truncatedMemoryMarker(memoryId: string): string {
|
|
43
|
+
return `… [truncated; memory_get ${memoryId} for the rest]`;
|
|
44
|
+
}
|
|
45
|
+
|
|
34
46
|
function itemMemoryIds(item: ContextBudgetItem): readonly string[] {
|
|
35
47
|
if (item.memoryIds && item.memoryIds.length > 0) return item.memoryIds;
|
|
36
48
|
return item.memoryId ? [item.memoryId] : [];
|
|
@@ -55,6 +67,19 @@ function joinSections(sections: readonly (string | null)[]): string {
|
|
|
55
67
|
.join(JOINER);
|
|
56
68
|
}
|
|
57
69
|
|
|
70
|
+
function contextHead(text: string, budget: number, units: ContextBudgetUnits): string {
|
|
71
|
+
if (budget <= 0) return '';
|
|
72
|
+
const characters: string[] = [];
|
|
73
|
+
let used = 0;
|
|
74
|
+
for (const character of text) {
|
|
75
|
+
const size = measureContext(character, units);
|
|
76
|
+
if (used + size > budget) break;
|
|
77
|
+
characters.push(character);
|
|
78
|
+
used += size;
|
|
79
|
+
}
|
|
80
|
+
return characters.join('');
|
|
81
|
+
}
|
|
82
|
+
|
|
58
83
|
/** Measure rendered context in the host's native budget unit. */
|
|
59
84
|
export function measureContext(text: string, units: ContextBudgetUnits = 'characters'): number {
|
|
60
85
|
return units === 'utf8-bytes' ? Buffer.byteLength(text, 'utf8') : text.length;
|
|
@@ -62,7 +87,8 @@ export function measureContext(text: string, units: ContextBudgetUnits = 'charac
|
|
|
62
87
|
|
|
63
88
|
/**
|
|
64
89
|
* Compose ordered items within a fixed budget. Full items are emitted exactly;
|
|
65
|
-
* the first item that does not fit and every later item are shed.
|
|
90
|
+
* the first item that does not fit and every later item are shed. The first
|
|
91
|
+
* shed memory keeps a bounded head plus its retrieval marker; later shed items
|
|
66
92
|
* share one trailing marker containing only their explicit retrieval routes.
|
|
67
93
|
* Items without a route leave no agent-visible stub.
|
|
68
94
|
*/
|
|
@@ -102,6 +128,50 @@ export function fitContextItems(
|
|
|
102
128
|
continue;
|
|
103
129
|
}
|
|
104
130
|
|
|
131
|
+
if (item.memoryId) {
|
|
132
|
+
const marker = truncatedMemoryMarker(item.memoryId);
|
|
133
|
+
const laterPointer = notReachedPointer(later);
|
|
134
|
+
const markerOnly = joinSections([
|
|
135
|
+
...accepted,
|
|
136
|
+
marker,
|
|
137
|
+
...suffix.map((entry) => entry.text),
|
|
138
|
+
laterPointer,
|
|
139
|
+
]);
|
|
140
|
+
if (measureContext(markerOnly, units) <= opts.budget) {
|
|
141
|
+
const headBudget =
|
|
142
|
+
opts.budget - measureContext(markerOnly, units) - measureContext('\n', units);
|
|
143
|
+
const head = contextHead(item.text, headBudget, units);
|
|
144
|
+
return {
|
|
145
|
+
value:
|
|
146
|
+
head.length > 0
|
|
147
|
+
? joinSections([
|
|
148
|
+
...accepted,
|
|
149
|
+
`${head}\n${marker}`,
|
|
150
|
+
...suffix.map((entry) => entry.text),
|
|
151
|
+
laterPointer,
|
|
152
|
+
])
|
|
153
|
+
: markerOnly,
|
|
154
|
+
fullyDeliveredItems: index,
|
|
155
|
+
partialItemIndex: index,
|
|
156
|
+
partialUnitsDelivered: measureContext(head, units),
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
const fullItemWithoutPointer = joinSections([
|
|
161
|
+
...accepted,
|
|
162
|
+
item.text,
|
|
163
|
+
...suffix.map((entry) => entry.text),
|
|
164
|
+
]);
|
|
165
|
+
if (measureContext(fullItemWithoutPointer, units) <= opts.budget) {
|
|
166
|
+
return {
|
|
167
|
+
value: fullItemWithoutPointer,
|
|
168
|
+
fullyDeliveredItems: index + 1,
|
|
169
|
+
partialItemIndex: null,
|
|
170
|
+
partialUnitsDelivered: 0,
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
105
175
|
const withoutPointer = joinSections([...accepted, ...suffix.map((entry) => entry.text)]);
|
|
106
176
|
const withPointer = joinSections([
|
|
107
177
|
...accepted,
|