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.
Files changed (112) hide show
  1. package/AGENTS.md +4 -0
  2. package/CLAUDE.md +4 -0
  3. package/README.md +141 -167
  4. package/ai-instructions/claude-code/SKILL.md +11 -0
  5. package/dist/adapters/llm/BrowserOpenAIProvider.js +1 -1
  6. package/dist/adapters/llm/MockProvider.js +2 -1
  7. package/dist/adapters/llm/MockProvider.js.map +1 -1
  8. package/dist/debug/finders.js +29 -0
  9. package/dist/debug/finders.js.map +1 -0
  10. package/dist/debug.js +134 -0
  11. package/dist/debug.js.map +1 -0
  12. package/dist/esm/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
  13. package/dist/esm/adapters/llm/BrowserOpenAIProvider.js +1 -1
  14. package/dist/esm/adapters/llm/MockProvider.d.ts +2 -1
  15. package/dist/esm/adapters/llm/MockProvider.js +2 -1
  16. package/dist/esm/adapters/llm/MockProvider.js.map +1 -1
  17. package/dist/esm/debug/finders.d.ts +12 -0
  18. package/dist/esm/debug/finders.js +13 -0
  19. package/dist/esm/debug/finders.js.map +1 -0
  20. package/dist/esm/debug.d.ts +25 -0
  21. package/dist/esm/debug.js +54 -0
  22. package/dist/esm/debug.js.map +1 -0
  23. package/dist/esm/events.d.ts +18 -0
  24. package/dist/esm/events.js +22 -0
  25. package/dist/esm/events.js.map +1 -0
  26. package/dist/esm/index.d.ts +4 -24
  27. package/dist/esm/index.js +7 -54
  28. package/dist/esm/index.js.map +1 -1
  29. package/dist/esm/lib/injection-engine/index.d.ts +1 -1
  30. package/dist/esm/lib/injection-engine/index.js +1 -1
  31. package/dist/esm/lib/injection-engine/index.js.map +1 -1
  32. package/dist/esm/lib/injection-engine/skillGraph.d.ts +3 -2
  33. package/dist/esm/lib/injection-engine/skillGraph.js +3 -2
  34. package/dist/esm/lib/injection-engine/skillGraph.js.map +1 -1
  35. package/dist/esm/lib/rag/defineRAG.d.ts +3 -3
  36. package/dist/esm/lib/rag/defineRAG.js +3 -3
  37. package/dist/esm/lib/rag/indexDocuments.d.ts +2 -1
  38. package/dist/esm/lib/rag/indexDocuments.js +2 -1
  39. package/dist/esm/lib/rag/indexDocuments.js.map +1 -1
  40. package/dist/esm/locales/index.d.ts +9 -0
  41. package/dist/esm/locales/index.js +7 -0
  42. package/dist/esm/locales/index.js.map +1 -1
  43. package/dist/esm/memory/causal/types.d.ts +13 -9
  44. package/dist/esm/memory/causal/types.js.map +1 -1
  45. package/dist/esm/memory/define.types.d.ts +5 -3
  46. package/dist/esm/memory/define.types.js +5 -3
  47. package/dist/esm/memory/define.types.js.map +1 -1
  48. package/dist/esm/observe.d.ts +1 -6
  49. package/dist/esm/observe.js +7 -36
  50. package/dist/esm/observe.js.map +1 -1
  51. package/dist/esm/providers.d.ts +2 -2
  52. package/dist/esm/providers.js +1 -1
  53. package/dist/esm/providers.js.map +1 -1
  54. package/dist/esm/status.d.ts +10 -4
  55. package/dist/esm/status.js +13 -4
  56. package/dist/esm/status.js.map +1 -1
  57. package/dist/esm/tool-providers/index.d.ts +1 -1
  58. package/dist/events.js +42 -0
  59. package/dist/events.js.map +1 -0
  60. package/dist/index.js +7 -121
  61. package/dist/index.js.map +1 -1
  62. package/dist/lib/injection-engine/index.js +2 -2
  63. package/dist/lib/injection-engine/index.js.map +1 -1
  64. package/dist/lib/injection-engine/skillGraph.js +5 -4
  65. package/dist/lib/injection-engine/skillGraph.js.map +1 -1
  66. package/dist/lib/rag/defineRAG.js +3 -3
  67. package/dist/lib/rag/indexDocuments.js +2 -1
  68. package/dist/lib/rag/indexDocuments.js.map +1 -1
  69. package/dist/locales/index.js +2 -1
  70. package/dist/locales/index.js.map +1 -1
  71. package/dist/memory/causal/types.js.map +1 -1
  72. package/dist/memory/define.types.js +5 -3
  73. package/dist/memory/define.types.js.map +1 -1
  74. package/dist/observe.js +22 -115
  75. package/dist/observe.js.map +1 -1
  76. package/dist/providers.js +3 -1
  77. package/dist/providers.js.map +1 -1
  78. package/dist/status.js +13 -5
  79. package/dist/status.js.map +1 -1
  80. package/dist/types/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
  81. package/dist/types/adapters/llm/MockProvider.d.ts +2 -1
  82. package/dist/types/adapters/llm/MockProvider.d.ts.map +1 -1
  83. package/dist/types/debug/finders.d.ts +13 -0
  84. package/dist/types/debug/finders.d.ts.map +1 -0
  85. package/dist/types/debug.d.ts +26 -0
  86. package/dist/types/debug.d.ts.map +1 -0
  87. package/dist/types/events.d.ts +19 -0
  88. package/dist/types/events.d.ts.map +1 -0
  89. package/dist/types/index.d.ts +4 -24
  90. package/dist/types/index.d.ts.map +1 -1
  91. package/dist/types/lib/injection-engine/index.d.ts +1 -1
  92. package/dist/types/lib/injection-engine/index.d.ts.map +1 -1
  93. package/dist/types/lib/injection-engine/skillGraph.d.ts +3 -2
  94. package/dist/types/lib/injection-engine/skillGraph.d.ts.map +1 -1
  95. package/dist/types/lib/rag/defineRAG.d.ts +3 -3
  96. package/dist/types/lib/rag/indexDocuments.d.ts +2 -1
  97. package/dist/types/lib/rag/indexDocuments.d.ts.map +1 -1
  98. package/dist/types/locales/index.d.ts +9 -0
  99. package/dist/types/locales/index.d.ts.map +1 -1
  100. package/dist/types/memory/causal/types.d.ts +13 -9
  101. package/dist/types/memory/causal/types.d.ts.map +1 -1
  102. package/dist/types/memory/define.types.d.ts +5 -3
  103. package/dist/types/memory/define.types.d.ts.map +1 -1
  104. package/dist/types/observe.d.ts +1 -6
  105. package/dist/types/observe.d.ts.map +1 -1
  106. package/dist/types/providers.d.ts +2 -2
  107. package/dist/types/providers.d.ts.map +1 -1
  108. package/dist/types/status.d.ts +10 -4
  109. package/dist/types/status.d.ts.map +1 -1
  110. package/dist/types/tool-providers/index.d.ts +1 -1
  111. package/dist/types/tool-providers/index.d.ts.map +1 -1
  112. 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, mock, defineTool } from 'agentfootprint';
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, mock, defineTool } from 'agentfootprint';
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":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAiFH,MAAM,OAAO,YAAY;IACd,IAAI,CAAS;IACL,KAAK,CAAU;IACf,OAAO,CAAwB;IACxC,aAAa,GAAG,CAAC,CAAC;IACT,OAAO,CAAqD;IAC5D,UAAU,CAAY;IACtB,YAAY,CAAY;IACxB,UAAU,CAAS;IACnB,aAAa,CAA+B;IAE7D,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO;YACV,OAAO,CAAC,OAAO;gBACf,CAAC,CAAC,GAAG,EAAE,EAAE;oBACP,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;oBAC5E,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,CAAC,CAAC,CAAC;QACL,iEAAiE;QACjE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC;QAC/C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,YAAY;QACV,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,UAA+B,EAAE;QAChD,OAAO,IAAI,YAAY,CAAC;YACtB,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;YACxB,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;YACtB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAe;QAC5B,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,GAAe;QAC3B,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC9D,+DAA+D;YAC/D,gEAAgE;YAChE,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,gEAAgE;QAChE,8DAA8D;QAC9D,2DAA2D;QAC3D,4DAA4D;QAC5D,mEAAmE;QACnE,8DAA8D;QAC9D,sDAAsD;QACtD,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAEO,aAAa,CAAC,GAAe;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,OAAO,GAAyB,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACvF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACjF,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;QACnC,OAAO;YACL,OAAO;YACP,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI;gBACtB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC7D,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;gBAChE,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,KAAK,SAAS,IAAI;oBACjD,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS;iBACxC,CAAC;gBACF,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,KAAK,SAAS,IAAI;oBAClD,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU;iBAC1C,CAAC;aACH;YACD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;SACxF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,GAAe;QACtC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,CAAC,IAAI,yBAAyB,IAAI,CAAC,OAAO,CAAC,MAAM,WAAW;oBAC9E,yBAAyB,IAAI,CAAC,aAAa,GAAG,CAAC,wBAAwB;oBACvE,yDAAyD;oBACzD,mEAAmE,CACtE,CAAC;YACJ,CAAC;YACD,qEAAqE;YACrE,oEAAoE;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAE,CAAC;YAC/C,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,IAAI,CAAC,UAA+B,EAAE;IACpD,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,uEAAuE;AAEvE;uCACuC;AACvC,SAAS,MAAM,CAAC,IAAe;IAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACxB,IAAI,GAAG,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,wEAAwE;AACxE,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;YACzB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,kEAAkE;YAClE,2DAA2D;YAC3D,oEAAoE;YACpE,MAAM,CAAC,MAAO,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;2EAC2E;AAC3E,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,mEAAmE;IACnE,mDAAmD;IACnD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,uDAAuD;IACvD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,aAAa,GAAG,CAAC;QAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,QAAgC;IACrD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAChD,OAAO,CAAC,CAAC;AACX,CAAC"}
@@ -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"}
@@ -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 { buildEventMeta, parseSubflowPath, type RunContext } from './bridge/eventMeta.js';
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 { buildMessageApiChart, type MessageApiChartDeps, } from './core/agent/buildMessageApiChart.js';
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, buildDefaultInstruction, type OutputSchemaParser, type OutputSchemaOptions, } from './core/outputSchema.js';
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 { MockProvider, mock, type MockProviderOptions, type MockReply, } from './adapters/llm/MockProvider.js';
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, extractAgentName, extractCommentaryVars, renderCommentary, selectCommentaryKey, } from './recorders/observability/commentary/commentaryTemplates.js';
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, buildDefaultInstruction, } from './core/outputSchema.js';
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 { MockProvider, mock, } from './adapters/llm/MockProvider.js';
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