agentfootprint 3.1.2 → 5.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 (136) hide show
  1. package/dist/adapters/llm/AnthropicProvider.js +1 -1
  2. package/dist/adapters/llm/OpenAIProvider.js +2 -2
  3. package/dist/adapters/memory/agentcore.js +2 -6
  4. package/dist/adapters/memory/agentcore.js.map +1 -1
  5. package/dist/adapters/memory/redis.js +2 -6
  6. package/dist/adapters/memory/redis.js.map +1 -1
  7. package/dist/core/RunnerBase.js +0 -4
  8. package/dist/core/RunnerBase.js.map +1 -1
  9. package/dist/core/agent/AgentBuilder.js +2 -2
  10. package/dist/core/agent/AgentBuilder.js.map +1 -1
  11. package/dist/core/slots/buildToolsSlot.js +2 -2
  12. package/dist/core/slots/buildToolsSlot.js.map +1 -1
  13. package/dist/esm/adapters/llm/AnthropicProvider.js +1 -1
  14. package/dist/esm/adapters/llm/OpenAIProvider.js +2 -2
  15. package/dist/esm/adapters/memory/agentcore.js +2 -6
  16. package/dist/esm/adapters/memory/agentcore.js.map +1 -1
  17. package/dist/esm/adapters/memory/redis.js +2 -6
  18. package/dist/esm/adapters/memory/redis.js.map +1 -1
  19. package/dist/esm/core/RunnerBase.js +0 -4
  20. package/dist/esm/core/RunnerBase.js.map +1 -1
  21. package/dist/esm/core/agent/AgentBuilder.js +3 -3
  22. package/dist/esm/core/agent/AgentBuilder.js.map +1 -1
  23. package/dist/esm/core/slots/buildToolsSlot.js +2 -2
  24. package/dist/esm/core/slots/buildToolsSlot.js.map +1 -1
  25. package/dist/esm/index.js +24 -34
  26. package/dist/esm/index.js.map +1 -1
  27. package/dist/esm/lib/injection-engine/factories/defineInjection.js +46 -0
  28. package/dist/esm/lib/injection-engine/factories/defineInjection.js.map +1 -0
  29. package/dist/esm/lib/injection-engine/index.js +4 -0
  30. package/dist/esm/lib/injection-engine/index.js.map +1 -1
  31. package/dist/esm/llm-providers.js +0 -4
  32. package/dist/esm/llm-providers.js.map +1 -1
  33. package/dist/esm/locales/index.js +4 -4
  34. package/dist/esm/locales/index.js.map +1 -1
  35. package/dist/esm/memory-providers.js +1 -5
  36. package/dist/esm/memory-providers.js.map +1 -1
  37. package/dist/esm/observe.js +5 -2
  38. package/dist/esm/observe.js.map +1 -1
  39. package/dist/esm/providers.js +5 -10
  40. package/dist/esm/providers.js.map +1 -1
  41. package/dist/esm/recorders/observability/BoundaryRecorder.js +1 -1
  42. package/dist/esm/recorders/observability/LiveStateRecorder.js +5 -5
  43. package/dist/esm/recorders/observability/LoggingRecorder.js +6 -3
  44. package/dist/esm/recorders/observability/LoggingRecorder.js.map +1 -1
  45. package/dist/esm/recorders/observability/RunStepRecorder.js +2 -2
  46. package/dist/esm/recorders/observability/{ThinkingRecorder.js → StatusRecorder.js} +9 -7
  47. package/dist/esm/recorders/observability/StatusRecorder.js.map +1 -0
  48. package/dist/esm/recorders/observability/thinking/thinkingTemplates.js +3 -3
  49. package/dist/esm/recorders/observability/thinking/thinkingTemplates.js.map +1 -1
  50. package/dist/esm/resilience/fallbackProvider.js +1 -1
  51. package/dist/esm/status.js +3 -3
  52. package/dist/esm/status.js.map +1 -1
  53. package/dist/esm/strategies/attach.js +5 -5
  54. package/dist/esm/strategies/attach.js.map +1 -1
  55. package/dist/index.js +28 -63
  56. package/dist/index.js.map +1 -1
  57. package/dist/lib/injection-engine/factories/defineInjection.js +50 -0
  58. package/dist/lib/injection-engine/factories/defineInjection.js.map +1 -0
  59. package/dist/lib/injection-engine/index.js +6 -1
  60. package/dist/lib/injection-engine/index.js.map +1 -1
  61. package/dist/llm-providers.js +0 -4
  62. package/dist/llm-providers.js.map +1 -1
  63. package/dist/locales/index.js +3 -3
  64. package/dist/locales/index.js.map +1 -1
  65. package/dist/memory-providers.js +1 -5
  66. package/dist/memory-providers.js.map +1 -1
  67. package/dist/observe.js +12 -4
  68. package/dist/observe.js.map +1 -1
  69. package/dist/providers.js +5 -10
  70. package/dist/providers.js.map +1 -1
  71. package/dist/recorders/observability/BoundaryRecorder.js +1 -1
  72. package/dist/recorders/observability/LiveStateRecorder.js +5 -5
  73. package/dist/recorders/observability/LoggingRecorder.js +6 -3
  74. package/dist/recorders/observability/LoggingRecorder.js.map +1 -1
  75. package/dist/recorders/observability/RunStepRecorder.js +2 -2
  76. package/dist/recorders/observability/{ThinkingRecorder.js → StatusRecorder.js} +11 -9
  77. package/dist/recorders/observability/StatusRecorder.js.map +1 -0
  78. package/dist/recorders/observability/thinking/thinkingTemplates.js +6 -6
  79. package/dist/recorders/observability/thinking/thinkingTemplates.js.map +1 -1
  80. package/dist/resilience/fallbackProvider.js +1 -1
  81. package/dist/status.js +6 -6
  82. package/dist/status.js.map +1 -1
  83. package/dist/strategies/attach.js +4 -4
  84. package/dist/strategies/attach.js.map +1 -1
  85. package/dist/types/adapters/llm/AnthropicProvider.d.ts +1 -1
  86. package/dist/types/adapters/llm/OpenAIProvider.d.ts +2 -2
  87. package/dist/types/adapters/memory/agentcore.d.ts +2 -6
  88. package/dist/types/adapters/memory/agentcore.d.ts.map +1 -1
  89. package/dist/types/adapters/memory/redis.d.ts +2 -6
  90. package/dist/types/adapters/memory/redis.d.ts.map +1 -1
  91. package/dist/types/adapters/types.d.ts +4 -3
  92. package/dist/types/adapters/types.d.ts.map +1 -1
  93. package/dist/types/core/RunnerBase.d.ts.map +1 -1
  94. package/dist/types/core/agent/AgentBuilder.d.ts +1 -1
  95. package/dist/types/core/runner.d.ts +1 -14
  96. package/dist/types/core/runner.d.ts.map +1 -1
  97. package/dist/types/events/payloads.d.ts +3 -4
  98. package/dist/types/events/payloads.d.ts.map +1 -1
  99. package/dist/types/index.d.ts +4 -20
  100. package/dist/types/index.d.ts.map +1 -1
  101. package/dist/types/lib/injection-engine/factories/defineInjection.d.ts +42 -0
  102. package/dist/types/lib/injection-engine/factories/defineInjection.d.ts.map +1 -0
  103. package/dist/types/lib/injection-engine/index.d.ts +1 -0
  104. package/dist/types/lib/injection-engine/index.d.ts.map +1 -1
  105. package/dist/types/llm-providers.d.ts +0 -4
  106. package/dist/types/llm-providers.d.ts.map +1 -1
  107. package/dist/types/locales/index.d.ts +2 -2
  108. package/dist/types/locales/index.d.ts.map +1 -1
  109. package/dist/types/memory-providers.d.ts +1 -5
  110. package/dist/types/memory-providers.d.ts.map +1 -1
  111. package/dist/types/observe.d.ts +6 -3
  112. package/dist/types/observe.d.ts.map +1 -1
  113. package/dist/types/providers.d.ts +5 -10
  114. package/dist/types/providers.d.ts.map +1 -1
  115. package/dist/types/recorders/observability/BoundaryRecorder.d.ts +1 -1
  116. package/dist/types/recorders/observability/LiveStateRecorder.d.ts +5 -5
  117. package/dist/types/recorders/observability/LoggingRecorder.d.ts +6 -3
  118. package/dist/types/recorders/observability/LoggingRecorder.d.ts.map +1 -1
  119. package/dist/types/recorders/observability/RunStepRecorder.d.ts +3 -3
  120. package/dist/types/recorders/observability/StatusRecorder.d.ts +37 -0
  121. package/dist/types/recorders/observability/StatusRecorder.d.ts.map +1 -0
  122. package/dist/types/recorders/observability/thinking/thinkingTemplates.d.ts +8 -8
  123. package/dist/types/recorders/observability/thinking/thinkingTemplates.d.ts.map +1 -1
  124. package/dist/types/resilience/fallbackProvider.d.ts +1 -1
  125. package/dist/types/status.d.ts +3 -3
  126. package/dist/types/status.d.ts.map +1 -1
  127. package/dist/types/strategies/attach.d.ts +2 -2
  128. package/dist/types/strategies/attach.d.ts.map +1 -1
  129. package/dist/types/strategies/defaults/chatBubbleLiveStatus.d.ts +2 -2
  130. package/dist/types/strategies/types.d.ts +3 -3
  131. package/dist/types/strategies/types.d.ts.map +1 -1
  132. package/package.json +8 -18
  133. package/dist/esm/recorders/observability/ThinkingRecorder.js.map +0 -1
  134. package/dist/recorders/observability/ThinkingRecorder.js.map +0 -1
  135. package/dist/types/recorders/observability/ThinkingRecorder.d.ts +0 -35
  136. package/dist/types/recorders/observability/ThinkingRecorder.d.ts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GAKnB,MAAM,yDAAyD,CAAC"}
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,GAKjB,MAAM,yDAAyD,CAAC"}
@@ -17,7 +17,7 @@
17
17
  * 7. Return Unsubscribe (or handle for lens)
18
18
  */
19
19
  import { flowChart } from 'footprintjs';
20
- import { selectThinkingState, renderThinkingLine, defaultThinkingTemplates, } from '../recorders/observability/thinking/thinkingTemplates.js';
20
+ import { selectStatus, renderStatusLine, defaultStatusTemplates, } from '../recorders/observability/thinking/thinkingTemplates.js';
21
21
  // Registry-lookup helpers (`getObservabilityStrategy` etc.) are
22
22
  // defined in `./registry.js` and used by consumers via the
23
23
  // `enable.*({ vendor, config })` path elsewhere — not used in the
@@ -197,12 +197,12 @@ export function attachCostStrategy(dispatcher, opts = {}) {
197
197
  /** Sliding-window cap for `attachLiveStatusStrategy`'s internal event
198
198
  * log. Long-lived agent servers would otherwise leak memory through
199
199
  * unbounded growth (per OTel SIG panel review). The cap is high
200
- * enough that `selectThinkingState` always sees the relevant recent
200
+ * enough that `selectStatus` always sees the relevant recent
201
201
  * history. */
202
202
  const LIVE_STATUS_LOG_CAP = 1000;
203
203
  export function attachLiveStatusStrategy(dispatcher, opts) {
204
204
  opts.strategy.validate?.();
205
- const templates = { ...defaultThinkingTemplates, ...(opts.templates ?? {}) };
205
+ const templates = { ...defaultStatusTemplates, ...(opts.templates ?? {}) };
206
206
  const ctx = { appName: opts.appName ?? 'Agent' };
207
207
  const eventLog = [];
208
208
  let lastLine = null;
@@ -212,12 +212,12 @@ export function attachLiveStatusStrategy(dispatcher, opts) {
212
212
  // because shift() runs only once per overflow.
213
213
  while (eventLog.length > LIVE_STATUS_LOG_CAP)
214
214
  eventLog.shift();
215
- const state = selectThinkingState(eventLog);
215
+ const state = selectStatus(eventLog);
216
216
  if (!state) {
217
217
  lastLine = null;
218
218
  return;
219
219
  }
220
- const line = renderThinkingLine(state, ctx, templates);
220
+ const line = renderStatusLine(state, ctx, templates);
221
221
  if (line === null || line === lastLine)
222
222
  return;
223
223
  lastLine = line;
@@ -1 +1 @@
1
- {"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../src/strategies/attach.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../src/strategies/attach.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -21,9 +21,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
21
21
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
22
22
  };
23
23
  Object.defineProperty(exports, "__esModule", { value: true });
24
- exports.defaultCommentaryTemplates = exports.LiveAgentTurnTracker = exports.LiveToolTracker = exports.LiveLLMTracker = exports.LiveStateRecorder = exports.liveStateRecorder = exports.boundaryRecorder = exports.BoundaryRecorder = exports.runStepRecorder = exports.RunStepRecorder = exports.buildRunSteps = exports.attachFlowchart = exports.LoggingDomains = exports.attachLogging = exports.attachThinking = exports.isPaused = exports.isPauseRequest = exports.askHuman = exports.pauseHere = exports.makeRunId = exports.RunnerBase = exports.typedEmit = exports.toolsRecorder = exports.skillRecorder = exports.memoryRecorder = exports.evalRecorder = exports.permissionRecorder = exports.costRecorder = exports.compositionRecorder = exports.contextEvaluatedRecorder = exports.agentRecorder = exports.streamRecorder = exports.EmitBridge = exports.BASELINE_SOURCES = exports.ENGINEERED_SOURCES = exports.isBaselineSource = exports.isEngineeredSource = exports.contextEngineering = exports.ContextRecorder = exports.parseSubflowPath = exports.buildEventMeta = exports.COMPOSITION_KEYS = exports.milestoneFor = exports.stageRole = exports.isInjectionKey = exports.injectionKeyForSlot = exports.INJECTION_KEYS = exports.EventDispatcher = exports.ALL_EVENT_TYPES = exports.EVENT_NAMES = void 0;
25
- exports.ephemeralPipeline = exports.defaultPipeline = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineInstruction = exports.projectActiveInjection = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.encodeSSE = exports.SSEFormatter = exports.toSSE = exports.createProvider = exports.BrowserOpenAIProvider = exports.browserOpenai = exports.BrowserAnthropicProvider = exports.browserAnthropic = exports.mock = exports.MockProvider = exports.LoopBuilder = exports.Loop = exports.ConditionalBuilder = exports.Conditional = exports.ParallelBuilder = exports.Parallel = exports.SequenceBuilder = exports.Sequence = exports.defineTool = exports.flowchartAsTool = exports.RunCheckpointError = exports.buildDefaultInstruction = exports.applyOutputSchema = exports.OutputSchemaError = exports.AgentBuilder = exports.Agent = exports.buildAgentMessageApiChart = exports.buildMessageApiChart = exports.LLMCallBuilder = exports.LLMCall = exports.renderThinkingLine = exports.selectThinkingState = exports.defaultThinkingTemplates = exports.selectCommentaryKey = exports.renderCommentary = exports.extractCommentaryVars = exports.extractAgentName = void 0;
26
- exports.validateMessages = exports.composeMessages = exports.defaultThinkingMessages = exports.defaultCommentaryMessages = exports.PolicyHaltError = exports.PermissionPolicy = exports.skillScopedTools = exports.gatedTools = exports.staticTools = exports.mockMcpClient = exports.mcpClient = exports.indexDocuments = exports.defineRAG = exports.identityNamespace = exports.mockEmbedder = exports.InMemoryStore = exports.SNAPSHOT_PROJECTIONS = exports.MEMORY_TIMING = exports.MEMORY_STRATEGIES = exports.MEMORY_TYPES = exports.defineMemory = exports.llmFactExtractor = exports.patternFactExtractor = exports.llmExtractor = exports.heuristicExtractor = exports.autoPipeline = exports.semanticPipeline = exports.narrativePipeline = exports.factPipeline = void 0;
24
+ exports.ConditionalBuilder = exports.Conditional = exports.ParallelBuilder = exports.Parallel = exports.SequenceBuilder = exports.Sequence = exports.defineTool = exports.flowchartAsTool = exports.RunCheckpointError = exports.buildDefaultInstruction = exports.applyOutputSchema = exports.OutputSchemaError = exports.AgentBuilder = exports.Agent = exports.buildAgentMessageApiChart = exports.buildMessageApiChart = exports.LLMCallBuilder = exports.LLMCall = exports.renderStatusLine = exports.selectStatus = exports.defaultStatusTemplates = exports.selectCommentaryKey = exports.renderCommentary = exports.extractCommentaryVars = exports.extractAgentName = exports.defaultCommentaryTemplates = exports.isPaused = exports.isPauseRequest = exports.askHuman = exports.pauseHere = exports.makeRunId = exports.RunnerBase = exports.typedEmit = exports.EmitBridge = exports.BASELINE_SOURCES = exports.ENGINEERED_SOURCES = exports.isBaselineSource = exports.isEngineeredSource = exports.contextEngineering = exports.parseSubflowPath = exports.buildEventMeta = exports.COMPOSITION_KEYS = exports.milestoneFor = exports.stageRole = exports.isInjectionKey = exports.injectionKeyForSlot = exports.INJECTION_KEYS = exports.EventDispatcher = exports.ALL_EVENT_TYPES = exports.EVENT_NAMES = void 0;
25
+ exports.PermissionPolicy = exports.skillScopedTools = exports.gatedTools = exports.staticTools = exports.mockMcpClient = exports.mcpClient = exports.indexDocuments = exports.defineRAG = exports.identityNamespace = exports.mockEmbedder = exports.InMemoryStore = exports.SNAPSHOT_PROJECTIONS = exports.MEMORY_TIMING = exports.MEMORY_STRATEGIES = exports.MEMORY_TYPES = exports.defineMemory = exports.llmFactExtractor = exports.patternFactExtractor = exports.llmExtractor = exports.heuristicExtractor = exports.autoPipeline = exports.semanticPipeline = exports.narrativePipeline = exports.factPipeline = exports.ephemeralPipeline = exports.defaultPipeline = exports.defineInjection = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineInstruction = exports.projectActiveInjection = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.encodeSSE = exports.SSEFormatter = exports.toSSE = exports.createProvider = exports.BrowserOpenAIProvider = exports.browserOpenai = exports.BrowserAnthropicProvider = exports.browserAnthropic = exports.mock = exports.MockProvider = exports.LoopBuilder = exports.Loop = void 0;
26
+ exports.validateMessages = exports.composeMessages = exports.defaultThinkingMessages = exports.defaultCommentaryMessages = exports.PolicyHaltError = void 0;
27
27
  // Side-effect imports — auto-register v2.6+ cache strategies in the
28
28
  // strategy registry. Without these, only the wildcard NoOp is
29
29
  // registered and `Agent.create({ provider: browserAnthropic({...}) })`
@@ -35,7 +35,6 @@ require("./cache/strategies/OpenAICacheStrategy.js");
35
35
  require("./cache/strategies/BedrockCacheStrategy.js");
36
36
  // Events — registry, types, payloads
37
37
  __exportStar(require("./events/types.js"), exports);
38
- __exportStar(require("./events/payloads.js"), exports);
39
38
  var registry_js_1 = require("./events/registry.js");
40
39
  Object.defineProperty(exports, "EVENT_NAMES", { enumerable: true, get: function () { return registry_js_1.EVENT_NAMES; } });
41
40
  Object.defineProperty(exports, "ALL_EVENT_TYPES", { enumerable: true, get: function () { return registry_js_1.ALL_EVENT_TYPES; } });
@@ -71,9 +70,15 @@ Object.defineProperty(exports, "COMPOSITION_KEYS", { enumerable: true, get: func
71
70
  var eventMeta_js_1 = require("./bridge/eventMeta.js");
72
71
  Object.defineProperty(exports, "buildEventMeta", { enumerable: true, get: function () { return eventMeta_js_1.buildEventMeta; } });
73
72
  Object.defineProperty(exports, "parseSubflowPath", { enumerable: true, get: function () { return eventMeta_js_1.parseSubflowPath; } });
74
- // Core recorders
75
- var ContextRecorder_js_1 = require("./recorders/core/ContextRecorder.js");
76
- Object.defineProperty(exports, "ContextRecorder", { enumerable: true, get: function () { return ContextRecorder_js_1.ContextRecorder; } });
73
+ // Context-engineering + emit primitives.
74
+ //
75
+ // The observability recorder FACTORIES (ContextRecorder, streamRecorder,
76
+ // agentRecorder, compositionRecorder, costRecorder, evalRecorder,
77
+ // memoryRecorder, permissionRecorder, skillRecorder, toolsRecorder,
78
+ // contextEvaluatedRecorder, boundaryRecorder, liveStateRecorder, the
79
+ // RunStep* family, attachFlowchart/attachLogging/attachStatus, …) now live
80
+ // ONLY under `agentfootprint/observe` — the dedicated observability subpath —
81
+ // so the main barrel stays focused on the core agent API.
77
82
  var contextEngineering_js_1 = require("./recorders/core/contextEngineering.js");
78
83
  Object.defineProperty(exports, "contextEngineering", { enumerable: true, get: function () { return contextEngineering_js_1.contextEngineering; } });
79
84
  Object.defineProperty(exports, "isEngineeredSource", { enumerable: true, get: function () { return contextEngineering_js_1.isEngineeredSource; } });
@@ -82,26 +87,6 @@ Object.defineProperty(exports, "ENGINEERED_SOURCES", { enumerable: true, get: fu
82
87
  Object.defineProperty(exports, "BASELINE_SOURCES", { enumerable: true, get: function () { return contextEngineering_js_1.BASELINE_SOURCES; } });
83
88
  var EmitBridge_js_1 = require("./recorders/core/EmitBridge.js");
84
89
  Object.defineProperty(exports, "EmitBridge", { enumerable: true, get: function () { return EmitBridge_js_1.EmitBridge; } });
85
- var StreamRecorder_js_1 = require("./recorders/core/StreamRecorder.js");
86
- Object.defineProperty(exports, "streamRecorder", { enumerable: true, get: function () { return StreamRecorder_js_1.streamRecorder; } });
87
- var AgentRecorder_js_1 = require("./recorders/core/AgentRecorder.js");
88
- Object.defineProperty(exports, "agentRecorder", { enumerable: true, get: function () { return AgentRecorder_js_1.agentRecorder; } });
89
- var ContextEvaluatedRecorder_js_1 = require("./recorders/core/ContextEvaluatedRecorder.js");
90
- Object.defineProperty(exports, "contextEvaluatedRecorder", { enumerable: true, get: function () { return ContextEvaluatedRecorder_js_1.contextEvaluatedRecorder; } });
91
- var CompositionRecorder_js_1 = require("./recorders/core/CompositionRecorder.js");
92
- Object.defineProperty(exports, "compositionRecorder", { enumerable: true, get: function () { return CompositionRecorder_js_1.compositionRecorder; } });
93
- var CostRecorder_js_1 = require("./recorders/core/CostRecorder.js");
94
- Object.defineProperty(exports, "costRecorder", { enumerable: true, get: function () { return CostRecorder_js_1.costRecorder; } });
95
- var PermissionRecorder_js_1 = require("./recorders/core/PermissionRecorder.js");
96
- Object.defineProperty(exports, "permissionRecorder", { enumerable: true, get: function () { return PermissionRecorder_js_1.permissionRecorder; } });
97
- var EvalRecorder_js_1 = require("./recorders/core/EvalRecorder.js");
98
- Object.defineProperty(exports, "evalRecorder", { enumerable: true, get: function () { return EvalRecorder_js_1.evalRecorder; } });
99
- var MemoryRecorder_js_1 = require("./recorders/core/MemoryRecorder.js");
100
- Object.defineProperty(exports, "memoryRecorder", { enumerable: true, get: function () { return MemoryRecorder_js_1.memoryRecorder; } });
101
- var SkillRecorder_js_1 = require("./recorders/core/SkillRecorder.js");
102
- Object.defineProperty(exports, "skillRecorder", { enumerable: true, get: function () { return SkillRecorder_js_1.skillRecorder; } });
103
- var ToolsRecorder_js_1 = require("./recorders/core/ToolsRecorder.js");
104
- Object.defineProperty(exports, "toolsRecorder", { enumerable: true, get: function () { return ToolsRecorder_js_1.toolsRecorder; } });
105
90
  var typedEmit_js_1 = require("./recorders/core/typedEmit.js");
106
91
  Object.defineProperty(exports, "typedEmit", { enumerable: true, get: function () { return typedEmit_js_1.typedEmit; } });
107
92
  var RunnerBase_js_1 = require("./core/RunnerBase.js");
@@ -117,27 +102,6 @@ Object.defineProperty(exports, "pauseHere", { enumerable: true, get: function ()
117
102
  Object.defineProperty(exports, "askHuman", { enumerable: true, get: function () { return pause_js_1.askHuman; } });
118
103
  Object.defineProperty(exports, "isPauseRequest", { enumerable: true, get: function () { return pause_js_1.isPauseRequest; } });
119
104
  Object.defineProperty(exports, "isPaused", { enumerable: true, get: function () { return pause_js_1.isPaused; } });
120
- // Tier 3 observability (enable.* namespace)
121
- var ThinkingRecorder_js_1 = require("./recorders/observability/ThinkingRecorder.js");
122
- Object.defineProperty(exports, "attachThinking", { enumerable: true, get: function () { return ThinkingRecorder_js_1.attachThinking; } });
123
- var LoggingRecorder_js_1 = require("./recorders/observability/LoggingRecorder.js");
124
- Object.defineProperty(exports, "attachLogging", { enumerable: true, get: function () { return LoggingRecorder_js_1.attachLogging; } });
125
- Object.defineProperty(exports, "LoggingDomains", { enumerable: true, get: function () { return LoggingRecorder_js_1.LoggingDomains; } });
126
- var FlowchartRecorder_js_1 = require("./recorders/observability/FlowchartRecorder.js");
127
- Object.defineProperty(exports, "attachFlowchart", { enumerable: true, get: function () { return FlowchartRecorder_js_1.attachFlowchart; } });
128
- var RunStepRecorder_js_1 = require("./recorders/observability/RunStepRecorder.js");
129
- Object.defineProperty(exports, "buildRunSteps", { enumerable: true, get: function () { return RunStepRecorder_js_1.buildRunSteps; } });
130
- Object.defineProperty(exports, "RunStepRecorder", { enumerable: true, get: function () { return RunStepRecorder_js_1.RunStepRecorder; } });
131
- Object.defineProperty(exports, "runStepRecorder", { enumerable: true, get: function () { return RunStepRecorder_js_1.runStepRecorder; } });
132
- var BoundaryRecorder_js_1 = require("./recorders/observability/BoundaryRecorder.js");
133
- Object.defineProperty(exports, "BoundaryRecorder", { enumerable: true, get: function () { return BoundaryRecorder_js_1.BoundaryRecorder; } });
134
- Object.defineProperty(exports, "boundaryRecorder", { enumerable: true, get: function () { return BoundaryRecorder_js_1.boundaryRecorder; } });
135
- var LiveStateRecorder_js_1 = require("./recorders/observability/LiveStateRecorder.js");
136
- Object.defineProperty(exports, "liveStateRecorder", { enumerable: true, get: function () { return LiveStateRecorder_js_1.liveStateRecorder; } });
137
- Object.defineProperty(exports, "LiveStateRecorder", { enumerable: true, get: function () { return LiveStateRecorder_js_1.LiveStateRecorder; } });
138
- Object.defineProperty(exports, "LiveLLMTracker", { enumerable: true, get: function () { return LiveStateRecorder_js_1.LiveLLMTracker; } });
139
- Object.defineProperty(exports, "LiveToolTracker", { enumerable: true, get: function () { return LiveStateRecorder_js_1.LiveToolTracker; } });
140
- Object.defineProperty(exports, "LiveAgentTurnTracker", { enumerable: true, get: function () { return LiveStateRecorder_js_1.LiveAgentTurnTracker; } });
141
105
  // Commentary — bundled prose templates + engine for narrating a run.
142
106
  // Consumers ship their own JSON locale / brand voice via the same
143
107
  // shape; viewers (Lens, CLI tail, log file) consume this surface.
@@ -147,16 +111,18 @@ Object.defineProperty(exports, "extractAgentName", { enumerable: true, get: func
147
111
  Object.defineProperty(exports, "extractCommentaryVars", { enumerable: true, get: function () { return commentaryTemplates_js_1.extractCommentaryVars; } });
148
112
  Object.defineProperty(exports, "renderCommentary", { enumerable: true, get: function () { return commentaryTemplates_js_1.renderCommentary; } });
149
113
  Object.defineProperty(exports, "selectCommentaryKey", { enumerable: true, get: function () { return commentaryTemplates_js_1.selectCommentaryKey; } });
150
- // Thinking — chat-bubble surface (separate audience: the end user
151
- // chatting). State machine: idle / streaming / tool / paused. Same
152
- // contract shape as commentary (`Record<string, string>` with
153
- // `{{vars}}`, partial overrides supported, missing keys ignored)
154
- // but a different vocabulary first-person status, mid-call only.
155
- // Per-tool keys (`tool.<toolName>`) win over the generic `tool` key.
114
+ // Status — chat-bubble surface (separate audience: the end user
115
+ // chatting; renamed from "thinking" in 5.0.0 to disambiguate from the
116
+ // MODEL's extended-thinking reasoning). State machine:
117
+ // idle / streaming / tool / paused. Same contract shape as commentary
118
+ // (`Record<string, string>` with `{{vars}}`, partial overrides
119
+ // supported, missing keys ignored) but a different vocabulary
120
+ // first-person status, mid-call only. Per-tool keys (`tool.<toolName>`)
121
+ // win over the generic `tool` key.
156
122
  var thinkingTemplates_js_1 = require("./recorders/observability/thinking/thinkingTemplates.js");
157
- Object.defineProperty(exports, "defaultThinkingTemplates", { enumerable: true, get: function () { return thinkingTemplates_js_1.defaultThinkingTemplates; } });
158
- Object.defineProperty(exports, "selectThinkingState", { enumerable: true, get: function () { return thinkingTemplates_js_1.selectThinkingState; } });
159
- Object.defineProperty(exports, "renderThinkingLine", { enumerable: true, get: function () { return thinkingTemplates_js_1.renderThinkingLine; } });
123
+ Object.defineProperty(exports, "defaultStatusTemplates", { enumerable: true, get: function () { return thinkingTemplates_js_1.defaultStatusTemplates; } });
124
+ Object.defineProperty(exports, "selectStatus", { enumerable: true, get: function () { return thinkingTemplates_js_1.selectStatus; } });
125
+ Object.defineProperty(exports, "renderStatusLine", { enumerable: true, get: function () { return thinkingTemplates_js_1.renderStatusLine; } });
160
126
  // Primitives (core/)
161
127
  var LLMCall_js_1 = require("./core/LLMCall.js");
162
128
  Object.defineProperty(exports, "LLMCall", { enumerable: true, get: function () { return LLMCall_js_1.LLMCall; } });
@@ -213,17 +179,14 @@ Object.defineProperty(exports, "LoopBuilder", { enumerable: true, get: function
213
179
  // because bundlers walking these never touch optional peer-dep code.
214
180
  //
215
181
  // Vendor-SDK-backed providers (AnthropicProvider, OpenAIProvider,
216
- // BedrockProvider) live ONLY at `agentfootprint/llm-providers` (or
217
- // the legacy `agentfootprint/providers` alias). That subpath
218
- // segregation means bundlers walking from `agentfootprint` main
182
+ // BedrockProvider) live ONLY at `agentfootprint/llm-providers`. That
183
+ // subpath segregation means bundlers walking from `agentfootprint` main
219
184
  // never see the lazy peer-dep requires for `@anthropic-ai/sdk`,
220
185
  // `openai`, `@aws-sdk/client-bedrock-runtime`, etc. — automatic
221
186
  // tree-shaking, no bundler-side workarounds.
222
187
  //
223
- // Migration (v2.4 v2.5):
224
- // import { AnthropicProvider } from 'agentfootprint'; // ❌ removed
188
+ // import { AnthropicProvider } from 'agentfootprint'; // ❌ not exported
225
189
  // import { AnthropicProvider } from 'agentfootprint/llm-providers'; // ✓ canonical
226
- // import { AnthropicProvider } from 'agentfootprint/providers'; // ✓ legacy alias
227
190
  var MockProvider_js_1 = require("./adapters/llm/MockProvider.js");
228
191
  Object.defineProperty(exports, "MockProvider", { enumerable: true, get: function () { return MockProvider_js_1.MockProvider; } });
229
192
  Object.defineProperty(exports, "mock", { enumerable: true, get: function () { return MockProvider_js_1.mock; } });
@@ -256,6 +219,8 @@ Object.defineProperty(exports, "buildListSkillsTool", { enumerable: true, get: f
256
219
  Object.defineProperty(exports, "buildReadSkillTool", { enumerable: true, get: function () { return index_js_1.buildReadSkillTool; } });
257
220
  Object.defineProperty(exports, "defineSteering", { enumerable: true, get: function () { return index_js_1.defineSteering; } });
258
221
  Object.defineProperty(exports, "defineFact", { enumerable: true, get: function () { return index_js_1.defineFact; } });
222
+ // Unified factory (type-discriminant over the four named factories above)
223
+ Object.defineProperty(exports, "defineInjection", { enumerable: true, get: function () { return index_js_1.defineInjection; } });
259
224
  // Patterns — factory functions composing primitives + core-flow into
260
225
  // well-known agent patterns from the research literature.
261
226
  __exportStar(require("./patterns/index.js"), exports);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ "use strict";
2
+ /**
3
+ * defineInjection — the unified injection factory (one factory, a `type`
4
+ * discriminant for the flavor).
5
+ *
6
+ * The named factories (`defineInstruction`, `defineSkill`, `defineSteering`,
7
+ * `defineFact`) are self-documenting sugar — prefer them when you know the
8
+ * flavor at author time. `defineInjection` is for the cases where the flavor is
9
+ * chosen *programmatically* (config-driven pipelines, a UI that lets users add
10
+ * any flavor, table-driven tests) — pass `type` and the same options the named
11
+ * factory takes:
12
+ *
13
+ * @example
14
+ * // these two are equivalent
15
+ * defineInstruction({ id: 'calm', prompt: '…', activeWhen });
16
+ * defineInjection({ type: 'instruction', id: 'calm', prompt: '…', activeWhen });
17
+ *
18
+ * @example // flavor decided at runtime
19
+ * const inj = defineInjection({ type: cfg.flavor, id: cfg.id, ...cfg.opts });
20
+ *
21
+ * All four flavors return the same `Injection` primitive — `type` simply routes
22
+ * to the matching named factory. RAG and Memory are NOT covered here: they are
23
+ * separate subsystems (retrieval + stores), not plain Injections.
24
+ */
25
+ Object.defineProperty(exports, "__esModule", { value: true });
26
+ exports.defineInjection = void 0;
27
+ const defineFact_js_1 = require("./defineFact.js");
28
+ const defineInstruction_js_1 = require("./defineInstruction.js");
29
+ const defineSkill_js_1 = require("./defineSkill.js");
30
+ const defineSteering_js_1 = require("./defineSteering.js");
31
+ function defineInjection(opts) {
32
+ // Each named factory reads only the fields it knows and constructs a fresh
33
+ // frozen Injection, so the extra `type` discriminant on `opts` is ignored.
34
+ switch (opts.type) {
35
+ case 'instruction':
36
+ return (0, defineInstruction_js_1.defineInstruction)(opts);
37
+ case 'skill':
38
+ return (0, defineSkill_js_1.defineSkill)(opts);
39
+ case 'steering':
40
+ return (0, defineSteering_js_1.defineSteering)(opts);
41
+ case 'fact':
42
+ return (0, defineFact_js_1.defineFact)(opts);
43
+ default: {
44
+ const exhaustive = opts;
45
+ throw new Error(`defineInjection: unknown injection type "${String(exhaustive.type)}".`);
46
+ }
47
+ }
48
+ }
49
+ exports.defineInjection = defineInjection;
50
+ //# sourceMappingURL=defineInjection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defineInjection.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/factories/defineInjection.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAGH,mDAAqE;AACrE,iEAA0F;AAC1F,qDAAwE;AACxE,2DAAiF;AAYjF,SAAgB,eAAe,CAAC,IAA4B;IAC1D,2EAA2E;IAC3E,2EAA2E;IAC3E,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,IAAA,wCAAiB,EAAC,IAAI,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,IAAA,4BAAW,EAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,IAAA,kCAAc,EAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,IAAA,0BAAU,EAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,IAAI,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,4CAA4C,MAAM,CAC/C,UAAiC,CAAC,IAAI,CACxC,IAAI,CACN,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AArBD,0CAqBC"}
@@ -7,7 +7,7 @@
7
7
  * factories. See `README.md` in this folder for the full concept.
8
8
  */
9
9
  Object.defineProperty(exports, "__esModule", { value: true });
10
- exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineInstruction = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.projectActiveInjection = void 0;
10
+ exports.defineInjection = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineInstruction = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.projectActiveInjection = void 0;
11
11
  // POJO projection — used by slot subflows + advanced consumers
12
12
  var types_js_1 = require("./types.js");
13
13
  Object.defineProperty(exports, "projectActiveInjection", { enumerable: true, get: function () { return types_js_1.projectActiveInjection; } });
@@ -35,4 +35,9 @@ var defineSteering_js_1 = require("./factories/defineSteering.js");
35
35
  Object.defineProperty(exports, "defineSteering", { enumerable: true, get: function () { return defineSteering_js_1.defineSteering; } });
36
36
  var defineFact_js_1 = require("./factories/defineFact.js");
37
37
  Object.defineProperty(exports, "defineFact", { enumerable: true, get: function () { return defineFact_js_1.defineFact; } });
38
+ // Unified factory — a `type` discriminant routes to the four named factories
39
+ // above. Use when the flavor is chosen programmatically; prefer the named
40
+ // factories when you know the flavor at author time.
41
+ var defineInjection_js_1 = require("./factories/defineInjection.js");
42
+ Object.defineProperty(exports, "defineInjection", { enumerable: true, get: function () { return defineInjection_js_1.defineInjection; } });
38
43
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAYH,+DAA+D;AAC/D,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAE/B,SAAS;AACT,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,mFAG0C;AAFxC,6IAAA,2BAA2B,OAAA;AAI7B,gFAAgF;AAChF,yEAAoG;AAA3F,yHAAA,iBAAiB,OAAA;AAE1B,6DAOoC;AANlC,6GAAA,WAAW,OAAA;AACX,oHAAA,kBAAkB,OAAA;AAOpB,uDAA8E;AAArE,iHAAA,aAAa,OAAA;AAEtB,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,iDAA8F;AAArF,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAEhD,mEAA2F;AAAlF,mHAAA,cAAc,OAAA;AAEvB,2DAA+E;AAAtE,2GAAA,UAAU,OAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAYH,+DAA+D;AAC/D,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAE/B,SAAS;AACT,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,mFAG0C;AAFxC,6IAAA,2BAA2B,OAAA;AAI7B,gFAAgF;AAChF,yEAAoG;AAA3F,yHAAA,iBAAiB,OAAA;AAE1B,6DAOoC;AANlC,6GAAA,WAAW,OAAA;AACX,oHAAA,kBAAkB,OAAA;AAOpB,uDAA8E;AAArE,iHAAA,aAAa,OAAA;AAEtB,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,iDAA8F;AAArF,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAEhD,mEAA2F;AAAlF,mHAAA,cAAc,OAAA;AAEvB,2DAA+E;AAAtE,2GAAA,UAAU,OAAA;AAEnB,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AACrD,qEAIwC;AAHtC,qHAAA,eAAe,OAAA"}
@@ -22,11 +22,7 @@
22
22
  * knows nothing about vendor specifics.
23
23
  *
24
24
  * @example
25
- * // New canonical import
26
25
  * import { mock, AnthropicProvider } from 'agentfootprint/llm-providers';
27
- *
28
- * // Legacy alias (still works through v2.x)
29
- * import { mock, AnthropicProvider } from 'agentfootprint/providers';
30
26
  */
31
27
  var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
32
28
  if (k2 === undefined) k2 = k;
@@ -1 +1 @@
1
- {"version":3,"file":"llm-providers.js","sourceRoot":"","sources":["../src/llm-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;;;;;;;;;;;;;;AAEH,iDAA+B"}
1
+ {"version":3,"file":"llm-providers.js","sourceRoot":"","sources":["../src/llm-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;;;;;;;;;;;AAEH,iDAA+B"}
@@ -12,7 +12,7 @@
12
12
  * "Looking up your order…"
13
13
  *
14
14
  * v2.4 shipped these as `defaultCommentaryTemplates` and
15
- * `defaultThinkingTemplates` (flat `Record<string, string>` maps with
15
+ * `defaultStatusTemplates` (flat `Record<string, string>` maps with
16
16
  * `{{var}}` substitution). The names worked but the framing was
17
17
  * generic — "templates" collides with TypeScript / templating-engine
18
18
  * terminology, and there was no first-class place to ship locale
@@ -74,12 +74,12 @@ const thinkingTemplates_js_1 = require("../recorders/observability/thinking/thin
74
74
  exports.defaultCommentaryMessages = commentaryTemplates_js_1.defaultCommentaryTemplates;
75
75
  /**
76
76
  * Canonical English thinking bundle. Alias of v2.4's
77
- * `defaultThinkingTemplates`.
77
+ * `defaultStatusTemplates`.
78
78
  *
79
79
  * Keys mirror agentfootprint event types; values may contain
80
80
  * `{{var}}` placeholders for runtime substitution.
81
81
  */
82
- exports.defaultThinkingMessages = thinkingTemplates_js_1.defaultThinkingTemplates;
82
+ exports.defaultThinkingMessages = thinkingTemplates_js_1.defaultStatusTemplates;
83
83
  /**
84
84
  * Spread `overrides` on top of `defaults` so every key in `defaults`
85
85
  * has a value (the override or the original). The result is a fresh
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/locales/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;;;AAEH,yGAA0G;AAC1G,mGAAoG;AAIpG;;;;;;GAMG;AACU,QAAA,yBAAyB,GAAG,mDAA0B,CAAC;AAEpE;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,+CAAwB,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAC7B,QAAW,EACX,YAA8C,EAAE;IAEhD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;AACtD,CAAC;AALD,0CAKC;AAoBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,gBAAgB,CAC9B,OAAyC,EACzC,YAA+B,EAC/B,OAAyC,EAAE;IAE3C,MAAM,QAAQ,GAA4B,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5F,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,iBAAiB,CAAC;IAClD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,KAAK,CAAC;IAElD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AA5BD,4CA4BC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/locales/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;;;AAEH,yGAA0G;AAC1G,mGAAkG;AAIlG;;;;;;GAMG;AACU,QAAA,yBAAyB,GAAG,mDAA0B,CAAC;AAEpE;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,6CAAsB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAC7B,QAAW,EACX,YAA8C,EAAE;IAEhD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;AACtD,CAAC;AALD,0CAKC;AAoBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,gBAAgB,CAC9B,OAAyC,EACzC,YAA+B,EAC/B,OAAyC,EAAE;IAE3C,MAAM,QAAQ,GAA4B,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5F,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,iBAAiB,CAAC;IAClD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,KAAK,CAAC;IAElD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AA5BD,4CA4BC"}
@@ -31,11 +31,7 @@
31
31
  * actually instantiate pull their SDK in.
32
32
  *
33
33
  * @example
34
- * // New canonical import
35
- * import { RedisStore } from 'agentfootprint/memory-providers';
36
- *
37
- * // Legacy per-adapter alias (still works through v2.x)
38
- * import { RedisStore } from 'agentfootprint/memory-redis';
34
+ * import { RedisStore, AgentCoreStore } from 'agentfootprint/memory-providers';
39
35
  */
40
36
  Object.defineProperty(exports, "__esModule", { value: true });
41
37
  exports.AgentCoreStore = exports.RedisStore = void 0;
@@ -1 +1 @@
1
- {"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../src/memory-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;;;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,uDAKoC;AAJlC,sGAAA,UAAU,OAAA;AAMZ,+DAIwC;AAHtC,8GAAA,cAAc,OAAA"}
1
+ {"version":3,"file":"memory-providers.js","sourceRoot":"","sources":["../src/memory-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,wDAAwD;AACxD,uDAKoC;AAJlC,sGAAA,UAAU,OAAA;AAMZ,+DAIwC;AAHtC,8GAAA,cAAc,OAAA"}
package/dist/observe.js CHANGED
@@ -26,13 +26,13 @@
26
26
  * • PermissionRecorder — permission decisions + denials
27
27
  * • SkillRecorder — skill activations
28
28
  * • LoggingRecorder — structured log lines per event
29
- * • ThinkingRecorder — chat-bubble first-person status
29
+ * • StatusRecorder — chat-bubble first-person status
30
30
  *
31
31
  * Domain-flavored consumers (Lens, Grafana, Datadog) compose Tier 1+2
32
32
  * directly; Tier 3 dashboards are opt-in.
33
33
  */
34
34
  Object.defineProperty(exports, "__esModule", { value: true });
35
- exports.typedEmit = exports.attachThinking = exports.LoggingDomains = exports.attachLogging = exports.skillRecorder = exports.permissionRecorder = exports.memoryRecorder = exports.evalRecorder = exports.costRecorder = exports.LiveAgentTurnTracker = exports.LiveToolTracker = exports.LiveLLMTracker = exports.LiveStateRecorder = exports.liveStateRecorder = exports.buildStepGraph = exports.attachFlowchart = exports.BoundaryRecorder = exports.boundaryRecorder = exports.agentRecorder = exports.compositionRecorder = exports.streamRecorder = exports.ContextRecorder = void 0;
35
+ exports.typedEmit = exports.attachStatus = exports.LoggingDomains = exports.attachLogging = exports.skillRecorder = exports.permissionRecorder = exports.memoryRecorder = exports.evalRecorder = exports.contextEvaluatedRecorder = exports.toolsRecorder = exports.costRecorder = exports.LiveAgentTurnTracker = exports.LiveToolTracker = exports.LiveLLMTracker = exports.LiveStateRecorder = exports.liveStateRecorder = exports.buildStepGraph = exports.attachFlowchart = exports.runStepRecorder = exports.RunStepRecorder = exports.buildRunSteps = exports.BoundaryRecorder = exports.boundaryRecorder = exports.agentRecorder = exports.compositionRecorder = exports.streamRecorder = exports.ContextRecorder = void 0;
36
36
  // Tier 1 — context + stream
37
37
  var ContextRecorder_js_1 = require("./recorders/core/ContextRecorder.js");
38
38
  Object.defineProperty(exports, "ContextRecorder", { enumerable: true, get: function () { return ContextRecorder_js_1.ContextRecorder; } });
@@ -46,6 +46,10 @@ Object.defineProperty(exports, "agentRecorder", { enumerable: true, get: functio
46
46
  var BoundaryRecorder_js_1 = require("./recorders/observability/BoundaryRecorder.js");
47
47
  Object.defineProperty(exports, "boundaryRecorder", { enumerable: true, get: function () { return BoundaryRecorder_js_1.boundaryRecorder; } });
48
48
  Object.defineProperty(exports, "BoundaryRecorder", { enumerable: true, get: function () { return BoundaryRecorder_js_1.BoundaryRecorder; } });
49
+ var RunStepRecorder_js_1 = require("./recorders/observability/RunStepRecorder.js");
50
+ Object.defineProperty(exports, "buildRunSteps", { enumerable: true, get: function () { return RunStepRecorder_js_1.buildRunSteps; } });
51
+ Object.defineProperty(exports, "RunStepRecorder", { enumerable: true, get: function () { return RunStepRecorder_js_1.RunStepRecorder; } });
52
+ Object.defineProperty(exports, "runStepRecorder", { enumerable: true, get: function () { return RunStepRecorder_js_1.runStepRecorder; } });
49
53
  var FlowchartRecorder_js_1 = require("./recorders/observability/FlowchartRecorder.js");
50
54
  Object.defineProperty(exports, "attachFlowchart", { enumerable: true, get: function () { return FlowchartRecorder_js_1.attachFlowchart; } });
51
55
  Object.defineProperty(exports, "buildStepGraph", { enumerable: true, get: function () { return FlowchartRecorder_js_1.buildStepGraph; } });
@@ -58,6 +62,10 @@ Object.defineProperty(exports, "LiveAgentTurnTracker", { enumerable: true, get:
58
62
  // Tier 3 — domain dashboards
59
63
  var CostRecorder_js_1 = require("./recorders/core/CostRecorder.js");
60
64
  Object.defineProperty(exports, "costRecorder", { enumerable: true, get: function () { return CostRecorder_js_1.costRecorder; } });
65
+ var ToolsRecorder_js_1 = require("./recorders/core/ToolsRecorder.js");
66
+ Object.defineProperty(exports, "toolsRecorder", { enumerable: true, get: function () { return ToolsRecorder_js_1.toolsRecorder; } });
67
+ var ContextEvaluatedRecorder_js_1 = require("./recorders/core/ContextEvaluatedRecorder.js");
68
+ Object.defineProperty(exports, "contextEvaluatedRecorder", { enumerable: true, get: function () { return ContextEvaluatedRecorder_js_1.contextEvaluatedRecorder; } });
61
69
  var EvalRecorder_js_1 = require("./recorders/core/EvalRecorder.js");
62
70
  Object.defineProperty(exports, "evalRecorder", { enumerable: true, get: function () { return EvalRecorder_js_1.evalRecorder; } });
63
71
  var MemoryRecorder_js_1 = require("./recorders/core/MemoryRecorder.js");
@@ -69,8 +77,8 @@ Object.defineProperty(exports, "skillRecorder", { enumerable: true, get: functio
69
77
  var LoggingRecorder_js_1 = require("./recorders/observability/LoggingRecorder.js");
70
78
  Object.defineProperty(exports, "attachLogging", { enumerable: true, get: function () { return LoggingRecorder_js_1.attachLogging; } });
71
79
  Object.defineProperty(exports, "LoggingDomains", { enumerable: true, get: function () { return LoggingRecorder_js_1.LoggingDomains; } });
72
- var ThinkingRecorder_js_1 = require("./recorders/observability/ThinkingRecorder.js");
73
- Object.defineProperty(exports, "attachThinking", { enumerable: true, get: function () { return ThinkingRecorder_js_1.attachThinking; } });
80
+ var StatusRecorder_js_1 = require("./recorders/observability/StatusRecorder.js");
81
+ Object.defineProperty(exports, "attachStatus", { enumerable: true, get: function () { return StatusRecorder_js_1.attachStatus; } });
74
82
  // Emit primitive — used by every Tier-3 source-domain.
75
83
  var typedEmit_js_1 = require("./recorders/core/typedEmit.js");
76
84
  Object.defineProperty(exports, "typedEmit", { enumerable: true, get: function () { return typedEmit_js_1.typedEmit; } });
@@ -1 +1 @@
1
- {"version":3,"file":"observe.js","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAEH,4BAA4B;AAC5B,0EAAmG;AAA1F,qHAAA,eAAe,OAAA;AACxB,wEAAgG;AAAvF,mHAAA,cAAc,OAAA;AAEvB,+BAA+B;AAC/B,kFAGiD;AAF/C,6HAAA,mBAAmB,OAAA;AAGrB,sEAA6F;AAApF,iHAAA,aAAa,OAAA;AACtB,qFAauD;AAZrD,uHAAA,gBAAgB,OAAA;AAChB,uHAAA,gBAAgB,OAAA;AAYlB,uFAUwD;AATtD,uHAAA,eAAe,OAAA;AACf,sHAAA,cAAc,OAAA;AAShB,uFAUwD;AATtD,yHAAA,iBAAiB,OAAA;AACjB,yHAAA,iBAAiB,OAAA;AACjB,sHAAA,cAAc,OAAA;AACd,uHAAA,eAAe,OAAA;AACf,4HAAA,oBAAoB,OAAA;AAOtB,6BAA6B;AAC7B,oEAA0F;AAAjF,+GAAA,YAAY,OAAA;AACrB,oEAA0F;AAAjF,+GAAA,YAAY,OAAA;AACrB,wEAAgG;AAAvF,mHAAA,cAAc,OAAA;AACvB,gFAGgD;AAF9C,2HAAA,kBAAkB,OAAA;AAGpB,sEAA6F;AAApF,iHAAA,aAAa,OAAA;AACtB,mFAMsD;AALpD,mHAAA,aAAa,OAAA;AACb,oHAAA,cAAc,OAAA;AAKhB,qFAIuD;AAHrD,qHAAA,cAAc,OAAA;AAKhB,uDAAuD;AACvD,8DAA0D;AAAjD,yGAAA,SAAS,OAAA"}
1
+ {"version":3,"file":"observe.js","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAEH,4BAA4B;AAC5B,0EAAmG;AAA1F,qHAAA,eAAe,OAAA;AACxB,wEAAgG;AAAvF,mHAAA,cAAc,OAAA;AAEvB,+BAA+B;AAC/B,kFAGiD;AAF/C,6HAAA,mBAAmB,OAAA;AAGrB,sEAA6F;AAApF,iHAAA,aAAa,OAAA;AACtB,qFAkBuD;AAjBrD,uHAAA,gBAAgB,OAAA;AAChB,uHAAA,gBAAgB,OAAA;AAiBlB,mFAWsD;AAVpD,mHAAA,aAAa,OAAA;AACb,qHAAA,eAAe,OAAA;AACf,qHAAA,eAAe,OAAA;AASjB,uFAUwD;AATtD,uHAAA,eAAe,OAAA;AACf,sHAAA,cAAc,OAAA;AAShB,uFAUwD;AATtD,yHAAA,iBAAiB,OAAA;AACjB,yHAAA,iBAAiB,OAAA;AACjB,sHAAA,cAAc,OAAA;AACd,uHAAA,eAAe,OAAA;AACf,4HAAA,oBAAoB,OAAA;AAOtB,6BAA6B;AAC7B,oEAA0F;AAAjF,+GAAA,YAAY,OAAA;AACrB,sEAA6F;AAApF,iHAAA,aAAa,OAAA;AACtB,4FAGsD;AAFpD,uIAAA,wBAAwB,OAAA;AAG1B,oEAA0F;AAAjF,+GAAA,YAAY,OAAA;AACrB,wEAAgG;AAAvF,mHAAA,cAAc,OAAA;AACvB,gFAGgD;AAF9C,2HAAA,kBAAkB,OAAA;AAGpB,sEAA6F;AAApF,iHAAA,aAAa,OAAA;AACtB,mFAMsD;AALpD,mHAAA,aAAa,OAAA;AACb,oHAAA,cAAc,OAAA;AAKhB,iFAIqD;AAHnD,iHAAA,YAAY,OAAA;AAKd,uDAAuD;AACvD,8DAA0D;AAAjD,yGAAA,SAAS,OAAA"}
package/dist/providers.js CHANGED
@@ -1,17 +1,12 @@
1
1
  "use strict";
2
2
  /**
3
- * agentfootprint/providersLLM provider adapters.
3
+ * LLM provider adapters implementation behind the `agentfootprint/llm-providers`
4
+ * subpath (which re-exports this file).
4
5
  *
5
- * **DEPRECATION NOTICE (v2.5):** This subpath is now the legacy alias.
6
- * The canonical name in v2.5+ is `agentfootprint/llm-providers`,
7
- * matching the parallel structure (`tool-providers` /
8
- * `memory-providers` / `security`). Existing imports keep working
9
- * unchanged through the v2.x line; the alias is removed in v3.0.
6
+ * The standalone `agentfootprint/providers` subpath alias was removed in 4.0.0.
7
+ * Import from the canonical subpath:
10
8
  *
11
- * // Old (still works through v2.x):
12
- * import { mock } from 'agentfootprint/providers';
13
- * // New canonical:
14
- * import { mock } from 'agentfootprint/llm-providers';
9
+ * import { mock, anthropic, openai } from 'agentfootprint/llm-providers';
15
10
  *
16
11
  * Pattern: Adapter (GoF) — concrete `LLMProvider` implementations that
17
12
  * translate the agentfootprint port to a specific vendor SDK.
@@ -1 +1 @@
1
- {"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,kEAKwC;AAJtC,+GAAA,YAAY,OAAA;AACZ,uGAAA,IAAI,OAAA;AAKN,4EAI6C;AAH3C,iHAAA,SAAS,OAAA;AACT,yHAAA,iBAAiB,OAAA;AAInB,sEAK0C;AAJxC,2GAAA,MAAM,OAAA;AACN,mHAAA,cAAc,OAAA;AACd,2GAAA,MAAM,OAAA;AAIR,wEAI2C;AAHzC,6GAAA,OAAO,OAAA;AACP,qHAAA,eAAe,OAAA;AAIjB,0FAIoD;AAHlD,+HAAA,gBAAgB,OAAA;AAChB,uIAAA,wBAAwB,OAAA;AAI1B,oFAIiD;AAH/C,yHAAA,aAAa,OAAA;AACb,iIAAA,qBAAqB,OAAA;AAIvB,sEAI0C;AAHxC,mHAAA,cAAc,OAAA"}
1
+ {"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAEH,kEAKwC;AAJtC,+GAAA,YAAY,OAAA;AACZ,uGAAA,IAAI,OAAA;AAKN,4EAI6C;AAH3C,iHAAA,SAAS,OAAA;AACT,yHAAA,iBAAiB,OAAA;AAInB,sEAK0C;AAJxC,2GAAA,MAAM,OAAA;AACN,mHAAA,cAAc,OAAA;AACd,2GAAA,MAAM,OAAA;AAIR,wEAI2C;AAHzC,6GAAA,OAAO,OAAA;AACP,qHAAA,eAAe,OAAA;AAIjB,0FAIoD;AAHlD,+HAAA,gBAAgB,OAAA;AAChB,uIAAA,wBAAwB,OAAA;AAI1B,oFAIiD;AAH/C,yHAAA,aAAa,OAAA;AACb,iIAAA,qBAAqB,OAAA;AAIvB,sEAI0C;AAHxC,mHAAA,cAAc,OAAA"}
@@ -194,7 +194,7 @@ exports.boundaryRecorder = boundaryRecorder;
194
194
  * to wire to the agentfootprint typed-event dispatcher.
195
195
  *
196
196
  * v5: composes a `SequenceStore<DomainEvent>` (storage) instead of
197
- * extending the deprecated `SequenceRecorder<T>` base. Time-travel
197
+ * extending the deprecated `SequenceStore<T>` base. Time-travel
198
198
  * utilities (`getEntryRanges`, `accumulate`) are accessed through the
199
199
  * store via the public read API on this class.
200
200
  */
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  /**
3
3
  * LiveStateRecorder — domain trackers built on the footprintjs
4
- * `BoundaryStateTracker<TState>` storage primitive (v4.17.2+).
4
+ * `BoundaryStateStore<TState>` storage primitive (v4.17.2+).
5
5
  *
6
6
  * **What this answers:** "Right now, mid-run, what's happening?"
7
7
  *
@@ -15,7 +15,7 @@
15
15
  *
16
16
  * **Mental model — observers vs. bookkeepers:**
17
17
  *
18
- * `BoundaryStateTracker<TState>` (footprintjs) = STORAGE shelf.
18
+ * `BoundaryStateStore<TState>` (footprintjs) = STORAGE shelf.
19
19
  * `EventDispatcher.on(...)` (agentfootprint) = OBSERVER source.
20
20
  *
21
21
  * Each domain tracker (`LiveLLMTracker`, `LiveToolTracker`,
@@ -25,7 +25,7 @@
25
25
  *
26
26
  * **Tier 1 (live) only.** Past states are not stored — when a boundary
27
27
  * closes, its transient state clears. For time-travel queries, snapshot
28
- * to a `SequenceRecorder<TState>` instead. See the BoundaryStateTracker
28
+ * to a `SequenceStore<TState>` instead. See the BoundaryStateStore
29
29
  * JSDoc for the rationale.
30
30
  *
31
31
  * @example Use the bundled façade — one attach, three live views:
@@ -310,11 +310,11 @@ exports.LiveAgentTurnTracker = LiveAgentTurnTracker;
310
310
  *
311
311
  * **What this is NOT for:**
312
312
  * - Time-travel queries (Tier 1 only — live state)
313
- * - Aggregations (use SequenceRecorder.aggregate)
313
+ * - Aggregations (use SequenceStore.aggregate)
314
314
  * - Stage-level observation (use Recorder.onStageStart/End)
315
315
  *
316
316
  * **Composition over inheritance:** the façade does NOT extend
317
- * `BoundaryStateTracker` itself — different boundary kinds need
317
+ * `BoundaryStateStore` itself — different boundary kinds need
318
318
  * separate active maps to avoid key collisions between LLM and tool
319
319
  * boundaries. Each sub-tracker keeps its own state.
320
320
  */
@@ -3,7 +3,10 @@
3
3
  * LoggingRecorder — firehose-style structured logging of every event.
4
4
  *
5
5
  * Pattern: Facade over EventDispatcher's wildcard subscription.
6
- * Role: Tier 3 observability — enabled via `agent.enable.logging({...})`.
6
+ * Role: Tier 3 observability — the low-level helper behind
7
+ * `attachLogging(dispatcher, {...})` (exported from
8
+ * `agentfootprint/observe`). For the high-level, uniform path use
9
+ * `agent.enable.observability({ strategy: consoleObservability() })`.
7
10
  * Developer debugging tool; production typically uses an OTEL
8
11
  * recorder instead.
9
12
  * Emits: Does NOT emit; READS the dispatcher and writes to the logger.
@@ -21,8 +24,8 @@ exports.attachLogging = exports.LoggingDomains = void 0;
21
24
  * Raw strings still work (backed by the same literal union type below).
22
25
  *
23
26
  * @example
24
- * agent.enable.logging({ domains: [LoggingDomains.CONTEXT, LoggingDomains.STREAM] });
25
- * agent.enable.logging({ domains: ['context', 'stream'] }); // equivalent
27
+ * attachLogging(dispatcher, { domains: [LoggingDomains.CONTEXT, LoggingDomains.STREAM] });
28
+ * attachLogging(dispatcher, { domains: ['context', 'stream'] }); // equivalent
26
29
  */
27
30
  exports.LoggingDomains = {
28
31
  /** Context-engineering events (the 3-slot model). THE DEBUG CORE. */