agentfootprint 6.23.0 → 6.24.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/dist/esm/lib/influence-core/cache.js +149 -0
- package/dist/esm/lib/influence-core/cache.js.map +1 -0
- package/dist/esm/lib/influence-core/index.js +32 -0
- package/dist/esm/lib/influence-core/index.js.map +1 -0
- package/dist/esm/lib/influence-core/margin.js +110 -0
- package/dist/esm/lib/influence-core/margin.js.map +1 -0
- package/dist/esm/lib/influence-core/signals.js +232 -0
- package/dist/esm/lib/influence-core/signals.js.map +1 -0
- package/dist/esm/lib/influence-core/similarity.js +79 -0
- package/dist/esm/lib/influence-core/similarity.js.map +1 -0
- package/dist/esm/lib/influence-core/types.js +35 -0
- package/dist/esm/lib/influence-core/types.js.map +1 -0
- package/dist/esm/lib/trace-toolpack/bounded.js +76 -0
- package/dist/esm/lib/trace-toolpack/bounded.js.map +1 -0
- package/dist/esm/lib/trace-toolpack/index.js +10 -0
- package/dist/esm/lib/trace-toolpack/index.js.map +1 -0
- package/dist/esm/lib/trace-toolpack/traceToolpack.js +699 -0
- package/dist/esm/lib/trace-toolpack/traceToolpack.js.map +1 -0
- package/dist/esm/lib/trace-toolpack/types.js +24 -0
- package/dist/esm/lib/trace-toolpack/types.js.map +1 -0
- package/dist/esm/observe.js +12 -0
- package/dist/esm/observe.js.map +1 -1
- package/dist/lib/influence-core/cache.js +155 -0
- package/dist/lib/influence-core/cache.js.map +1 -0
- package/dist/lib/influence-core/index.js +50 -0
- package/dist/lib/influence-core/index.js.map +1 -0
- package/dist/lib/influence-core/margin.js +114 -0
- package/dist/lib/influence-core/margin.js.map +1 -0
- package/dist/lib/influence-core/signals.js +242 -0
- package/dist/lib/influence-core/signals.js.map +1 -0
- package/dist/lib/influence-core/similarity.js +83 -0
- package/dist/lib/influence-core/similarity.js.map +1 -0
- package/dist/lib/influence-core/types.js +38 -0
- package/dist/lib/influence-core/types.js.map +1 -0
- package/dist/lib/trace-toolpack/bounded.js +86 -0
- package/dist/lib/trace-toolpack/bounded.js.map +1 -0
- package/dist/lib/trace-toolpack/index.js +16 -0
- package/dist/lib/trace-toolpack/index.js.map +1 -0
- package/dist/lib/trace-toolpack/traceToolpack.js +704 -0
- package/dist/lib/trace-toolpack/traceToolpack.js.map +1 -0
- package/dist/lib/trace-toolpack/types.js +28 -0
- package/dist/lib/trace-toolpack/types.js.map +1 -0
- package/dist/observe.js +31 -1
- package/dist/observe.js.map +1 -1
- package/dist/types/lib/influence-core/cache.d.ts +95 -0
- package/dist/types/lib/influence-core/cache.d.ts.map +1 -0
- package/dist/types/lib/influence-core/index.d.ts +33 -0
- package/dist/types/lib/influence-core/index.d.ts.map +1 -0
- package/dist/types/lib/influence-core/margin.d.ts +34 -0
- package/dist/types/lib/influence-core/margin.d.ts.map +1 -0
- package/dist/types/lib/influence-core/signals.d.ts +104 -0
- package/dist/types/lib/influence-core/signals.d.ts.map +1 -0
- package/dist/types/lib/influence-core/similarity.d.ts +26 -0
- package/dist/types/lib/influence-core/similarity.d.ts.map +1 -0
- package/dist/types/lib/influence-core/types.d.ts +158 -0
- package/dist/types/lib/influence-core/types.d.ts.map +1 -0
- package/dist/types/lib/trace-toolpack/bounded.d.ts +48 -0
- package/dist/types/lib/trace-toolpack/bounded.d.ts.map +1 -0
- package/dist/types/lib/trace-toolpack/index.d.ts +10 -0
- package/dist/types/lib/trace-toolpack/index.d.ts.map +1 -0
- package/dist/types/lib/trace-toolpack/traceToolpack.d.ts +70 -0
- package/dist/types/lib/trace-toolpack/traceToolpack.d.ts.map +1 -0
- package/dist/types/lib/trace-toolpack/types.d.ts +60 -0
- package/dist/types/lib/trace-toolpack/types.d.ts.map +1 -0
- package/dist/types/observe.d.ts +2 -0
- package/dist/types/observe.d.ts.map +1 -1
- package/package.json +3 -3
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bounded serialization helpers for the trace toolpack.
|
|
3
|
+
*
|
|
4
|
+
* Pattern: pure functions — no state, no events.
|
|
5
|
+
* Role: The token-economics layer. EVERY value the toolpack serves goes
|
|
6
|
+
* through these: previews are capped, truncation is EXPLICIT
|
|
7
|
+
* (never silent), and nested-path keys round-trip between the
|
|
8
|
+
* engine's DELIM encoding and LLM-friendly dot notation.
|
|
9
|
+
*/
|
|
10
|
+
/**
|
|
11
|
+
* footprintjs's canonical nested-path delimiter (ASCII unit separator,
|
|
12
|
+
* `src/lib/memory/utils.ts`). Internal to the engine — the toolpack
|
|
13
|
+
* translates it to/from dot notation so the LLM never sees a control char.
|
|
14
|
+
*/
|
|
15
|
+
export declare const FP_PATH_DELIM = "\u001F";
|
|
16
|
+
/** Engine path → LLM-friendly dotted display form. */
|
|
17
|
+
export declare function displayKey(path: string): string;
|
|
18
|
+
/**
|
|
19
|
+
* LLM-supplied key → engine path. Exact keys pass through; a dotted key
|
|
20
|
+
* that doesn't exist verbatim but matches a known DELIM-joined path is
|
|
21
|
+
* translated back. `knownPaths` is the set of every path seen in the
|
|
22
|
+
* commit log's trace entries.
|
|
23
|
+
*/
|
|
24
|
+
export declare function normalizeKey(key: string, knownPaths: ReadonlySet<string>): string;
|
|
25
|
+
/** Replace every DELIM in an already-formatted text block with '.' for display. */
|
|
26
|
+
export declare function displayText(text: string): string;
|
|
27
|
+
/**
|
|
28
|
+
* Serialize a value to compact JSON, total-function style: cycles, BigInt
|
|
29
|
+
* and other non-JSON values degrade to a tagged placeholder instead of
|
|
30
|
+
* throwing — a debugger tool must never crash on the evidence it serves.
|
|
31
|
+
*/
|
|
32
|
+
export declare function safeStringify(value: unknown): string;
|
|
33
|
+
/** A bounded preview of a value: capped text + the TRUE total size, never silent. */
|
|
34
|
+
export interface BoundedPreview {
|
|
35
|
+
/** The (possibly truncated) serialized text. */
|
|
36
|
+
readonly text: string;
|
|
37
|
+
/** Full serialized length in chars — so the consumer knows what it's NOT seeing. */
|
|
38
|
+
readonly totalChars: number;
|
|
39
|
+
/** True when `text` is shorter than the full serialization. */
|
|
40
|
+
readonly truncated: boolean;
|
|
41
|
+
}
|
|
42
|
+
/** Serialize + cap at `maxChars`. Truncation is reported, never silent. */
|
|
43
|
+
export declare function boundedPreview(value: unknown, maxChars: number): BoundedPreview;
|
|
44
|
+
/** Render a preview with its honesty suffix when truncated. */
|
|
45
|
+
export declare function renderPreview(preview: BoundedPreview, fetchHint?: string): string;
|
|
46
|
+
/** Clamp an LLM-supplied numeric param into [min, hardCap], with a default. */
|
|
47
|
+
export declare function clampParam(requested: number | undefined, fallback: number, min: number, hardCap: number): number;
|
|
48
|
+
//# sourceMappingURL=bounded.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bounded.d.ts","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/bounded.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAOjF;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAM/E;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,MAAM,CAGR"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* trace-toolpack — RFC-003 Part C: the introspection toolpack.
|
|
3
|
+
*
|
|
4
|
+
* footprintjs trace evidence exposed as TOOLS an LLM calls: a debugging
|
|
5
|
+
* model navigates a COMPLETED run's evidence by runtimeStageIds instead of
|
|
6
|
+
* reading dumps. Bounded, honest (⚠ markers), redaction-respecting.
|
|
7
|
+
*/
|
|
8
|
+
export { callTraceTool, traceToolpack } from './traceToolpack.js';
|
|
9
|
+
export { TOOLPACK_HARD_CAPS, type TraceToolpackArtifacts, type TraceToolpackOptions, } from './types.js';
|
|
10
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","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,EAClB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* traceToolpack — footprintjs trace evidence exposed as TOOLS an LLM calls
|
|
3
|
+
* (RFC-003 Part C: the introspection toolpack).
|
|
4
|
+
*
|
|
5
|
+
* "The framework's internal tool for itself": after a run completes, a
|
|
6
|
+
* debugging LLM (a cheap model in a SEPARATE session) navigates the run's
|
|
7
|
+
* evidence by ids instead of reading dumps — the same just-in-time,
|
|
8
|
+
* token-efficient loading pattern as `read_skill`. Feed the slice, not the
|
|
9
|
+
* trace; the LLM ranks by navigating, so no embedder is needed.
|
|
10
|
+
*
|
|
11
|
+
* Pattern: Factory over frozen artifacts. `traceToolpack(artifacts)` returns
|
|
12
|
+
* plain `Tool[]` — mount them on any Agent, or drive them scripted
|
|
13
|
+
* via `callTraceTool` (the offline auditor pattern, like
|
|
14
|
+
* examples/features/20). Nothing re-runs; every tool is a bounded
|
|
15
|
+
* read-only VIEW over a COMPLETED run's snapshot + commit log.
|
|
16
|
+
*
|
|
17
|
+
* The toolpack's three contracts (B13 posture):
|
|
18
|
+
*
|
|
19
|
+
* 1. BOUNDED BY DEFAULT — every output is capped (previews, slice
|
|
20
|
+
* depth/nodes, value chars, narrative lines). Per-call params raise
|
|
21
|
+
* the budget only up to hard caps the LLM cannot exceed.
|
|
22
|
+
* 2. HONEST — truncation and incompleteness are ALWAYS marked (⚠), never
|
|
23
|
+
* silent: truncated slices, untracked sources (args/env/silent reads),
|
|
24
|
+
* missing read tracking, missing control-dependence lookup, values the
|
|
25
|
+
* commit log cannot see (pre-run state, closures).
|
|
26
|
+
* 3. REDACTION-RESPECTING — the commit log already carries redacted
|
|
27
|
+
* payloads (footprintjs scrubs at commit time); the toolpack passes
|
|
28
|
+
* placeholders through verbatim and flags redacted keys. It never
|
|
29
|
+
* reconstructs around a redaction.
|
|
30
|
+
*
|
|
31
|
+
* Why ids: every view names steps by `runtimeStageId`
|
|
32
|
+
* (`stageId#executionIndex`) — the universal key linking the commit log,
|
|
33
|
+
* the execution tree, and recorder events. The LLM drills like a debugger:
|
|
34
|
+
* overview → slice → node → value, paying only for what it opens.
|
|
35
|
+
*/
|
|
36
|
+
import { type Tool } from '../../core/tools.js';
|
|
37
|
+
import { type TraceToolpackArtifacts, type TraceToolpackOptions } from './types.js';
|
|
38
|
+
/**
|
|
39
|
+
* Build the introspection toolpack over a COMPLETED run's artifacts.
|
|
40
|
+
*
|
|
41
|
+
* Returns plain `Tool[]`:
|
|
42
|
+
*
|
|
43
|
+
* | Tool | Question it answers |
|
|
44
|
+
* |------------------|-----------------------------------------------------------|
|
|
45
|
+
* | `run_overview` | What happened, broadly? (the entry point) |
|
|
46
|
+
* | `trace_node` | What did step X read/write, and where did its inputs come from? |
|
|
47
|
+
* | `trace_slice` | Which chain of steps produced the data at X? (causal slice) |
|
|
48
|
+
* | `who_wrote` | Which step last wrote key K? |
|
|
49
|
+
* | `get_value` | The full value of K as of step X (capped, truncation-marked) |
|
|
50
|
+
* | `read_narrative` | The human-readable story, paginated (only when narrative provided) |
|
|
51
|
+
*
|
|
52
|
+
* Mount on an Agent (`Agent.create({...}).tool(...tools)`) or drive scripted
|
|
53
|
+
* via {@link callTraceTool}. The tools NEVER throw on bad ids/keys — they
|
|
54
|
+
* return corrective, model-visible messages (the #9 philosophy), and their
|
|
55
|
+
* strict input schemas give Agent-dispatched calls free arg validation.
|
|
56
|
+
*
|
|
57
|
+
* Security note (B13 posture): trace content can carry adversarial text from
|
|
58
|
+
* the original run (tool results, user input). Serve these tools to a
|
|
59
|
+
* SEPARATE debugging session over completed runs — not to the production
|
|
60
|
+
* agent mid-run — and treat tool outputs as data, not instructions.
|
|
61
|
+
*/
|
|
62
|
+
export declare function traceToolpack(artifacts: TraceToolpackArtifacts, options?: TraceToolpackOptions): Tool[];
|
|
63
|
+
/**
|
|
64
|
+
* Invoke a toolpack tool OUTSIDE an Agent (scripted debug sessions, tests,
|
|
65
|
+
* offline auditors). Mirrors the Agent's #9 boundary: args are validated
|
|
66
|
+
* against the tool's inputSchema first, and an invalid call returns the same
|
|
67
|
+
* model-visible correction string instead of executing.
|
|
68
|
+
*/
|
|
69
|
+
export declare function callTraceTool(tools: readonly Tool[], name: string, args?: Record<string, unknown>): Promise<string>;
|
|
70
|
+
//# sourceMappingURL=traceToolpack.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"traceToolpack.d.ts","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/traceToolpack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAc,KAAK,IAAI,EAA6B,MAAM,qBAAqB,CAAC;AAWvF,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAiNpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,sBAAsB,EACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,EAAE,CAeR;AA8jBD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,MAAM,CAAC,CASjB"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Trace toolpack types — RFC-003 Part C (the introspection toolpack).
|
|
3
|
+
*
|
|
4
|
+
* Pattern: artifact bag — everything a debugging LLM needs to navigate a
|
|
5
|
+
* COMPLETED run, captured once and handed to `traceToolpack()`.
|
|
6
|
+
* Role: Input contract. The toolpack never re-runs anything; it serves
|
|
7
|
+
* bounded, id-addressed views over these frozen artifacts.
|
|
8
|
+
*/
|
|
9
|
+
import type { RuntimeSnapshot } from 'footprintjs';
|
|
10
|
+
import type { ControlDepLookup } from 'footprintjs/trace';
|
|
11
|
+
/**
|
|
12
|
+
* The frozen evidence of one completed run.
|
|
13
|
+
*
|
|
14
|
+
* - `snapshot` — `executor.getSnapshot()`. Carries the commit log (what every
|
|
15
|
+
* step wrote, with verbs + redaction + `untrackedSources` honesty markers),
|
|
16
|
+
* the execution tree (per-step name/description/reads/errors), the final
|
|
17
|
+
* shared state, and the `commitValues` mode discriminant.
|
|
18
|
+
* - `controlDeps` — OPTIONAL `controlDepRecorder().asLookup()` from the run.
|
|
19
|
+
* With it, causal slices include `[control: <rule label>]` edges to the
|
|
20
|
+
* decider that routed execution. Without it, slices say so explicitly.
|
|
21
|
+
* - `narrative` — OPTIONAL narrative lines (e.g. rendered from
|
|
22
|
+
* `executor.getNarrativeEntries()`). When present, a `read_narrative` tool
|
|
23
|
+
* is added for bounded, paginated access to the human-readable story.
|
|
24
|
+
*/
|
|
25
|
+
export interface TraceToolpackArtifacts {
|
|
26
|
+
readonly snapshot: RuntimeSnapshot;
|
|
27
|
+
readonly controlDeps?: ControlDepLookup;
|
|
28
|
+
readonly narrative?: readonly string[];
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Bounding dials. Every output is bounded BY DEFAULT — these set the
|
|
32
|
+
* defaults; per-call params (`maxDepth`, `maxNodes`, `maxChars`, `maxLines`)
|
|
33
|
+
* let the LLM ask for more up to hard caps the consumer cannot exceed.
|
|
34
|
+
*/
|
|
35
|
+
export interface TraceToolpackOptions {
|
|
36
|
+
/** Value-preview length in chars (trace_node / who_wrote). Default 160. */
|
|
37
|
+
readonly previewChars?: number;
|
|
38
|
+
/** Default causal-slice depth for trace_slice. Default 6 (hard cap 20). */
|
|
39
|
+
readonly sliceMaxDepth?: number;
|
|
40
|
+
/** Default causal-slice node budget for trace_slice. Default 25 (hard cap 100). */
|
|
41
|
+
readonly sliceMaxNodes?: number;
|
|
42
|
+
/** Default char budget for get_value. Default 2000 (hard cap 8000). */
|
|
43
|
+
readonly valueMaxChars?: number;
|
|
44
|
+
}
|
|
45
|
+
/** Resolved options with defaults applied (internal). */
|
|
46
|
+
export interface ResolvedToolpackOptions {
|
|
47
|
+
readonly previewChars: number;
|
|
48
|
+
readonly sliceMaxDepth: number;
|
|
49
|
+
readonly sliceMaxNodes: number;
|
|
50
|
+
readonly valueMaxChars: number;
|
|
51
|
+
}
|
|
52
|
+
/** Hard caps — per-call params clamp to these regardless of what the LLM asks for. */
|
|
53
|
+
export declare const TOOLPACK_HARD_CAPS: {
|
|
54
|
+
readonly sliceMaxDepth: 20;
|
|
55
|
+
readonly sliceMaxNodes: 100;
|
|
56
|
+
readonly valueMaxChars: 8000;
|
|
57
|
+
readonly narrativeMaxLines: 200;
|
|
58
|
+
};
|
|
59
|
+
export declare function resolveToolpackOptions(options?: TraceToolpackOptions): ResolvedToolpackOptions;
|
|
60
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,yDAAyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,sFAAsF;AACtF,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,uBAAuB,CAO9F"}
|
package/dist/types/observe.d.ts
CHANGED
|
@@ -50,4 +50,6 @@ export { attachStatus, type StatusEvent, type StatusOptions, } from './recorders
|
|
|
50
50
|
export { toolLineageRecorder, type ToolLineageRecorderHandle, type ToolLineageOptions, type ToolLineageGraph, type ToolLineageEdge, type ToolCallRef, } from './recorders/observability/ToolLineageRecorder.js';
|
|
51
51
|
export { agentThinkingTrace, type AgentThinkingTraceHandle, type AgentThinkingTraceOptions, type AttTrace, type AttStep, type AttCost, type AttAnswer, type AttToolSeen, } from './recorders/observability/AgentThinkingTraceRecorder.js';
|
|
52
52
|
export { typedEmit } from './recorders/core/typedEmit.js';
|
|
53
|
+
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';
|
|
54
|
+
export { callTraceTool, TOOLPACK_HARD_CAPS, traceToolpack, type TraceToolpackArtifacts, type TraceToolpackOptions, } from './lib/trace-toolpack/index.js';
|
|
53
55
|
//# sourceMappingURL=observe.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/observe.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/observe.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentfootprint",
|
|
3
|
-
"version": "6.
|
|
3
|
+
"version": "6.24.0",
|
|
4
4
|
"description": "The explainable agent framework — build AI agents you can explain, audit, and trust. Built on footprintjs.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Sanjay Krishna Anbalagan",
|
|
@@ -184,7 +184,7 @@
|
|
|
184
184
|
"@aws-sdk/client-xray": "*",
|
|
185
185
|
"@modelcontextprotocol/sdk": "*",
|
|
186
186
|
"@opentelemetry/api": "*",
|
|
187
|
-
"footprintjs": "^9.
|
|
187
|
+
"footprintjs": "^9.8.0",
|
|
188
188
|
"ioredis": "*",
|
|
189
189
|
"openai": "*",
|
|
190
190
|
"zod": "*"
|
|
@@ -229,7 +229,7 @@
|
|
|
229
229
|
"esbuild": "^0.28.0",
|
|
230
230
|
"eslint": "^8.44.0",
|
|
231
231
|
"eslint-config-prettier": "^6.15.0",
|
|
232
|
-
"footprintjs": "^9.
|
|
232
|
+
"footprintjs": "^9.8.0",
|
|
233
233
|
"prettier": "^2.8.1",
|
|
234
234
|
"typedoc": "^0.28.19",
|
|
235
235
|
"typedoc-plugin-markdown": "^4.11.0",
|