agentfootprint 9.92.1 → 9.93.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/CHANGELOG.md +113 -0
- package/dist/core/Agent.js +15 -0
- package/dist/core/Agent.js.map +1 -1
- package/dist/core/LLMCall.js +6 -4
- package/dist/core/LLMCall.js.map +1 -1
- package/dist/core/agent/messageApiReceipt.js +1 -0
- package/dist/core/agent/messageApiReceipt.js.map +1 -1
- package/dist/core/agent/stages/callLLM.js +18 -7
- package/dist/core/agent/stages/callLLM.js.map +1 -1
- package/dist/core/agent/stages/window.js +12 -2
- package/dist/core/agent/stages/window.js.map +1 -1
- package/dist/core/agent/window/evictedTurns.js +60 -0
- package/dist/core/agent/window/evictedTurns.js.map +1 -0
- package/dist/esm/core/Agent.d.ts +4 -0
- package/dist/esm/core/Agent.js +15 -0
- package/dist/esm/core/Agent.js.map +1 -1
- package/dist/esm/core/LLMCall.js +6 -4
- package/dist/esm/core/LLMCall.js.map +1 -1
- package/dist/esm/core/agent/messageApiReceipt.d.ts +3 -1
- package/dist/esm/core/agent/messageApiReceipt.js +1 -0
- package/dist/esm/core/agent/messageApiReceipt.js.map +1 -1
- package/dist/esm/core/agent/stages/callLLM.d.ts +9 -0
- package/dist/esm/core/agent/stages/callLLM.js +18 -7
- package/dist/esm/core/agent/stages/callLLM.js.map +1 -1
- package/dist/esm/core/agent/stages/window.d.ts +8 -0
- package/dist/esm/core/agent/stages/window.js +12 -2
- package/dist/esm/core/agent/stages/window.js.map +1 -1
- package/dist/esm/core/agent/window/evictedTurns.d.ts +52 -0
- package/dist/esm/core/agent/window/evictedTurns.js +56 -0
- package/dist/esm/core/agent/window/evictedTurns.js.map +1 -0
- package/dist/esm/lib/time-travel/receipt.d.ts +71 -28
- package/dist/esm/lib/time-travel/receipt.js +33 -17
- package/dist/esm/lib/time-travel/receipt.js.map +1 -1
- package/dist/esm/lib/time-travel/servedView.d.ts +31 -22
- package/dist/esm/lib/time-travel/servedView.js +78 -43
- package/dist/esm/lib/time-travel/servedView.js.map +1 -1
- package/dist/lib/time-travel/receipt.js +33 -17
- package/dist/lib/time-travel/receipt.js.map +1 -1
- package/dist/lib/time-travel/servedView.js +78 -43
- package/dist/lib/time-travel/servedView.js.map +1 -1
- package/dist/types/core/Agent.d.ts +4 -0
- package/dist/types/core/Agent.d.ts.map +1 -1
- package/dist/types/core/LLMCall.d.ts.map +1 -1
- package/dist/types/core/agent/messageApiReceipt.d.ts +3 -1
- package/dist/types/core/agent/messageApiReceipt.d.ts.map +1 -1
- package/dist/types/core/agent/stages/callLLM.d.ts +9 -0
- package/dist/types/core/agent/stages/callLLM.d.ts.map +1 -1
- package/dist/types/core/agent/stages/window.d.ts +8 -0
- package/dist/types/core/agent/stages/window.d.ts.map +1 -1
- package/dist/types/core/agent/window/evictedTurns.d.ts +53 -0
- package/dist/types/core/agent/window/evictedTurns.d.ts.map +1 -0
- package/dist/types/lib/time-travel/receipt.d.ts +71 -28
- package/dist/types/lib/time-travel/receipt.d.ts.map +1 -1
- package/dist/types/lib/time-travel/servedView.d.ts +31 -22
- package/dist/types/lib/time-travel/servedView.d.ts.map +1 -1
- package/package.json +1 -1
|
@@ -21,20 +21,32 @@
|
|
|
21
21
|
* here.
|
|
22
22
|
*
|
|
23
23
|
* ATTENTION omissions are a different fact and MAY ride the receipt:
|
|
24
|
-
* `omittedForAttention` says a
|
|
25
|
-
* refused anything — the request simply did not fit — and
|
|
26
|
-
* did it not know that?" needs to see it. Even there the
|
|
27
|
-
* never quoted, for the same reason everything else on a
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
24
|
+
* `omittedForAttention` says a budget dropped content before this request was
|
|
25
|
+
* composed. Nobody was refused anything — the request simply did not fit — and
|
|
26
|
+
* a reader chasing "why did it not know that?" needs to see it. Even there the
|
|
27
|
+
* turns are hashed, never quoted, for the same reason everything else on a
|
|
28
|
+
* receipt is.
|
|
29
|
+
*
|
|
30
|
+
* WHO SUPPLIES IT (9.93.0). Measured on 9.88.0 and again on 9.91.0, no chart
|
|
31
|
+
* supplied it, and the reason recorded was the slots: a slot writes its drops
|
|
32
|
+
* to `slotCompositions` inside its own subflow, no boundary bubbles that record
|
|
33
|
+
* out — and, underneath that, the built-in slots never DROP anything
|
|
34
|
+
* (`slots/helpers.ts` · `slotOverflow` answers over-budget with
|
|
35
|
+
* `planAction: 'none'`). That was true and it was not the whole measurement.
|
|
36
|
+
* The agent chart's WINDOW STAGE (`stages/window.ts`) evicts turns for budget
|
|
37
|
+
* on every run whose strategy engages — `context.evicted` fires with
|
|
38
|
+
* `reason: 'budget'` — and it never wrote the field. Since 9.93.0 it does: the
|
|
39
|
+
* window files what left at this iteration's head on an in-memory handle
|
|
40
|
+
* (`window/evictedTurns.ts`), the same seam the compaction meter already
|
|
41
|
+
* crosses, and the call-llm mint hands those turns here. NOT a scope read:
|
|
42
|
+
* a tracked read of `compactions` — absent on every run without a window —
|
|
43
|
+
* would put a phantom context source on every call-llm stage, the defect
|
|
44
|
+
* measured when `slotCompositions` was read for one release.
|
|
45
|
+
*
|
|
46
|
+
* Each hash is the evicted turn's OWN digest — `messageDigestInput`, the same
|
|
47
|
+
* formula `messages.entries[].hash` uses — so a dropped turn on epoch k's
|
|
48
|
+
* receipt pairs by hash with the turn as it was served on an earlier epoch's.
|
|
49
|
+
* That pairing is a law a test can check, and `gap-sentences.test.ts` does.
|
|
38
50
|
*
|
|
39
51
|
* ── THE SECOND LAW: HASHES AND REFERENCES, NEVER BYTES ─────────────────────
|
|
40
52
|
* A receipt is a fingerprint, not a copy. It records that a piece of a given
|
|
@@ -244,10 +256,13 @@ export interface ReceiptParams {
|
|
|
244
256
|
readonly name?: string;
|
|
245
257
|
};
|
|
246
258
|
}
|
|
247
|
-
/** What a
|
|
259
|
+
/** What a budget dropped before the request was composed — the window's
|
|
260
|
+
* evictions at this iteration's head. */
|
|
248
261
|
export interface ReceiptAttentionOmission {
|
|
249
262
|
readonly count: number;
|
|
250
|
-
/** One hash per dropped
|
|
263
|
+
/** One hash per dropped turn — the turn's own `messages.entries[].hash`, so
|
|
264
|
+
* it pairs with the receipt that last served it. See the first law for why
|
|
265
|
+
* not the text. */
|
|
251
266
|
readonly hashes: readonly string[];
|
|
252
267
|
}
|
|
253
268
|
/**
|
|
@@ -305,17 +320,42 @@ export interface Receipt {
|
|
|
305
320
|
/** The breakpoints the strategy actually applied, in the order it applied
|
|
306
321
|
* them — see {@link ReceiptCacheMarker}. Empty when it applied none. */
|
|
307
322
|
readonly markersApplied: readonly ReceiptCacheMarker[];
|
|
323
|
+
/**
|
|
324
|
+
* WHICH strategy stood between assembly and the port, or `null` when none
|
|
325
|
+
* did (9.93.0). The value is the strategy's declared `providerName` — the
|
|
326
|
+
* key it registers under (`'anthropic'`, `'openai'`; `'*'` is the built-in
|
|
327
|
+
* pass-through every agent runs when no provider-specific strategy is
|
|
328
|
+
* registered).
|
|
329
|
+
*
|
|
330
|
+
* `null` is a FACT, not an absence: `LLMCall` and the two message-API
|
|
331
|
+
* charts hand the port the request assembly built, with nothing in
|
|
332
|
+
* between, and say so here. `transform` alone could not — `'unchanged'` is
|
|
333
|
+
* the honest verdict both when a strategy returned what it was given and
|
|
334
|
+
* when there was no strategy to return anything — which is why the served
|
|
335
|
+
* view raised `cache-transform` on every view until this field existed.
|
|
336
|
+
* Now it raises that gap only where a strategy could have rewritten the
|
|
337
|
+
* request: where this is not `null`, or where no receipt can say.
|
|
338
|
+
*
|
|
339
|
+
* A receipt minted before 9.93.0 has no key here; a reader treats that as
|
|
340
|
+
* "cannot say", never as `null`.
|
|
341
|
+
*/
|
|
342
|
+
readonly strategy: string | null;
|
|
308
343
|
};
|
|
309
344
|
/** The sampling knobs the call went out with — see {@link ReceiptParams}. */
|
|
310
345
|
readonly params: ReceiptParams;
|
|
311
346
|
/**
|
|
312
|
-
*
|
|
313
|
-
*
|
|
314
|
-
* `
|
|
315
|
-
*
|
|
316
|
-
*
|
|
317
|
-
*
|
|
318
|
-
*
|
|
347
|
+
* What left the window for budget at this iteration's head, before this
|
|
348
|
+
* request was composed — one hash per evicted turn, each the turn's own
|
|
349
|
+
* `messages.entries[].hash` as an earlier receipt served it.
|
|
350
|
+
*
|
|
351
|
+
* Absent when nothing was dropped before this call. Since 9.93.0 that is a
|
|
352
|
+
* claim and not a shrug: the agent chart's window stage is the one shipped
|
|
353
|
+
* mechanism that drops for attention and it files every eviction here; the
|
|
354
|
+
* built-in slots drop nothing; `LLMCall` and the message-API charts have no
|
|
355
|
+
* window. It is named by the `no-receipt-on-chart` entry of `servedView.ts` ·
|
|
356
|
+
* `SERVED_GAPS` — the one gap that can lose it, by losing the receipt — and it sat in
|
|
357
|
+
* `UNGAPPED_FIELDS` until this release, when its absence was universal and
|
|
358
|
+
* meant only that nobody had recorded a drop.
|
|
319
359
|
*/
|
|
320
360
|
readonly omittedForAttention?: ReceiptAttentionOmission;
|
|
321
361
|
readonly basis: {
|
|
@@ -485,11 +525,14 @@ export interface BuildReceiptInput {
|
|
|
485
525
|
readonly boundaryIndex: number;
|
|
486
526
|
readonly ttl: 'short' | 'long';
|
|
487
527
|
}[];
|
|
488
|
-
/**
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
528
|
+
/** The `providerName` of the strategy `preparedRequest` came back from, or
|
|
529
|
+
* `null` when no strategy stood between assembly and the port — see
|
|
530
|
+
* {@link Receipt.cache.strategy}. A mint must say which; it may not omit. */
|
|
531
|
+
readonly strategy: string | null;
|
|
532
|
+
/** The turns a budget dropped before this request was composed — the
|
|
533
|
+
* window's evictions at this iteration's head. Absent or empty ⇒ no key on
|
|
534
|
+
* the receipt. */
|
|
535
|
+
readonly omittedForAttention?: readonly LLMMessage[];
|
|
493
536
|
}
|
|
494
537
|
/**
|
|
495
538
|
* The system pieces a receipt records, off the injection records a slot
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../../../src/lib/time-travel/receipt.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../../../src/lib/time-travel/receipt.ts"],"names":[],"mappings":"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"}
|
|
@@ -217,13 +217,18 @@ export interface ServedGap {
|
|
|
217
217
|
* excuse to grant — a checker that excused these would stop checking
|
|
218
218
|
* fields the record proves perfectly well.
|
|
219
219
|
*
|
|
220
|
-
* The qualifier is load-bearing and was missing until 9.88.0.
|
|
221
|
-
* carries `cache-transform
|
|
222
|
-
*
|
|
223
|
-
*
|
|
224
|
-
*
|
|
225
|
-
*
|
|
226
|
-
*
|
|
220
|
+
* The qualifier is load-bearing and was missing until 9.88.0. A view that
|
|
221
|
+
* carries `cache-transform` may also carry `no-fold-base`, and there the
|
|
222
|
+
* rebuild does NOT agree: measured on a base-less recording, the receipt
|
|
223
|
+
* said 27 system chars over 3 turns and the rebuild produced 0 over 1.
|
|
224
|
+
* Read this entry as "up to the cache strategy" and read the OTHER gaps on
|
|
225
|
+
* the view for whether the rebuild got there at all.
|
|
226
|
+
*
|
|
227
|
+
* Since 9.93.0 the entry is raised only where a strategy could have
|
|
228
|
+
* rewritten anything: where the receipt names one (`cache.strategy`), or
|
|
229
|
+
* where no receipt can say. A view whose receipt says `null` — `LLMCall`,
|
|
230
|
+
* the message-API charts — does not carry it, because nothing stood
|
|
231
|
+
* between assembly and the port for the caveat to be about.
|
|
227
232
|
*
|
|
228
233
|
* `provider-defaults`/`params` is the caveat kind too, and is the one field
|
|
229
234
|
* read past the strategy: it describes the request the port really got, and
|
|
@@ -238,8 +243,9 @@ export interface ServedGap {
|
|
|
238
243
|
* `system.hash` / `system.chars` are the view's `system.text`,
|
|
239
244
|
* `messages.entries` / `messages.count` are its `messages.asSent`, and
|
|
240
245
|
* `tools.schemaHashes` is its `tools.schemas`. The rest — `system.pieces`,
|
|
241
|
-
* `messages.requestOnly`, `tools.names`, `tools.forced`, `
|
|
242
|
-
* — are spelled the same on both
|
|
246
|
+
* `messages.requestOnly`, `tools.names`, `tools.forced`, `tools.withheld`,
|
|
247
|
+
* `params`, `cache.*`, `omittedForAttention` — are spelled the same on both,
|
|
248
|
+
* or exist on the receipt alone.
|
|
243
249
|
*
|
|
244
250
|
* THE ONE EXCEPTION is the epoch number, and it is an exception because the
|
|
245
251
|
* two shapes do not hold one fact there: they hold two RECORDS of it that can
|
|
@@ -318,19 +324,23 @@ export declare const SERVED_GAPS: Readonly<Record<ServedGapKind, Omit<ServedGap,
|
|
|
318
324
|
* reviewable as adding one to a gap, and that is the point: both are a claim
|
|
319
325
|
* somebody wrote down.
|
|
320
326
|
*
|
|
321
|
-
* TWO reasons
|
|
327
|
+
* TWO reasons qualified when this list was written, and one of them has since
|
|
328
|
+
* emptied out:
|
|
322
329
|
*
|
|
323
330
|
* • NO FOLD CAN FAIL TO PRODUCE IT — the field is read straight off the
|
|
324
331
|
* located epoch, never through a fold. `callRuntimeStageId` is this kind.
|
|
325
332
|
* • ITS ABSENCE IS UNIVERSAL AND HAS NOTHING TO DO WITH THIS RECORDING — no
|
|
326
333
|
* chart IN THIS LIBRARY supplies it, on any run, so no gap about a limit of
|
|
327
|
-
* the rebuild describes it. `omittedForAttention`
|
|
328
|
-
*
|
|
329
|
-
*
|
|
330
|
-
*
|
|
331
|
-
*
|
|
332
|
-
*
|
|
333
|
-
*
|
|
334
|
+
* the rebuild describes it. `omittedForAttention` WAS this kind from
|
|
335
|
+
* 9.88.0's fourth review round to 9.93.0, and is not any more: the
|
|
336
|
+
* measurement it rested on ("no chart drops for attention") had missed the
|
|
337
|
+
* agent chart's window stage, which evicts turns for budget on every run
|
|
338
|
+
* whose strategy engages and now files them on the receipt. A recorded
|
|
339
|
+
* drop can be lost in exactly one way — with the receipt — so the field is
|
|
340
|
+
* named by `no-receipt-on-chart` and is not here. The kind is kept on this
|
|
341
|
+
* list because the next universally-absent field will need it, and because
|
|
342
|
+
* a reason that was true for five releases and then measured false is
|
|
343
|
+
* worth a sentence where the next person looks.
|
|
334
344
|
*
|
|
335
345
|
* A field a gap DOES name never belongs here, whatever else is also true of it.
|
|
336
346
|
* `epoch` was a key here through three rounds, on the true-but-irrelevant
|
|
@@ -338,10 +348,9 @@ export declare const SERVED_GAPS: Readonly<Record<ServedGapKind, Omit<ServedGap,
|
|
|
338
348
|
* what that number MEANS, `servedViews()` returns the fold's number outright,
|
|
339
349
|
* and `no-fold-base` names it now.
|
|
340
350
|
*
|
|
341
|
-
* Paths are spelled as they are on the shape that HAS the field
|
|
342
|
-
*
|
|
343
|
-
*
|
|
344
|
-
* paths — see {@link ServedGap.fields} for the places the two shapes differ.
|
|
351
|
+
* Paths are spelled as they are on the shape that HAS the field — both keys
|
|
352
|
+
* here are `ServedView` fields. Gap `fields` are spelled as `Receipt` paths —
|
|
353
|
+
* see {@link ServedGap.fields} for the places the two shapes differ.
|
|
345
354
|
*
|
|
346
355
|
* @example
|
|
347
356
|
* ```ts
|
|
@@ -372,7 +381,7 @@ export declare const UNGAPPED_FIELDS: Readonly<Record<string, string>>;
|
|
|
372
381
|
* view.messages.asSent.length; // the turns that went out
|
|
373
382
|
* view.tools.names; // including a forced answer tool
|
|
374
383
|
* view.basis?.model; // which model saw it
|
|
375
|
-
* view.gaps.map((g) => g.gap); // ['cache-transform', 'provider-defaults']
|
|
384
|
+
* view.gaps.map((g) => g.gap); // ['cache-transform', 'provider-defaults'] on an agent
|
|
376
385
|
* ```
|
|
377
386
|
*/
|
|
378
387
|
export interface ServedView {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"servedView.d.ts","sourceRoot":"","sources":["../../../../src/lib/time-travel/servedView.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwJG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAWrF,OAAO,EAAyD,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAEnG,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,GACnB,cAAc,GACd,2BAA2B,GAC3B,YAAY,GACZ,qBAAqB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,cAAc,GAAG,sBAAsB,GAAG,wBAAwB,CAAC;AAE/E;6DAC6D;AAC7D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B
|
|
1
|
+
{"version":3,"file":"servedView.d.ts","sourceRoot":"","sources":["../../../../src/lib/time-travel/servedView.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentfootprint",
|
|
3
|
-
"version": "9.
|
|
3
|
+
"version": "9.93.0",
|
|
4
4
|
"description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "commonjs",
|