@modelprofile.com/flexharness-agent 16.2.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.
@@ -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
- /** Accepted and active generations, and terminal generations with actual model/tool output. */
106
- const isModelVisibleTransaction = (transaction, producedOutput) => transaction.state === 'accepted'
107
- || transaction.state === 'execution-started'
108
- || ((transaction.state === 'interrupted' || transaction.state === 'rejected')
109
- && transaction.executionStarted !== undefined
110
- && producedOutput.has(transaction.generationId));
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
- visibleEvents.push(event);
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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC50cmFuc2FjdGlvbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19hZ2VudC9zbWFydGFnZW50LnRyYW5zYWN0aW9ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUE0QkEsTUFBTSxjQUFjLEdBQUcsQ0FBQyxLQUFrQixFQUErQixFQUFFLENBQ3pFLEtBQUssQ0FBQyxJQUFJLEtBQUssa0JBQWtCO09BQzlCLEtBQUssQ0FBQyxJQUFJLEtBQUssOEJBQThCO09BQzdDLEtBQUssQ0FBQyxJQUFJLEtBQUssZ0NBQWdDO09BQy9DLEtBQUssQ0FBQyxJQUFJLEtBQUssb0JBQW9CO09BQ25DLEtBQUssQ0FBQyxJQUFJLEtBQUssdUJBQXVCO09BQ3RDLEtBQUssQ0FBQyxJQUFJLEtBQUssK0JBQStCLENBQUM7QUFFcEQsTUFBTSxDQUFDLE1BQU0sOEJBQThCLEdBQUcsQ0FDNUMsTUFBOEIsRUFDWSxFQUFFO0lBZTVDLE1BQU0sV0FBVyxHQUFHLElBQUksR0FBRyxFQUFtQyxDQUFDO0lBQy9ELE1BQU0sUUFBUSxHQUFHLENBQUMsWUFBb0IsRUFBMkIsRUFBRTtRQUNqRSxJQUFJLEtBQUssR0FBRyxXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBQzFDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNYLEtBQUssR0FBRztnQkFDTixVQUFVLEVBQUUsQ0FBQztnQkFDYixVQUFVLEVBQUUsQ0FBQyxDQUFDO2dCQUNkLFlBQVksRUFBRSxDQUFDO2dCQUNmLFlBQVksRUFBRSxDQUFDLENBQUM7Z0JBQ2hCLGNBQWMsRUFBRSxDQUFDO2dCQUNqQixjQUFjLEVBQUUsQ0FBQyxDQUFDO2dCQUNsQixZQUFZLEVBQUUsQ0FBQztnQkFDZixZQUFZLEVBQUUsQ0FBQyxDQUFDO2FBQ2pCLENBQUM7WUFDRixXQUFXLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxLQUFLLENBQUMsQ0FBQztRQUN2QyxDQUFDO1FBQ0QsT0FBTyxLQUFLLENBQUM7SUFDZixDQUFDLENBQUM7SUFDRixLQUFLLE1BQU0sQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUM7UUFDOUMsSUFBSSxLQUFLLENBQUMsSUFBSSxLQUFLLGtCQUFrQixFQUFFLENBQUM7WUFDdEMsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxZQUFZLENBQUMsQ0FBQztZQUMzQyxLQUFLLENBQUMsS0FBSyxLQUFLLEtBQUssQ0FBQztZQUN0QixLQUFLLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDbkIsSUFBSSxLQUFLLENBQUMsVUFBVSxHQUFHLENBQUM7Z0JBQUUsS0FBSyxDQUFDLFVBQVUsR0FBRyxLQUFLLENBQUM7UUFDckQsQ0FBQzthQUFNLElBQUksS0FBSyxDQUFDLElBQUksS0FBSyw4QkFBOEIsRUFBRSxDQUFDO1lBQ3pELE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxLQUFLLENBQUMsWUFBWSxDQUFDLENBQUM7WUFDM0MsS0FBSyxDQUFDLE9BQU8sS0FBSyxLQUFLLENBQUM7WUFDeEIsS0FBSyxDQUFDLFlBQVksRUFBRSxDQUFDO1lBQ3JCLElBQUksS0FBSyxDQUFDLFlBQVksR0FBRyxDQUFDO2dCQUFFLEtBQUssQ0FBQyxZQUFZLEdBQUcsS0FBSyxDQUFDO1FBQ3pELENBQUM7YUFBTSxJQUFJLEtBQUssQ0FBQyxJQUFJLEtBQUssZ0NBQWdDLEVBQUUsQ0FBQztZQUMzRCxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsS0FBSyxDQUFDLFlBQVksQ0FBQyxDQUFDO1lBQzNDLEtBQUssQ0FBQyxTQUFTLEtBQUssS0FBSyxDQUFDO1lBQzFCLEtBQUssQ0FBQyxjQUFjLEVBQUUsQ0FBQztZQUN2QixJQUFJLEtBQUssQ0FBQyxjQUFjLEdBQUcsQ0FBQztnQkFBRSxLQUFLLENBQUMsY0FBYyxHQUFHLEtBQUssQ0FBQztRQUM3RCxDQUFDO2FBQU0sSUFBSSxLQUFLLENBQUMsSUFBSSxLQUFLLG9CQUFvQixFQUFFLENBQUM7WUFDL0MsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxZQUFZLENBQUMsQ0FBQztZQUMzQyxLQUFLLENBQUMsT0FBTyxLQUFLLEtBQUssQ0FBQztZQUN4QixLQUFLLENBQUMsWUFBWSxFQUFFLENBQUM7WUFDckIsSUFBSSxLQUFLLENBQUMsWUFBWSxHQUFHLENBQUM7Z0JBQUUsS0FBSyxDQUFDLFlBQVksR0FBRyxLQUFLLENBQUM7UUFDekQsQ0FBQztJQUNILENBQUM7SUFDRCxNQUFNLFlBQVksR0FBRyxJQUFJLEdBQUcsRUFBdUMsQ0FBQztJQUNwRSxLQUFLLE1BQU0sQ0FBQyxZQUFZLEVBQUUsS0FBSyxDQUFDLElBQUksV0FBVyxFQUFFLENBQUM7UUFDaEQsSUFBSSxDQUFDLEtBQUssQ0FBQyxLQUFLO1lBQUUsU0FBUztRQUMzQixJQUFJLEtBQXVDLENBQUM7UUFDNUMsSUFDRSxLQUFLLENBQUMsVUFBVSxLQUFLLENBQUM7ZUFDbkIsS0FBSyxDQUFDLFlBQVksR0FBRyxDQUFDO2VBQ3RCLEtBQUssQ0FBQyxjQUFjLEdBQUcsQ0FBQztlQUN4QixLQUFLLENBQUMsWUFBWSxHQUFHLENBQUM7ZUFDdEIsQ0FBQyxLQUFLLENBQUMsWUFBWSxJQUFJLENBQUMsSUFBSSxLQUFLLENBQUMsWUFBWSxHQUFHLEtBQUssQ0FBQyxVQUFVLENBQUM7ZUFDbEUsQ0FBQyxLQUFLLENBQUMsWUFBWSxLQUFLLENBQUMsSUFBSSxLQUFLLENBQUMsY0FBYyxHQUFHLENBQUMsQ0FBQztlQUN0RCxDQUFDLEtBQUssQ0FBQyxjQUFjLElBQUksQ0FBQyxJQUFJLEtBQUssQ0FBQyxjQUFjLEdBQUcsS0FBSyxDQUFDLFlBQVksQ0FBQztlQUN4RSxDQUFDLEtBQUssQ0FBQyxZQUFZLElBQUksQ0FBQyxJQUFJLEtBQUssQ0FBQyxZQUFZLEdBQUcsS0FBSyxDQUFDLFVBQVUsQ0FBQztlQUNsRSxDQUFDLEtBQUssQ0FBQyxZQUFZLElBQUksQ0FBQyxJQUFJLEtBQUssQ0FBQyxZQUFZLEdBQUcsS0FBSyxDQUFDLFlBQVksQ0FBQztlQUNwRSxDQUFDLEtBQUssQ0FBQyxZQUFZLElBQUksQ0FBQyxJQUFJLEtBQUssQ0FBQyxjQUFjLEdBQUcsS0FBSyxDQUFDLFlBQVksQ0FBQztlQUN0RSxDQUNELENBQUMsS0FBSyxDQUFDLE9BQU8sRUFBRSxPQUFPLEtBQUssVUFBVSxJQUFJLEtBQUssQ0FBQyxPQUFPLEVBQUUsT0FBTyxLQUFLLFVBQVUsQ0FBQzttQkFDN0UsS0FBSyxDQUFDLGNBQWMsS0FBSyxDQUFDLENBQzlCLEVBQ0QsQ0FBQztZQUNELEtBQUssR0FBRyxTQUFTLENBQUM7UUFDcEIsQ0FBQzthQUFNLElBQUksS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ3pCLEtBQUssR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQztRQUNoQyxDQUFDO2FBQU0sSUFBSSxLQUFLLENBQUMsU0FBUyxFQUFFLENBQUM7WUFDM0IsS0FBSyxHQUFHLHFCQUFxQixDQUFDO1FBQ2hDLENBQUM7YUFBTSxJQUFJLEtBQUssQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUN6QixLQUFLLEdBQUcsbUJBQW1CLENBQUM7UUFDOUIsQ0FBQzthQUFNLENBQUM7WUFDTixLQUFLLEdBQUcsT0FBTyxDQUFDO1FBQ2xCLENBQUM7UUFDRCxZQUFZLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRTtZQUM3QixZQUFZO1lBQ1osS0FBSztZQUNMLEtBQUssRUFBRSxLQUFLLENBQUMsS0FBSztZQUNsQixnQkFBZ0IsRUFBRSxLQUFLLENBQUMsT0FBTztZQUMvQixrQkFBa0IsRUFBRSxLQUFLLENBQUMsU0FBUztZQUNuQyxPQUFPLEVBQUUsS0FBSyxDQUFDLE9BQU87U0FDdkIsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztJQUNELE9BQU8sWUFBWSxDQUFDO0FBQ3RCLENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLENBQ3ZDLE1BQThCLEVBQzlCLFlBQW9CLEVBQ1gsRUFBRSxDQUFDLDhCQUE4QixDQUFDLE1BQU0sQ0FBQyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsQ0FBQztBQUV2RSw2RkFBNkY7QUFDN0YsTUFBTSxDQUFDLE1BQU0sNEJBQTRCLEdBQ3ZDLHNGQUFzRixDQUFDO0FBRXpGLE1BQU0sa0JBQWtCLEdBQUcsQ0FBQyxLQUFrQixFQUFXLEVBQUUsQ0FDekQsS0FBSyxDQUFDLElBQUksS0FBSyxtQkFBbUI7T0FDL0IsS0FBSyxDQUFDLElBQUksS0FBSyxXQUFXO09BQzFCLEtBQUssQ0FBQyxJQUFJLEtBQUssYUFBYTtPQUM1QixLQUFLLENBQUMsSUFBSSxLQUFLLGVBQWUsQ0FBQztBQUVwQywrRkFBK0Y7QUFDL0YsTUFBTSx5QkFBeUIsR0FBRyxDQUNoQyxXQUF3QyxFQUN4QyxjQUFtQyxFQUMxQixFQUFFLENBQ1gsV0FBVyxDQUFDLEtBQUssS0FBSyxVQUFVO09BQzdCLFdBQVcsQ0FBQyxLQUFLLEtBQUssbUJBQW1CO09BQ3pDLENBQ0QsQ0FBQyxXQUFXLENBQUMsS0FBSyxLQUFLLGFBQWEsSUFBSSxXQUFXLENBQUMsS0FBSyxLQUFLLFVBQVUsQ0FBQztXQUN0RSxXQUFXLENBQUMsZ0JBQWdCLEtBQUssU0FBUztXQUMxQyxjQUFjLENBQUMsR0FBRyxDQUFDLFdBQVcsQ0FBQyxZQUFZLENBQUMsQ0FDaEQsQ0FBQztBQUVKLCtEQUErRDtBQUMvRCxNQUFNLDBCQUEwQixHQUFHLENBQUMsTUFBOEIsRUFBZSxFQUFFO0lBQ2pGLE1BQU0sY0FBYyxHQUFHLElBQUksR0FBRyxFQUFVLENBQUM7SUFDekMsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztRQUMzQixJQUFJLEtBQUssQ0FBQyxZQUFZLElBQUksa0JBQWtCLENBQUMsS0FBSyxDQUFDO1lBQUUsY0FBYyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDOUYsQ0FBQztJQUNELE9BQU8sY0FBYyxDQUFDO0FBQ3hCLENBQUMsQ0FBQztBQUVGLGtHQUFrRztBQUNsRyxNQUFNLENBQUMsTUFBTSwwQkFBMEIsR0FBRyxDQUN4QyxNQUE4QixFQUM5QixZQUFvQixFQUNYLEVBQUU7SUFDWCxNQUFNLFdBQVcsR0FBRyw4QkFBOEIsQ0FBQyxNQUFNLENBQUMsQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDN0UsT0FBTyxXQUFXLEtBQUssU0FBUztXQUMzQix5QkFBeUIsQ0FBQyxXQUFXLEVBQUUsMEJBQTBCLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQztBQUNsRixDQUFDLENBQUM7QUFFRixNQUFNLHFCQUFxQixHQUFHLENBQzVCLFVBQWtCLEVBQ2xCLFFBQWdCLEVBQ2hCLE1BQW1CLEVBQ0QsRUFBRSxDQUFDLENBQUM7SUFDdEIsRUFBRSxFQUFFLEdBQUcsTUFBTSxDQUFDLEVBQUUsZ0JBQWdCLFVBQVUsRUFBRTtJQUM1QyxTQUFTLEVBQUUsTUFBTSxDQUFDLFNBQVM7SUFDM0IsSUFBSSxFQUFFLGFBQWE7SUFDbkIsVUFBVTtJQUNWLFFBQVE7SUFDUixLQUFLLEVBQUUsNEJBQTRCO0lBQ25DLFdBQVcsRUFBRSxFQUFFLElBQUksRUFBRSxZQUFZLEVBQUUsS0FBSyxFQUFFLDRCQUE0QixFQUFFO0lBQ3hFLFlBQVksRUFBRSxNQUFNLENBQUMsWUFBWTtJQUNqQyxXQUFXLEVBQUUsTUFBTSxDQUFDLFdBQVc7SUFDL0IsV0FBVyxFQUFFLE1BQU0sQ0FBQyxXQUFXO0lBQy9CLFNBQVMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7Q0FDdkIsQ0FBQyxDQUFDO0FBRUgsTUFBTSxDQUFDLE1BQU0sNkJBQTZCLEdBQUcsQ0FDM0MsTUFBOEIsRUFDZixFQUFFO0lBQ2pCLE1BQU0sWUFBWSxHQUFHLDhCQUE4QixDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzVELE1BQU0sY0FBYyxHQUFHLDBCQUEwQixDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzFELE1BQU0saUJBQWlCLEdBQUcsSUFBSSxHQUFHLEVBQVUsQ0FBQztJQUM1QyxLQUFLLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzNCLElBQUksQ0FBQyxLQUFLLENBQUMsWUFBWTtZQUFFLFNBQVM7UUFDbEMsSUFBSSxLQUFLLENBQUMsSUFBSSxLQUFLLGFBQWE7WUFBRSxpQkFBaUIsQ0FBQyxHQUFHLENBQUMsR0FBRyxLQUFLLENBQUMsWUFBWSxLQUFLLEtBQUssQ0FBQyxVQUFVLEVBQUUsQ0FBQyxDQUFDO1FBQ3RHLElBQUksS0FBSyxDQUFDLElBQUksS0FBSyxtQkFBbUIsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO1lBQ3ZFLEtBQUssTUFBTSxJQUFJLElBQUksS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO2dCQUNqQyxJQUFJLElBQUksQ0FBQyxJQUFJLEtBQUssYUFBYSxFQUFFLENBQUM7b0JBQ2hDLGlCQUFpQixDQUFDLEdBQUcsQ0FBQyxHQUFHLEtBQUssQ0FBQyxZQUFZLEtBQUssSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDLENBQUM7Z0JBQ3JFLENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7SUFDRCxNQUFNLGFBQWEsR0FBa0IsRUFBRSxDQUFDO0lBQ3hDLHdGQUF3RjtJQUN4RixNQUFNLGlCQUFpQixHQUFHLENBQUMsVUFBa0IsRUFBRSxRQUFnQixFQUFFLE1BQW1CLEVBQVEsRUFBRTtRQUM1RixNQUFNLEdBQUcsR0FBRyxHQUFHLE1BQU0sQ0FBQyxZQUFZLEtBQUssVUFBVSxFQUFFLENBQUM7UUFDcEQsSUFBSSxpQkFBaUIsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDO1lBQUUsT0FBTztRQUN2QyxpQkFBaUIsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDM0IsYUFBYSxDQUFDLElBQUksQ0FBQyxxQkFBcUIsQ0FBQyxVQUFVLEVBQUUsUUFBUSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUM7SUFDMUUsQ0FBQyxDQUFDO0lBQ0YsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztRQUMzQixJQUFJLGNBQWMsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQzFCLElBQUksS0FBSyxDQUFDLElBQUksS0FBSyxvQkFBb0IsSUFBSSxLQUFLLENBQUMsT0FBTyxLQUFLLFVBQVUsRUFBRSxDQUFDO2dCQUN4RSxNQUFNLFdBQVcsR0FBRyxZQUFZLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxZQUFZLENBQUMsQ0FBQztnQkFDekQsSUFBSSxXQUFXLElBQUkseUJBQXlCLENBQUMsV0FBVyxFQUFFLGNBQWMsQ0FBQyxFQUFFLENBQUM7b0JBQzFFLGFBQWEsQ0FBQyxJQUFJLENBQUM7d0JBQ2pCLEVBQUUsRUFBRSxHQUFHLEtBQUssQ0FBQyxFQUFFLGdCQUFnQjt3QkFDL0IsU0FBUyxFQUFFLEtBQUssQ0FBQyxTQUFTO3dCQUMxQixZQUFZLEVBQUUsS0FBSyxDQUFDLFlBQVk7d0JBQ2hDLElBQUksRUFBRSxjQUFjO3dCQUNwQixPQUFPLEVBQUUsS0FBSyxDQUFDLE9BQU8sS0FBSyxVQUFVOzRCQUNuQyxDQUFDLENBQUMsc0tBQXNLOzRCQUN4SyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU87Z0NBQ2IsQ0FBQyxDQUFDLHFIQUFxSDtnQ0FDdkgsQ0FBQyxDQUFDLDRJQUE0STtxQkFDbkosQ0FBQyxDQUFDO2dCQUNMLENBQUM7WUFDSCxDQUFDO1lBQ0QsU0FBUztRQUNYLENBQUM7UUFDRCxJQUFJLEtBQUssQ0FBQyxJQUFJLEtBQUssb0JBQW9CLElBQUksS0FBSyxDQUFDLG9CQUFvQixFQUFFLENBQUM7WUFDdEUsYUFBYSxDQUFDLElBQUksQ0FBQyxFQUFFLEdBQUcsS0FBSyxFQUFFLG9CQUFvQixFQUFFLFNBQVMsRUFBRSxDQUFDLENBQUM7WUFDbEUsU0FBUztRQUNYLENBQUM7UUFDRCxJQUFJLENBQUMsS0FBSyxDQUFDLFlBQVksRUFBRSxDQUFDO1lBQ3hCLGFBQWEsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDMUIsU0FBUztRQUNYLENBQUM7UUFDRCxNQUFNLFdBQVcsR0FBRyxZQUFZLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxZQUFZLENBQUMsQ0FBQztRQUN6RCxJQUFJLFdBQVcsSUFBSSxDQUFDLHlCQUF5QixDQUFDLFdBQVcsRUFBRSxjQUFjLENBQUM7WUFBRSxTQUFTO1FBQ3JGLGFBQWEsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDMUIsSUFBSSxXQUFXLEVBQUUsS0FBSyxLQUFLLGFBQWEsSUFBSSxXQUFXLEVBQUUsS0FBSyxLQUFLLFVBQVU7WUFBRSxTQUFTO1FBQ3hGLElBQUksS0FBSyxDQUFDLElBQUksS0FBSyxXQUFXLElBQUksS0FBSyxDQUFDLGdCQUFnQixLQUFLLElBQUksRUFBRSxDQUFDO1lBQ2xFLGlCQUFpQixDQUFDLEtBQUssQ0FBQyxVQUFVLEVBQUUsS0FBSyxDQUFDLFFBQVEsRUFBRSxLQUFLLENBQUMsQ0FBQztRQUM3RCxDQUFDO2FBQU0sSUFBSSxLQUFLLENBQUMsSUFBSSxLQUFLLG1CQUFtQixJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDOUUsS0FBSyxNQUFNLElBQUksSUFBSSxLQUFLLENBQUMsT0FBTyxFQUFFLENBQUM7Z0JBQ2pDLElBQUksSUFBSSxDQUFDLElBQUksS0FBSyxXQUFXLElBQUksSUFBSSxDQUFDLGdCQUFnQixLQUFLLElBQUksRUFBRSxDQUFDO29CQUNoRSxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLElBQUksQ0FBQyxRQUFRLEVBQUUsS0FBSyxDQUFDLENBQUM7Z0JBQzNELENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7SUFDRCxPQUFPLGFBQWEsQ0FBQztBQUN2QixDQUFDLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSxrQ0FBa0MsR0FBRyxDQUNoRCxNQUE4QixFQUNDLEVBQUUsQ0FBQyxDQUFDLEdBQUcsOEJBQThCLENBQUMsTUFBTSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7S0FDckYsTUFBTSxDQUFDLENBQUMsV0FBVyxFQUFFLEVBQUUsQ0FDdEIsV0FBVyxDQUFDLEtBQUssS0FBSyxVQUFVO09BQzdCLFdBQVcsQ0FBQyxLQUFLLEtBQUssVUFBVTtPQUNoQyxXQUFXLENBQUMsS0FBSyxLQUFLLGFBQWEsQ0FBQyxDQUFDO0FBRTVDLE1BQU0sQ0FBQyxNQUFNLGdDQUFnQyxHQUFHLENBQzlDLE1BQThCLEVBQzlCLFlBQXFCLEVBQ1EsRUFBRTtJQUMvQixNQUFNLFNBQVMsR0FBRyxJQUFJLEdBQUcsRUFBcUMsQ0FBQztJQUMvRCxLQUFLLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzNCLElBQ0UsS0FBSyxDQUFDLElBQUksS0FBSyx1QkFBdUI7ZUFDbkMsQ0FBQyxZQUFZLEtBQUssU0FBUyxJQUFJLEtBQUssQ0FBQyxZQUFZLEtBQUssWUFBWSxDQUFDLEVBQ3RFLENBQUM7WUFDRCxTQUFTLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxFQUFFLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDakMsQ0FBQzthQUFNLElBQUksS0FBSyxDQUFDLElBQUksS0FBSyxhQUFhLElBQUksS0FBSyxDQUFDLGlCQUFpQixFQUFFLENBQUM7WUFDbkUsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsaUJBQWlCLENBQUMsQ0FBQztZQUN0RCxJQUFJLE1BQU0sRUFBRSxZQUFZLEtBQUssS0FBSyxDQUFDLFlBQVksRUFBRSxDQUFDO2dCQUNoRCxTQUFTLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxpQkFBaUIsQ0FBQyxDQUFDO1lBQzVDLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sQ0FBQyxHQUFHLFNBQVMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO0FBQ2pDLENBQUMsQ0FBQyJ9
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.2.0",
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.2.0",
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
- const contextUsage = this.generationContextUsage.get(generationId);
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
- private buildContext(events: readonly TAgentEvent[]): plugins.ModelMessage[] {
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 = filterModelVisibleAgentEvents(coveredEvents);
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,
@@ -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
- const applyLatestCompaction = (events: readonly TAgentEvent[]): TAgentEvent[] => {
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
+ }