agentfootprint 9.41.0 → 9.44.0

package/dist/types/lib/injection-engine/toolOutcome.d.ts

@@ -10,7 +10,7 @@
  * tool-effects module for one string union: the loop's vocabulary embedded
  * in the graph's contract, pointing the dependency the wrong way.
  *
- * So the six words moved DOWN here — a module with zero imports that both
+ * So the words moved DOWN here — a module with zero imports that both
  * sides read. `core/agent/toolEffects.ts` re-exports them under the same
  * names, so every existing import path is unchanged; that module remains
  * the owner of the ENVELOPE grammar (the two effect kinds, the recognizer,
@@ -20,12 +20,21 @@
  * `test/lib/injection-engine/skill-graph-fence.test.ts`.
  */
 /**
- * Normalized outcome of one tool call, declared by the tool itself. Six
+ * Normalized outcome of one tool call, declared by the tool itself. Seven
  * values, deliberately closed: routing keyed on meaning needs a vocabulary
  * both sides spell identically. A string outside this set makes the value
  * NOT an envelope (data path, unchanged).
+ *
+ * `'absent'` is the seventh (the `absent()` primitive, from field use), and
+ * it earns its own word rather than folding into `'success'` or `'failure'`
+ * for the reason the primitive exists: *nothing found* and *could not look*
+ * must not route down the same edge. Under `'failure'` an honest empty answer
+ * sends an operator to investigate a healthy collector; under `'success'` a
+ * route that wants to escalate on "we found nothing" has nothing to key on.
+ * A tool may declare it directly (`{ content, effects: [], status:
+ * 'absent' }`); returning `absent(…)` makes the framework declare it.
  */
-export type ToolResultStatus = 'success' | 'failure' | 'denied' | 'invalid' | 'partial' | 'pending';
+export type ToolResultStatus = 'success' | 'failure' | 'denied' | 'invalid' | 'partial' | 'pending' | 'absent';
 /** The closed set, as data — validators and docs read one list. */
 export declare const TOOL_RESULT_STATUSES: readonly ToolResultStatus[];
 //# sourceMappingURL=toolOutcome.d.ts.map

package/dist/types/lib/injection-engine/toolOutcome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolOutcome.d.ts","sourceRoot":"","sources":["../../../../src/lib/injection-engine/toolOutcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpG,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,EAAE,SAAS,gBAAgB,EAO3D,CAAC"}
+{"version":3,"file":"toolOutcome.d.ts","sourceRoot":"","sources":["../../../../src/lib/injection-engine/toolOutcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,QAAQ,CAAC;AAEb,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,EAAE,SAAS,gBAAgB,EAQ3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "9.41.0",
+  "version": "9.44.0",
   "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
   "license": "MIT",
   "type": "commonjs",