agentfootprint 9.76.0 → 9.77.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.
Files changed (94) hide show
  1. package/CHANGELOG.md +108 -0
  2. package/CLAUDE.md +2 -1
  3. package/dist/core/Agent.js +36 -0
  4. package/dist/core/Agent.js.map +1 -1
  5. package/dist/core/agent/integrityFindings.js +47 -0
  6. package/dist/core/agent/integrityFindings.js.map +1 -0
  7. package/dist/core/agent/stages/callLLM.js +14 -29
  8. package/dist/core/agent/stages/callLLM.js.map +1 -1
  9. package/dist/core/agent/stages/toolCalls.js +77 -0
  10. package/dist/core/agent/stages/toolCalls.js.map +1 -1
  11. package/dist/core/runbook/report.js +69 -0
  12. package/dist/core/runbook/report.js.map +1 -0
  13. package/dist/core/runbook/runbookAsTool.js +38 -15
  14. package/dist/core/runbook/runbookAsTool.js.map +1 -1
  15. package/dist/esm/core/Agent.d.ts +3 -0
  16. package/dist/esm/core/Agent.js +36 -0
  17. package/dist/esm/core/Agent.js.map +1 -1
  18. package/dist/esm/core/agent/integrityFindings.d.ts +27 -0
  19. package/dist/esm/core/agent/integrityFindings.js +43 -0
  20. package/dist/esm/core/agent/integrityFindings.js.map +1 -0
  21. package/dist/esm/core/agent/stages/callLLM.d.ts +14 -0
  22. package/dist/esm/core/agent/stages/callLLM.js +11 -26
  23. package/dist/esm/core/agent/stages/callLLM.js.map +1 -1
  24. package/dist/esm/core/agent/stages/toolCalls.d.ts +23 -0
  25. package/dist/esm/core/agent/stages/toolCalls.js +78 -1
  26. package/dist/esm/core/agent/stages/toolCalls.js.map +1 -1
  27. package/dist/esm/core/agent/types.d.ts +49 -0
  28. package/dist/esm/core/runbook/report.d.ts +52 -0
  29. package/dist/esm/core/runbook/report.js +64 -0
  30. package/dist/esm/core/runbook/report.js.map +1 -0
  31. package/dist/esm/core/runbook/runbookAsTool.d.ts +3 -1
  32. package/dist/esm/core/runbook/runbookAsTool.js +38 -15
  33. package/dist/esm/core/runbook/runbookAsTool.js.map +1 -1
  34. package/dist/esm/core/runbook/types.d.ts +8 -1
  35. package/dist/esm/index.d.ts +1 -0
  36. package/dist/esm/index.js +7 -0
  37. package/dist/esm/index.js.map +1 -1
  38. package/dist/esm/integrity/argumentLeaves.d.ts +33 -0
  39. package/dist/esm/integrity/argumentLeaves.js +49 -0
  40. package/dist/esm/integrity/argumentLeaves.js.map +1 -0
  41. package/dist/esm/integrity/disposition/lifecycle.d.ts +16 -1
  42. package/dist/esm/integrity/disposition/lifecycle.js +25 -1
  43. package/dist/esm/integrity/disposition/lifecycle.js.map +1 -1
  44. package/dist/esm/integrity/empty-lookup/check.d.ts +140 -0
  45. package/dist/esm/integrity/empty-lookup/check.js +212 -0
  46. package/dist/esm/integrity/empty-lookup/check.js.map +1 -0
  47. package/dist/esm/integrity/finding/types.d.ts +11 -2
  48. package/dist/esm/integrity/finding/types.js.map +1 -1
  49. package/dist/esm/integrity/unsupported-argument/check.js +11 -27
  50. package/dist/esm/integrity/unsupported-argument/check.js.map +1 -1
  51. package/dist/esm/lib/trace-toolpack/traceToolpack.js +6 -4
  52. package/dist/esm/lib/trace-toolpack/traceToolpack.js.map +1 -1
  53. package/dist/index.js +11 -3
  54. package/dist/index.js.map +1 -1
  55. package/dist/integrity/argumentLeaves.js +54 -0
  56. package/dist/integrity/argumentLeaves.js.map +1 -0
  57. package/dist/integrity/disposition/lifecycle.js +25 -1
  58. package/dist/integrity/disposition/lifecycle.js.map +1 -1
  59. package/dist/integrity/empty-lookup/check.js +217 -0
  60. package/dist/integrity/empty-lookup/check.js.map +1 -0
  61. package/dist/integrity/finding/types.js.map +1 -1
  62. package/dist/integrity/unsupported-argument/check.js +13 -29
  63. package/dist/integrity/unsupported-argument/check.js.map +1 -1
  64. package/dist/lib/trace-toolpack/traceToolpack.js +6 -4
  65. package/dist/lib/trace-toolpack/traceToolpack.js.map +1 -1
  66. package/dist/types/core/Agent.d.ts +3 -0
  67. package/dist/types/core/Agent.d.ts.map +1 -1
  68. package/dist/types/core/agent/integrityFindings.d.ts +28 -0
  69. package/dist/types/core/agent/integrityFindings.d.ts.map +1 -0
  70. package/dist/types/core/agent/stages/callLLM.d.ts +14 -0
  71. package/dist/types/core/agent/stages/callLLM.d.ts.map +1 -1
  72. package/dist/types/core/agent/stages/toolCalls.d.ts +23 -0
  73. package/dist/types/core/agent/stages/toolCalls.d.ts.map +1 -1
  74. package/dist/types/core/agent/types.d.ts +49 -0
  75. package/dist/types/core/agent/types.d.ts.map +1 -1
  76. package/dist/types/core/runbook/report.d.ts +53 -0
  77. package/dist/types/core/runbook/report.d.ts.map +1 -0
  78. package/dist/types/core/runbook/runbookAsTool.d.ts +3 -1
  79. package/dist/types/core/runbook/runbookAsTool.d.ts.map +1 -1
  80. package/dist/types/core/runbook/types.d.ts +8 -1
  81. package/dist/types/core/runbook/types.d.ts.map +1 -1
  82. package/dist/types/index.d.ts +1 -0
  83. package/dist/types/index.d.ts.map +1 -1
  84. package/dist/types/integrity/argumentLeaves.d.ts +34 -0
  85. package/dist/types/integrity/argumentLeaves.d.ts.map +1 -0
  86. package/dist/types/integrity/disposition/lifecycle.d.ts +16 -1
  87. package/dist/types/integrity/disposition/lifecycle.d.ts.map +1 -1
  88. package/dist/types/integrity/empty-lookup/check.d.ts +141 -0
  89. package/dist/types/integrity/empty-lookup/check.d.ts.map +1 -0
  90. package/dist/types/integrity/finding/types.d.ts +11 -2
  91. package/dist/types/integrity/finding/types.d.ts.map +1 -1
  92. package/dist/types/integrity/unsupported-argument/check.d.ts.map +1 -1
  93. package/dist/types/lib/trace-toolpack/traceToolpack.d.ts.map +1 -1
  94. package/package.json +1 -1
@@ -0,0 +1,212 @@
1
+ /**
2
+ * empty-lookup — the run itself produced this identifier, and the lookup for
3
+ * it found nothing. Filed at the WRITE seam, as an advisory, never an
4
+ * accusation.
5
+ *
6
+ * Pattern: pure function over (one finished call, the results its declared
7
+ * producers served); the domain check, one seam later than
8
+ * `unsupported-argument`.
9
+ * Role: the decidable fragment of "did this tool answer, or did it only
10
+ * appear to answer?".
11
+ *
12
+ * THE MEASURED FAILURE. A triage agent's reverse-lookup tool filtered a
13
+ * column before a pivot, so the column did not exist yet and EVERY reverse
14
+ * lookup returned an empty result — for every identifier, always. The tool
15
+ * then answered SUCCESSFULLY with an empty list, and the agent reported in a
16
+ * table, with confidence, that the device was "not currently logged in to any
17
+ * port on the collected switches" and advised checking physical cabling. It
18
+ * was logged in the whole time. Nothing in the framework noticed, because an
19
+ * empty result from a broken filter is byte-identical to an empty result from
20
+ * a genuine absence.
21
+ *
22
+ * WHAT THE LIBRARY ALREADY KNOWS, and this check is nothing more than the
23
+ * join of the two:
24
+ * (a) the identifier was GROUNDED — it came out of an earlier tool result
25
+ * in THIS run, from a tool the consumer's author named in
26
+ * `Tool.argumentsFrom`;
27
+ * (b) the lookup keyed on it came back EMPTY.
28
+ * When the run produced the identifier and the lookup for it finds nothing,
29
+ * that is worth filing. It is not worth accusing anyone of.
30
+ *
31
+ * THE CEILING, and it is the whole reason this is an advisory: an empty
32
+ * answer can be perfectly true. The device may exist and simply have no
33
+ * logins right now. NOTHING IN THIS FILE CAN TELL THOSE APART, and nothing in
34
+ * this file pretends to — the finding says "here is a pair worth a look", the
35
+ * record carries the ceiling sentence verbatim, and the same finding is filed
36
+ * for the true absence and the broken filter alike. A check that guessed
37
+ * which one it was looking at would be inventing the certainty the field
38
+ * failure was made of.
39
+ *
40
+ * DECLARED, NEVER INFERRED — the `argumentsFrom` precedent, THIRD use. A tool
41
+ * is this check's subject only because its author said its arguments come
42
+ * from another tool's results. One declaration now arms three seams:
43
+ * `dangling-reference` asks whether the ground is still in reach when the
44
+ * tool is OFFERED, `unsupported-argument` whether the value the model chose
45
+ * came from that ground when the tool was CALLED, and this whether the ground
46
+ * the run really did serve then found anything when the tool ANSWERED.
47
+ *
48
+ * WHAT COUNTS AS EMPTY — and what this refuses to judge. See
49
+ * {@link readLookupResult}. A rowset is counted, never interpreted; an
50
+ * absence is read from the marker its own helper mints. Every other shape a
51
+ * tool has ever returned — a sentence, an object, a `null`, a claim ticket —
52
+ * is BESPOKE: the library cannot see whether it holds rows, so the encounter
53
+ * is `not-applicable` and says so in the ledger. That row is the point. A
54
+ * check that silently skipped what it could not read would be the decoration
55
+ * the disposition family exists to make impossible.
56
+ *
57
+ * Detection only. Nothing here blocks, retries, rewrites or delays anything;
58
+ * the result the model reads is the result the tool returned.
59
+ */
60
+ import { MIN_CHECKED_LENGTH, clipValue, stringLeaves } from '../argumentLeaves.js';
61
+ /**
62
+ * THE CEILING, as one string with one owner.
63
+ *
64
+ * Quoted verbatim into every finding's message, into the check's README and
65
+ * into its docs page, so the bound cannot drift out of one of them and leave
66
+ * a reader thinking the library knows more than it does.
67
+ */
68
+ export const EMPTY_LOOKUP_CEILING = 'An empty result can be perfectly true — the thing may exist and simply have nothing to show ' +
69
+ 'right now — so this is a place to look, never a verdict that anything is wrong.';
70
+ /**
71
+ * READ a finished result's shape, or decline to.
72
+ *
73
+ * The two readable shapes, and why only these two:
74
+ *
75
+ * • a **rowset** — an array. Its length is COUNTED, not interpreted: zero
76
+ * rows is zero rows, and no judgement about what the tool meant is
77
+ * involved. This is the shape the recorded failure actually returned.
78
+ * • an **absence** — the `absent()` envelope, whose author said in so many
79
+ * words "the search ran and matched nothing".
80
+ *
81
+ * Everything else returns `undefined`, which the caller files as
82
+ * `not-applicable`. A prose sentence, a bespoke `{ rows: [...] }` wrapper, a
83
+ * `null`, a placement claim ticket — the library cannot see rows in any of
84
+ * them, and guessing is how a checker starts lying.
85
+ *
86
+ * @param value the tool's own answer, as it returned it.
87
+ * @param declaredAbsence whether `readAbsence` recognized the value. PASSED
88
+ * IN rather than re-derived here on purpose: the `af_absent` marker has
89
+ * exactly one owner (`core/agent/coverage/absent.ts`), a second spelling of
90
+ * a reserved word would eventually disagree with the first, and
91
+ * `src/integrity/` stays a leaf that imports no agent code.
92
+ */
93
+ export function readLookupResult(value, declaredAbsence) {
94
+ if (declaredAbsence)
95
+ return { shape: 'absence', empty: true };
96
+ if (Array.isArray(value))
97
+ return { shape: 'rowset', empty: value.length === 0, rows: value.length };
98
+ return undefined;
99
+ }
100
+ /**
101
+ * Judge one finished call to an armed tool.
102
+ *
103
+ * @param call the call and what the library could read of its result. The
104
+ * caller has already established the tool declared `argumentsFrom`;
105
+ * nothing here re-decides who is a subject.
106
+ * @param produced every tool result this run served BEFORE this call, with
107
+ * the tool that produced each. Filtered to the declared producers here.
108
+ * @param epoch the run iteration, stamped on every witness.
109
+ */
110
+ export function emptyLookupOf(call, produced, epoch) {
111
+ // A shape the library cannot read is not a pass and not a fail. It is the
112
+ // check looking at a subject that is out of its scope BY RULE, which is
113
+ // exactly what `not-applicable` was minted for.
114
+ if (call.reading === undefined)
115
+ return { findings: [], disposition: 'not-applicable' };
116
+ // The lookup found something. Nothing to say — and a `checked-pass` rather
117
+ // than silence, because a check that only speaks when it fires cannot be
118
+ // told apart from one that was never wired.
119
+ if (!call.reading.empty)
120
+ return { findings: [], disposition: 'checked-pass' };
121
+ // Only the DECLARED producers ground anything here. The choice seam asks
122
+ // the broader question (did ANYTHING the run served carry this value); this
123
+ // one is narrower on purpose — `argumentsFrom` says where the value was
124
+ // supposed to come from, and "it came from exactly there, and the lookup
125
+ // still found nothing" is the pair worth a person's attention.
126
+ const grounds = produced
127
+ .filter((p) => call.argumentsFrom.includes(p.toolName) && p.text.length > 0)
128
+ .map((p) => ({ toolName: p.toolName, lowered: p.text.toLowerCase() }));
129
+ // The declared ground served nothing at all in this run, so there is no
130
+ // corpus to join against and no identity edge between the two tools. Not a
131
+ // pass — the check could not run. `unreachable` is the family's word for
132
+ // exactly that, and it is the falsification instrument: an `empty-lookup`
133
+ // row dominated by `unreachable` means apps are calling consumers before
134
+ // their declared producers, and this check is watching a seam that is not
135
+ // where their identifiers come from.
136
+ if (grounds.length === 0)
137
+ return { findings: [], disposition: 'unreachable' };
138
+ const consumer = { kind: 'tool', id: call.toolName };
139
+ const emptyPhrase = call.reading.shape === 'absence'
140
+ ? 'a declared absence — the tool said the search ran and matched nothing'
141
+ : 'a rowset with zero rows';
142
+ const findings = [];
143
+ for (const leaf of stringLeaves(call.args, '')) {
144
+ const value = leaf.value.trim();
145
+ // The same fences as the choice seam, for the same reasons and from the
146
+ // same file: non-strings are never identifier-shaped, and below four
147
+ // characters substring matching is noise in both directions.
148
+ if (value.length < MIN_CHECKED_LENGTH)
149
+ continue;
150
+ const needle = value.toLowerCase();
151
+ // Substring, case-insensitive — deliberately THE SAME rule the choice
152
+ // seam grounds by. The two checks must agree about what "this value came
153
+ // from that tool" means, or a value could fall between them and be seen
154
+ // by neither.
155
+ const ground = grounds.find((g) => g.lowered.includes(needle));
156
+ if (ground === undefined)
157
+ continue;
158
+ const producer = { kind: 'tool', id: ground.toolName };
159
+ const witnesses = [
160
+ {
161
+ subject: consumer,
162
+ predicate: leaf.path,
163
+ value: leaf.value,
164
+ epoch,
165
+ stratum: 'asserted',
166
+ provenance: `tool call ${call.toolCallId}: argument '${leaf.path}' as the model chose it`,
167
+ },
168
+ {
169
+ subject: producer,
170
+ predicate: leaf.path,
171
+ value: 'served this value earlier in this run',
172
+ epoch,
173
+ stratum: 'asserted',
174
+ provenance: `'${ground.toolName}' is a declared ground of '${call.toolName}' ` +
175
+ `(Tool.argumentsFrom) and one of its results in this run carries the value`,
176
+ },
177
+ {
178
+ subject: consumer,
179
+ predicate: leaf.path,
180
+ value: `found nothing — ${emptyPhrase}`,
181
+ epoch,
182
+ stratum: 'asserted',
183
+ provenance: `tool call ${call.toolCallId}: the result, as the tool returned it`,
184
+ },
185
+ ];
186
+ findings.push({
187
+ kind: 'empty-lookup',
188
+ seam: 'write',
189
+ subjects: [consumer, producer],
190
+ // The dot-path IS the discriminator, exactly as at the choice seam: two
191
+ // arguments of one call are two notices. The stated limit is the same
192
+ // one — the SAME argument re-chosen with a different value stays one
193
+ // finding, and the ledger's `findings` count is what says how often.
194
+ predicate: leaf.path,
195
+ witnesses,
196
+ epoch,
197
+ // Doubt, not contradiction. Counted apart from real defects everywhere
198
+ // the family reports, because this check can never know it found one.
199
+ advisory: true,
200
+ message: `'${call.toolName}' was called with ${leaf.path} = "${clipValue(value)}" — a value ` +
201
+ `this run itself produced, in a result from '${ground.toolName}', which ` +
202
+ `'${call.toolName}' declares as where its arguments come from — and the lookup came ` +
203
+ `back with ${emptyPhrase}. That pairing is what makes it worth a look: the run had ` +
204
+ `the identifier, so an empty answer is either a true absence or a lookup that could ` +
205
+ `never have matched, and those two are byte-identical from here. ` +
206
+ `${EMPTY_LOOKUP_CEILING} Call id ${call.toolCallId}. Nothing here blocked the call, ` +
207
+ `changed the result, or retried anything.`,
208
+ });
209
+ }
210
+ return { findings, disposition: findings.length > 0 ? 'checked-fail' : 'checked-pass' };
211
+ }
212
+ //# sourceMappingURL=check.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"check.js","sourceRoot":"","sources":["../../../../src/integrity/empty-lookup/check.ts"],"names":[],"mappings":"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"}
@@ -20,7 +20,7 @@
20
20
  import type { Assertion, SubjectRef } from '../assertion/types.js';
21
21
  import type { IntegritySeam } from '../disposition/types.js';
22
22
  /**
23
- * The five defect classes, by their plain names:
23
+ * The six defect classes, by their plain names:
24
24
  *
25
25
  * | kind | means | mechanism |
26
26
  * |---|---|---|
@@ -29,8 +29,17 @@ import type { IntegritySeam } from '../disposition/types.js';
29
29
  * | `dangling-reference` | offered an action whose inputs are no longer available | closure |
30
30
  * | `duplicate-execution` | did settled work again | once |
31
31
  * | `unsupported-claim` | stated something the record does not support | grounding |
32
+ * | `empty-lookup` | the run produced this value, and the lookup for it found nothing | join |
33
+ *
34
+ * `empty-lookup` is the one class that is ADVISORY BY CONSTRUCTION (9.77.0) —
35
+ * every finding it files carries `advisory: true`, because an empty result
36
+ * can be perfectly true and nothing in the library can tell a true absence
37
+ * from a lookup that could never have matched. It is a place to look, not a
38
+ * defect that was proven. It is deliberately NOT `dangling-reference`, whose
39
+ * meaning is the opposite: there the ground has left reach, here the ground
40
+ * is in reach and the lookup came back with nothing.
32
41
  */
33
- export type ContextErrorKind = 'invariant-violation' | 'unsupported-argument' | 'dangling-reference' | 'duplicate-execution' | 'unsupported-claim';
42
+ export type ContextErrorKind = 'invariant-violation' | 'unsupported-argument' | 'dangling-reference' | 'duplicate-execution' | 'unsupported-claim' | 'empty-lookup';
34
43
  /** One detected context error — a labelled instance, automatically. */
35
44
  export interface ContextError {
36
45
  readonly kind: ContextErrorKind;
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/integrity/finding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiEH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAe;IAClD,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;SAC/B,IAAI,EAAE;SACN,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3D,oEAAoE;IACpE,wEAAwE;IACxE,mDAAmD;IACnD,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IACpC,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,QAAQ,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC;AACpE,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/integrity/finding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA2EH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAe;IAClD,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;SAC/B,IAAI,EAAE;SACN,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3D,oEAAoE;IACpE,wEAAwE;IACxE,mDAAmD;IACnD,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IACpC,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,QAAQ,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC;AACpE,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -61,33 +61,17 @@
61
61
  *
62
62
  * Detection only. Nothing here blocks, rewrites or delays a call.
63
63
  */
64
- /** Below this, substring matching says nothing. */
65
- const MIN_CHECKED_LENGTH = 4;
66
- /** Longest a single value is quoted at inside a message. */
67
- const MAX_QUOTED_CHARS = 80;
64
+ import { MIN_CHECKED_LENGTH, clipValue, stringLeaves } from '../argumentLeaves.js';
65
+ /**
66
+ * The value fence, the quoting length and the argument walk moved to
67
+ * `../argumentLeaves.ts` when the write seam's `empty-lookup` check landed
68
+ * (9.77.0). Two checks now read one call's arguments and must agree, to the
69
+ * character, about which leaves are candidates and what their dot-paths are —
70
+ * the second check's whole job is to notice something about a value this one
71
+ * already excused.
72
+ */
68
73
  /** Deepest a schema is walked for `enum` declarations. */
69
74
  const MAX_SCHEMA_DEPTH = 8;
70
- function clip(value) {
71
- return value.length <= MAX_QUOTED_CHARS ? value : `${value.slice(0, MAX_QUOTED_CHARS - 1)}…`;
72
- }
73
- /** Every string leaf of an arguments object, with its dot-path. */
74
- function* stringLeaves(node, path) {
75
- if (typeof node === 'string') {
76
- yield { path, value: node };
77
- return;
78
- }
79
- if (Array.isArray(node)) {
80
- for (let i = 0; i < node.length; i++) {
81
- yield* stringLeaves(node[i], path === '' ? String(i) : `${path}.${String(i)}`);
82
- }
83
- return;
84
- }
85
- if (node !== null && typeof node === 'object') {
86
- for (const [key, value] of Object.entries(node)) {
87
- yield* stringLeaves(value, path === '' ? key : `${path}.${key}`);
88
- }
89
- }
90
- }
91
75
  /**
92
76
  * Best-effort: every string an `enum` array declares anywhere in a tool's
93
77
  * `inputSchema`. Flat by design — a per-path map would be more precise, and on
@@ -211,12 +195,12 @@ export function unsupportedArgumentsOf(calls, corpus, epoch) {
211
195
  witnesses,
212
196
  epoch,
213
197
  message: selfReferenced
214
- ? `'${call.toolName}' was called with ${leaf.path} = "${clip(value)}", and the only ` +
198
+ ? `'${call.toolName}' was called with ${leaf.path} = "${clipValue(value)}", and the only ` +
215
199
  `place that value appears in the frame the model chose from is the model’s own ` +
216
200
  `earlier answer. Rendered text is not evidence — a value re-read out of prose can ` +
217
201
  `be a fragment of something else entirely. To ground it, ${refetch}. Nothing here ` +
218
202
  `blocked the call.`
219
- : `'${call.toolName}' was called with ${leaf.path} = "${clip(value)}", and that value ` +
203
+ : `'${call.toolName}' was called with ${leaf.path} = "${clipValue(value)}", and that value ` +
220
204
  `appears nowhere in the frame the model chose from — not in the instructions, not ` +
221
205
  `in any message from the user, not in any tool result. Nothing served it, so ` +
222
206
  `nothing in this run can say what it refers to. To ground it, ${refetch}. Nothing ` +
@@ -1 +1 @@
1
- {"version":3,"file":"check.js","sourceRoot":"","sources":["../../../../src/integrity/unsupported-argument/check.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"check.js","sourceRoot":"","sources":["../../../../src/integrity/unsupported-argument/check.ts"],"names":[],"mappings":"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"}
@@ -442,7 +442,7 @@ function buildRunOverview(artifacts, index) {
442
442
  }
443
443
  // ── find_context_errors ────────────────────────────────────────────────────
444
444
  /**
445
- * The five ContextErrorKinds — each mapped to the check that can FILE it in
445
+ * The six ContextErrorKinds — each mapped to the check that can FILE it in
446
446
  * this build, or `false` when no check ships for that class.
447
447
  *
448
448
  * Two jobs in one table:
@@ -451,8 +451,8 @@ function buildRunOverview(artifacts, index) {
451
451
  * a kind added to the finding type without joining this list fails to
452
452
  * compile HERE, rather than becoming a value the tool's enum silently
453
453
  * rejects at run time.
454
- * - the honesty gate. `ContextErrorKind` names five defect classes;
455
- * `src/integrity/` ships four checks. Offering the fifth in the
454
+ * - the honesty gate. `ContextErrorKind` names six defect classes;
455
+ * `src/integrity/` ships five checks. Offering the sixth in the
456
456
  * schema enum invites a query whose only possible answer is a negative
457
457
  * verdict about a class nothing in the library could have filed — the
458
458
  * tool telling a model "no duplicate-execution errors" when nothing on
@@ -466,6 +466,7 @@ const CONTEXT_ERROR_KIND_CHECKS = {
466
466
  'dangling-reference': 'src/integrity/dangling-reference (compose)',
467
467
  'duplicate-execution': false,
468
468
  'unsupported-claim': 'src/integrity/unsupported-claim (claim)',
469
+ 'empty-lookup': 'src/integrity/empty-lookup (write)',
469
470
  };
470
471
  const ALL_CONTEXT_ERROR_KINDS = Object.keys(CONTEXT_ERROR_KIND_CHECKS);
471
472
  /** The kinds the tool OFFERS — the ones a shipped check can actually file. */
@@ -754,7 +755,8 @@ function buildFindContextErrors(artifacts, index, reader, opts) {
754
755
  name: 'find_context_errors',
755
756
  description: 'What did this run CONTRADICT ITSELF about? Lists the Context Integrity findings the ' +
756
757
  'library already caught — an invariant violated, an offered action whose inputs left ' +
757
- 'scope, an argument nothing served, a claim the record does not support — each with the ' +
758
+ 'scope, an argument nothing served, a claim the record does not support, a lookup for a ' +
759
+ 'value this run produced that came back empty — each with the ' +
758
760
  'step it was filed at and the ' +
759
761
  'exact drill that opens the state behind it. Call it EARLY when an answer looks wrong: a ' +
760
762
  'contradiction the library already caught beats re-deriving one. Reads only; nothing is ' +