agentfootprint 6.23.0 → 6.24.0

package/dist/esm/lib/influence-core/types.js

@@ -0,0 +1,35 @@
+/**
+ * influence-core types — the ONE embedding-based scoring contract.
+ *
+ * Pattern: Strategy seam (plug-and-play meta-pattern) — the frame and
+ *          rule engine are the library's; the `Embedder` is consumer-
+ *          injected, exactly like NarrativeFormatter / reliability /
+ *          permission / commentary strategies.
+ * Role:    `src/lib/` leaf module. Shared by the FDL paper pipeline
+ *          (Visible Reasoning, Eq. 1–6), RFC-002's tool-catalog lint +
+ *          margin recorder (C1/C4/C5), and RFC-003 Part B's LLM-edge
+ *          weigher (D7). Extracted as RFC-003 block D6 so all three
+ *          consumers share one scoring engine and one embedding cache.
+ *
+ * ## Honest claim (RFC-002 §2, the FDL discipline)
+ *
+ * Every score produced under these types is a PROXY computed from
+ * embedding geometry — cosine similarity over consumer-injected
+ * embeddings. None of it reads model internals. Scores mean "high
+ * semantic alignment", never "the model chose/answered BECAUSE".
+ * Scores are not additive across items and are not causal attribution
+ * — counterfactual ablation (RFC-003 stage 4) is where causal claims
+ * live.
+ */
+/** Paper defaults: α=0.40, β=0.30, γ=0.20, δ=0.10 (sum to 1.0). */
+export const DEFAULT_INFLUENCE_WEIGHTS = Object.freeze({
+    fa: 0.4,
+    avg: 0.3,
+    persist: 0.2,
+    depth: 0.1,
+});
+/** Paper default for the PERSIST threshold T (Eq. 3). */
+export const DEFAULT_PERSISTENCE_THRESHOLD = 0.3;
+/** RFC-002 §4 default: margins below this flag the choice as `narrow`. */
+export const DEFAULT_MARGIN_THRESHOLD = 0.05;
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/influence-core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/influence-core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AA0BH,mEAAmE;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAqB,MAAM,CAAC,MAAM,CAAC;IACvE,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,GAAG;IACR,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,GAAG;CACX,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC"}

package/dist/esm/lib/trace-toolpack/bounded.js

@@ -0,0 +1,76 @@
+/**
+ * Bounded serialization helpers for the trace toolpack.
+ *
+ * Pattern: pure functions — no state, no events.
+ * Role:    The token-economics layer. EVERY value the toolpack serves goes
+ *          through these: previews are capped, truncation is EXPLICIT
+ *          (never silent), and nested-path keys round-trip between the
+ *          engine's DELIM encoding and LLM-friendly dot notation.
+ */
+/**
+ * footprintjs's canonical nested-path delimiter (ASCII unit separator,
+ * `src/lib/memory/utils.ts`). Internal to the engine — the toolpack
+ * translates it to/from dot notation so the LLM never sees a control char.
+ */
+export const FP_PATH_DELIM = '\u001F';
+/** Engine path → LLM-friendly dotted display form. */
+export function displayKey(path) {
+    return path.includes(FP_PATH_DELIM) ? path.split(FP_PATH_DELIM).join('.') : path;
+}
+/**
+ * LLM-supplied key → engine path. Exact keys pass through; a dotted key
+ * that doesn't exist verbatim but matches a known DELIM-joined path is
+ * translated back. `knownPaths` is the set of every path seen in the
+ * commit log's trace entries.
+ */
+export function normalizeKey(key, knownPaths) {
+    if (knownPaths.has(key))
+        return key;
+    if (key.includes('.')) {
+        const delimForm = key.split('.').join(FP_PATH_DELIM);
+        if (knownPaths.has(delimForm))
+            return delimForm;
+    }
+    return key;
+}
+/** Replace every DELIM in an already-formatted text block with '.' for display. */
+export function displayText(text) {
+    return text.split(FP_PATH_DELIM).join('.');
+}
+/**
+ * Serialize a value to compact JSON, total-function style: cycles, BigInt
+ * and other non-JSON values degrade to a tagged placeholder instead of
+ * throwing — a debugger tool must never crash on the evidence it serves.
+ */
+export function safeStringify(value) {
+    if (value === undefined)
+        return 'undefined';
+    try {
+        const json = JSON.stringify(value);
+        return json === undefined ? String(value) : json;
+    }
+    catch {
+        return '[unserializable value]';
+    }
+}
+/** Serialize + cap at `maxChars`. Truncation is reported, never silent. */
+export function boundedPreview(value, maxChars) {
+    const full = safeStringify(value);
+    if (full.length <= maxChars) {
+        return { text: full, totalChars: full.length, truncated: false };
+    }
+    return { text: `${full.slice(0, maxChars)}…`, totalChars: full.length, truncated: true };
+}
+/** Render a preview with its honesty suffix when truncated. */
+export function renderPreview(preview, fetchHint) {
+    if (!preview.truncated)
+        return preview.text;
+    const hint = fetchHint ? ` — ${fetchHint}` : '';
+    return `${preview.text} (${preview.totalChars} chars total${hint})`;
+}
+/** Clamp an LLM-supplied numeric param into [min, hardCap], with a default. */
+export function clampParam(requested, fallback, min, hardCap) {
+    const value = typeof requested === 'number' && Number.isFinite(requested) ? requested : fallback;
+    return Math.max(min, Math.min(Math.floor(value), hardCap));
+}
+//# sourceMappingURL=bounded.js.map

package/dist/esm/lib/trace-toolpack/bounded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.js","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/bounded.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAEtC,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,UAA+B;IACvE,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,wBAAwB,CAAC;IAClC,CAAC;AACH,CAAC;AAYD,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,QAAgB;IAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC3F,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,OAAuB,EAAE,SAAkB;IACvE,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU,eAAe,IAAI,GAAG,CAAC;AACtE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CACxB,SAA6B,EAC7B,QAAgB,EAChB,GAAW,EACX,OAAe;IAEf,MAAM,KAAK,GAAG,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjG,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/esm/lib/trace-toolpack/index.js

@@ -0,0 +1,10 @@
+/**
+ * trace-toolpack — RFC-003 Part C: the introspection toolpack.
+ *
+ * footprintjs trace evidence exposed as TOOLS an LLM calls: a debugging
+ * model navigates a COMPLETED run's evidence by runtimeStageIds instead of
+ * reading dumps. Bounded, honest (⚠ markers), redaction-respecting.
+ */
+export { callTraceTool, traceToolpack } from './traceToolpack.js';
+export { TOOLPACK_HARD_CAPS, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/trace-toolpack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,kBAAkB,GAGnB,MAAM,YAAY,CAAC"}