@modelprofile.com/flexharness-agent 16.3.0 → 16.4.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/dist_ts_agent/classes.sessionengine.d.ts +7 -0
- package/dist_ts_agent/classes.sessionengine.js +56 -7
- package/dist_ts_agent/index.d.ts +3 -2
- package/dist_ts_agent/index.js +2 -1
- package/dist_ts_agent/smartagent.context.d.ts +2 -0
- package/dist_ts_agent/smartagent.context.js +3 -2
- package/dist_ts_agent/smartagent.events.d.ts +16 -0
- package/dist_ts_agent/smartagent.events.js +1 -1
- package/dist_ts_agent/smartagent.interfaces.d.ts +34 -1
- package/dist_ts_agent/smartagent.interfaces.js +1 -1
- package/dist_ts_agent/smartagent.persistence.js +8 -1
- package/dist_ts_agent/smartagent.pinnedcontext.d.ts +15 -0
- package/dist_ts_agent/smartagent.pinnedcontext.js +52 -0
- package/dist_ts_agent/smartagent.transactions.d.ts +5 -0
- package/dist_ts_agent/smartagent.transactions.js +50 -8
- package/package.json +2 -2
- package/readme.md +6 -2
- package/ts_agent/classes.sessionengine.ts +65 -6
- package/ts_agent/index.ts +4 -0
- package/ts_agent/readme.md +6 -2
- package/ts_agent/smartagent.context.ts +2 -1
- package/ts_agent/smartagent.events.ts +17 -0
- package/ts_agent/smartagent.interfaces.ts +36 -0
- package/ts_agent/smartagent.persistence.ts +7 -0
- package/ts_agent/smartagent.pinnedcontext.ts +64 -0
- package/ts_agent/smartagent.transactions.ts +50 -8
|
@@ -102,12 +102,16 @@ const isModelOutputEvent = (event) => event.type === 'assistant-message'
|
|
|
102
102
|
|| event.type === 'tool-call'
|
|
103
103
|
|| event.type === 'tool-result'
|
|
104
104
|
|| event.type === 'model-message';
|
|
105
|
-
/**
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
105
|
+
/**
|
|
106
|
+
* Accepted and active generations, and terminal generations with actual model/tool output. An
|
|
107
|
+
* ephemeral generation is visible only until its outcome.
|
|
108
|
+
*/
|
|
109
|
+
const isModelVisibleTransaction = (transaction, producedOutput) => (transaction.begun.ephemeral !== true || transaction.outcome === undefined)
|
|
110
|
+
&& (transaction.state === 'accepted'
|
|
111
|
+
|| transaction.state === 'execution-started'
|
|
112
|
+
|| ((transaction.state === 'interrupted' || transaction.state === 'rejected')
|
|
113
|
+
&& transaction.executionStarted !== undefined
|
|
114
|
+
&& producedOutput.has(transaction.generationId)));
|
|
111
115
|
/** The generations whose model produced output in `events`. */
|
|
112
116
|
const generationsWithModelOutput = (events) => {
|
|
113
117
|
const producedOutput = new Set();
|
|
@@ -136,10 +140,46 @@ const interruptedToolResult = (toolCallId, toolName, source) => ({
|
|
|
136
140
|
causationId: source.causationId,
|
|
137
141
|
parentIds: [source.id],
|
|
138
142
|
});
|
|
143
|
+
/**
|
|
144
|
+
* The events a model sees, in the order it sees them. A generation's pinned context message is
|
|
145
|
+
* committed once its lease is prepared, after its prompt; the model sees it right before the
|
|
146
|
+
* prompt. Nothing committed after the generation's first model call moves.
|
|
147
|
+
*/
|
|
139
148
|
export const filterModelVisibleAgentEvents = (events) => {
|
|
140
149
|
const transactions = getAgentGenerationTransactions(events);
|
|
141
150
|
const producedOutput = generationsWithModelOutput(events);
|
|
142
151
|
const resultedToolCalls = new Set();
|
|
152
|
+
/** The pinned context messages of each generation whose prompt precedes them, by its prompt's id. */
|
|
153
|
+
const pinnedBeforePrompt = new Map();
|
|
154
|
+
const promptIds = new Map();
|
|
155
|
+
/**
|
|
156
|
+
* Generations that have started a model call. Only a pinned context message committed before its
|
|
157
|
+
* generation's first model call moves: once a call has been sent, every later call of the
|
|
158
|
+
* generation must extend that request byte for byte, so anything committed after it stays where
|
|
159
|
+
* it was appended.
|
|
160
|
+
*/
|
|
161
|
+
const inferringGenerations = new Set();
|
|
162
|
+
for (const event of events) {
|
|
163
|
+
if (!event.generationId)
|
|
164
|
+
continue;
|
|
165
|
+
if (event.type === 'runtime-event' && event.event.type === 'inference-started') {
|
|
166
|
+
inferringGenerations.add(event.generationId);
|
|
167
|
+
continue;
|
|
168
|
+
}
|
|
169
|
+
if (event.type !== 'user-message')
|
|
170
|
+
continue;
|
|
171
|
+
const transaction = transactions.get(event.generationId);
|
|
172
|
+
if (!event.pinnedContext && transaction && event.causationId === transaction.begun.id) {
|
|
173
|
+
promptIds.set(event.generationId, event.id);
|
|
174
|
+
}
|
|
175
|
+
else if (event.pinnedContext
|
|
176
|
+
&& promptIds.has(event.generationId)
|
|
177
|
+
&& !inferringGenerations.has(event.generationId)) {
|
|
178
|
+
const promptId = promptIds.get(event.generationId);
|
|
179
|
+
pinnedBeforePrompt.set(promptId, [...pinnedBeforePrompt.get(promptId) ?? [], event]);
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
const movedPinnedIds = new Set([...pinnedBeforePrompt.values()].flat().map((event) => event.id));
|
|
143
183
|
for (const event of events) {
|
|
144
184
|
if (!event.generationId)
|
|
145
185
|
continue;
|
|
@@ -193,7 +233,9 @@ export const filterModelVisibleAgentEvents = (events) => {
|
|
|
193
233
|
const transaction = transactions.get(event.generationId);
|
|
194
234
|
if (transaction && !isModelVisibleTransaction(transaction, producedOutput))
|
|
195
235
|
continue;
|
|
196
|
-
|
|
236
|
+
if (movedPinnedIds.has(event.id))
|
|
237
|
+
continue;
|
|
238
|
+
visibleEvents.push(...pinnedBeforePrompt.get(event.id) ?? [], event);
|
|
197
239
|
if (transaction?.state !== 'interrupted' && transaction?.state !== 'rejected')
|
|
198
240
|
continue;
|
|
199
241
|
if (event.type === 'tool-call' && event.providerExecuted !== true) {
|
|
@@ -229,4 +271,4 @@ export const getUncertainToolExecutionIntents = (events, generationId) => {
|
|
|
229
271
|
}
|
|
230
272
|
return [...uncertain.values()];
|
|
231
273
|
};
|
|
232
|
-
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC50cmFuc2FjdGlvbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19hZ2VudC9zbWFydGFnZW50LnRyYW5zYWN0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUE0QkEsTUFBTSxjQUFjLEdBQUcsQ0FBQyxLQUFrQixFQUErQixFQUFFLENBQ3pFLEtBQUssQ0FBQyxJQUFJLEtBQUssa0JBQWtCO09BQzlCLEtBQUssQ0FBQyxJQUFJLEtBQUssOEJBQThCO09BQzdDLEtBQUssQ0FBQyxJQUFJLEtBQUssZ0NBQWdDO09BQy9DLEtBQUssQ0FBQyxJQUFJLEtBQUssb0JBQW9CO09BQ25DLEtBQUssQ0FBQyxJQUFJLEtBQUssdUJBQXVCO09BQ3RDLEtBQUssQ0FBQyxJQUFJLEtBQUssK0JBQStCLENBQUM7QUFFcEQsTUFBTSxDQUFDLE1BQU0sOEJBQThCLEdBQUcsQ0FDNUMsTUFBOEIsRUFDWSxFQUFFO0lBZTVDLE1BQU0sV0FBVyxHQUFHLElBQUksR0FBRyxFQUFtQyxDQUFDO0lBQy9ELE1BQU0sUUFBUSxHQUFHLENBQUMsWUFBb0IsRUFBMkIsRUFBRTtRQUNqRSxJQUFJLEtBQUssR0FBRyxXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBQzFDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNYLEtBQUssR0FBRztnQkFDTixVQUFVLEVBQUUsQ0FBQztnQkFDYixVQUFVLEVBQUUsQ0FBQyxDQUFDO2dCQUNkLFlBQVksRUFBRSxDQUFDO2dCQUNmLFlBQVksRUFBRSxDQUFDLENBQUM7Z0JBQ2hCLGNBQWMsRUFBRSxDQUFDO2dCQUNqQixjQUFjLEVBQUUsQ0FBQyxDQUFDO2dCQUNsQixZQUFZLEVBQUUsQ0FBQztnQkFDZixZQUFZLEVBQUUsQ0FBQyxDQUFDO2FBQ2pCLENBQUM7WUFDRixXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxLQUFLLENBQUMsQ0FBQztRQUN2QyxDQUFDO1FBQ0QsT0FB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
|
|
274
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC50cmFuc2FjdGlvbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19hZ2VudC9zbWFydGFnZW50LnRyYW5zYWN0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUE0QkEsTUFBTSxjQUFjLEdBQUcsQ0FBQyxLQUFrQixFQUErQixFQUFFLENBQ3pFLEtBQUssQ0FBQyxJQUFJLEtBQUssa0JBQWtCO09BQzlCLEtBQUssQ0FBQyxJQUFJLEtBQUssOEJBQThCO09BQzdDLEtBQUssQ0FBQyxJQUFJLEtBQUssZ0NBQWdDO09BQy9DLEtBQUssQ0FBQyxJQUFJLEtBQUssb0JBQW9CO09BQ25DLEtBQUssQ0FBQyxJQUFJLEtBQUssdUJBQXVCO09BQ3RDLEtBQUssQ0FBQyxJQUFJLEtBQUssK0JBQStCLENBQUM7QUFFcEQsTUFBTSxDQUFDLE1BQU0sOEJBQThCLEdBQUcsQ0FDNUMsTUFBOEIsRUFDWSxFQUFFO0lBZTVDLE1BQU0sV0FBVyxHQUFHLElBQUksR0FBRyxFQUFtQyxDQUFDO0lBQy9ELE1BQU0sUUFBUSxHQUFHLENBQUMsWUFBb0IsRUFBMkIsRUFBRTtRQUNqRSxJQUFJLEtBQUssR0FBRyxXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBQzFDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNYLEtBQUssR0FBRztnQkFDTixVQUFVLEVBQUUsQ0FBQztnQkFDYixVQUFVLEVBQUUsQ0FBQyxDQUFDO2dCQUNkLFlBQVksRUFBRSxDQUFDO2dCQUNmLFlBQVksRUFBRSxDQUFDLENBQUM7Z0JBQ2hCLGNBQWMsRUFBRSxDQUFDO2dCQUNqQixjQUFjLEVBQUUsQ0FBQyxDQUFDO2dCQUNsQixZQUFZLEVBQUUsQ0FBQztnQkFDZixZQUFZLEVBQUUsQ0FBQyxDQUFDO2FBQ2pCLENBQUM7WUFDRixXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxLQUFLLENBQUMsQ0FBQztRQUN2QyxDQUFDO1FBQ0QsT0FB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
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"author": "Task Venture Capital GmbH",
|
|
3
3
|
"license": "MIT",
|
|
4
4
|
"name": "@modelprofile.com/flexharness-agent",
|
|
5
|
-
"version": "16.
|
|
5
|
+
"version": "16.4.0",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"description": "Standalone event-driven agent runtime with generation transactions, context and tool execution contracts.",
|
|
8
8
|
"main": "./dist_ts_agent/index.js",
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
}
|
|
19
19
|
},
|
|
20
20
|
"dependencies": {
|
|
21
|
-
"@modelprofile.com/flexharness-models": "16.
|
|
21
|
+
"@modelprofile.com/flexharness-models": "16.4.0",
|
|
22
22
|
"ai": "^7.0.111",
|
|
23
23
|
"zod": "^4.6.5",
|
|
24
24
|
"@noble/hashes": "^2.4.0",
|
package/readme.md
CHANGED
|
@@ -290,6 +290,8 @@ changes. The managing harness owns validation that an unanswered turn exists.
|
|
|
290
290
|
`IAgentSession.beginGeneration(content: TAgentPrompt, options?)` keeps its existing
|
|
291
291
|
contract, so existing session implementers do not need to support missing input.
|
|
292
292
|
|
|
293
|
+
`beginGeneration(content, { generationId, ephemeral: true })` begins an ephemeral generation: its own model calls see it, but once it has an outcome none of its events, prompt and answer included, reaches a later model request, whatever the outcome. Its events, outcome and usage stay recorded, its outcome carries no `contextUsage`, and `isGenerationInModelContext()` reports `false` for it once settled. A later request continues the context that preceded it, so it shares the prefix the ephemeral generation's calls sent before its prompt: a prompt-cache warm turn is one.
|
|
294
|
+
|
|
293
295
|
Closing a session or restoring a stored session interrupts unfinished transactions. Restoration does not automatically rerun them. Persisted transactions require an event store; without one, transactions are process-local.
|
|
294
296
|
|
|
295
297
|
A rejected generation does not roll back external tool effects. The runtime records transactional tool-execution intents and results. If a crash leaves an intent without a known result, inspect `listUncertainToolExecutions()` and reconcile the external operation through `reconcileToolExecution()` before treating its outcome as known. This is not a general exactly-once guarantee for external services.
|
|
@@ -373,11 +375,13 @@ The steps of one generation read each URL once; a read that fails fails the step
|
|
|
373
375
|
|
|
374
376
|
### Bound model context and active events
|
|
375
377
|
|
|
376
|
-
- `contextBuilder({ events })` controls the model-message projection.
|
|
378
|
+
- `contextBuilder({ events })` controls the model-message projection. It receives the model-visible events in the order the model sees them (`filterModelVisibleAgentEvents()`).
|
|
379
|
+
- `contextEventFilter(events)` leaves out events the host keeps from the model, such as undone turns. It receives `filterModelVisibleAgentEvents()`'s result and applies to everything the session derives from it: the context it builds, what a compaction summarizes and which pinned context revision is visible.
|
|
380
|
+
- A generation lease's `pinnedContext: { id, revision, text }` keeps text in front of the model without placing it in the system prompt, so a new revision leaves the cached prefix as it was. When the model-visible context after the latest compaction does not show this revision as the id's latest, the generation appends a pinned context message (a user message with `pinnedContext: { id, revision }` and the content `pinnedContextMessageContent()` renders) before its first model call; the model sees it right before the generation's prompt, and every later model call of the generation extends the first request byte for byte. A compaction ends its replacement with the latest revision of each pinned context it covered, unless the events it leaves in place carry that id. The revision is read from the model-visible events alone: a generation that leaves the context takes its message along, and the next one appends it again. A new text needs a new revision, a non-negative safe integer compared for equality only.
|
|
377
381
|
- `contextCompactor(messages, events, { reason, abortSignal, reportUsage })` returns replacement model messages. Provide it to use `session.compact()` or automatic event retention. Report the usage of its model calls through `reportUsage`; see [What is counted](#what-is-counted).
|
|
378
382
|
- A compactor also enables proactive compaction with reason `context-budget` before a generation's first inference, once the context reaches its compaction point in tokens. The point's ceiling is 90% of the served context window of the generation's model: `contextWindow` on the generation lease that names the model, or on the session options for the session model. The default is the ceiling, or `contextCompactionDefaultTokens` when lower; `contextCompaction` chooses `{ tokens }` (clamped to the ceiling, unclamped without a window), `{ percent }` (an integer from 1 through 90 of the window; none without one) or `false`. A lease's `contextCompaction` takes precedence over the session's. `resolveAgentContextCompactionPoint()` states the point. The context counts the input tokens of the latest transactional generation outcome's `contextUsage` while the events that call saw still build the same model messages and no compaction followed, plus an estimate of 4 UTF-8 JSON bytes per token for what came after; otherwise the whole context is estimated. Only settled history is covered, never the current unsettled generation. Budget compactions carry `automatic: true`; after transactional finalization their covered events are archived when the store supports it and no open transaction or uncertain tool intent remains. Manual compaction is not automatically archived.
|
|
379
383
|
- `eventRetention: { maxEvents }` triggers compaction and archival when the active event count exceeds the threshold. It also requires an event store with `archive()` support.
|
|
380
|
-
- Context overflow invokes the configured compactor, or the `onContextOverflow(messages, { abortSignal, reportUsage })` handler. Without either, generation throws `ContextOverflowError`. `maxContextOverflowRetries` defaults to `3`.
|
|
384
|
+
- Context overflow invokes the configured compactor, or the `onContextOverflow(messages, { abortSignal, reportUsage })` handler. Without either, generation throws `ContextOverflowError`. It throws it as well, without calling the model again, when the overflow compaction finds nothing to compact: compaction never covers the current generation, and uncertain tool intents block it. `maxContextOverflowRetries` defaults to `3`.
|
|
381
385
|
- Open transactions and uncertain tool intents constrain when compaction and archival can proceed. Resolve them before manual compaction.
|
|
382
386
|
|
|
383
387
|
Compaction changes the active model context; archival moves covered events out of the active event set. Implement archive retention in your chosen store when you need a complete audit history.
|
|
@@ -2,6 +2,11 @@ import * as plugins from './plugins.js';
|
|
|
2
2
|
import type { IAgentRuntimePlatform, TAgentSessionOwnership } from './runtime.interfaces.js';
|
|
3
3
|
import { assertAttachmentResolver, createAttachmentDownload } from './smartagent.attachments.js';
|
|
4
4
|
import { buildModelMessages } from './smartagent.context.js';
|
|
5
|
+
import {
|
|
6
|
+
assertAgentPinnedContext,
|
|
7
|
+
createPinnedContextMessageFields,
|
|
8
|
+
latestPinnedContextMessages,
|
|
9
|
+
} from './smartagent.pinnedcontext.js';
|
|
5
10
|
import {
|
|
6
11
|
createAgentEvent,
|
|
7
12
|
createAgentEventId,
|
|
@@ -884,6 +889,9 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
884
889
|
await this.flushPersistence();
|
|
885
890
|
const generationId = options.generationId ?? createAgentEventId('generation');
|
|
886
891
|
if (!generationId.trim()) throw new Error('Transactional generationId must not be empty.');
|
|
892
|
+
if (options.ephemeral !== undefined && options.ephemeral !== true) {
|
|
893
|
+
throw new Error('ephemeral must be true when present.');
|
|
894
|
+
}
|
|
887
895
|
const existingTransaction = getAgentGenerationTransactions(this.events).get(generationId);
|
|
888
896
|
if (existingTransaction) {
|
|
889
897
|
if (existingTransaction.state === 'invalid') {
|
|
@@ -894,7 +902,7 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
894
902
|
&& event.generationId === generationId
|
|
895
903
|
&& event.causationId === existingTransaction.begun.id);
|
|
896
904
|
const handle = this.generationHandles.get(generationId);
|
|
897
|
-
if (handle && (content === undefined
|
|
905
|
+
if (handle && existingTransaction.begun.ephemeral === options.ephemeral && (content === undefined
|
|
898
906
|
? existingMessage === undefined
|
|
899
907
|
: existingMessage && this.platform.isDeepEqual(existingMessage.content, content))) {
|
|
900
908
|
return handle;
|
|
@@ -918,6 +926,7 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
918
926
|
type: 'generation-begun',
|
|
919
927
|
generationId,
|
|
920
928
|
claimTokenDigest,
|
|
929
|
+
...(options.ephemeral ? { ephemeral: true as const } : {}),
|
|
921
930
|
parentIds: priorEvent ? [priorEvent.id] : undefined,
|
|
922
931
|
});
|
|
923
932
|
this.commitEvents(content === undefined ? [begun] : [begun, createAgentEvent<IUserMessageEvent>({
|
|
@@ -967,7 +976,8 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
967
976
|
const parent = transaction.executionCompleted
|
|
968
977
|
?? transaction.executionStarted
|
|
969
978
|
?? transaction.begun;
|
|
970
|
-
|
|
979
|
+
// An ephemeral generation's reading measured a context no later request sends.
|
|
980
|
+
const contextUsage = transaction.begun.ephemeral ? undefined : this.generationContextUsage.get(generationId);
|
|
971
981
|
this.commitEvent(createAgentEvent<IGenerationOutcomeEvent>({
|
|
972
982
|
type: 'generation-outcome',
|
|
973
983
|
generationId,
|
|
@@ -1126,8 +1136,14 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
1126
1136
|
return this.buildContext(this.events);
|
|
1127
1137
|
}
|
|
1128
1138
|
|
|
1129
|
-
|
|
1139
|
+
/** The model-visible events, without those the host's `contextEventFilter` keeps from the model. */
|
|
1140
|
+
private modelVisibleEvents(events: readonly TAgentEvent[]): TAgentEvent[] {
|
|
1130
1141
|
const visibleEvents = filterModelVisibleAgentEvents(events);
|
|
1142
|
+
return this.options.contextEventFilter ? this.options.contextEventFilter(visibleEvents) : visibleEvents;
|
|
1143
|
+
}
|
|
1144
|
+
|
|
1145
|
+
private buildContext(events: readonly TAgentEvent[]): plugins.ModelMessage[] {
|
|
1146
|
+
const visibleEvents = this.modelVisibleEvents(events);
|
|
1131
1147
|
return this.options.contextBuilder
|
|
1132
1148
|
? this.options.contextBuilder({ events: visibleEvents })
|
|
1133
1149
|
: buildModelMessages(visibleEvents);
|
|
@@ -1407,7 +1423,7 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
1407
1423
|
coveredEvents = this.events.slice();
|
|
1408
1424
|
}
|
|
1409
1425
|
if (coveredEvents.length === 0) return undefined;
|
|
1410
|
-
const visibleCoveredEvents =
|
|
1426
|
+
const visibleCoveredEvents = this.modelVisibleEvents(coveredEvents);
|
|
1411
1427
|
const messages = this.buildContext(visibleCoveredEvents);
|
|
1412
1428
|
const replacementMessages = this.options.contextCompactor
|
|
1413
1429
|
? await this.invokeGenerationCallback(
|
|
@@ -1468,11 +1484,24 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
1468
1484
|
}
|
|
1469
1485
|
const archivedTransactions = [...archivedTransactionMap.values()]
|
|
1470
1486
|
.slice(-(this.options.maxArchivedTransactionTombstones ?? 1000));
|
|
1487
|
+
// The replacement ends with the latest revision of each pinned context it covers, unless the
|
|
1488
|
+
// events left in place, the open generation's, carry that id themselves.
|
|
1489
|
+
const coveredIds = new Set(coveredEvents.map((event) => event.id));
|
|
1490
|
+
const keptPinnedIds = latestPinnedContextMessages(
|
|
1491
|
+
this.modelVisibleEvents(this.events.filter((event) => !coveredIds.has(event.id))),
|
|
1492
|
+
);
|
|
1493
|
+
const carriedPinnedContexts = [...latestPinnedContextMessages(visibleCoveredEvents).values()]
|
|
1494
|
+
.filter((event) => !keptPinnedIds.has(event.pinnedContext!.id))
|
|
1495
|
+
.map((event) => createAgentEvent<IUserMessageEvent>({
|
|
1496
|
+
type: 'user-message',
|
|
1497
|
+
content: event.content,
|
|
1498
|
+
pinnedContext: { ...event.pinnedContext! },
|
|
1499
|
+
}));
|
|
1471
1500
|
const compaction = this.commitEvent(createAgentEvent<IContextCompactionEvent>({
|
|
1472
1501
|
type: 'context-compaction',
|
|
1473
1502
|
...(reason === 'context-budget' ? { automatic: true as const } : {}),
|
|
1474
1503
|
coveredEventIds: coveredEvents.map((event) => event.id),
|
|
1475
|
-
replacementEvents: modelMessagesToAgentEvents(replacementMessages),
|
|
1504
|
+
replacementEvents: [...modelMessagesToAgentEvents(replacementMessages), ...carriedPinnedContexts],
|
|
1476
1505
|
archivedTransactions: archivedTransactions.length > 0
|
|
1477
1506
|
? archivedTransactions
|
|
1478
1507
|
: undefined,
|
|
@@ -1482,6 +1511,27 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
1482
1511
|
return compaction;
|
|
1483
1512
|
}
|
|
1484
1513
|
|
|
1514
|
+
/**
|
|
1515
|
+
* Appends a generation's pinned context message unless the model-visible context after the
|
|
1516
|
+
* latest compaction already shows that revision as the id's latest.
|
|
1517
|
+
*/
|
|
1518
|
+
private async appendPinnedContext(
|
|
1519
|
+
pinnedContext: IAgentGenerationLease['pinnedContext'],
|
|
1520
|
+
generationId: string,
|
|
1521
|
+
): Promise<void> {
|
|
1522
|
+
if (pinnedContext === undefined) return;
|
|
1523
|
+
assertAgentPinnedContext(pinnedContext, 'The generation lease\'s pinnedContext');
|
|
1524
|
+
const visible = latestPinnedContextMessages(this.modelVisibleEvents(this.events)).get(pinnedContext.id);
|
|
1525
|
+
if (visible?.pinnedContext?.revision === pinnedContext.revision) return;
|
|
1526
|
+
if (this.persistenceError !== undefined) throw this.persistenceError;
|
|
1527
|
+
this.commitEvent(createAgentEvent<IUserMessageEvent>({
|
|
1528
|
+
...createPinnedContextMessageFields(pinnedContext),
|
|
1529
|
+
generationId,
|
|
1530
|
+
parentIds: this.events.length > 0 ? [this.events[this.events.length - 1].id] : undefined,
|
|
1531
|
+
}));
|
|
1532
|
+
await this.flushPersistence();
|
|
1533
|
+
}
|
|
1534
|
+
|
|
1485
1535
|
private queueExclusive<TValue>(operation: () => Promise<TValue>): Promise<TValue> {
|
|
1486
1536
|
const run = this.generationQueue.then(() => {
|
|
1487
1537
|
if (this.closed) throw new Error('AgentSession is closed.');
|
|
@@ -2217,6 +2267,8 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
2217
2267
|
cacheDispatch = dispatch;
|
|
2218
2268
|
try { options.onCacheDispatch?.(dispatch); } catch (error) { this.reportListenerError(error); }
|
|
2219
2269
|
});
|
|
2270
|
+
await this.appendPinnedContext(lease?.pinnedContext, generationId);
|
|
2271
|
+
combinedAbort.signal.throwIfAborted();
|
|
2220
2272
|
if (options.activateOnBackgroundJobs && this.options.executionContext?.jobs) {
|
|
2221
2273
|
if (!this.options.executionContext.jobs.subscribe) {
|
|
2222
2274
|
throw new Error('Background job activation requires jobs.subscribe.');
|
|
@@ -3088,12 +3140,19 @@ export class AgentSessionEngine implements IAgentContinuationSession {
|
|
|
3088
3140
|
combinedAbort.signal.throwIfAborted();
|
|
3089
3141
|
contextOverflowRetries++;
|
|
3090
3142
|
// No tools: the summary of an overflowing context needs the room they take.
|
|
3091
|
-
await this.performCompaction(
|
|
3143
|
+
const compaction = await this.performCompaction(
|
|
3092
3144
|
'context-overflow',
|
|
3093
3145
|
reportCompactionUsage,
|
|
3094
3146
|
combinedAbort.signal,
|
|
3095
3147
|
{ system: runtime.system, providerOptions: runtime.providerOptions },
|
|
3096
3148
|
);
|
|
3149
|
+
// Compaction never covers the open generation, and unresolved tool intents block it.
|
|
3150
|
+
// When it compacted nothing, the same context would overflow again.
|
|
3151
|
+
if (!compaction) {
|
|
3152
|
+
throw new ContextOverflowError(
|
|
3153
|
+
'Agent context overflow: no settled history outside the current generation could be compacted',
|
|
3154
|
+
);
|
|
3155
|
+
}
|
|
3097
3156
|
continue;
|
|
3098
3157
|
}
|
|
3099
3158
|
throw effectiveError;
|
package/ts_agent/index.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export { runAgent } from './smartagent.classes.agent.js';
|
|
2
2
|
export { AgentSession } from './smartagent.classes.session.js';
|
|
3
3
|
export { buildModelMessages } from './smartagent.context.js';
|
|
4
|
+
export { pinnedContextMessageContent } from './smartagent.pinnedcontext.js';
|
|
4
5
|
export {
|
|
5
6
|
filterModelVisibleAgentEvents,
|
|
6
7
|
getAgentGenerationTransactions,
|
|
@@ -94,6 +95,8 @@ export type {
|
|
|
94
95
|
TAgentPrompt,
|
|
95
96
|
TAgentContextBuilder,
|
|
96
97
|
TAgentContextCompactor,
|
|
98
|
+
TAgentContextEventFilter,
|
|
99
|
+
IAgentPinnedContext,
|
|
97
100
|
TAgentGenerationPrepare,
|
|
98
101
|
TAgentModelCallUnreportedReason,
|
|
99
102
|
TAgentModelCallUsage,
|
|
@@ -114,6 +117,7 @@ export type {
|
|
|
114
117
|
} from './smartagent.persistence.js';
|
|
115
118
|
export type {
|
|
116
119
|
IAgentEventBase,
|
|
120
|
+
IAgentPinnedContextMark,
|
|
117
121
|
IAgentRuntimeEventPayload,
|
|
118
122
|
IArchivedAgentGenerationTransaction,
|
|
119
123
|
IAssistantMessageEvent,
|
package/ts_agent/readme.md
CHANGED
|
@@ -290,6 +290,8 @@ changes. The managing harness owns validation that an unanswered turn exists.
|
|
|
290
290
|
`IAgentSession.beginGeneration(content: TAgentPrompt, options?)` keeps its existing
|
|
291
291
|
contract, so existing session implementers do not need to support missing input.
|
|
292
292
|
|
|
293
|
+
`beginGeneration(content, { generationId, ephemeral: true })` begins an ephemeral generation: its own model calls see it, but once it has an outcome none of its events, prompt and answer included, reaches a later model request, whatever the outcome. Its events, outcome and usage stay recorded, its outcome carries no `contextUsage`, and `isGenerationInModelContext()` reports `false` for it once settled. A later request continues the context that preceded it, so it shares the prefix the ephemeral generation's calls sent before its prompt: a prompt-cache warm turn is one.
|
|
294
|
+
|
|
293
295
|
Closing a session or restoring a stored session interrupts unfinished transactions. Restoration does not automatically rerun them. Persisted transactions require an event store; without one, transactions are process-local.
|
|
294
296
|
|
|
295
297
|
A rejected generation does not roll back external tool effects. The runtime records transactional tool-execution intents and results. If a crash leaves an intent without a known result, inspect `listUncertainToolExecutions()` and reconcile the external operation through `reconcileToolExecution()` before treating its outcome as known. This is not a general exactly-once guarantee for external services.
|
|
@@ -373,11 +375,13 @@ The steps of one generation read each URL once; a read that fails fails the step
|
|
|
373
375
|
|
|
374
376
|
### Bound model context and active events
|
|
375
377
|
|
|
376
|
-
- `contextBuilder({ events })` controls the model-message projection.
|
|
378
|
+
- `contextBuilder({ events })` controls the model-message projection. It receives the model-visible events in the order the model sees them (`filterModelVisibleAgentEvents()`).
|
|
379
|
+
- `contextEventFilter(events)` leaves out events the host keeps from the model, such as undone turns. It receives `filterModelVisibleAgentEvents()`'s result and applies to everything the session derives from it: the context it builds, what a compaction summarizes and which pinned context revision is visible.
|
|
380
|
+
- A generation lease's `pinnedContext: { id, revision, text }` keeps text in front of the model without placing it in the system prompt, so a new revision leaves the cached prefix as it was. When the model-visible context after the latest compaction does not show this revision as the id's latest, the generation appends a pinned context message (a user message with `pinnedContext: { id, revision }` and the content `pinnedContextMessageContent()` renders) before its first model call; the model sees it right before the generation's prompt, and every later model call of the generation extends the first request byte for byte. A compaction ends its replacement with the latest revision of each pinned context it covered, unless the events it leaves in place carry that id. The revision is read from the model-visible events alone: a generation that leaves the context takes its message along, and the next one appends it again. A new text needs a new revision, a non-negative safe integer compared for equality only.
|
|
377
381
|
- `contextCompactor(messages, events, { reason, abortSignal, reportUsage })` returns replacement model messages. Provide it to use `session.compact()` or automatic event retention. Report the usage of its model calls through `reportUsage`; see [What is counted](#what-is-counted).
|
|
378
382
|
- A compactor also enables proactive compaction with reason `context-budget` before a generation's first inference, once the context reaches its compaction point in tokens. The point's ceiling is 90% of the served context window of the generation's model: `contextWindow` on the generation lease that names the model, or on the session options for the session model. The default is the ceiling, or `contextCompactionDefaultTokens` when lower; `contextCompaction` chooses `{ tokens }` (clamped to the ceiling, unclamped without a window), `{ percent }` (an integer from 1 through 90 of the window; none without one) or `false`. A lease's `contextCompaction` takes precedence over the session's. `resolveAgentContextCompactionPoint()` states the point. The context counts the input tokens of the latest transactional generation outcome's `contextUsage` while the events that call saw still build the same model messages and no compaction followed, plus an estimate of 4 UTF-8 JSON bytes per token for what came after; otherwise the whole context is estimated. Only settled history is covered, never the current unsettled generation. Budget compactions carry `automatic: true`; after transactional finalization their covered events are archived when the store supports it and no open transaction or uncertain tool intent remains. Manual compaction is not automatically archived.
|
|
379
383
|
- `eventRetention: { maxEvents }` triggers compaction and archival when the active event count exceeds the threshold. It also requires an event store with `archive()` support.
|
|
380
|
-
- Context overflow invokes the configured compactor, or the `onContextOverflow(messages, { abortSignal, reportUsage })` handler. Without either, generation throws `ContextOverflowError`. `maxContextOverflowRetries` defaults to `3`.
|
|
384
|
+
- Context overflow invokes the configured compactor, or the `onContextOverflow(messages, { abortSignal, reportUsage })` handler. Without either, generation throws `ContextOverflowError`. It throws it as well, without calling the model again, when the overflow compaction finds nothing to compact: compaction never covers the current generation, and uncertain tool intents block it. `maxContextOverflowRetries` defaults to `3`.
|
|
381
385
|
- Open transactions and uncertain tool intents constrain when compaction and archival can proceed. Resolve them before manual compaction.
|
|
382
386
|
|
|
383
387
|
Compaction changes the active model context; archival moves covered events out of the active event set. Implement archive retention in your chosen store when you need a complete audit history.
|
|
@@ -52,7 +52,8 @@ const orderEvents = (events: readonly TAgentEvent[]): TAgentEvent[] => {
|
|
|
52
52
|
return ordered;
|
|
53
53
|
};
|
|
54
54
|
|
|
55
|
-
|
|
55
|
+
/** The events after the latest compaction: its replacement, then the events it left in place. */
|
|
56
|
+
export const applyLatestCompaction = (events: readonly TAgentEvent[]): TAgentEvent[] => {
|
|
56
57
|
const latestCompaction = [...events].reverse().find(
|
|
57
58
|
(event) => event.type === 'context-compaction',
|
|
58
59
|
);
|
|
@@ -37,6 +37,18 @@ export interface IUserMessageEvent extends IAgentEventBase {
|
|
|
37
37
|
providerOptions?: TAgentUserMessage['providerOptions'];
|
|
38
38
|
/** Set when a running generation took the message in from its pending input. */
|
|
39
39
|
inputId?: string;
|
|
40
|
+
/**
|
|
41
|
+
* Set on a pinned context message: the revision of the pinned context its content states. See
|
|
42
|
+
* `IAgentGenerationLease.pinnedContext`.
|
|
43
|
+
*/
|
|
44
|
+
pinnedContext?: IAgentPinnedContextMark;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** Which pinned context, at which revision, a pinned context message states. */
|
|
48
|
+
export interface IAgentPinnedContextMark {
|
|
49
|
+
id: string;
|
|
50
|
+
/** Names the text: a new text has a new revision. Compared for equality only. */
|
|
51
|
+
revision: number;
|
|
40
52
|
}
|
|
41
53
|
|
|
42
54
|
export interface IAssistantMessageEvent extends IAgentEventBase {
|
|
@@ -91,6 +103,11 @@ export interface IGenerationBegunEvent extends IAgentEventBase {
|
|
|
91
103
|
type: 'generation-begun';
|
|
92
104
|
generationId: string;
|
|
93
105
|
claimTokenDigest: string;
|
|
106
|
+
/**
|
|
107
|
+
* An ephemeral generation is model-visible only to its own model calls: once it has an outcome,
|
|
108
|
+
* none of its events reaches a later model request. See `IAgentBeginGenerationOptions.ephemeral`.
|
|
109
|
+
*/
|
|
110
|
+
ephemeral?: true;
|
|
94
111
|
}
|
|
95
112
|
|
|
96
113
|
export interface IGenerationExecutionStartedEvent extends IAgentEventBase {
|
|
@@ -12,6 +12,7 @@ import type {
|
|
|
12
12
|
TSmartAiCacheSetting,
|
|
13
13
|
} from './plugins.js';
|
|
14
14
|
import type {
|
|
15
|
+
IAgentPinnedContextMark,
|
|
15
16
|
IAgentRuntimeEventPayload,
|
|
16
17
|
IToolExecutionIntentEvent,
|
|
17
18
|
TAgentEvent,
|
|
@@ -181,6 +182,12 @@ export type TAgentContextBuilder = (
|
|
|
181
182
|
options: IAgentContextBuildOptions,
|
|
182
183
|
) => ModelMessage[];
|
|
183
184
|
|
|
185
|
+
/**
|
|
186
|
+
* Leaves out of the model-visible events those the host keeps from the model, such as undone
|
|
187
|
+
* turns. It receives `filterModelVisibleAgentEvents()`'s result and must be pure.
|
|
188
|
+
*/
|
|
189
|
+
export type TAgentContextEventFilter = (events: readonly TAgentEvent[]) => TAgentEvent[];
|
|
190
|
+
|
|
184
191
|
export interface IAgentContextCompactionOptions {
|
|
185
192
|
abortSignal?: AbortSignal;
|
|
186
193
|
reason: 'context-overflow' | 'context-budget' | 'retention' | 'manual';
|
|
@@ -281,6 +288,12 @@ export interface IAgentSessionOptions {
|
|
|
281
288
|
executionContext?: IToolExecutionContext;
|
|
282
289
|
/** Projects canonical events into model messages. Default: buildModelMessages(). */
|
|
283
290
|
contextBuilder?: TAgentContextBuilder;
|
|
291
|
+
/**
|
|
292
|
+
* Leaves events the host keeps from the model out of everything the session derives from the
|
|
293
|
+
* model-visible events: the context it builds, what a compaction summarizes, and which pinned
|
|
294
|
+
* context revision is visible.
|
|
295
|
+
*/
|
|
296
|
+
contextEventFilter?: TAgentContextEventFilter;
|
|
284
297
|
/** Explicit context compactor used by manual and event-retention compaction. */
|
|
285
298
|
contextCompactor?: TAgentContextCompactor;
|
|
286
299
|
/**
|
|
@@ -389,6 +402,13 @@ export interface IAgentGenerationHandle {
|
|
|
389
402
|
export interface IAgentBeginGenerationOptions {
|
|
390
403
|
/** Stable caller-owned identity used to make begin retries deterministic. */
|
|
391
404
|
generationId?: string;
|
|
405
|
+
/**
|
|
406
|
+
* The generation is model-visible only to its own model calls: once it has an outcome, none of
|
|
407
|
+
* its events, prompt and answer included, reaches a later model request. Its events, outcome and
|
|
408
|
+
* usage stay recorded. A later request continues the context that preceded it, so it shares the
|
|
409
|
+
* prefix the generation's own calls sent before its prompt.
|
|
410
|
+
*/
|
|
411
|
+
ephemeral?: true;
|
|
392
412
|
}
|
|
393
413
|
|
|
394
414
|
export interface IAgentFinalizeGenerationOptions {
|
|
@@ -404,6 +424,11 @@ export interface IAgentGenerationPreparationContext {
|
|
|
404
424
|
abortSignal: AbortSignal;
|
|
405
425
|
}
|
|
406
426
|
|
|
427
|
+
/** A pinned context: see `IAgentGenerationLease.pinnedContext`. */
|
|
428
|
+
export interface IAgentPinnedContext extends IAgentPinnedContextMark {
|
|
429
|
+
text: string;
|
|
430
|
+
}
|
|
431
|
+
|
|
407
432
|
export interface IAgentGenerationLease {
|
|
408
433
|
model?: TSmartAiLanguageModel;
|
|
409
434
|
system?: string;
|
|
@@ -432,6 +457,17 @@ export interface IAgentGenerationLease {
|
|
|
432
457
|
contextCompactionDefaultTokens?: number;
|
|
433
458
|
/** The compaction setting of this generation; takes precedence over the session's. */
|
|
434
459
|
contextCompaction?: TAgentContextCompactionSetting;
|
|
460
|
+
/**
|
|
461
|
+
* Text the model sees in its current revision without it being part of the system prompt, so a
|
|
462
|
+
* new revision leaves the cached prefix (instructions, tools, history) as it was. When the
|
|
463
|
+
* model-visible context after the latest compaction does not end its appearances of this id
|
|
464
|
+
* with this revision, the generation appends a pinned context message before its first model
|
|
465
|
+
* call; in the context it stands right before the generation's prompt. A compaction ends its
|
|
466
|
+
* replacement with the latest revision of each pinned context it summarized, unless the events
|
|
467
|
+
* it leaves in place carry that id. Nothing else records it: a generation that leaves the context
|
|
468
|
+
* takes its pinned context message along, and the next one appends it again.
|
|
469
|
+
*/
|
|
470
|
+
pinnedContext?: IAgentPinnedContext;
|
|
435
471
|
/**
|
|
436
472
|
* Must be safe to call repeatedly and concurrently after failure or timeout.
|
|
437
473
|
* A timeout does not cancel the original close attempt, so a retry may overlap it.
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { TAgentEvent } from './smartagent.events.js';
|
|
2
|
+
import { assertAgentPinnedContextMark } from './smartagent.pinnedcontext.js';
|
|
2
3
|
|
|
3
4
|
const SNAPSHOT_SCHEMA_VERSION = 2 as const;
|
|
4
5
|
const ARCHIVE_SCHEMA_VERSION = 2 as const;
|
|
@@ -452,6 +453,9 @@ const assertAgentEvent: (
|
|
|
452
453
|
if (eventValue.type === 'user-message' && eventValue.inputId !== undefined) {
|
|
453
454
|
assertNonEmptyString(eventValue.inputId, `${eventPath}.inputId`);
|
|
454
455
|
}
|
|
456
|
+
if (eventValue.type === 'user-message' && eventValue.pinnedContext !== undefined) {
|
|
457
|
+
assertAgentPinnedContextMark(eventValue.pinnedContext, `${eventPath}.pinnedContext`);
|
|
458
|
+
}
|
|
455
459
|
break;
|
|
456
460
|
case 'tool-call':
|
|
457
461
|
assertNonEmptyString(eventValue.toolCallId, `${eventPath}.toolCallId`);
|
|
@@ -494,6 +498,9 @@ const assertAgentEvent: (
|
|
|
494
498
|
case 'generation-begun':
|
|
495
499
|
assertRequiredGenerationId(eventValue, eventPath);
|
|
496
500
|
assertNonEmptyString(eventValue.claimTokenDigest, `${eventPath}.claimTokenDigest`);
|
|
501
|
+
if (eventValue.ephemeral !== undefined && eventValue.ephemeral !== true) {
|
|
502
|
+
validationError(`${eventPath}.ephemeral`, 'must be true when present.');
|
|
503
|
+
}
|
|
497
504
|
break;
|
|
498
505
|
case 'generation-execution-started':
|
|
499
506
|
case 'generation-execution-completed':
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { applyLatestCompaction } from './smartagent.context.js';
|
|
2
|
+
import type { IAgentPinnedContextMark, IUserMessageEvent, TAgentEvent } from './smartagent.events.js';
|
|
3
|
+
import type { IAgentPinnedContext } from './smartagent.interfaces.js';
|
|
4
|
+
|
|
5
|
+
const isRecord = (value: unknown): value is Record<string, unknown> =>
|
|
6
|
+
value !== null && typeof value === 'object' && !Array.isArray(value);
|
|
7
|
+
|
|
8
|
+
/** Checks a pinned context mark: exactly a non-empty `id` and a non-negative safe integer `revision`. */
|
|
9
|
+
export function assertAgentPinnedContextMark(
|
|
10
|
+
value: unknown,
|
|
11
|
+
path: string,
|
|
12
|
+
): asserts value is IAgentPinnedContextMark {
|
|
13
|
+
if (!isRecord(value)) throw new Error(`${path} must be an object.`);
|
|
14
|
+
const unknownKey = Object.keys(value).find((key) => key !== 'id' && key !== 'revision');
|
|
15
|
+
if (unknownKey !== undefined) throw new Error(`${path}.${unknownKey} is not a pinned context field.`);
|
|
16
|
+
if (typeof value.id !== 'string' || !value.id.trim()) throw new Error(`${path}.id must be a non-empty string.`);
|
|
17
|
+
if (!Number.isSafeInteger(value.revision) || (value.revision as number) < 0) {
|
|
18
|
+
throw new Error(`${path}.revision must be a non-negative safe integer.`);
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** Checks a pinned context: a mark's `id` and `revision`, and its `text`. */
|
|
23
|
+
export function assertAgentPinnedContext(
|
|
24
|
+
value: unknown,
|
|
25
|
+
path = 'pinnedContext',
|
|
26
|
+
): asserts value is IAgentPinnedContext {
|
|
27
|
+
if (!isRecord(value)) throw new Error(`${path} must be an object.`);
|
|
28
|
+
const { text, ...mark } = value;
|
|
29
|
+
assertAgentPinnedContextMark(mark, path);
|
|
30
|
+
if (typeof text !== 'string') throw new Error(`${path}.text must be a string.`);
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** What the model reads for a pinned context: which one, at which revision, then its text. */
|
|
34
|
+
export function pinnedContextMessageContent(context: IAgentPinnedContext): string {
|
|
35
|
+
const id = JSON.stringify(context.id);
|
|
36
|
+
const header = `[Pinned context ${id}, revision ${context.revision}. This is its current text; `
|
|
37
|
+
+ `it replaces every earlier revision of ${id}.]`;
|
|
38
|
+
return context.text ? `${header}\n\n${context.text}` : header;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** A pinned context message: a user message with the pinned context's content and mark. */
|
|
42
|
+
export function createPinnedContextMessageFields(
|
|
43
|
+
context: IAgentPinnedContext,
|
|
44
|
+
): Pick<IUserMessageEvent, 'type' | 'content' | 'pinnedContext'> {
|
|
45
|
+
return {
|
|
46
|
+
type: 'user-message',
|
|
47
|
+
content: pinnedContextMessageContent(context),
|
|
48
|
+
pinnedContext: { id: context.id, revision: context.revision },
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* The latest pinned context message of each id among model-visible events, as the model sees them
|
|
54
|
+
* after the latest compaction: the compaction's replacement, then the events it left in place.
|
|
55
|
+
*/
|
|
56
|
+
export function latestPinnedContextMessages(
|
|
57
|
+
visibleEvents: readonly TAgentEvent[],
|
|
58
|
+
): Map<string, IUserMessageEvent> {
|
|
59
|
+
const latest = new Map<string, IUserMessageEvent>();
|
|
60
|
+
for (const event of applyLatestCompaction(visibleEvents)) {
|
|
61
|
+
if (event.type === 'user-message' && event.pinnedContext) latest.set(event.pinnedContext.id, event);
|
|
62
|
+
}
|
|
63
|
+
return latest;
|
|
64
|
+
}
|