agentfootprint 6.45.0 → 7.0.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/AGENTS.md +4 -0
- package/CLAUDE.md +4 -0
- package/README.md +141 -167
- package/ai-instructions/claude-code/SKILL.md +11 -0
- package/dist/adapters/llm/BrowserOpenAIProvider.js +1 -1
- package/dist/adapters/llm/MockProvider.js +2 -1
- package/dist/adapters/llm/MockProvider.js.map +1 -1
- package/dist/debug/finders.js +29 -0
- package/dist/debug/finders.js.map +1 -0
- package/dist/debug.js +134 -0
- package/dist/debug.js.map +1 -0
- package/dist/esm/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
- package/dist/esm/adapters/llm/BrowserOpenAIProvider.js +1 -1
- package/dist/esm/adapters/llm/MockProvider.d.ts +2 -1
- package/dist/esm/adapters/llm/MockProvider.js +2 -1
- package/dist/esm/adapters/llm/MockProvider.js.map +1 -1
- package/dist/esm/debug/finders.d.ts +12 -0
- package/dist/esm/debug/finders.js +13 -0
- package/dist/esm/debug/finders.js.map +1 -0
- package/dist/esm/debug.d.ts +25 -0
- package/dist/esm/debug.js +54 -0
- package/dist/esm/debug.js.map +1 -0
- package/dist/esm/events.d.ts +18 -0
- package/dist/esm/events.js +22 -0
- package/dist/esm/events.js.map +1 -0
- package/dist/esm/index.d.ts +4 -24
- package/dist/esm/index.js +7 -54
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/lib/injection-engine/index.d.ts +1 -1
- package/dist/esm/lib/injection-engine/index.js +1 -1
- package/dist/esm/lib/injection-engine/index.js.map +1 -1
- package/dist/esm/lib/injection-engine/skillGraph.d.ts +3 -2
- package/dist/esm/lib/injection-engine/skillGraph.js +3 -2
- package/dist/esm/lib/injection-engine/skillGraph.js.map +1 -1
- package/dist/esm/lib/rag/defineRAG.d.ts +3 -3
- package/dist/esm/lib/rag/defineRAG.js +3 -3
- package/dist/esm/lib/rag/indexDocuments.d.ts +2 -1
- package/dist/esm/lib/rag/indexDocuments.js +2 -1
- package/dist/esm/lib/rag/indexDocuments.js.map +1 -1
- package/dist/esm/locales/index.d.ts +9 -0
- package/dist/esm/locales/index.js +7 -0
- package/dist/esm/locales/index.js.map +1 -1
- package/dist/esm/memory/causal/types.d.ts +13 -9
- package/dist/esm/memory/causal/types.js.map +1 -1
- package/dist/esm/memory/define.types.d.ts +5 -3
- package/dist/esm/memory/define.types.js +5 -3
- package/dist/esm/memory/define.types.js.map +1 -1
- package/dist/esm/observe.d.ts +1 -6
- package/dist/esm/observe.js +7 -36
- package/dist/esm/observe.js.map +1 -1
- package/dist/esm/providers.d.ts +2 -2
- package/dist/esm/providers.js +1 -1
- package/dist/esm/providers.js.map +1 -1
- package/dist/esm/status.d.ts +10 -4
- package/dist/esm/status.js +13 -4
- package/dist/esm/status.js.map +1 -1
- package/dist/esm/tool-providers/index.d.ts +1 -1
- package/dist/events.js +42 -0
- package/dist/events.js.map +1 -0
- package/dist/index.js +7 -121
- package/dist/index.js.map +1 -1
- package/dist/lib/injection-engine/index.js +2 -2
- package/dist/lib/injection-engine/index.js.map +1 -1
- package/dist/lib/injection-engine/skillGraph.js +5 -4
- package/dist/lib/injection-engine/skillGraph.js.map +1 -1
- package/dist/lib/rag/defineRAG.js +3 -3
- package/dist/lib/rag/indexDocuments.js +2 -1
- package/dist/lib/rag/indexDocuments.js.map +1 -1
- package/dist/locales/index.js +2 -1
- package/dist/locales/index.js.map +1 -1
- package/dist/memory/causal/types.js.map +1 -1
- package/dist/memory/define.types.js +5 -3
- package/dist/memory/define.types.js.map +1 -1
- package/dist/observe.js +22 -115
- package/dist/observe.js.map +1 -1
- package/dist/providers.js +3 -1
- package/dist/providers.js.map +1 -1
- package/dist/status.js +13 -5
- package/dist/status.js.map +1 -1
- package/dist/types/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
- package/dist/types/adapters/llm/MockProvider.d.ts +2 -1
- package/dist/types/adapters/llm/MockProvider.d.ts.map +1 -1
- package/dist/types/debug/finders.d.ts +13 -0
- package/dist/types/debug/finders.d.ts.map +1 -0
- package/dist/types/debug.d.ts +26 -0
- package/dist/types/debug.d.ts.map +1 -0
- package/dist/types/events.d.ts +19 -0
- package/dist/types/events.d.ts.map +1 -0
- package/dist/types/index.d.ts +4 -24
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/lib/injection-engine/index.d.ts +1 -1
- package/dist/types/lib/injection-engine/index.d.ts.map +1 -1
- package/dist/types/lib/injection-engine/skillGraph.d.ts +3 -2
- package/dist/types/lib/injection-engine/skillGraph.d.ts.map +1 -1
- package/dist/types/lib/rag/defineRAG.d.ts +3 -3
- package/dist/types/lib/rag/indexDocuments.d.ts +2 -1
- package/dist/types/lib/rag/indexDocuments.d.ts.map +1 -1
- package/dist/types/locales/index.d.ts +9 -0
- package/dist/types/locales/index.d.ts.map +1 -1
- package/dist/types/memory/causal/types.d.ts +13 -9
- package/dist/types/memory/causal/types.d.ts.map +1 -1
- package/dist/types/memory/define.types.d.ts +5 -3
- package/dist/types/memory/define.types.d.ts.map +1 -1
- package/dist/types/observe.d.ts +1 -6
- package/dist/types/observe.d.ts.map +1 -1
- package/dist/types/providers.d.ts +2 -2
- package/dist/types/providers.d.ts.map +1 -1
- package/dist/types/status.d.ts +10 -4
- package/dist/types/status.d.ts.map +1 -1
- package/dist/types/tool-providers/index.d.ts +1 -1
- package/dist/types/tool-providers/index.d.ts.map +1 -1
- package/package.json +59 -2
package/dist/debug.js
ADDED
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* agentfootprint/debug — diagnosis tools for a BROKEN run.
|
|
4
|
+
*
|
|
5
|
+
* Where `agentfootprint/observe` watches a HEALTHY run (recorders), this
|
|
6
|
+
* subpath is the autopsy kit for a wrong answer. Split out of `observe` in
|
|
7
|
+
* the surface cleanup — same code, dedicated home, so the import path now
|
|
8
|
+
* matches the Debug docs category. The honesty discipline is unchanged:
|
|
9
|
+
* scores/weights are embedding-geometry PROXIES; ablation verdicts are the
|
|
10
|
+
* ONLY causal claims; slice completeness is bounded by tracking — and says so.
|
|
11
|
+
*
|
|
12
|
+
* Four libraries:
|
|
13
|
+
* • influence-core — embedding-based scoring (proxy, never causal)
|
|
14
|
+
* • trace-toolpack — traceToolpack + traceDebugAgent + `.selfExplain()`
|
|
15
|
+
* • context-bisect — localizeContextBug + ablation/restoration probes
|
|
16
|
+
* • tool-lint — build-time tool-catalog confusability lint
|
|
17
|
+
*
|
|
18
|
+
* For backward compatibility these are ALSO re-exported (deprecated) from
|
|
19
|
+
* `agentfootprint/observe` for one transition version.
|
|
20
|
+
*/
|
|
21
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
22
|
+
exports.llmCallIdsFromEvents = exports.formatContextBugReport = exports.findDroppedContext = exports.defaultSuspectClassifier = exports.defaultOutcomeComparator = exports.CONTEXT_BISECT_DEFAULTS = exports.findLoopHeads = exports.classifySuspect = exports.DEFAULT_RECENCY_DECAY = exports.buildWriterFrameIndex = exports.walkTrajectory = exports.walkToRoot = exports.shortlistEarlyCulprits = exports.bucketByAnchors = exports.bisectCulprits = exports.assignCostVerdicts = exports.assembleTrajectory = exports.applyAblations = exports.ablationForSuspect = exports.traceDebugAgent = exports.SelfExplainBinding = exports.buildSelfExplainToolProvider = exports.buildSelfExplainSkill = exports.traceToolpack = exports.TOOLPACK_HARD_CAPS = exports.NO_COMPLETED_RUN_MESSAGE = exports.lazyTraceToolpack = exports.callTraceTool = exports.structuralProximity = exports.scoreMargin = exports.scoreInfluence = exports.scoreContrastiveInfluence = exports.ratioStrategy = exports.rankingConfidence = exports.persistence = exports.pairwiseSimilarity = exports.marginStrategy = exports.finalAnswerSimilarity = exports.embeddingCache = exports.EmbeddingCache = exports.DEFAULT_SHORTLIST_BAND = exports.DEFAULT_PERSISTENCE_THRESHOLD = exports.DEFAULT_MARGIN_THRESHOLD = exports.DEFAULT_INFLUENCE_WEIGHTS = exports.DEFAULT_CLEAR_WINNER_RATIO = exports.DEFAULT_CLEAR_WINNER_MARGIN = exports.contentHash = exports.compositeScore = exports.averageRelevancy = exports.adaptWeights = void 0;
|
|
23
|
+
exports.saysWhatNotWhenRule = exports.runToolLintCli = exports.optionalParamRule = exports.MOCK_EMBEDDER_CALIBRATION = exports.formatToolCatalogReport = exports.enumInProseRule = exports.differentiationHint = exports.descriptionRule = exports.defaultStructuralRules = exports.DEFAULT_WHEN_CUES = exports.DEFAULT_WATCH_BAND = exports.DEFAULT_OMISSION_CUES = exports.DEFAULT_CONFUSABILITY_THRESHOLD = exports.confusabilityText = exports.coerceCatalog = exports.catalogFromTools = exports.analyzeToolCatalog = exports.toBacktrackTrace = exports.verdictFor = exports.suspectLabel = exports.stepOutputText = exports.runRestorationProbe = exports.runAblationProbe = exports.probeFlipped = exports.localizeContextBug = exports.llmEdgeWeigher = void 0;
|
|
24
|
+
// influence-core — the ONE embedding-based scoring engine (RFC-002/003
|
|
25
|
+
// block D6). Not a recorder: pure, embedder-injected scoring functions
|
|
26
|
+
// + the shared bounded embedding cache. Honest claim: every score is an
|
|
27
|
+
// embedding-geometry PROXY — semantic alignment, never model internals,
|
|
28
|
+
// never causal attribution.
|
|
29
|
+
var index_js_1 = require("./lib/influence-core/index.js");
|
|
30
|
+
Object.defineProperty(exports, "adaptWeights", { enumerable: true, get: function () { return index_js_1.adaptWeights; } });
|
|
31
|
+
Object.defineProperty(exports, "averageRelevancy", { enumerable: true, get: function () { return index_js_1.averageRelevancy; } });
|
|
32
|
+
Object.defineProperty(exports, "compositeScore", { enumerable: true, get: function () { return index_js_1.compositeScore; } });
|
|
33
|
+
Object.defineProperty(exports, "contentHash", { enumerable: true, get: function () { return index_js_1.contentHash; } });
|
|
34
|
+
Object.defineProperty(exports, "DEFAULT_CLEAR_WINNER_MARGIN", { enumerable: true, get: function () { return index_js_1.DEFAULT_CLEAR_WINNER_MARGIN; } });
|
|
35
|
+
Object.defineProperty(exports, "DEFAULT_CLEAR_WINNER_RATIO", { enumerable: true, get: function () { return index_js_1.DEFAULT_CLEAR_WINNER_RATIO; } });
|
|
36
|
+
Object.defineProperty(exports, "DEFAULT_INFLUENCE_WEIGHTS", { enumerable: true, get: function () { return index_js_1.DEFAULT_INFLUENCE_WEIGHTS; } });
|
|
37
|
+
Object.defineProperty(exports, "DEFAULT_MARGIN_THRESHOLD", { enumerable: true, get: function () { return index_js_1.DEFAULT_MARGIN_THRESHOLD; } });
|
|
38
|
+
Object.defineProperty(exports, "DEFAULT_PERSISTENCE_THRESHOLD", { enumerable: true, get: function () { return index_js_1.DEFAULT_PERSISTENCE_THRESHOLD; } });
|
|
39
|
+
Object.defineProperty(exports, "DEFAULT_SHORTLIST_BAND", { enumerable: true, get: function () { return index_js_1.DEFAULT_SHORTLIST_BAND; } });
|
|
40
|
+
Object.defineProperty(exports, "EmbeddingCache", { enumerable: true, get: function () { return index_js_1.EmbeddingCache; } });
|
|
41
|
+
Object.defineProperty(exports, "embeddingCache", { enumerable: true, get: function () { return index_js_1.embeddingCache; } });
|
|
42
|
+
Object.defineProperty(exports, "finalAnswerSimilarity", { enumerable: true, get: function () { return index_js_1.finalAnswerSimilarity; } });
|
|
43
|
+
Object.defineProperty(exports, "marginStrategy", { enumerable: true, get: function () { return index_js_1.marginStrategy; } });
|
|
44
|
+
Object.defineProperty(exports, "pairwiseSimilarity", { enumerable: true, get: function () { return index_js_1.pairwiseSimilarity; } });
|
|
45
|
+
Object.defineProperty(exports, "persistence", { enumerable: true, get: function () { return index_js_1.persistence; } });
|
|
46
|
+
Object.defineProperty(exports, "rankingConfidence", { enumerable: true, get: function () { return index_js_1.rankingConfidence; } });
|
|
47
|
+
Object.defineProperty(exports, "ratioStrategy", { enumerable: true, get: function () { return index_js_1.ratioStrategy; } });
|
|
48
|
+
Object.defineProperty(exports, "scoreContrastiveInfluence", { enumerable: true, get: function () { return index_js_1.scoreContrastiveInfluence; } });
|
|
49
|
+
Object.defineProperty(exports, "scoreInfluence", { enumerable: true, get: function () { return index_js_1.scoreInfluence; } });
|
|
50
|
+
Object.defineProperty(exports, "scoreMargin", { enumerable: true, get: function () { return index_js_1.scoreMargin; } });
|
|
51
|
+
Object.defineProperty(exports, "structuralProximity", { enumerable: true, get: function () { return index_js_1.structuralProximity; } });
|
|
52
|
+
// Introspection toolpack (RFC-003 Part C) — footprintjs trace evidence
|
|
53
|
+
// exposed as TOOLS a debugging LLM calls over a COMPLETED run's artifacts.
|
|
54
|
+
// Bounded, honest (⚠ markers), redaction-respecting, id-navigable.
|
|
55
|
+
var index_js_2 = require("./lib/trace-toolpack/index.js");
|
|
56
|
+
Object.defineProperty(exports, "callTraceTool", { enumerable: true, get: function () { return index_js_2.callTraceTool; } });
|
|
57
|
+
Object.defineProperty(exports, "lazyTraceToolpack", { enumerable: true, get: function () { return index_js_2.lazyTraceToolpack; } });
|
|
58
|
+
Object.defineProperty(exports, "NO_COMPLETED_RUN_MESSAGE", { enumerable: true, get: function () { return index_js_2.NO_COMPLETED_RUN_MESSAGE; } });
|
|
59
|
+
Object.defineProperty(exports, "TOOLPACK_HARD_CAPS", { enumerable: true, get: function () { return index_js_2.TOOLPACK_HARD_CAPS; } });
|
|
60
|
+
Object.defineProperty(exports, "traceToolpack", { enumerable: true, get: function () { return index_js_2.traceToolpack; } });
|
|
61
|
+
// The two conversational doors over the toolpack: a DEDICATED debugger
|
|
62
|
+
// agent (separate session, any provider — cheap models welcome), and the
|
|
63
|
+
// in-conversation `.selfExplain()` builder option's types. Same evidence,
|
|
64
|
+
// same honesty discipline as the UI doors (BacktrackView / Lens).
|
|
65
|
+
var index_js_3 = require("./lib/trace-toolpack/index.js");
|
|
66
|
+
Object.defineProperty(exports, "buildSelfExplainSkill", { enumerable: true, get: function () { return index_js_3.buildSelfExplainSkill; } });
|
|
67
|
+
Object.defineProperty(exports, "buildSelfExplainToolProvider", { enumerable: true, get: function () { return index_js_3.buildSelfExplainToolProvider; } });
|
|
68
|
+
Object.defineProperty(exports, "SelfExplainBinding", { enumerable: true, get: function () { return index_js_3.SelfExplainBinding; } });
|
|
69
|
+
Object.defineProperty(exports, "traceDebugAgent", { enumerable: true, get: function () { return index_js_3.traceDebugAgent; } });
|
|
70
|
+
// Contextual-bug localizer (RFC-003 Part B, D7–D9) — "git bisect for
|
|
71
|
+
// context". Assembly: footprintjs causal DAG (control edges + honesty
|
|
72
|
+
// markers + EdgeWeigher) × influence-core scoring (D6) × consumer-run
|
|
73
|
+
// counterfactual ablation. §B2 claim tiers: scores/weights are
|
|
74
|
+
// embedding-geometry PROXIES; ablation verdicts are the ONLY causal
|
|
75
|
+
// claims; slice completeness is bounded by tracking — and says so.
|
|
76
|
+
var index_js_4 = require("./lib/context-bisect/index.js");
|
|
77
|
+
Object.defineProperty(exports, "ablationForSuspect", { enumerable: true, get: function () { return index_js_4.ablationForSuspect; } });
|
|
78
|
+
Object.defineProperty(exports, "applyAblations", { enumerable: true, get: function () { return index_js_4.applyAblations; } });
|
|
79
|
+
Object.defineProperty(exports, "assembleTrajectory", { enumerable: true, get: function () { return index_js_4.assembleTrajectory; } });
|
|
80
|
+
Object.defineProperty(exports, "assignCostVerdicts", { enumerable: true, get: function () { return index_js_4.assignCostVerdicts; } });
|
|
81
|
+
Object.defineProperty(exports, "bisectCulprits", { enumerable: true, get: function () { return index_js_4.bisectCulprits; } });
|
|
82
|
+
Object.defineProperty(exports, "bucketByAnchors", { enumerable: true, get: function () { return index_js_4.bucketByAnchors; } });
|
|
83
|
+
Object.defineProperty(exports, "shortlistEarlyCulprits", { enumerable: true, get: function () { return index_js_4.shortlistEarlyCulprits; } });
|
|
84
|
+
Object.defineProperty(exports, "walkToRoot", { enumerable: true, get: function () { return index_js_4.walkToRoot; } });
|
|
85
|
+
Object.defineProperty(exports, "walkTrajectory", { enumerable: true, get: function () { return index_js_4.walkTrajectory; } });
|
|
86
|
+
Object.defineProperty(exports, "buildWriterFrameIndex", { enumerable: true, get: function () { return index_js_4.buildWriterFrameIndex; } });
|
|
87
|
+
Object.defineProperty(exports, "DEFAULT_RECENCY_DECAY", { enumerable: true, get: function () { return index_js_4.DEFAULT_RECENCY_DECAY; } });
|
|
88
|
+
Object.defineProperty(exports, "classifySuspect", { enumerable: true, get: function () { return index_js_4.classifySuspect; } });
|
|
89
|
+
Object.defineProperty(exports, "findLoopHeads", { enumerable: true, get: function () { return index_js_4.findLoopHeads; } });
|
|
90
|
+
Object.defineProperty(exports, "CONTEXT_BISECT_DEFAULTS", { enumerable: true, get: function () { return index_js_4.CONTEXT_BISECT_DEFAULTS; } });
|
|
91
|
+
Object.defineProperty(exports, "defaultOutcomeComparator", { enumerable: true, get: function () { return index_js_4.defaultOutcomeComparator; } });
|
|
92
|
+
Object.defineProperty(exports, "defaultSuspectClassifier", { enumerable: true, get: function () { return index_js_4.defaultSuspectClassifier; } });
|
|
93
|
+
Object.defineProperty(exports, "findDroppedContext", { enumerable: true, get: function () { return index_js_4.findDroppedContext; } });
|
|
94
|
+
Object.defineProperty(exports, "formatContextBugReport", { enumerable: true, get: function () { return index_js_4.formatContextBugReport; } });
|
|
95
|
+
Object.defineProperty(exports, "llmCallIdsFromEvents", { enumerable: true, get: function () { return index_js_4.llmCallIdsFromEvents; } });
|
|
96
|
+
Object.defineProperty(exports, "llmEdgeWeigher", { enumerable: true, get: function () { return index_js_4.llmEdgeWeigher; } });
|
|
97
|
+
Object.defineProperty(exports, "localizeContextBug", { enumerable: true, get: function () { return index_js_4.localizeContextBug; } });
|
|
98
|
+
Object.defineProperty(exports, "probeFlipped", { enumerable: true, get: function () { return index_js_4.probeFlipped; } });
|
|
99
|
+
Object.defineProperty(exports, "runAblationProbe", { enumerable: true, get: function () { return index_js_4.runAblationProbe; } });
|
|
100
|
+
Object.defineProperty(exports, "runRestorationProbe", { enumerable: true, get: function () { return index_js_4.runRestorationProbe; } });
|
|
101
|
+
Object.defineProperty(exports, "stepOutputText", { enumerable: true, get: function () { return index_js_4.stepOutputText; } });
|
|
102
|
+
Object.defineProperty(exports, "suspectLabel", { enumerable: true, get: function () { return index_js_4.suspectLabel; } });
|
|
103
|
+
Object.defineProperty(exports, "verdictFor", { enumerable: true, get: function () { return index_js_4.verdictFor; } });
|
|
104
|
+
// BacktrackTrace serializer — feeds agentThinkingUI's <BacktrackView>
|
|
105
|
+
// (the "why?" board) straight off a localizer report. Pure mapping, no
|
|
106
|
+
// UI dependency; the interfaces mirror agentthinkingui's contract.
|
|
107
|
+
var index_js_5 = require("./lib/context-bisect/index.js");
|
|
108
|
+
Object.defineProperty(exports, "toBacktrackTrace", { enumerable: true, get: function () { return index_js_5.toBacktrackTrace; } });
|
|
109
|
+
// Tool-catalog confusability lint (RFC-002 tier 1, C1–C3) — build-time,
|
|
110
|
+
// CI-gateable, framework-agnostic: plain { name, description?, inputSchema? }
|
|
111
|
+
// tools in (OpenAI/Anthropic/MCP lists coerce via coerceCatalog; the
|
|
112
|
+
// library's Tool[] via catalogFromTools), a report with a gateable `ok`
|
|
113
|
+
// out. Pluggable structural rule pack; thresholds + embedder consumer-
|
|
114
|
+
// injected with our defaults. Bin: `agentfootprint-lint-tools`.
|
|
115
|
+
// Front door: docs/guides/tool-catalog-lint.md.
|
|
116
|
+
var index_js_6 = require("./lib/tool-lint/index.js");
|
|
117
|
+
Object.defineProperty(exports, "analyzeToolCatalog", { enumerable: true, get: function () { return index_js_6.analyzeToolCatalog; } });
|
|
118
|
+
Object.defineProperty(exports, "catalogFromTools", { enumerable: true, get: function () { return index_js_6.catalogFromTools; } });
|
|
119
|
+
Object.defineProperty(exports, "coerceCatalog", { enumerable: true, get: function () { return index_js_6.coerceCatalog; } });
|
|
120
|
+
Object.defineProperty(exports, "confusabilityText", { enumerable: true, get: function () { return index_js_6.confusabilityText; } });
|
|
121
|
+
Object.defineProperty(exports, "DEFAULT_CONFUSABILITY_THRESHOLD", { enumerable: true, get: function () { return index_js_6.DEFAULT_CONFUSABILITY_THRESHOLD; } });
|
|
122
|
+
Object.defineProperty(exports, "DEFAULT_OMISSION_CUES", { enumerable: true, get: function () { return index_js_6.DEFAULT_OMISSION_CUES; } });
|
|
123
|
+
Object.defineProperty(exports, "DEFAULT_WATCH_BAND", { enumerable: true, get: function () { return index_js_6.DEFAULT_WATCH_BAND; } });
|
|
124
|
+
Object.defineProperty(exports, "DEFAULT_WHEN_CUES", { enumerable: true, get: function () { return index_js_6.DEFAULT_WHEN_CUES; } });
|
|
125
|
+
Object.defineProperty(exports, "defaultStructuralRules", { enumerable: true, get: function () { return index_js_6.defaultStructuralRules; } });
|
|
126
|
+
Object.defineProperty(exports, "descriptionRule", { enumerable: true, get: function () { return index_js_6.descriptionRule; } });
|
|
127
|
+
Object.defineProperty(exports, "differentiationHint", { enumerable: true, get: function () { return index_js_6.differentiationHint; } });
|
|
128
|
+
Object.defineProperty(exports, "enumInProseRule", { enumerable: true, get: function () { return index_js_6.enumInProseRule; } });
|
|
129
|
+
Object.defineProperty(exports, "formatToolCatalogReport", { enumerable: true, get: function () { return index_js_6.formatToolCatalogReport; } });
|
|
130
|
+
Object.defineProperty(exports, "MOCK_EMBEDDER_CALIBRATION", { enumerable: true, get: function () { return index_js_6.MOCK_EMBEDDER_CALIBRATION; } });
|
|
131
|
+
Object.defineProperty(exports, "optionalParamRule", { enumerable: true, get: function () { return index_js_6.optionalParamRule; } });
|
|
132
|
+
Object.defineProperty(exports, "runToolLintCli", { enumerable: true, get: function () { return index_js_6.runToolLintCli; } });
|
|
133
|
+
Object.defineProperty(exports, "saysWhatNotWhenRule", { enumerable: true, get: function () { return index_js_6.saysWhatNotWhenRule; } });
|
|
134
|
+
//# sourceMappingURL=debug.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"debug.js","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"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"}
|
|
@@ -78,7 +78,7 @@ export interface BrowserAzureOpenAIProviderOptions {
|
|
|
78
78
|
* proxy) or a backend. Same trade-off as `browserOpenai`.
|
|
79
79
|
*
|
|
80
80
|
* @example
|
|
81
|
-
* import { browserAzureOpenai } from 'agentfootprint';
|
|
81
|
+
* import { browserAzureOpenai } from 'agentfootprint/llm-providers';
|
|
82
82
|
* const provider = browserAzureOpenai({
|
|
83
83
|
* endpoint: 'https://my-co.openai.azure.com',
|
|
84
84
|
* apiKey: userKey, apiVersion: '2024-12-01-preview', deployment: 'gpt-4o-128k',
|
|
@@ -172,7 +172,7 @@ const AZURE_BROWSER_SHORTHANDS = new Set([
|
|
|
172
172
|
* proxy) or a backend. Same trade-off as `browserOpenai`.
|
|
173
173
|
*
|
|
174
174
|
* @example
|
|
175
|
-
* import { browserAzureOpenai } from 'agentfootprint';
|
|
175
|
+
* import { browserAzureOpenai } from 'agentfootprint/llm-providers';
|
|
176
176
|
* const provider = browserAzureOpenai({
|
|
177
177
|
* endpoint: 'https://my-co.openai.azure.com',
|
|
178
178
|
* apiKey: userKey, apiVersion: '2024-12-01-preview', deployment: 'gpt-4o-128k',
|
|
@@ -144,7 +144,8 @@ export declare class MockProvider implements LLMProvider {
|
|
|
144
144
|
* `new MockProvider(options)`.
|
|
145
145
|
*
|
|
146
146
|
* @example
|
|
147
|
-
* import { Agent,
|
|
147
|
+
* import { Agent, defineTool } from 'agentfootprint'
|
|
148
|
+
import { mock } from 'agentfootprint/llm-providers';
|
|
148
149
|
*
|
|
149
150
|
* const agent = Agent.create({ provider: mock({ reply: 'hello' }) })
|
|
150
151
|
* .tool(defineTool({ name: 'echo', ... }))
|
|
@@ -153,7 +153,8 @@ export class MockProvider {
|
|
|
153
153
|
* `new MockProvider(options)`.
|
|
154
154
|
*
|
|
155
155
|
* @example
|
|
156
|
-
* import { Agent,
|
|
156
|
+
* import { Agent, defineTool } from 'agentfootprint'
|
|
157
|
+
import { mock } from 'agentfootprint/llm-providers';
|
|
157
158
|
*
|
|
158
159
|
* const agent = Agent.create({ provider: mock({ reply: 'hello' }) })
|
|
159
160
|
* .tool(defineTool({ name: 'echo', ... }))
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MockProvider.js","sourceRoot":"","sources":["../../../../src/adapters/llm/MockProvider.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"MockProvider.js","sourceRoot":"","sources":["../../../../src/adapters/llm/MockProvider.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentfootprint/debug/finders — context-error finder strategies.
|
|
3
|
+
*
|
|
4
|
+
* Collapsed home for what was the 3-level-deep
|
|
5
|
+
* `agentfootprint/observability/contextError/finders` path. Same
|
|
6
|
+
* tree-shakeable, re-export-only barrel — one finder = one file = one
|
|
7
|
+
* named export — now under the Debug category where it belongs.
|
|
8
|
+
*
|
|
9
|
+
* The old `agentfootprint/observability/contextError/finders` path is kept
|
|
10
|
+
* (deprecated) for one transition version.
|
|
11
|
+
*/
|
|
12
|
+
export * from '../observability/contextError/finders/index.js';
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentfootprint/debug/finders — context-error finder strategies.
|
|
3
|
+
*
|
|
4
|
+
* Collapsed home for what was the 3-level-deep
|
|
5
|
+
* `agentfootprint/observability/contextError/finders` path. Same
|
|
6
|
+
* tree-shakeable, re-export-only barrel — one finder = one file = one
|
|
7
|
+
* named export — now under the Debug category where it belongs.
|
|
8
|
+
*
|
|
9
|
+
* The old `agentfootprint/observability/contextError/finders` path is kept
|
|
10
|
+
* (deprecated) for one transition version.
|
|
11
|
+
*/
|
|
12
|
+
export * from '../observability/contextError/finders/index.js';
|
|
13
|
+
//# sourceMappingURL=finders.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"finders.js","sourceRoot":"","sources":["../../../src/debug/finders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,gDAAgD,CAAC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentfootprint/debug — diagnosis tools for a BROKEN run.
|
|
3
|
+
*
|
|
4
|
+
* Where `agentfootprint/observe` watches a HEALTHY run (recorders), this
|
|
5
|
+
* subpath is the autopsy kit for a wrong answer. Split out of `observe` in
|
|
6
|
+
* the surface cleanup — same code, dedicated home, so the import path now
|
|
7
|
+
* matches the Debug docs category. The honesty discipline is unchanged:
|
|
8
|
+
* scores/weights are embedding-geometry PROXIES; ablation verdicts are the
|
|
9
|
+
* ONLY causal claims; slice completeness is bounded by tracking — and says so.
|
|
10
|
+
*
|
|
11
|
+
* Four libraries:
|
|
12
|
+
* • influence-core — embedding-based scoring (proxy, never causal)
|
|
13
|
+
* • trace-toolpack — traceToolpack + traceDebugAgent + `.selfExplain()`
|
|
14
|
+
* • context-bisect — localizeContextBug + ablation/restoration probes
|
|
15
|
+
* • tool-lint — build-time tool-catalog confusability lint
|
|
16
|
+
*
|
|
17
|
+
* For backward compatibility these are ALSO re-exported (deprecated) from
|
|
18
|
+
* `agentfootprint/observe` for one transition version.
|
|
19
|
+
*/
|
|
20
|
+
export { adaptWeights, averageRelevancy, compositeScore, contentHash, DEFAULT_CLEAR_WINNER_MARGIN, DEFAULT_CLEAR_WINNER_RATIO, DEFAULT_INFLUENCE_WEIGHTS, DEFAULT_MARGIN_THRESHOLD, DEFAULT_PERSISTENCE_THRESHOLD, DEFAULT_SHORTLIST_BAND, EmbeddingCache, embeddingCache, finalAnswerSimilarity, marginStrategy, pairwiseSimilarity, persistence, rankingConfidence, ratioStrategy, scoreContrastiveInfluence, scoreInfluence, scoreMargin, structuralProximity, type CandidateScore, type ConfidenceStrategy, type Embedder, type EmbeddingCacheOptions, type EmbeddingCacheStats, type EvidenceInput, type InfluenceScore, type InfluenceScorer, type InfluenceWeights, type MarginCandidate, type MarginResult, type PairwiseSimilarityArgs, type PairwiseSimilarityResult, type RankingConfidence, type RankingConfidenceOptions, type ScoreContrastiveInfluenceArgs, type ScoreInfluenceArgs, type ScoreMarginArgs, type SignalScores, type SimilarityItem, type SimilarityPair, } from './lib/influence-core/index.js';
|
|
21
|
+
export { callTraceTool, lazyTraceToolpack, NO_COMPLETED_RUN_MESSAGE, TOOLPACK_HARD_CAPS, traceToolpack, type TraceToolpackArtifacts, type TraceToolpackOptions, } from './lib/trace-toolpack/index.js';
|
|
22
|
+
export { buildSelfExplainSkill, buildSelfExplainToolProvider, SelfExplainBinding, traceDebugAgent, type SelfExplainOptions, type TraceDebugAgentOptions, } from './lib/trace-toolpack/index.js';
|
|
23
|
+
export { ablationForSuspect, applyAblations, assembleTrajectory, assignCostVerdicts, bisectCulprits, bucketByAnchors, shortlistEarlyCulprits, walkToRoot, walkTrajectory, buildWriterFrameIndex, DEFAULT_RECENCY_DECAY, classifySuspect, findLoopHeads, CONTEXT_BISECT_DEFAULTS, defaultOutcomeComparator, defaultSuspectClassifier, findDroppedContext, formatContextBugReport, llmCallIdsFromEvents, llmEdgeWeigher, localizeContextBug, probeFlipped, runAblationProbe, runRestorationProbe, stepOutputText, suspectLabel, verdictFor, type AblationRerun, type AblationRunner, type AblationRunStats, type AblationSpec, type AblationTargets, type AblationVerdict, type AblationVerdictKind, type AnchorBucket, type AssembleTrajectoryOptions, type LoopCandidate, type LoopRecallShortlist, type ShortlistEarlyCulpritsOptions, type RootCauseHop, type RootCauseNote, type RootCausePath, type WalkToRootOptions, type BisectCulpritsOptions, type BisectionProbe, type BisectionResult, type CapturedEventLike, type ClassifyContext, type ContextBugArtifacts, type ContextBugReport, type ContextSource, type ContextUnit, type CostRange, type CostStats, type CostVerdict, type DroppedUnit, type EdgePathStep, type LoopFrame, type HonestyFlag, type HonestyFlagKind, type LlmEdgeWeigherHandle, type LlmEdgeWeigherOptions, type LocalizeContextBugOptions, type MissingContextResult, type OutcomeComparator, type QualityTriggerLookup, type RankedParentEdge, type RestorationProbeConfig, type RestorationRerun, type RestorationRunner, type RestoredCandidate, type RunCost, type SimilarityStats, type SliceStats, type Suspect, type SuspectClass, type SuspectClassifier, type SuspectDetail, type SuspectKind, type SuspectSeed, type SyntheticQuestionNode, type Trajectory, } from './lib/context-bisect/index.js';
|
|
24
|
+
export { toBacktrackTrace, type BacktrackCustodyHop, type BacktrackHop, type BacktrackSuspectCard, type BacktrackTrace, type BacktrackTrail, type ToBacktrackTraceOptions, } from './lib/context-bisect/index.js';
|
|
25
|
+
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';
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentfootprint/debug — diagnosis tools for a BROKEN run.
|
|
3
|
+
*
|
|
4
|
+
* Where `agentfootprint/observe` watches a HEALTHY run (recorders), this
|
|
5
|
+
* subpath is the autopsy kit for a wrong answer. Split out of `observe` in
|
|
6
|
+
* the surface cleanup — same code, dedicated home, so the import path now
|
|
7
|
+
* matches the Debug docs category. The honesty discipline is unchanged:
|
|
8
|
+
* scores/weights are embedding-geometry PROXIES; ablation verdicts are the
|
|
9
|
+
* ONLY causal claims; slice completeness is bounded by tracking — and says so.
|
|
10
|
+
*
|
|
11
|
+
* Four libraries:
|
|
12
|
+
* • influence-core — embedding-based scoring (proxy, never causal)
|
|
13
|
+
* • trace-toolpack — traceToolpack + traceDebugAgent + `.selfExplain()`
|
|
14
|
+
* • context-bisect — localizeContextBug + ablation/restoration probes
|
|
15
|
+
* • tool-lint — build-time tool-catalog confusability lint
|
|
16
|
+
*
|
|
17
|
+
* For backward compatibility these are ALSO re-exported (deprecated) from
|
|
18
|
+
* `agentfootprint/observe` for one transition version.
|
|
19
|
+
*/
|
|
20
|
+
// influence-core — the ONE embedding-based scoring engine (RFC-002/003
|
|
21
|
+
// block D6). Not a recorder: pure, embedder-injected scoring functions
|
|
22
|
+
// + the shared bounded embedding cache. Honest claim: every score is an
|
|
23
|
+
// embedding-geometry PROXY — semantic alignment, never model internals,
|
|
24
|
+
// never causal attribution.
|
|
25
|
+
export { adaptWeights, averageRelevancy, compositeScore, contentHash, DEFAULT_CLEAR_WINNER_MARGIN, DEFAULT_CLEAR_WINNER_RATIO, DEFAULT_INFLUENCE_WEIGHTS, DEFAULT_MARGIN_THRESHOLD, DEFAULT_PERSISTENCE_THRESHOLD, DEFAULT_SHORTLIST_BAND, EmbeddingCache, embeddingCache, finalAnswerSimilarity, marginStrategy, pairwiseSimilarity, persistence, rankingConfidence, ratioStrategy, scoreContrastiveInfluence, scoreInfluence, scoreMargin, structuralProximity, } from './lib/influence-core/index.js';
|
|
26
|
+
// Introspection toolpack (RFC-003 Part C) — footprintjs trace evidence
|
|
27
|
+
// exposed as TOOLS a debugging LLM calls over a COMPLETED run's artifacts.
|
|
28
|
+
// Bounded, honest (⚠ markers), redaction-respecting, id-navigable.
|
|
29
|
+
export { callTraceTool, lazyTraceToolpack, NO_COMPLETED_RUN_MESSAGE, TOOLPACK_HARD_CAPS, traceToolpack, } from './lib/trace-toolpack/index.js';
|
|
30
|
+
// The two conversational doors over the toolpack: a DEDICATED debugger
|
|
31
|
+
// agent (separate session, any provider — cheap models welcome), and the
|
|
32
|
+
// in-conversation `.selfExplain()` builder option's types. Same evidence,
|
|
33
|
+
// same honesty discipline as the UI doors (BacktrackView / Lens).
|
|
34
|
+
export { buildSelfExplainSkill, buildSelfExplainToolProvider, SelfExplainBinding, traceDebugAgent, } from './lib/trace-toolpack/index.js';
|
|
35
|
+
// Contextual-bug localizer (RFC-003 Part B, D7–D9) — "git bisect for
|
|
36
|
+
// context". Assembly: footprintjs causal DAG (control edges + honesty
|
|
37
|
+
// markers + EdgeWeigher) × influence-core scoring (D6) × consumer-run
|
|
38
|
+
// counterfactual ablation. §B2 claim tiers: scores/weights are
|
|
39
|
+
// embedding-geometry PROXIES; ablation verdicts are the ONLY causal
|
|
40
|
+
// claims; slice completeness is bounded by tracking — and says so.
|
|
41
|
+
export { ablationForSuspect, applyAblations, assembleTrajectory, assignCostVerdicts, bisectCulprits, bucketByAnchors, shortlistEarlyCulprits, walkToRoot, walkTrajectory, buildWriterFrameIndex, DEFAULT_RECENCY_DECAY, classifySuspect, findLoopHeads, CONTEXT_BISECT_DEFAULTS, defaultOutcomeComparator, defaultSuspectClassifier, findDroppedContext, formatContextBugReport, llmCallIdsFromEvents, llmEdgeWeigher, localizeContextBug, probeFlipped, runAblationProbe, runRestorationProbe, stepOutputText, suspectLabel, verdictFor, } from './lib/context-bisect/index.js';
|
|
42
|
+
// BacktrackTrace serializer — feeds agentThinkingUI's <BacktrackView>
|
|
43
|
+
// (the "why?" board) straight off a localizer report. Pure mapping, no
|
|
44
|
+
// UI dependency; the interfaces mirror agentthinkingui's contract.
|
|
45
|
+
export { toBacktrackTrace, } from './lib/context-bisect/index.js';
|
|
46
|
+
// Tool-catalog confusability lint (RFC-002 tier 1, C1–C3) — build-time,
|
|
47
|
+
// CI-gateable, framework-agnostic: plain { name, description?, inputSchema? }
|
|
48
|
+
// tools in (OpenAI/Anthropic/MCP lists coerce via coerceCatalog; the
|
|
49
|
+
// library's Tool[] via catalogFromTools), a report with a gateable `ok`
|
|
50
|
+
// out. Pluggable structural rule pack; thresholds + embedder consumer-
|
|
51
|
+
// injected with our defaults. Bin: `agentfootprint-lint-tools`.
|
|
52
|
+
// Front door: docs/guides/tool-catalog-lint.md.
|
|
53
|
+
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, } from './lib/tool-lint/index.js';
|
|
54
|
+
//# sourceMappingURL=debug.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,4BAA4B;AAC5B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,mBAAmB,GAsBpB,MAAM,+BAA+B,CAAC;AACvC,uEAAuE;AACvE,2EAA2E;AAC3E,mEAAmE;AACnE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,GAGd,MAAM,+BAA+B,CAAC;AACvC,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,kEAAkE;AAClE,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,GAGhB,MAAM,+BAA+B,CAAC;AACvC,qEAAqE;AACrE,sEAAsE;AACtE,sEAAsE;AACtE,+DAA+D;AAC/D,oEAAoE;AACpE,mEAAmE;AACnE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,UAAU,GAwDX,MAAM,+BAA+B,CAAC;AACvC,sEAAsE;AACtE,uEAAuE;AACvE,mEAAmE;AACnE,OAAO,EACL,gBAAgB,GAOjB,MAAM,+BAA+B,CAAC;AACvC,wEAAwE;AACxE,8EAA8E;AAC9E,qEAAqE;AACrE,wEAAwE;AACxE,uEAAuE;AACvE,gEAAgE;AAChE,gDAAgD;AAChD,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,GAepB,MAAM,0BAA0B,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentfootprint/events — the typed event system.
|
|
3
|
+
*
|
|
4
|
+
* Every agentfootprint run emits a single, strongly-typed event stream:
|
|
5
|
+
* the registry (`EVENT_NAMES`, `AgentfootprintEventMap`, `AgentfootprintEvent`),
|
|
6
|
+
* the dispatcher (`EventDispatcher` + listener/wildcard types), the shared
|
|
7
|
+
* context/composition types, and the ~60 typed payload shapes (grouped
|
|
8
|
+
* under the `Payloads` namespace).
|
|
9
|
+
*
|
|
10
|
+
* This is observability infrastructure, not core agent API, so in v7 it
|
|
11
|
+
* lives on its own subpath — consistent with `/observe`, `/memory`, etc.
|
|
12
|
+
* Recorders (`agentfootprint/observe`) and viewer libraries consume it;
|
|
13
|
+
* the `Agent` builder wires it for you.
|
|
14
|
+
*/
|
|
15
|
+
export * from './events/types.js';
|
|
16
|
+
export type * as Payloads from './events/payloads.js';
|
|
17
|
+
export { EVENT_NAMES, ALL_EVENT_TYPES, type AgentfootprintEvent, type AgentfootprintEventMap, type AgentfootprintEventType, } from './events/registry.js';
|
|
18
|
+
export { EventDispatcher, type EventListener, type WildcardListener, type ListenOptions, type Unsubscribe, type DomainWildcard, type AllWildcard, type WildcardSubscription, } from './events/dispatcher.js';
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agentfootprint/events — the typed event system.
|
|
3
|
+
*
|
|
4
|
+
* Every agentfootprint run emits a single, strongly-typed event stream:
|
|
5
|
+
* the registry (`EVENT_NAMES`, `AgentfootprintEventMap`, `AgentfootprintEvent`),
|
|
6
|
+
* the dispatcher (`EventDispatcher` + listener/wildcard types), the shared
|
|
7
|
+
* context/composition types, and the ~60 typed payload shapes (grouped
|
|
8
|
+
* under the `Payloads` namespace).
|
|
9
|
+
*
|
|
10
|
+
* This is observability infrastructure, not core agent API, so in v7 it
|
|
11
|
+
* lives on its own subpath — consistent with `/observe`, `/memory`, etc.
|
|
12
|
+
* Recorders (`agentfootprint/observe`) and viewer libraries consume it;
|
|
13
|
+
* the `Agent` builder wires it for you.
|
|
14
|
+
*/
|
|
15
|
+
// Shared event/context/composition types.
|
|
16
|
+
export * from './events/types.js';
|
|
17
|
+
// Registry — the event-name set + the typed map/union/discriminant.
|
|
18
|
+
export { EVENT_NAMES, ALL_EVENT_TYPES, } from './events/registry.js';
|
|
19
|
+
// Dispatcher — subscribe to the stream (`.on(type, listener)`), wildcard
|
|
20
|
+
// subscriptions, and the unsubscribe handle.
|
|
21
|
+
export { EventDispatcher, } from './events/dispatcher.js';
|
|
22
|
+
//# sourceMappingURL=events.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,0CAA0C;AAC1C,cAAc,mBAAmB,CAAC;AAQlC,oEAAoE;AACpE,OAAO,EACL,WAAW,EACX,eAAe,GAIhB,MAAM,sBAAsB,CAAC;AAE9B,yEAAyE;AACzE,6CAA6C;AAC7C,OAAO,EACL,eAAe,GAQhB,MAAM,wBAAwB,CAAC"}
|
package/dist/esm/index.d.ts
CHANGED
|
@@ -9,33 +9,26 @@ import './cache/strategies/AnthropicCacheStrategy.js';
|
|
|
9
9
|
import './cache/strategies/OpenAICacheStrategy.js';
|
|
10
10
|
import './cache/strategies/BedrockCacheStrategy.js';
|
|
11
11
|
export type { CombinedRecorder, ScopeRecorder, FlowRecorder, EmitRecorder, WriteEvent, ReadEvent, CommitEvent, StageEvent, ErrorEvent, FlowStageEvent, FlowNextEvent, FlowDecisionEvent, FlowForkEvent, FlowSelectedEvent, FlowSubflowEvent, FlowSubflowRegisteredEvent, FlowLoopEvent, FlowBreakEvent, FlowErrorEvent, TraversalContext, EmitEvent, RedactionPolicy, RedactionReport, } from 'footprintjs';
|
|
12
|
-
export * from './events/types.js';
|
|
13
|
-
export type * as Payloads from './events/payloads.js';
|
|
14
|
-
export { EVENT_NAMES, ALL_EVENT_TYPES, type AgentfootprintEvent, type AgentfootprintEventMap, type AgentfootprintEventType, } from './events/registry.js';
|
|
15
|
-
export { EventDispatcher, type EventListener, type WildcardListener, type ListenOptions, type Unsubscribe, type DomainWildcard, type AllWildcard, type WildcardSubscription, } from './events/dispatcher.js';
|
|
16
12
|
export * from './adapters/types.js';
|
|
17
13
|
export { INJECTION_KEYS, injectionKeyForSlot, isInjectionKey, type InjectionKey, stageRole, type StageRole, milestoneFor, type Milestone, type MilestoneKind, } from './conventions.js';
|
|
18
14
|
export { COMPOSITION_KEYS, type BudgetPressureRecord, type CompositionKey, type EvictionRecord, type InjectionRecord, type SlotComposition, } from './recorders/core/types.js';
|
|
19
|
-
export {
|
|
15
|
+
export { type RunContext, } from './bridge/eventMeta.js';
|
|
20
16
|
export { contextEngineering, isEngineeredSource, isBaselineSource, ENGINEERED_SOURCES, BASELINE_SOURCES, type ContextEngineeringHandle, type ContextEngineeringUnsubscribe, type ContextInjectedEvent, type ContextInjectedListener, } from './recorders/core/contextEngineering.js';
|
|
21
|
-
export { EmitBridge, type EmitBridgeOptions } from './recorders/core/EmitBridge.js';
|
|
22
|
-
export { typedEmit } from './recorders/core/typedEmit.js';
|
|
23
17
|
export type { EmittedEvent, EnableNamespace, Runner } from './core/runner.js';
|
|
24
18
|
export { RunnerBase, makeRunId } from './core/RunnerBase.js';
|
|
25
19
|
export type { GroupKind, GroupMember, GroupMetadata, GroupTranslator } from './core/translator.js';
|
|
26
20
|
export { pauseHere, askHuman, isPauseRequest, isPaused, type RunnerPauseOutcome, } from './core/pause.js';
|
|
27
21
|
export type { FlowchartHandle, FlowchartOptions, } from './recorders/observability/FlowchartRecorder.js';
|
|
28
22
|
export { defaultCommentaryTemplates, extractAgentName, extractCommentaryVars, renderCommentary, selectCommentaryKey, type CommentaryContext, type CommentaryTemplates, } from './recorders/observability/commentary/commentaryTemplates.js';
|
|
29
|
-
export { defaultStatusTemplates, selectStatus, renderStatusLine, type StatusContext, type StatusState, type StatusKind, type StatusTemplates, } from './recorders/observability/status/statusTemplates.js';
|
|
30
23
|
export { LLMCall, LLMCallBuilder, type LLMCallInput, type LLMCallOptions, type LLMCallOutput, } from './core/LLMCall.js';
|
|
31
|
-
export {
|
|
24
|
+
export { type MessageApiChartDeps, } from './core/agent/buildMessageApiChart.js';
|
|
32
25
|
export { buildAgentMessageApiChart, type AgentMessageApiChartDeps, } from './core/agent/buildAgentMessageApiChart.js';
|
|
33
26
|
export { Agent, AgentBuilder, type AgentInput, type AgentOptions, type AgentOutput, type ObserverDeliveryOptions, } from './core/Agent.js';
|
|
34
27
|
export type { SelfExplainOptions } from './lib/trace-toolpack/selfExplain.js';
|
|
35
28
|
export type { ObserverDrainResult, ObserverStats } from 'footprintjs';
|
|
36
29
|
export type { ToolArgValidationMode } from './core/agent/toolArgsValidation.js';
|
|
37
30
|
export type { ReadSummaryMarker, ReadTrackingMode } from 'footprintjs';
|
|
38
|
-
export { OutputSchemaError, applyOutputSchema,
|
|
31
|
+
export { OutputSchemaError, applyOutputSchema, type OutputSchemaParser, type OutputSchemaOptions, } from './core/outputSchema.js';
|
|
39
32
|
export { type OutputFallbackOptions, type OutputFallbackFn } from './core/outputFallback.js';
|
|
40
33
|
export { RunCheckpointError, type AgentRunCheckpoint } from './core/runCheckpoint.js';
|
|
41
34
|
export { flowchartAsTool, type FlowchartAsToolOptions, type FlowchartResultMapper, type FlowchartToolSnapshot, } from './core/flowchartAsTool.js';
|
|
@@ -46,19 +39,6 @@ export { Sequence, SequenceBuilder, type SequenceInput, type SequenceOptions, ty
|
|
|
46
39
|
export { Parallel, ParallelBuilder, type BranchOutcome, type MergeFn, type MergeOutcomesFn, type MergeWithLLMOptions, type ParallelBranchOptions, type ParallelInput, type ParallelOptions, type ParallelOutput, } from './core-flow/Parallel.js';
|
|
47
40
|
export { Conditional, ConditionalBuilder, type ConditionalInput, type ConditionalOptions, type ConditionalOutput, type Predicate, } from './core-flow/Conditional.js';
|
|
48
41
|
export { Loop, LoopBuilder, type LoopInput, type LoopOptions, type LoopOutput, type UntilGuard, } from './core-flow/Loop.js';
|
|
49
|
-
export {
|
|
50
|
-
export { browserAnthropic, BrowserAnthropicProvider, type BrowserAnthropicProviderOptions, } from './adapters/llm/BrowserAnthropicProvider.js';
|
|
51
|
-
export { browserOpenai, BrowserOpenAIProvider, type BrowserOpenAIProviderOptions, browserAzureOpenai, BrowserAzureOpenAIProvider, type BrowserAzureOpenAIProviderOptions, } from './adapters/llm/BrowserOpenAIProvider.js';
|
|
52
|
-
export { createProvider, providerFromEnv, type ProviderKind, type CreateProviderOptions, type ProviderFromEnv, } from './adapters/llm/createProvider.js';
|
|
53
|
-
export { toSSE, SSEFormatter, encodeSSE, type ToSSEOptions } from './stream.js';
|
|
54
|
-
export { type Injection, type InjectionTrigger, type InjectionContent, type InjectionContext, type InjectionEvaluation, evaluateInjections, buildInjectionEngineSubflow, projectActiveInjection, type InjectionEngineConfig, type ActiveInjection, defineInstruction, type DefineInstructionOptions, defineRelevanceHint, type RelevanceHintOptions, defineSkill, resolveSurfaceMode, SkillRegistry, type SkillRegistryOptions, buildListSkillsTool, buildReadSkillTool, type SkillToolPair, type DefineSkillOptions, type SurfaceMode, type RefreshPolicy, type AutoActivateMode, defineSteering, type DefineSteeringOptions, defineFact, type DefineFactOptions, defineInjection, type DefineInjectionOptions, type InjectionFlavor, skillGraph, decide, SKILL_GRAPH_METADATA_KEY, type SkillGraph, type SkillGraphBuilder, type SkillRouteOptions, type SkillEntryOptions, type TreeOptions, type SkillEdge, type SkillEdgeKind, type SkillNode, type DecisionNode, type SkillRouting, type SkillRoutingStep, type EntryScore, type EntryScoring, type SkillGraphConfig, type BuildOptions, type GraphCheckMode, type GraphCheckup, type GraphProblem, type GraphProblemCode, keywordScorer, embeddingScorer, rankEntries, type EntryScorer, type EntryScorerInput, type EntryCandidate, checkSkillContract, checkSkillContracts, skillToolNames, } from './lib/injection-engine/index.js';
|
|
42
|
+
export { providerFromEnv, type ProviderKind, type CreateProviderOptions, type ProviderFromEnv, } from './adapters/llm/createProvider.js';
|
|
55
43
|
export * from './patterns/index.js';
|
|
56
|
-
export { defaultPipeline, ephemeralPipeline, factPipeline, narrativePipeline, semanticPipeline, autoPipeline, } from './memory/pipeline/index.js';
|
|
57
|
-
export { heuristicExtractor, llmExtractor, } from './memory/beats/index.js';
|
|
58
|
-
export { patternFactExtractor, llmFactExtractor, } from './memory/facts/index.js';
|
|
59
|
-
export { defineMemory, MEMORY_TYPES, MEMORY_STRATEGIES, MEMORY_TIMING, SNAPSHOT_PROJECTIONS, type MemoryType, type MemoryStrategyKind, type MemoryTiming, type SnapshotProjection, type Strategy, type MemoryDefinition, type DefineMemoryOptions, InMemoryStore, mockEmbedder, identityNamespace, type MemoryIdentity, type Embedder, } from './memory/index.js';
|
|
60
44
|
export { defineRAG, type DefineRAGOptions, indexDocuments, type IndexDocumentsOptions, type RagDocument, } from './lib/rag/index.js';
|
|
61
|
-
export { mcpClient, mockMcpClient, type McpClient, type McpClientOptions, type McpHttpTransport, type McpStdioTransport, type McpTransport, type McpSdkClient, type MockMcpClientOptions, type MockMcpTool, } from './lib/mcp/index.js';
|
|
62
|
-
export { staticTools, gatedTools, skillScopedTools, type ToolProvider, type ToolDispatchContext, type ToolGatePredicate, } from './tool-providers/index.js';
|
|
63
|
-
export { PermissionPolicy, PolicyHaltError, type PolicyHaltContext, type RoleAllowlist, type PermissionPolicyOptions, } from './security/index.js';
|
|
64
|
-
export { defaultCommentaryMessages, defaultThinkingMessages, composeMessages, validateMessages, type MessageCatalog, } from './locales/index.js';
|
package/dist/esm/index.js
CHANGED
|
@@ -14,11 +14,6 @@
|
|
|
14
14
|
import './cache/strategies/AnthropicCacheStrategy.js';
|
|
15
15
|
import './cache/strategies/OpenAICacheStrategy.js';
|
|
16
16
|
import './cache/strategies/BedrockCacheStrategy.js';
|
|
17
|
-
// Events — registry, types, payloads
|
|
18
|
-
export * from './events/types.js';
|
|
19
|
-
export { EVENT_NAMES, ALL_EVENT_TYPES, } from './events/registry.js';
|
|
20
|
-
// Dispatcher
|
|
21
|
-
export { EventDispatcher, } from './events/dispatcher.js';
|
|
22
17
|
// Adapter interfaces (ports)
|
|
23
18
|
export * from './adapters/types.js';
|
|
24
19
|
// Injection keys + recorder authoring helpers — needed by anyone writing
|
|
@@ -40,8 +35,6 @@ milestoneFor, } from './conventions.js';
|
|
|
40
35
|
// API. Library code reaches them via the relative `./conventions.js`
|
|
41
36
|
// import; downstream code should never need them.
|
|
42
37
|
export { COMPOSITION_KEYS, } from './recorders/core/types.js';
|
|
43
|
-
// Bridge helper
|
|
44
|
-
export { buildEventMeta, parseSubflowPath } from './bridge/eventMeta.js';
|
|
45
38
|
// Context-engineering + emit primitives.
|
|
46
39
|
//
|
|
47
40
|
// The observability recorder FACTORIES (ContextRecorder, streamRecorder,
|
|
@@ -52,8 +45,6 @@ export { buildEventMeta, parseSubflowPath } from './bridge/eventMeta.js';
|
|
|
52
45
|
// ONLY under `agentfootprint/observe` — the dedicated observability subpath —
|
|
53
46
|
// so the main barrel stays focused on the core agent API.
|
|
54
47
|
export { contextEngineering, isEngineeredSource, isBaselineSource, ENGINEERED_SOURCES, BASELINE_SOURCES, } from './recorders/core/contextEngineering.js';
|
|
55
|
-
export { EmitBridge } from './recorders/core/EmitBridge.js';
|
|
56
|
-
export { typedEmit } from './recorders/core/typedEmit.js';
|
|
57
48
|
export { RunnerBase, makeRunId } from './core/RunnerBase.js';
|
|
58
49
|
// Pause/Resume primitives — consumer API for human-in-the-loop tools.
|
|
59
50
|
// `PauseRequest` (the throwable signal class) stays internal; consumers
|
|
@@ -64,7 +55,11 @@ export { pauseHere, askHuman, isPauseRequest, isPaused, } from './core/pause.js'
|
|
|
64
55
|
// Commentary — bundled prose templates + engine for narrating a run.
|
|
65
56
|
// Consumers ship their own JSON locale / brand voice via the same
|
|
66
57
|
// shape; viewers (Lens, CLI tail, log file) consume this surface.
|
|
67
|
-
export { defaultCommentaryTemplates,
|
|
58
|
+
export { defaultCommentaryTemplates,
|
|
59
|
+
// Commentary engine helpers — advanced surface consumed by viewer
|
|
60
|
+
// libraries (agentfootprint-lens) to render run narration. Not the
|
|
61
|
+
// everyday API, but de-facto public: keep exported.
|
|
62
|
+
extractAgentName, extractCommentaryVars, renderCommentary, selectCommentaryKey, } from './recorders/observability/commentary/commentaryTemplates.js';
|
|
68
63
|
// Status — chat-bubble surface (separate audience: the end user
|
|
69
64
|
// chatting; renamed from "thinking" in 5.0.0 to disambiguate from the
|
|
70
65
|
// MODEL's extended-thinking reasoning). State machine:
|
|
@@ -73,20 +68,15 @@ export { defaultCommentaryTemplates, extractAgentName, extractCommentaryVars, re
|
|
|
73
68
|
// supported, missing keys ignored) but a different vocabulary —
|
|
74
69
|
// first-person status, mid-call only. Per-tool keys (`tool.<toolName>`)
|
|
75
70
|
// win over the generic `tool` key.
|
|
76
|
-
export { defaultStatusTemplates, selectStatus, renderStatusLine, } from './recorders/observability/status/statusTemplates.js';
|
|
77
71
|
// Primitives (core/)
|
|
78
72
|
export { LLMCall, LLMCallBuilder, } from './core/LLMCall.js';
|
|
79
|
-
// messageAPI merge-tree proof chart (LLM-only) — Context-selector → slot
|
|
80
|
-
// subflows → messageAPI assembly stage → Call-LLM. The locked shape that
|
|
81
|
-
// will later serve both Static and Dynamic agents. See buildMessageApiChart.
|
|
82
|
-
export { buildMessageApiChart, } from './core/agent/buildMessageApiChart.js';
|
|
83
73
|
// Agent (ReAct) form of the merge-tree — Context root selector → two-stage
|
|
84
74
|
// convergence: [sf-message-api (system-prompt+messages → messageAPI), sf-tools]
|
|
85
75
|
// → Call-LLM → route → [tool-exec → loop] / final. tools + the loop are the
|
|
86
76
|
// only additions over buildMessageApiChart. See buildAgentMessageApiChart.
|
|
87
77
|
export { buildAgentMessageApiChart, } from './core/agent/buildAgentMessageApiChart.js';
|
|
88
78
|
export { Agent, AgentBuilder, } from './core/Agent.js';
|
|
89
|
-
export { OutputSchemaError, applyOutputSchema,
|
|
79
|
+
export { OutputSchemaError, applyOutputSchema, } from './core/outputSchema.js';
|
|
90
80
|
export { RunCheckpointError } from './core/runCheckpoint.js';
|
|
91
81
|
export { flowchartAsTool, } from './core/flowchartAsTool.js';
|
|
92
82
|
export { defineTool, assertValidToolName, warnIfInvalidToolName } from './core/tools.js';
|
|
@@ -119,27 +109,10 @@ export { Loop, LoopBuilder, } from './core-flow/Loop.js';
|
|
|
119
109
|
//
|
|
120
110
|
// import { AnthropicProvider } from 'agentfootprint'; // ❌ not exported
|
|
121
111
|
// import { AnthropicProvider } from 'agentfootprint/llm-providers'; // ✓ canonical
|
|
122
|
-
export {
|
|
123
|
-
export { browserAnthropic, BrowserAnthropicProvider, } from './adapters/llm/BrowserAnthropicProvider.js';
|
|
124
|
-
export { browserOpenai, BrowserOpenAIProvider, browserAzureOpenai, BrowserAzureOpenAIProvider, } from './adapters/llm/BrowserOpenAIProvider.js';
|
|
125
|
-
export { createProvider, providerFromEnv, } from './adapters/llm/createProvider.js';
|
|
112
|
+
export { providerFromEnv, } from './adapters/llm/createProvider.js';
|
|
126
113
|
// Streaming helpers — agent events → SSE for browser delivery.
|
|
127
|
-
export { toSSE, SSEFormatter, encodeSSE } from './stream.js';
|
|
128
114
|
// Injection Engine — the unifying primitive of context engineering.
|
|
129
115
|
// One Injection type, four sugar factories, one engine subflow.
|
|
130
|
-
export {
|
|
131
|
-
// Engine
|
|
132
|
-
evaluateInjections, buildInjectionEngineSubflow, projectActiveInjection,
|
|
133
|
-
// Sugar factories — one per injection flavor
|
|
134
|
-
defineInstruction, defineRelevanceHint, defineSkill, resolveSurfaceMode, SkillRegistry, buildListSkillsTool, buildReadSkillTool, defineSteering, defineFact,
|
|
135
|
-
// Unified factory (type-discriminant over the four named factories above)
|
|
136
|
-
defineInjection,
|
|
137
|
-
// Declarative skill graph (proposal 002)
|
|
138
|
-
skillGraph, decide, SKILL_GRAPH_METADATA_KEY,
|
|
139
|
-
// Pluggable entry-relevance scorer strategy + built-ins (keyword / embedding)
|
|
140
|
-
keywordScorer, embeddingScorer, rankEntries,
|
|
141
|
-
// Proposal 009 Tier 1 — skill-body ↔ tool-contract consistency check
|
|
142
|
-
checkSkillContract, checkSkillContracts, skillToolNames, } from './lib/injection-engine/index.js';
|
|
143
116
|
// Patterns — factory functions composing primitives + core-flow into
|
|
144
117
|
// well-known agent patterns from the research literature.
|
|
145
118
|
export * from './patterns/index.js';
|
|
@@ -148,22 +121,6 @@ export * from './patterns/index.js';
|
|
|
148
121
|
// the most-used factories; the full subsystem (including types that
|
|
149
122
|
// would collide with adapter types like MemoryStore) is reachable via
|
|
150
123
|
// the `agentfootprint/memory` subpath import.
|
|
151
|
-
export {
|
|
152
|
-
// Pipelines
|
|
153
|
-
defaultPipeline, ephemeralPipeline, factPipeline, narrativePipeline, semanticPipeline, autoPipeline, } from './memory/pipeline/index.js';
|
|
154
|
-
export {
|
|
155
|
-
// Beat extractors
|
|
156
|
-
heuristicExtractor, llmExtractor, } from './memory/beats/index.js';
|
|
157
|
-
export {
|
|
158
|
-
// Fact extractors
|
|
159
|
-
patternFactExtractor, llmFactExtractor, } from './memory/facts/index.js';
|
|
160
|
-
export {
|
|
161
|
-
// Layered memory API — consumer-facing factory + const-objects
|
|
162
|
-
defineMemory, MEMORY_TYPES, MEMORY_STRATEGIES, MEMORY_TIMING, SNAPSHOT_PROJECTIONS,
|
|
163
|
-
// Reference implementations + helpers consumers reach for daily.
|
|
164
|
-
// Real-backend adapters (Redis, Postgres, Pinecone, ...) ship as
|
|
165
|
-
// separate subpath exports.
|
|
166
|
-
InMemoryStore, mockEmbedder, identityNamespace, } from './memory/index.js';
|
|
167
124
|
// RAG — retrieval-augmented generation as a context-engineering flavor.
|
|
168
125
|
// Thin sugar over `defineMemory({ type: SEMANTIC, strategy: TOP_K })`
|
|
169
126
|
// plus the `indexDocuments` helper for seeding the corpus at startup.
|
|
@@ -172,19 +129,15 @@ export { defineRAG, indexDocuments, } from './lib/rag/index.js';
|
|
|
172
129
|
// expose their tools as agentfootprint Tool[] for `agent.tools(...)`.
|
|
173
130
|
// `@modelcontextprotocol/sdk` is a lazy-required peer-dep (no runtime
|
|
174
131
|
// cost when MCP isn't used).
|
|
175
|
-
export { mcpClient, mockMcpClient, } from './lib/mcp/index.js';
|
|
176
132
|
// Tool dispatch primitives (v2.5+). New `agentfootprint/tool-providers`
|
|
177
133
|
// subpath bundles tool sources (mcpClient / mockMcpClient) with tool
|
|
178
134
|
// dispatch primitives (staticTools / gatedTools) so consumers find
|
|
179
135
|
// "everything tool-related" in one place. Top-level barrel re-exports
|
|
180
136
|
// the dispatch primitives too — `mcpClient` already re-exports above.
|
|
181
|
-
export { staticTools, gatedTools, skillScopedTools, } from './tool-providers/index.js';
|
|
182
137
|
// Cross-cutting authorization (v2.5+). `agentfootprint/security` is the
|
|
183
138
|
// dedicated subpath; the root barrel also re-exports `PermissionPolicy`
|
|
184
139
|
// so existing v2.4 consumers find it at the top level.
|
|
185
|
-
export { PermissionPolicy, PolicyHaltError, } from './security/index.js';
|
|
186
140
|
// Message Catalog Pattern (v2.5+). `agentfootprint/locales` is the
|
|
187
141
|
// dedicated subpath; the root barrel also re-exports the helpers so
|
|
188
142
|
// existing v2.4 consumers find them at the top level.
|
|
189
|
-
export { defaultCommentaryMessages, defaultThinkingMessages, composeMessages, validateMessages, } from './locales/index.js';
|
|
190
143
|
//# sourceMappingURL=index.js.map
|