agentfootprint 6.25.0 → 6.26.1

package/dist/types/lib/context-bisect/localize.d.ts

@@ -0,0 +1,119 @@
+/**
+ * localizeContextBug — the contextual-bug LOCALIZER, "git bisect for
+ * context" (RFC-003 Part B, block D8).
+ *
+ * The five-stage pipeline (each stage is a shipped piece — this file only
+ * ASSEMBLES):
+ *
+ *   1. TRIGGER     — an explicit `atStep`, a custom trigger strategy, or
+ *                    the QualityRecorder's lowest-scoring step.
+ *   2. SLICE       — footprintjs `causalChain` over the commit log, WITH
+ *                    control-dependence edges (D3) and honesty markers
+ *                    (A2/A4) when the artifacts carry them.
+ *   3. WEIGH       — D7's `llmEdgeWeigher` stamps influence weights on
+ *                    every LLM-call parent edge (two-pass: prime, re-slice).
+ *   4. RANK        — suspects = slice nodes classified into ablatable
+ *                    context sources (tool / injection / memory / arg),
+ *                    scored by max-product path weight × per-item semantic
+ *                    refinement. CORRELATIONAL tier — and marked so.
+ *   5. ABLATE      — optional: the consumer's `AblationRunner` re-runs the
+ *                    scenario without each top suspect, N seeded times.
+ *                    Verdicts (the ONLY causal claims, §B2) + variance.
+ *
+ * Without a runner the report stops at stage 4 with
+ * `mode: 'correlational'` — explicitly a ranking of proxies, no causal
+ * claim anywhere.
+ *
+ * Every `source` / `step` id in the report is a plain runtimeStageId —
+ * drill any of them with the trace-toolpack tools (`trace_node`,
+ * `trace_slice`, `get_value`) over the same artifacts bag.
+ */
+import type { CausalNode } from 'footprintjs/trace';
+import { type Embedder } from '../influence-core/index.js';
+import type { AblationRerun, ContextBugArtifacts, ContextBugReport, Suspect, SuspectDetail, SuspectKind } from './types.js';
+/**
+ * Extract LLM-call step ids from captured typed events: the
+ * `meta.runtimeStageId` of every `agentfootprint.stream.llm_start`
+ * envelope, deduplicated in event order. Collect events with
+ * `agent.on('*', (e) => events.push(e))`.
+ */
+export declare function llmCallIdsFromEvents(events: readonly {
+    readonly type: string;
+    readonly meta: {
+        readonly runtimeStageId: string;
+    };
+}[]): string[];
+/** A classified-but-unscored suspect produced by a classifier. */
+export interface SuspectSeed {
+    readonly kind: SuspectKind;
+    readonly detail?: SuspectDetail;
+}
+/** What a classifier sees for one slice node. */
+export interface ClassifyContext {
+    readonly node: CausalNode;
+    /** Keys this node committed. */
+    readonly keysWritten: readonly string[];
+    /** Verb-aware value of a key as of this node's last commit. */
+    readonly valueOf: (key: string) => unknown;
+}
+/**
+ * Pluggable classifier: map one slice node to its ablatable context
+ * sources. Return `undefined` to fall through to the default (which
+ * understands the agent chart's committed shapes); return `[]` to
+ * suppress the node entirely.
+ */
+export type SuspectClassifier = (ctx: ClassifyContext) => readonly SuspectSeed[] | undefined;
+/**
+ * The default classifier — reads the node's COMMITTED values (already
+ * redaction-scrubbed) and recognizes the agent chart's shapes:
+ *
+ * - `systemPromptInjections` / `messagesInjections` / `toolsInjections`
+ *   records with an engineered source → one suspect per `Injection.id`
+ *   (kind `'memory'` for source `'memory'`, else `'injection'`).
+ * - `lastToolResult` → a `'tool'` suspect for the tool that ran.
+ * - footprintjs A2 honesty marker `args` → an `'arg'` suspect (the
+ *   consumer's runner must override the input — nothing to filter).
+ * - anything else → the honest `'stage'` fallback (no ablation spec).
+ */
+export declare function defaultSuspectClassifier(ctx: ClassifyContext): readonly SuspectSeed[];
+export interface LocalizeContextBugOptions {
+    readonly artifacts: ContextBugArtifacts;
+    /** Injected embedder (D6) — wrap in `embeddingCache(...)`. */
+    readonly embedder: Embedder;
+    /** Explicit trigger step (runtimeStageId). Wins over everything. */
+    readonly atStep?: string;
+    /** Custom trigger strategy — consulted when `atStep` is absent. */
+    readonly trigger?: (artifacts: ContextBugArtifacts) => string | undefined;
+    /**
+     * The counterfactual tier: supply a runner (+ the original output) and
+     * top suspects get ablation verdicts. Absent → the report stops at the
+     * ranking, marked `mode: 'correlational'`.
+     */
+    readonly rerun?: AblationRerun;
+    /** Slice depth budget. Default 12. */
+    readonly maxDepth?: number;
+    /** Slice node budget. Default 80. */
+    readonly maxNodes?: number;
+    /** Ranked suspects kept on the report. Default 12. */
+    readonly maxSuspects?: number;
+    /** Override / extend the suspect classifier. */
+    readonly classify?: SuspectClassifier;
+}
+/**
+ * Localize a contextual bug: trigger → causal slice → influence-weighted
+ * ranking → (optional) counterfactual ablation. See module docs for the
+ * pipeline and the §B2 claim tiers.
+ *
+ * @throws when no trigger can be resolved (no `atStep`, no custom
+ *         strategy hit, no `artifacts.quality`), or when the trigger step
+ *         is not in the commit log.
+ */
+export declare function localizeContextBug(options: LocalizeContextBugOptions): Promise<ContextBugReport>;
+export declare function suspectLabel(suspect: Suspect): string;
+/**
+ * Human-readable report. The claim tiers are spelled out in the output
+ * itself (§B2): scores are proxies; verdict lines are the only causal
+ * claims; every ⚠ honesty flag prints.
+ */
+export declare function formatContextBugReport(report: ContextBugReport): string;
+//# sourceMappingURL=localize.d.ts.map

package/dist/types/lib/context-bisect/localize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize.d.ts","sourceRoot":"","sources":["../../../../src/lib/context-bisect/localize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAkB,KAAK,QAAQ,EAAsB,MAAM,4BAA4B,CAAC;AAG/F,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAIhB,OAAO,EACP,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAC;AAKpB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAAE,GAC/F,MAAM,EAAE,CAWV;AAID,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,SAAS,WAAW,EAAE,GAAG,SAAS,CAAC;AAuB7F;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,WAAW,EAAE,CAsDrF;AAmGD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,mBAAmB,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAID;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CA+N3B;AAsGD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGrD;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAiFvE"}

package/dist/types/lib/context-bisect/types.d.ts

@@ -0,0 +1,356 @@
+/**
+ * context-bisect types — RFC-003 Part B: the contextual-bug localizer
+ * ("git bisect for context").
+ *
+ * Pattern: assembly contract. Part B is pure ASSEMBLY over shipped pieces:
+ *          footprintjs 9.8.0's complete causal DAG (control edges, honesty
+ *          markers, `EdgeWeigher` hook) × influence-core scoring (D6) ×
+ *          consumer-run counterfactual ablation. No new engine features,
+ *          no new typed events.
+ * Role:    `src/lib/context-bisect/` leaf. Exported via
+ *          `agentfootprint/observe`.
+ *
+ * ## The two-tier honest-claims discipline (RFC-003 §B2)
+ *
+ * Every number in these types belongs to exactly ONE of two tiers, and the
+ * docs say which:
+ *
+ *   - **CORRELATIONAL** — edge weights, suspect scores, rankings. These are
+ *     deterministic embedding-geometry PROXIES (influence-core composite:
+ *     semantic alignment between what a source wrote and what the LLM step
+ *     produced). They mean "high semantic alignment", never "the model
+ *     answered BECAUSE of this". A report without reruns stops here and is
+ *     marked `mode: 'correlational'`.
+ *
+ *   - **CAUSAL** — ablation verdicts ONLY. A suspect earns `verdict:
+ *     'confirmed'` exclusively by counterfactual evidence: the consumer's
+ *     `AblationRunner` re-ran the scenario WITHOUT the suspect N seeded
+ *     times and the outcome flipped (with baseline stability checked and
+ *     variance reported — never a single-run verdict).
+ *
+ * Slice completeness is bounded by tracking — and SAYS so: untracked reads
+ * (`$getArgs()` / env / silent reads), missing control-dependence lookups,
+ * missing read tracking, and depth/node truncation all surface as
+ * `honestyFlags` on the report, mirrored from footprintjs's own A2/A4
+ * markers.
+ */
+import type { CommitBundle, RuntimeSnapshot, StageSnapshot } from 'footprintjs/advanced';
+import type { ControlDepLookup } from 'footprintjs/trace';
+import type { Embedder, InfluenceWeights } from '../influence-core/index.js';
+/**
+ * Minimal structural envelope for captured typed events — satisfied by
+ * `AgentfootprintEvent` (collect with `agent.on('*', e => events.push(e))`).
+ * Structural so a consumer can hand in any array shaped like this.
+ */
+export interface CapturedEventLike {
+    readonly type: string;
+    readonly payload: unknown;
+    readonly meta: {
+        readonly runtimeStageId: string;
+    };
+}
+/**
+ * Minimal per-step quality lookup for trigger derivation — satisfied by
+ * footprintjs's `QualityRecorder` (structural, decoupled).
+ */
+export interface QualityTriggerLookup {
+    getLowest(): {
+        runtimeStageId: string;
+        entry: {
+            score: number;
+            stageName: string;
+        };
+    } | undefined;
+}
+/**
+ * The frozen evidence of one completed run — a structural SUPERSET of the
+ * trace-toolpack's `TraceToolpackArtifacts`, so the same bag literal can
+ * serve `traceToolpack(...)` and `localizeContextBug(...)`: every
+ * runtimeStageId in the report drills straight into the toolpack tools.
+ *
+ * - `snapshot` — `executor.getSnapshot()` / `agent.getLastSnapshot()`.
+ * - `controlDeps` — OPTIONAL `controlDepRecorder().asLookup()` from the
+ *   run. With it, the slice includes `[control: <rule label>]` edges to
+ *   the deciders that routed execution. Without it, the report carries the
+ *   `no-control-deps` honesty flag.
+ * - `quality` — OPTIONAL `QualityRecorder` from the run; its
+ *   lowest-scoring step is the default trigger when `atStep` is absent.
+ * - `events` — OPTIONAL captured typed events; used to extract LLM-call
+ *   step ids (`stream.llm_start`) when `llmCallIds` is not given.
+ * - `llmCallIds` — explicit override: the runtimeStageIds of LLM-call
+ *   executions (the steps whose parent edges D7 weighs).
+ */
+export interface ContextBugArtifacts {
+    readonly snapshot: RuntimeSnapshot;
+    readonly controlDeps?: ControlDepLookup;
+    readonly quality?: QualityTriggerLookup;
+    readonly events?: readonly CapturedEventLike[];
+    readonly llmCallIds?: readonly string[];
+}
+/**
+ * What kind of context source a suspect is — picks which ablation adapter
+ * applies. `'stage'` is the honest fallback for slice nodes the classifier
+ * cannot map to an ablatable source (pipeline plumbing, plain stages).
+ */
+export type SuspectKind = 'tool' | 'injection' | 'memory' | 'arg' | 'stage';
+/** Kind-specific identity + the text the semantic refinement embedded. */
+export interface SuspectDetail {
+    /** Tool name (kind 'tool'). */
+    readonly toolName?: string;
+    /** Injection id (kind 'injection' / 'memory') — `Injection.id`. */
+    readonly injectionId?: string;
+    /** Injection flavor (fact / skill / rag / memory / …), when known. */
+    readonly flavor?: string;
+    /**
+     * The suspect's own content text (tool result / injection rawContent),
+     * already redaction-scrubbed by footprintjs at commit time. This is
+     * what the embedder saw for `semanticScore`.
+     */
+    readonly text?: string;
+}
+/**
+ * One hop of a suspect's evidence path — the argmax-weight chain from the
+ * trigger step back to the suspect. Control edges carry `kind: 'control'`
+ * and (when decide() supplied one) the rule label in `key`.
+ */
+export interface EdgePathStep {
+    /** Child (downstream) step. The first hop's `from` is the trigger. */
+    readonly from: string;
+    readonly fromName: string;
+    /** Parent (upstream) step. The last hop's `to` is the suspect. */
+    readonly to: string;
+    readonly toName: string;
+    readonly kind: 'data' | 'control';
+    /** State key (data) or decide() rule label (control), when present. */
+    readonly key?: string;
+    /** Edge weight — 1.0 unless D7 weighed it (child was an LLM call). */
+    readonly weight: number;
+}
+/** Per-run similarity statistics — variance ALWAYS reported (D9). */
+export interface SimilarityStats {
+    readonly mean: number;
+    readonly min: number;
+    readonly max: number;
+    /** Population standard deviation across the N seeded reruns. */
+    readonly stdev: number;
+}
+/** Evidence from N seeded ablation reruns of one probe. */
+export interface AblationRunStats {
+    /** Seeded reruns performed (the consumer's runner was called N times). */
+    readonly samples: number;
+    /** Runs where `outcomeChanged(original, ablated)` was true. */
+    readonly flips: number;
+    /** Embedding similarity of each ablated output to the original. */
+    readonly similarity: SimilarityStats;
+}
+export type AblationVerdictKind = 'confirmed' | 'not-confirmed' | 'inconclusive';
+/**
+ * The ONLY causal claim in the report (§B2). `'confirmed'` = ablating the
+ * suspect flipped the outcome in a MAJORITY of N seeded reruns while the
+ * un-ablated baseline stayed stable. `'inconclusive'` = mixed flips, or an
+ * unstable baseline (the scenario itself doesn't reproduce — no ablation
+ * verdict is trustworthy then). `'not-confirmed'` = no flip observed; the
+ * suspect's score remains a correlational proxy only.
+ */
+export interface AblationVerdict {
+    readonly verdict: AblationVerdictKind;
+    /** Human-readable claim, phrased at the right tier (causal vs proxy). */
+    readonly claim: string;
+}
+/** One ranked suspect. */
+export interface Suspect {
+    /**
+     * runtimeStageId of the slice node this suspect lives at — drillable
+     * with the trace-toolpack tools (`trace_node(source)` etc.).
+     */
+    readonly source: string;
+    readonly stageName: string;
+    readonly kind: SuspectKind;
+    readonly detail?: SuspectDetail;
+    /**
+     * The ranking key — CORRELATIONAL proxy (§B2):
+     * `structuralScore × semanticScore` when a semantic refinement exists,
+     * else `structuralScore`. Means "semantically aligned and causally
+     * UPSTREAM", never "caused".
+     *
+     * Comparison caveat: a suspect WITHOUT content text (kind 'stage'/'arg',
+     * or a path through control edges only) keeps its bare structural score
+     * — an UPPER BOUND with no content evidence behind it. Plumbing can
+     * legitimately rank above ablatable sources; the ablation verdicts (and
+     * `semanticScore`'s presence) are what disambiguate.
+     */
+    readonly score: number;
+    /**
+     * Max-product of edge weights along the best path from the trigger to
+     * this node (1.0 when no D7-weighted LLM edge is on the path).
+     */
+    readonly structuralScore: number;
+    /**
+     * Influence-core composite of the suspect's own content vs the trigger
+     * step's output (clamped to [0, 1]); only for suspects with a known
+     * content text. The same proxy disclaimers as D6 apply.
+     */
+    readonly semanticScore?: number;
+    /**
+     * TRUE when `score` includes a content signal (semanticScore present).
+     * FALSE = path-only structural score — an UPPER BOUND that can reach 1.0
+     * through control-edge paths alone; rank such suspects with care and
+     * prefer ablation verdicts to disambiguate. (Machine-readable twin of
+     * the "path only — no content signal" report marking.)
+     */
+    readonly hasContentEvidence: boolean;
+    /** Evidence path, trigger → … → suspect, control edges labeled. */
+    readonly edgePath: readonly EdgePathStep[];
+    /** The counterfactual to run — absent for kind 'stage'. */
+    readonly ablation?: AblationSpec;
+    /** CAUSAL tier — present only when an `AblationRunner` was supplied. */
+    readonly verdict?: AblationVerdict;
+    /** The rerun evidence behind `verdict`. */
+    readonly runs?: AblationRunStats;
+}
+/**
+ * What to remove for one counterfactual rerun. The library BUILDS specs
+ * (one per suspect kind) and provides `applyAblations` to apply them to
+ * the inputs an agent is constructed from; the consumer's `AblationRunner`
+ * re-runs the scenario with the spec applied.
+ *
+ * THE TOOL SEAM (documented because `AgentOptions` has no `ignoredTools`):
+ * agentfootprint has no runtime tool kill-switch — tools enter an agent at
+ * construction (`.tools([...])` / injection `inject.tools`). Tool ablation
+ * therefore happens where tools are DECLARED: the runner rebuilds the
+ * agent with `applyAblations(specs, { tools }).tools`. The same pattern
+ * covers injections (rebuild without the excluded `Injection.id`s) and
+ * memory (filter `MemoryEntry`s by id before attaching).
+ */
+export type AblationSpec = 
+/** Drop these tools from the catalog the agent is built with. */
+{
+    readonly kind: 'tool';
+    readonly ignoredTools: readonly string[];
+}
+/** Drop these injections (facts / skills / instructions / steering / rag). */
+ | {
+    readonly kind: 'injection';
+    readonly excludeInjectionIds: readonly string[];
+}
+/** Drop these memory entries (matched by `MemoryEntry.id`). */
+ | {
+    readonly kind: 'memory';
+    readonly excludeMemoryIds: readonly string[];
+}
+/**
+ * The suspect is run INPUT (`$getArgs()` / seed args) — there is nothing
+ * the library can filter. The consumer's runner must override the arg
+ * itself (e.g. re-run with a neutralized field). `source` names the step
+ * that consumed the untracked input.
+ */
+ | {
+    readonly kind: 'arg';
+    readonly source: string;
+    readonly note: string;
+};
+/**
+ * Consumer-supplied counterfactual runner: re-run the SAME scenario with
+ * every spec in `specs` applied, and return the run's output text.
+ *
+ * Contract:
+ * - `specs` may be empty — that is the BASELINE probe (re-run unchanged);
+ *   its outputs measure the scenario's natural variance.
+ * - `run.seed` varies 0..N-1 across the N samples of one probe. Thread it
+ *   into any stochastic knob (sampling temperature seed, mock script
+ *   selection) so reruns are deterministic-but-distinct; ignore it for
+ *   fully deterministic scenarios.
+ * - Build a FRESH agent/provider per call — scripted mock providers are
+ *   stateful (replies consume in order).
+ */
+export type AblationRunner = (specs: readonly AblationSpec[], run: {
+    readonly seed: number;
+}) => Promise<string>;
+/**
+ * Did the ablated output mean something DIFFERENT from the original?
+ * Default: embedding similarity below `flipThreshold`. Override with a
+ * domain comparator (e.g. compare extracted decisions) — recommended with
+ * `mockEmbedder`, whose cosine compresses prose into ~0.85–0.97 (the C1
+ * calibration note: absolute thresholds only with real embedders).
+ */
+export type OutcomeComparator = (original: string, ablated: string) => boolean | Promise<boolean>;
+/** The rerun configuration that upgrades the report to the causal tier. */
+export interface AblationRerun {
+    readonly runner: AblationRunner;
+    /** The original (buggy) output the reruns are compared against. */
+    readonly originalOutput: string;
+    /** Seeded reruns per probe. Default 3. Never below 2 (no single-run verdicts — D9). */
+    readonly samples?: number;
+    /** Outcome-flip comparator. Default: similarity < `flipThreshold`. */
+    readonly outcomeChanged?: OutcomeComparator;
+    /** Similarity floor for the DEFAULT comparator. Default 0.8. */
+    readonly flipThreshold?: number;
+    /** Ablate only the top-K ranked suspects that carry a spec. Default 5. */
+    readonly maxSuspects?: number;
+}
+/** Slice-shape numbers — how much evidence the ranking stands on. */
+export interface SliceStats {
+    readonly nodes: number;
+    readonly dataEdges: number;
+    readonly controlEdges: number;
+    /** Edges that received a D7 (LLM-influence) weight. */
+    readonly weightedEdges: number;
+    /** Nodes that ALSO consumed untracked sources (args/env/silent reads). */
+    readonly incompleteNodes: number;
+    readonly maxDepth: number;
+    readonly maxNodes: number;
+    /** Present when a limit actually cut the slice (footprintjs A4). */
+    readonly truncated?: {
+        readonly byDepth: boolean;
+        readonly byNodes: boolean;
+    };
+}
+export type HonestyFlagKind = 'slice-truncated' | 'untracked-sources' | 'no-control-deps' | 'no-read-tracking' | 'no-llm-call-ids' | 'baseline-unstable';
+export interface HonestyFlag {
+    readonly flag: HonestyFlagKind;
+    readonly note: string;
+}
+/** The localizer's full output (D8). */
+export interface ContextBugReport {
+    /** The trigger step the slice was rooted at. */
+    readonly step: string;
+    readonly stepName: string;
+    /** Where the trigger came from. */
+    readonly triggerSource: 'explicit' | 'quality' | 'custom';
+    /** The quality score that selected the trigger (quality source only). */
+    readonly triggerScore?: number;
+    /**
+     * `'correlational'` — no `AblationRunner` supplied: the report STOPS at
+     * the ranking; every score is a proxy and no causal claim is made.
+     * `'causal'` — suspects additionally carry ablation verdicts (§B2: the
+     * verdicts are the only causal claims; the scores stay proxies).
+     */
+    readonly mode: 'correlational' | 'causal';
+    /** Ranked suspects, best (most aligned + upstream) first. */
+    readonly suspects: readonly Suspect[];
+    readonly sliceStats: SliceStats;
+    /** ⚠ everything that bounds what this report can honestly claim. */
+    readonly honestyFlags: readonly HonestyFlag[];
+    /** Baseline probe stats (causal mode only). */
+    readonly baseline?: AblationRunStats;
+}
+export declare const CONTEXT_BISECT_DEFAULTS: {
+    /** Slice depth budget (forwarded to `causalChain`). */
+    readonly maxDepth: 12;
+    /** Slice node budget (forwarded to `causalChain`). */
+    readonly maxNodes: 80;
+    /** Ranked suspects kept on the report. */
+    readonly maxSuspects: 12;
+    /** Chars of written content embedded per step text (D7). */
+    readonly maxTextChars: 2000;
+    /** Seeded reruns per ablation probe (D9 — never single-run verdicts). */
+    readonly samples: 3;
+    /** Default similarity floor for the default outcome comparator. */
+    readonly flipThreshold: 0.8;
+    /** Ablation probes budget for `bisectCulprits`. */
+    readonly maxProbes: 24;
+    /** Independent-culprit search rounds for `bisectCulprits`. */
+    readonly maxCulprits: 4;
+};
+export type { CommitBundle, ControlDepLookup, Embedder, InfluenceWeights, RuntimeSnapshot, StageSnapshot, };
+//# sourceMappingURL=types.d.ts.map

package/dist/types/lib/context-bisect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/context-bisect/types.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/tool-lint/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../src/lib/tool-lint/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAqBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,WAAW,EAAE,CAuCnE;AAmDD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,GAAE,aAKH,GACA,OAAO,CAAC,MAAM,CAAC,CAkDjB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../src/lib/tool-lint/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAqBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,WAAW,EAAE,CAuCnE;AAmDD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,GAAE,aAKH,GACA,OAAO,CAAC,MAAM,CAAC,CAwDjB"}

package/dist/types/observe.d.ts

@@ -52,6 +52,7 @@ export { agentThinkingTrace, type AgentThinkingTraceHandle, type AgentThinkingTr
 export { typedEmit } from './recorders/core/typedEmit.js';
 export { adaptWeights, averageRelevancy, compositeScore, contentHash, DEFAULT_INFLUENCE_WEIGHTS, DEFAULT_MARGIN_THRESHOLD, DEFAULT_PERSISTENCE_THRESHOLD, EmbeddingCache, embeddingCache, finalAnswerSimilarity, pairwiseSimilarity, persistence, scoreInfluence, scoreMargin, structuralProximity, type CandidateScore, type Embedder, type EmbeddingCacheOptions, type EmbeddingCacheStats, type EvidenceInput, type InfluenceScore, type InfluenceWeights, type MarginCandidate, type MarginResult, type PairwiseSimilarityArgs, type PairwiseSimilarityResult, type ScoreInfluenceArgs, type ScoreMarginArgs, type SignalScores, type SimilarityItem, type SimilarityPair, } from './lib/influence-core/index.js';
 export { callTraceTool, TOOLPACK_HARD_CAPS, traceToolpack, type TraceToolpackArtifacts, type TraceToolpackOptions, } from './lib/trace-toolpack/index.js';
+export { ablationForSuspect, applyAblations, bisectCulprits, CONTEXT_BISECT_DEFAULTS, defaultOutcomeComparator, defaultSuspectClassifier, formatContextBugReport, llmCallIdsFromEvents, llmEdgeWeigher, localizeContextBug, probeFlipped, runAblationProbe, stepOutputText, suspectLabel, verdictFor, type AblationRerun, type AblationRunner, type AblationRunStats, type AblationSpec, type AblationTargets, type AblationVerdict, type AblationVerdictKind, type BisectCulpritsOptions, type BisectionProbe, type BisectionResult, type CapturedEventLike, type ClassifyContext, type ContextBugArtifacts, type ContextBugReport, type EdgePathStep, type HonestyFlag, type HonestyFlagKind, type LlmEdgeWeigherHandle, type LlmEdgeWeigherOptions, type LocalizeContextBugOptions, type OutcomeComparator, type QualityTriggerLookup, type RankedParentEdge, type SimilarityStats, type SliceStats, type Suspect, type SuspectClassifier, type SuspectDetail, type SuspectKind, type SuspectSeed, } from './lib/context-bisect/index.js';
 export { analyzeToolCatalog, catalogFromTools, coerceCatalog, confusabilityText, DEFAULT_CONFUSABILITY_THRESHOLD, DEFAULT_OMISSION_CUES, DEFAULT_WATCH_BAND, DEFAULT_WHEN_CUES, defaultStructuralRules, descriptionRule, differentiationHint, enumInProseRule, formatToolCatalogReport, MOCK_EMBEDDER_CALIBRATION, optionalParamRule, runToolLintCli, saysWhatNotWhenRule, type AnalyzeToolCatalogOptions, type CatalogTool, type ConfusablePairFinding, type DescriptionRuleOptions, type FormatReportOptions, type LintRule, type LintSeverity, type OptionalParamRuleOptions, type PairVerdict, type SaysWhatNotWhenRuleOptions, type SimilarityReport, type StructuralFinding, type ToolCatalogReport, type ToolLintCliIO, } from './lib/tool-lint/index.js';
 export { buildChoiceContext, toolChoiceRecorder, type OfferedTool, type ToolChoiceCall, type ToolChoiceRecorderHandle, type ToolChoiceRecorderOptions, type ToolChoiceSkipReason, type ToolChoiceSummary, } from './recorders/observability/ToolChoiceRecorder.js';
 //# sourceMappingURL=observe.d.ts.map

package/dist/types/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/observe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/observe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAGhG,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,gDAAgD,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,GACrC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,kDAAkD,CAAC;AAG1D,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,yDAAyD,CAAC;AAGjE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAS1D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,iDAAiD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "6.25.0",
+  "version": "6.26.1",
   "description": "The explainable agent framework — build AI agents you can explain, audit, and trust. Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",