@smthrs/observability 0.35.0 → 1.0.0-rc.4

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 (363) hide show
  1. package/CHANGELOG.md +56 -0
  2. package/LICENSE +1 -1
  3. package/README.md +84 -0
  4. package/dist/cjs/BrowserOtel.d.ts +37 -0
  5. package/dist/cjs/BrowserOtel.d.ts.map +1 -0
  6. package/dist/cjs/BrowserOtel.js +47 -0
  7. package/dist/cjs/BrowserOtel.js.map +7 -0
  8. package/dist/cjs/Endpoint.d.ts +70 -0
  9. package/dist/cjs/Endpoint.d.ts.map +1 -0
  10. package/dist/cjs/Endpoint.js +85 -0
  11. package/dist/cjs/Endpoint.js.map +7 -0
  12. package/dist/cjs/JournalLogger.d.ts +232 -0
  13. package/dist/cjs/JournalLogger.d.ts.map +1 -0
  14. package/dist/cjs/JournalLogger.js +388 -0
  15. package/dist/cjs/JournalLogger.js.map +7 -0
  16. package/dist/cjs/Logger.d.ts +55 -0
  17. package/dist/cjs/Logger.d.ts.map +1 -0
  18. package/dist/cjs/Logger.js +72 -0
  19. package/dist/cjs/Logger.js.map +7 -0
  20. package/dist/cjs/Metric.d.ts +67 -0
  21. package/dist/cjs/Metric.d.ts.map +1 -0
  22. package/dist/cjs/Metric.js +68 -0
  23. package/dist/cjs/Metric.js.map +7 -0
  24. package/dist/cjs/NodeOtel.d.ts +42 -0
  25. package/dist/cjs/NodeOtel.d.ts.map +1 -0
  26. package/dist/cjs/NodeOtel.js +78 -0
  27. package/dist/cjs/NodeOtel.js.map +7 -0
  28. package/dist/cjs/Otel.d.ts +62 -0
  29. package/dist/cjs/Otel.d.ts.map +1 -0
  30. package/dist/cjs/Otel.js +75 -0
  31. package/dist/cjs/Otel.js.map +7 -0
  32. package/dist/cjs/Otlp.d.ts +200 -0
  33. package/dist/cjs/Otlp.d.ts.map +1 -0
  34. package/dist/cjs/Otlp.js +235 -0
  35. package/dist/cjs/Otlp.js.map +7 -0
  36. package/dist/cjs/Resource.d.ts +162 -0
  37. package/dist/cjs/Resource.d.ts.map +1 -0
  38. package/dist/cjs/Resource.js +186 -0
  39. package/dist/cjs/Resource.js.map +7 -0
  40. package/dist/cjs/index.d.ts +61 -0
  41. package/dist/cjs/index.d.ts.map +1 -0
  42. package/dist/cjs/index.js +47 -0
  43. package/dist/cjs/index.js.map +7 -0
  44. package/dist/cjs/internal/schemaIssuePath.d.ts +31 -0
  45. package/dist/cjs/internal/schemaIssuePath.d.ts.map +1 -0
  46. package/dist/cjs/internal/schemaIssuePath.js +49 -0
  47. package/dist/cjs/internal/schemaIssuePath.js.map +7 -0
  48. package/dist/cjs/package.json +1 -0
  49. package/dist/esm/BrowserOtel.d.ts +37 -0
  50. package/dist/esm/BrowserOtel.d.ts.map +1 -0
  51. package/dist/esm/BrowserOtel.js +24 -0
  52. package/dist/esm/BrowserOtel.js.map +1 -0
  53. package/dist/esm/Endpoint.d.ts +70 -0
  54. package/dist/esm/Endpoint.d.ts.map +1 -0
  55. package/dist/esm/Endpoint.js +110 -0
  56. package/dist/esm/Endpoint.js.map +1 -0
  57. package/dist/esm/JournalLogger.d.ts +232 -0
  58. package/dist/esm/JournalLogger.d.ts.map +1 -0
  59. package/dist/esm/JournalLogger.js +482 -0
  60. package/dist/esm/JournalLogger.js.map +1 -0
  61. package/dist/esm/Logger.d.ts +55 -0
  62. package/dist/esm/Logger.d.ts.map +1 -0
  63. package/dist/esm/Logger.js +60 -0
  64. package/dist/esm/Logger.js.map +1 -0
  65. package/dist/esm/Metric.d.ts +67 -0
  66. package/dist/esm/Metric.d.ts.map +1 -0
  67. package/dist/esm/Metric.js +80 -0
  68. package/dist/esm/Metric.js.map +1 -0
  69. package/dist/esm/NodeOtel.d.ts +42 -0
  70. package/dist/esm/NodeOtel.d.ts.map +1 -0
  71. package/dist/esm/NodeOtel.js +56 -0
  72. package/dist/esm/NodeOtel.js.map +1 -0
  73. package/dist/esm/Otel.d.ts +62 -0
  74. package/dist/esm/Otel.d.ts.map +1 -0
  75. package/dist/esm/Otel.js +51 -0
  76. package/dist/esm/Otel.js.map +1 -0
  77. package/dist/esm/Otlp.d.ts +200 -0
  78. package/dist/esm/Otlp.d.ts.map +1 -0
  79. package/dist/esm/Otlp.js +350 -0
  80. package/dist/esm/Otlp.js.map +1 -0
  81. package/dist/esm/Resource.d.ts +162 -0
  82. package/dist/esm/Resource.d.ts.map +1 -0
  83. package/dist/esm/Resource.js +237 -0
  84. package/dist/esm/Resource.js.map +1 -0
  85. package/dist/esm/index.d.ts +61 -0
  86. package/dist/esm/index.d.ts.map +1 -0
  87. package/dist/esm/index.js +61 -0
  88. package/dist/esm/index.js.map +1 -0
  89. package/dist/esm/internal/schemaIssuePath.d.ts +31 -0
  90. package/dist/esm/internal/schemaIssuePath.d.ts.map +1 -0
  91. package/dist/esm/internal/schemaIssuePath.js +59 -0
  92. package/dist/esm/internal/schemaIssuePath.js.map +1 -0
  93. package/docs/README.md +162 -0
  94. package/docs/api.md +768 -0
  95. package/docs/concepts/instrumentation-and-export.md +68 -0
  96. package/docs/concepts/layer-map.md +72 -0
  97. package/docs/concepts/validated-acquisition.md +105 -0
  98. package/docs/guides/export-to-a-collector.md +167 -0
  99. package/docs/guides/forward-logs-to-the-journal.md +226 -0
  100. package/docs/guides/install-a-logger.md +111 -0
  101. package/docs/guides/read-runtime-metrics.md +83 -0
  102. package/docs/guides/testing.md +134 -0
  103. package/docs/guides/wire-an-opentelemetry-sdk.md +220 -0
  104. package/docs/installation.md +98 -0
  105. package/docs/quickstart.md +145 -0
  106. package/docs/troubleshooting.md +168 -0
  107. package/package.json +221 -32
  108. package/src/BrowserOtel.ts +51 -0
  109. package/src/Endpoint.ts +131 -0
  110. package/src/JournalLogger.ts +596 -0
  111. package/src/Logger.ts +106 -0
  112. package/src/Metric.ts +88 -0
  113. package/src/NodeOtel.ts +90 -0
  114. package/src/Otel.ts +117 -0
  115. package/src/Otlp.ts +477 -0
  116. package/src/Resource.ts +324 -0
  117. package/src/index.ts +67 -0
  118. package/src/internal/schemaIssuePath.ts +65 -0
  119. package/docker-compose.otel.yml +0 -104
  120. package/grafana/dashboards/smithers-dashboard.json +0 -453
  121. package/grafana/provisioning/dashboards/dashboards.yml +0 -12
  122. package/grafana/provisioning/datasources/datasources.yml +0 -49
  123. package/loki/loki-config.yaml +0 -35
  124. package/otel-collector-config.yml +0 -38
  125. package/prometheus/prometheus.yml +0 -8
  126. package/src/MetricName.ts +0 -1
  127. package/src/MetricsServiceLive.js +0 -9
  128. package/src/README.md +0 -28
  129. package/src/ResolvedSmithersObservabilityOptions.ts +0 -12
  130. package/src/SmithersEvent.ts +0 -843
  131. package/src/SmithersLogFormat.ts +0 -1
  132. package/src/SmithersMetricDefinition.ts +0 -15
  133. package/src/SmithersMetricType.ts +0 -1
  134. package/src/SmithersMetricUnit.ts +0 -1
  135. package/src/SmithersObservability.js +0 -15
  136. package/src/SmithersObservabilityOptions.ts +0 -12
  137. package/src/SmithersObservabilityService.ts +0 -13
  138. package/src/_coreCorrelation/CorrelationContext.ts +0 -10
  139. package/src/_coreCorrelation/CorrelationContextLive.js +0 -11
  140. package/src/_coreCorrelation/CorrelationContextService.js +0 -15
  141. package/src/_coreCorrelation/CorrelationContextServiceShape.ts +0 -12
  142. package/src/_coreCorrelation/CorrelationPatch.ts +0 -3
  143. package/src/_coreCorrelation/README.md +0 -20
  144. package/src/_coreCorrelation/_correlationStorage.js +0 -4
  145. package/src/_coreCorrelation/correlationContextFiberRef.js +0 -5
  146. package/src/_coreCorrelation/correlationContextToLogAnnotations.js +0 -18
  147. package/src/_coreCorrelation/getCurrentCorrelationContext.js +0 -9
  148. package/src/_coreCorrelation/getCurrentCorrelationContextEffect.js +0 -11
  149. package/src/_coreCorrelation/index.js +0 -14
  150. package/src/_coreCorrelation/mergeCorrelationContext.js +0 -51
  151. package/src/_coreCorrelation/runWithCorrelationContext.js +0 -14
  152. package/src/_coreCorrelation/updateCurrentCorrelationContext.js +0 -17
  153. package/src/_coreCorrelation/withCorrelationContext.js +0 -38
  154. package/src/_coreCorrelation/withCurrentCorrelationContext.js +0 -11
  155. package/src/_coreMetrics.js +0 -14
  156. package/src/_coreMetricsShape.ts +0 -44
  157. package/src/_corePrometheus.js +0 -91
  158. package/src/_corePrometheusShape.ts +0 -11
  159. package/src/_coreTracing.js +0 -132
  160. package/src/_coreTracingShape.ts +0 -17
  161. package/src/_otelLogBuilders.js +0 -102
  162. package/src/_sessionFileResolvers.js +0 -164
  163. package/src/_smithersSpanAttributeAliases.js +0 -19
  164. package/src/_smithersTraceSpanStorage.js +0 -3
  165. package/src/_traceEventNormalizers.js +0 -499
  166. package/src/_traceRedaction.js +0 -162
  167. package/src/agentSessionEventToOtelLogRecord.js +0 -55
  168. package/src/agentTrace.ts +0 -144
  169. package/src/agentTraceCapabilities.js +0 -151
  170. package/src/annotateSmithersTrace.js +0 -11
  171. package/src/canonicalTraceEventToOtelLogRecord.js +0 -55
  172. package/src/correlation.js +0 -56
  173. package/src/createSmithersObservabilityLayer.js +0 -59
  174. package/src/createSmithersOtelLayer.js +0 -23
  175. package/src/createSmithersRuntimeLayer.js +0 -2
  176. package/src/detectAgentFamily.js +0 -26
  177. package/src/detectCaptureMode.js +0 -29
  178. package/src/emitOtelLogRecord.js +0 -19
  179. package/src/getCurrentSmithersTraceAnnotations.js +0 -14
  180. package/src/getCurrentSmithersTraceSpan.js +0 -7
  181. package/src/index.d.ts +0 -1392
  182. package/src/index.js +0 -137
  183. package/src/kindPhase.js +0 -17
  184. package/src/logging.js +0 -264
  185. package/src/makeSmithersSpanAttributes.js +0 -20
  186. package/src/metrics/README.md +0 -22
  187. package/src/metrics/SmithersMetricDefinition.ts +0 -17
  188. package/src/metrics/SmithersMetricType.ts +0 -1
  189. package/src/metrics/SmithersMetricUnit.ts +0 -1
  190. package/src/metrics/_asyncExternalWaitCounts.js +0 -4
  191. package/src/metrics/_buckets.js +0 -37
  192. package/src/metrics/_incrementGauge.js +0 -11
  193. package/src/metrics/_processStartMs.js +0 -1
  194. package/src/metrics/activeNodes.js +0 -2
  195. package/src/metrics/activeRuns.js +0 -2
  196. package/src/metrics/agentActionsTotal.js +0 -2
  197. package/src/metrics/agentDurationMs.js +0 -3
  198. package/src/metrics/agentErrorsTotal.js +0 -2
  199. package/src/metrics/agentEventsTotal.js +0 -2
  200. package/src/metrics/agentInvocationsTotal.js +0 -2
  201. package/src/metrics/agentRetriesTotal.js +0 -2
  202. package/src/metrics/agentSessionsTotal.js +0 -2
  203. package/src/metrics/agentTokensTotal.js +0 -2
  204. package/src/metrics/alertDeliveriesAttempted.js +0 -2
  205. package/src/metrics/alertDeliveriesSuppressed.js +0 -2
  206. package/src/metrics/alertsAcknowledgedTotal.js +0 -2
  207. package/src/metrics/alertsActive.js +0 -2
  208. package/src/metrics/alertsEscalatedTotal.js +0 -2
  209. package/src/metrics/alertsFiredTotal.js +0 -2
  210. package/src/metrics/alertsReopenedTotal.js +0 -2
  211. package/src/metrics/alertsResolvedTotal.js +0 -2
  212. package/src/metrics/alertsSilencedTotal.js +0 -2
  213. package/src/metrics/approvalPending.js +0 -2
  214. package/src/metrics/approvalWaitDuration.js +0 -5
  215. package/src/metrics/approvalsDenied.js +0 -2
  216. package/src/metrics/approvalsGranted.js +0 -2
  217. package/src/metrics/approvalsRequested.js +0 -2
  218. package/src/metrics/attemptDuration.js +0 -3
  219. package/src/metrics/attentionBacklog.js +0 -2
  220. package/src/metrics/cacheHits.js +0 -2
  221. package/src/metrics/cacheMisses.js +0 -2
  222. package/src/metrics/dbQueryDuration.js +0 -3
  223. package/src/metrics/dbRetries.js +0 -2
  224. package/src/metrics/dbTransactionDuration.js +0 -3
  225. package/src/metrics/dbTransactionRetries.js +0 -2
  226. package/src/metrics/dbTransactionRollbacks.js +0 -2
  227. package/src/metrics/devtoolsActiveSubscribers.js +0 -2
  228. package/src/metrics/devtoolsBackpressureDisconnectTotal.js +0 -2
  229. package/src/metrics/devtoolsDeltaBuildMs.js +0 -3
  230. package/src/metrics/devtoolsEventBytes.js +0 -3
  231. package/src/metrics/devtoolsEventTotal.js +0 -2
  232. package/src/metrics/devtoolsSnapshotBuildMs.js +0 -5
  233. package/src/metrics/devtoolsSubscribeTotal.js +0 -2
  234. package/src/metrics/errorsTotal.js +0 -2
  235. package/src/metrics/eventsEmittedTotal.js +0 -2
  236. package/src/metrics/externalWaitAsyncPending.js +0 -2
  237. package/src/metrics/gatewayApprovalDecisionsTotal.js +0 -2
  238. package/src/metrics/gatewayAuthEventsTotal.js +0 -2
  239. package/src/metrics/gatewayConnectionsActive.js +0 -2
  240. package/src/metrics/gatewayConnectionsClosedTotal.js +0 -2
  241. package/src/metrics/gatewayConnectionsTotal.js +0 -2
  242. package/src/metrics/gatewayCronTriggersTotal.js +0 -2
  243. package/src/metrics/gatewayErrorsTotal.js +0 -2
  244. package/src/metrics/gatewayHeartbeatTicksTotal.js +0 -2
  245. package/src/metrics/gatewayMessagesReceivedTotal.js +0 -2
  246. package/src/metrics/gatewayMessagesSentTotal.js +0 -2
  247. package/src/metrics/gatewayRpcCallsTotal.js +0 -2
  248. package/src/metrics/gatewayRpcDuration.js +0 -3
  249. package/src/metrics/gatewayRunEventBackpressureDisconnectTotal.js +0 -4
  250. package/src/metrics/gatewayRunsCompletedTotal.js +0 -2
  251. package/src/metrics/gatewayRunsStartedTotal.js +0 -2
  252. package/src/metrics/gatewaySignalsTotal.js +0 -2
  253. package/src/metrics/gatewayWebhooksReceivedTotal.js +0 -2
  254. package/src/metrics/gatewayWebhooksRejectedTotal.js +0 -2
  255. package/src/metrics/gatewayWebhooksVerifiedTotal.js +0 -2
  256. package/src/metrics/heartbeatDataSizeBytes.js +0 -5
  257. package/src/metrics/heartbeatIntervalMs.js +0 -3
  258. package/src/metrics/hotReloadDuration.js +0 -3
  259. package/src/metrics/hotReloadFailures.js +0 -2
  260. package/src/metrics/hotReloads.js +0 -2
  261. package/src/metrics/httpRequestDuration.js +0 -3
  262. package/src/metrics/httpRequests.js +0 -2
  263. package/src/metrics/index.d.ts +0 -1222
  264. package/src/metrics/index.js +0 -168
  265. package/src/metrics/memoryFactReads.js +0 -3
  266. package/src/metrics/memoryFactWrites.js +0 -3
  267. package/src/metrics/memoryMessageSaves.js +0 -3
  268. package/src/metrics/memoryRecallDuration.js +0 -11
  269. package/src/metrics/memoryRecallQueries.js +0 -3
  270. package/src/metrics/metricsServiceAdapter.js +0 -181
  271. package/src/metrics/nodeDuration.js +0 -3
  272. package/src/metrics/nodeRetriesTotal.js +0 -2
  273. package/src/metrics/nodesFailed.js +0 -2
  274. package/src/metrics/nodesFinished.js +0 -2
  275. package/src/metrics/nodesStarted.js +0 -2
  276. package/src/metrics/openApiToolCallErrorsTotal.js +0 -3
  277. package/src/metrics/openApiToolCallsTotal.js +0 -3
  278. package/src/metrics/openApiToolDuration.js +0 -9
  279. package/src/metrics/processHeapUsedBytes.js +0 -2
  280. package/src/metrics/processMemoryRssBytes.js +0 -2
  281. package/src/metrics/processUptimeSeconds.js +0 -2
  282. package/src/metrics/promptSizeBytes.js +0 -3
  283. package/src/metrics/replaysStarted.js +0 -3
  284. package/src/metrics/responseSizeBytes.js +0 -3
  285. package/src/metrics/rewindDurationMs.js +0 -3
  286. package/src/metrics/rewindFramesDeleted.js +0 -3
  287. package/src/metrics/rewindRollbackTotal.js +0 -2
  288. package/src/metrics/rewindSandboxesReverted.js +0 -3
  289. package/src/metrics/rewindTotal.js +0 -2
  290. package/src/metrics/runDuration.js +0 -3
  291. package/src/metrics/runForksCreated.js +0 -3
  292. package/src/metrics/runsAncestryDepth.js +0 -3
  293. package/src/metrics/runsCancelledTotal.js +0 -2
  294. package/src/metrics/runsCarriedStateBytes.js +0 -5
  295. package/src/metrics/runsContinuedTotal.js +0 -2
  296. package/src/metrics/runsFailedTotal.js +0 -2
  297. package/src/metrics/runsFinishedTotal.js +0 -2
  298. package/src/metrics/runsResumedTotal.js +0 -2
  299. package/src/metrics/runsTotal.js +0 -2
  300. package/src/metrics/sandboxActive.js +0 -2
  301. package/src/metrics/sandboxBundleSizeBytes.js +0 -5
  302. package/src/metrics/sandboxCompletedTotal.js +0 -2
  303. package/src/metrics/sandboxCreatedTotal.js +0 -2
  304. package/src/metrics/sandboxDurationMs.js +0 -3
  305. package/src/metrics/sandboxPatchCount.js +0 -3
  306. package/src/metrics/sandboxTransportDurationMs.js +0 -5
  307. package/src/metrics/schedulerConcurrencyUtilization.js +0 -2
  308. package/src/metrics/schedulerQueueDepth.js +0 -2
  309. package/src/metrics/schedulerWaitDuration.js +0 -5
  310. package/src/metrics/scorerDuration.js +0 -9
  311. package/src/metrics/scorerEventsFailed.js +0 -2
  312. package/src/metrics/scorerEventsFinished.js +0 -2
  313. package/src/metrics/scorerEventsStarted.js +0 -2
  314. package/src/metrics/scorersFailed.js +0 -3
  315. package/src/metrics/scorersFinished.js +0 -3
  316. package/src/metrics/scorersStarted.js +0 -3
  317. package/src/metrics/smithersMetricCatalog.js +0 -893
  318. package/src/metrics/smithersMetricCatalogByKey.js +0 -2
  319. package/src/metrics/smithersMetricCatalogByName.js +0 -2
  320. package/src/metrics/smithersMetricCatalogByPrometheusName.js +0 -4
  321. package/src/metrics/snapshotDuration.js +0 -9
  322. package/src/metrics/snapshotsCaptured.js +0 -3
  323. package/src/metrics/supervisorPollDuration.js +0 -5
  324. package/src/metrics/supervisorPollsTotal.js +0 -2
  325. package/src/metrics/supervisorResumeLag.js +0 -5
  326. package/src/metrics/supervisorResumedTotal.js +0 -2
  327. package/src/metrics/supervisorSkippedTotal.js +0 -2
  328. package/src/metrics/supervisorStaleDetected.js +0 -2
  329. package/src/metrics/taskHeartbeatTimeoutTotal.js +0 -2
  330. package/src/metrics/taskHeartbeatsTotal.js +0 -2
  331. package/src/metrics/timerDelayDuration.js +0 -3
  332. package/src/metrics/timersCancelled.js +0 -2
  333. package/src/metrics/timersCreated.js +0 -2
  334. package/src/metrics/timersFired.js +0 -2
  335. package/src/metrics/timersPending.js +0 -2
  336. package/src/metrics/toPrometheusMetricName.js +0 -8
  337. package/src/metrics/tokensCacheReadTotal.js +0 -2
  338. package/src/metrics/tokensCacheWriteTotal.js +0 -2
  339. package/src/metrics/tokensContextWindowBucketTotal.js +0 -2
  340. package/src/metrics/tokensContextWindowPerCall.js +0 -5
  341. package/src/metrics/tokensInputPerCall.js +0 -3
  342. package/src/metrics/tokensInputTotal.js +0 -2
  343. package/src/metrics/tokensOutputPerCall.js +0 -3
  344. package/src/metrics/tokensOutputTotal.js +0 -2
  345. package/src/metrics/tokensReasoningTotal.js +0 -2
  346. package/src/metrics/toolCallErrorsTotal.js +0 -2
  347. package/src/metrics/toolCallsTotal.js +0 -2
  348. package/src/metrics/toolDuration.js +0 -3
  349. package/src/metrics/toolOutputTruncatedTotal.js +0 -2
  350. package/src/metrics/trackEvent.js +0 -608
  351. package/src/metrics/updateAsyncExternalWaitPending.js +0 -18
  352. package/src/metrics/updateProcessMetrics.js +0 -20
  353. package/src/metrics/vcsDuration.js +0 -3
  354. package/src/normalizeStructuredEvent.js +0 -15
  355. package/src/prometheusContentType.js +0 -1
  356. package/src/renderPrometheusMetrics.js +0 -212
  357. package/src/resolveAgentTraceCapabilities.js +0 -59
  358. package/src/resolveSmithersObservabilityOptions.js +0 -109
  359. package/src/smithersMetrics.js +0 -2
  360. package/src/smithersSpanNames.js +0 -6
  361. package/src/unsupportedKindsForCapabilities.js +0 -32
  362. package/src/withSmithersSpan.js +0 -17
  363. package/tempo/tempo.yml +0 -17
package/src/index.d.ts DELETED
@@ -1,1392 +0,0 @@
1
- import { LogLevel, Effect, Context, Metric, Layer } from 'effect';
2
- import * as effect_Tracer from 'effect/Tracer';
3
- import * as effect_Metric from 'effect/Metric';
4
- import * as BunContext from '@effect/platform-bun/BunServices';
5
-
6
- type SmithersLogFormat$1 = "json" | "pretty" | "string" | "logfmt";
7
-
8
- type ResolvedSmithersObservabilityOptions$2 = {
9
- readonly enabled: boolean;
10
- readonly endpoint: string;
11
- readonly headers: Record<string, string> | undefined;
12
- readonly serviceName: string;
13
- readonly logFormat: SmithersLogFormat$1;
14
- readonly logLevel: LogLevel.LogLevel;
15
- readonly installLogger: boolean;
16
- };
17
-
18
- type SmithersObservabilityService$2 = {
19
- readonly options: ResolvedSmithersObservabilityOptions$2;
20
- readonly annotate: (attributes: Readonly<Record<string, unknown>>) => Effect.Effect<void>;
21
- readonly withSpan: <A, E, R>(name: string, effect: Effect.Effect<A, E, R>, attributes?: Readonly<Record<string, unknown>>) => Effect.Effect<A, E, Exclude<R, effect_Tracer.ParentSpan>>;
22
- };
23
-
24
- type SmithersObservabilityOptions$4 = {
25
- readonly enabled?: boolean;
26
- readonly endpoint?: string;
27
- readonly headers?: Record<string, string>;
28
- readonly serviceName?: string;
29
- readonly logFormat?: SmithersLogFormat$1;
30
- readonly logLevel?: LogLevel.LogLevel | string;
31
- readonly installLogger?: boolean;
32
- };
33
-
34
- type MetricLabels$1 = Readonly<Record<string, string | number | boolean>>;
35
-
36
- type SmithersMetricType$1 = "counter" | "gauge" | "histogram";
37
-
38
- type SmithersMetricUnit$1 = "count" | "milliseconds" | "seconds" | "bytes" | "tokens" | "ratio" | "depth";
39
-
40
- type SmithersMetricDefinition$2 = {
41
- readonly key: string;
42
- readonly name: string;
43
- readonly prometheusName: string;
44
- readonly type: SmithersMetricType$1;
45
- readonly label: string;
46
- readonly unit?: SmithersMetricUnit$1;
47
- readonly labels?: readonly string[];
48
- readonly defaultLabels?: readonly MetricLabels$1[];
49
- readonly boundaries?: readonly number[];
50
- };
51
-
52
- type AgentFamily = "pi" | "codex" | "claude-code" | "antigravity" | "gemini" | "kimi" | "openai" | "anthropic" | "amp" | "forge" | "unknown";
53
- type AgentCaptureMode = "sdk-events" | "rpc-events" | "cli-json-stream" | "cli-json" | "cli-text" | "artifact-import";
54
- type TraceCompleteness = "full-observed" | "partial-observed" | "final-only" | "capture-failed";
55
- type CanonicalAgentTraceEventKind = "session.start" | "session.end" | "turn.start" | "turn.end" | "message.start" | "message.update" | "message.end" | "assistant.text.delta" | "assistant.thinking.delta" | "assistant.message.final" | "tool.execution.start" | "tool.execution.update" | "tool.execution.end" | "tool.result" | "retry.start" | "retry.end" | "compaction.start" | "compaction.end" | "stderr" | "stdout" | "usage" | "capture.warning" | "capture.error" | "artifact.created";
56
- type CanonicalAgentTraceEventPhase = "agent" | "turn" | "message" | "tool" | "session" | "capture" | "artifact";
57
- type CanonicalAgentTraceEvent = {
58
- traceVersion: "1";
59
- runId: string;
60
- workflowPath?: string;
61
- workflowHash?: string;
62
- nodeId: string;
63
- iteration: number;
64
- attempt: number;
65
- timestampMs: number;
66
- event: {
67
- sequence: number;
68
- kind: CanonicalAgentTraceEventKind;
69
- phase: CanonicalAgentTraceEventPhase;
70
- };
71
- source: {
72
- agentFamily: AgentFamily;
73
- captureMode: AgentCaptureMode;
74
- rawType?: string;
75
- rawEventId?: string;
76
- observed: boolean;
77
- };
78
- traceCompleteness: TraceCompleteness;
79
- payload: Record<string, unknown> | null;
80
- raw: unknown;
81
- redaction: {
82
- applied: boolean;
83
- ruleIds: string[];
84
- };
85
- annotations: Record<string, string | number | boolean>;
86
- };
87
- type AgentTraceSummary = {
88
- traceVersion: "1";
89
- runId: string;
90
- workflowPath?: string;
91
- workflowHash?: string;
92
- nodeId: string;
93
- iteration: number;
94
- attempt: number;
95
- traceStartedAtMs: number;
96
- traceFinishedAtMs: number;
97
- agentFamily: AgentFamily;
98
- agentId?: string;
99
- model?: string;
100
- captureMode: AgentCaptureMode;
101
- traceCompleteness: TraceCompleteness;
102
- unsupportedEventKinds: CanonicalAgentTraceEventKind[];
103
- missingExpectedEventKinds: CanonicalAgentTraceEventKind[];
104
- rawArtifactRefs: string[];
105
- };
106
- type AgentSessionTranscriptEvent = {
107
- transcriptVersion: "1";
108
- runId: string;
109
- workflowPath?: string;
110
- workflowHash?: string;
111
- nodeId: string;
112
- iteration: number;
113
- attempt: number;
114
- timestampMs: number;
115
- event: {
116
- sequence: number;
117
- rowType: string;
118
- };
119
- source: {
120
- agentFamily: AgentFamily;
121
- captureMode: AgentCaptureMode;
122
- ingestSource: "live" | "artifact";
123
- observedLive: boolean;
124
- providerSessionId?: string;
125
- providerThreadId?: string;
126
- };
127
- raw: unknown;
128
- redaction: {
129
- applied: boolean;
130
- ruleIds: string[];
131
- };
132
- annotations: Record<string, string | number | boolean>;
133
- };
134
-
135
- type RunStatus = "running" | "waiting-approval" | "waiting-event" | "waiting-timer" | "waiting-quota" | "paused" | "finished" | "continued" | "failed" | "cancelled";
136
- type RunState = "running" | "waiting-approval" | "waiting-event" | "waiting-timer" | "waiting-quota" | "paused" | "recovering" | "stale" | "orphaned" | "failed" | "cancelled" | "succeeded" | "succeeded-with-failures" | "unknown";
137
- type AgentCliActionKind = "turn" | "command" | "tool" | "file_change" | "web_search" | "todo_list" | "reasoning" | "warning" | "note";
138
- type AgentCliActionPhase = "started" | "updated" | "completed";
139
- type AgentCliEventLevel = "debug" | "info" | "warning" | "error";
140
- type AgentCliStartedEvent = {
141
- type: "started";
142
- engine: string;
143
- title: string;
144
- resume?: string;
145
- detail?: Record<string, unknown>;
146
- };
147
- type AgentCliActionEvent = {
148
- type: "action";
149
- engine: string;
150
- phase: AgentCliActionPhase;
151
- entryType?: "thought" | "message";
152
- action: {
153
- id: string;
154
- kind: AgentCliActionKind;
155
- title: string;
156
- detail?: Record<string, unknown>;
157
- };
158
- message?: string;
159
- ok?: boolean;
160
- level?: AgentCliEventLevel;
161
- };
162
- type AgentCliCompletedEvent = {
163
- type: "completed";
164
- engine: string;
165
- ok: boolean;
166
- answer?: string;
167
- error?: string;
168
- resume?: string;
169
- usage?: Record<string, unknown>;
170
- };
171
- type AgentCliEvent = AgentCliStartedEvent | AgentCliActionEvent | AgentCliCompletedEvent;
172
- type RunCancellationSource$1 = {
173
- kind: "signal" | "rpc" | "cli" | "engine";
174
- detail?: string;
175
- signal?: string;
176
- clientPid?: number;
177
- requestId?: string;
178
- clientIdentity?: string;
179
- };
180
- type SmithersEvent$2 = {
181
- type: "SupervisorStarted";
182
- runId: string;
183
- pollIntervalMs: number;
184
- staleThresholdMs: number;
185
- timestampMs: number;
186
- } | {
187
- type: "SupervisorPollCompleted";
188
- runId: string;
189
- staleCount: number;
190
- resumedCount: number;
191
- skippedCount: number;
192
- durationMs: number;
193
- timestampMs: number;
194
- } | {
195
- type: "RunAutoResumed";
196
- runId: string;
197
- lastHeartbeatAtMs: number | null;
198
- staleDurationMs: number;
199
- timestampMs: number;
200
- } | {
201
- type: "RunAutoResumeSkipped";
202
- runId: string;
203
- reason: "pid-alive" | "missing-workflow" | "rate-limited";
204
- timestampMs: number;
205
- } | {
206
- type: "RunStarted";
207
- runId: string;
208
- timestampMs: number;
209
- } | {
210
- type: "RunStatusChanged";
211
- runId: string;
212
- status: RunStatus;
213
- timestampMs: number;
214
- } | {
215
- type: "RunStateChanged";
216
- runId: string;
217
- before: RunState;
218
- after: RunState;
219
- timestampMs: number;
220
- } | {
221
- type: "RunConcurrencySaturated";
222
- runId: string;
223
- requestedDemand: number;
224
- effectiveCap: number;
225
- remediationCommand: string;
226
- /** Present when a lifecycle-linked descendant caused the owner's budget to saturate. */
227
- descendantRunId?: string;
228
- /** Which owner budget bound admission. Historical events omit this. */
229
- budget?: "run" | "subtree";
230
- /** Present when `budget` is `subtree`. */
231
- subtreeGroupId?: string;
232
- timestampMs: number;
233
- } | {
234
- type: "RunFinished";
235
- runId: string;
236
- timestampMs: number;
237
- /**
238
- * Tasks that ended `failed` but were tolerated (continueOnFail / transient
239
- * agent failures) so the run still finished. Present only when `> 0` — the
240
- * run "succeeded" while these children failed. See `docs/runtime/run-state.mdx`.
241
- */
242
- failedChildren?: number;
243
- /** Task state keys (`nodeId::iteration`) counted by `failedChildren`. */
244
- failedChildKeys?: readonly string[];
245
- } | {
246
- type: "RunFailed";
247
- runId: string;
248
- error: unknown;
249
- timestampMs: number;
250
- } | {
251
- type: "RunCancelled";
252
- runId: string;
253
- timestampMs: number;
254
- /** Missing only on historical or unattributed cancellation events. */
255
- source?: RunCancellationSource$1;
256
- } | {
257
- type: "RunContinuedAsNew";
258
- runId: string;
259
- newRunId: string;
260
- iteration: number;
261
- carriedStateSize: number;
262
- ancestryDepth?: number;
263
- timestampMs: number;
264
- } | {
265
- type: "RunHijackRequested";
266
- runId: string;
267
- target?: string;
268
- timestampMs: number;
269
- } | {
270
- type: "RunHijacked";
271
- runId: string;
272
- nodeId: string;
273
- iteration: number;
274
- attempt: number;
275
- engine: string;
276
- mode: "native-cli" | "conversation";
277
- resume?: string | null;
278
- cwd: string;
279
- timestampMs: number;
280
- } | {
281
- type: "OneshotSteerQueued";
282
- runId: string;
283
- nodeId: "steer";
284
- messageId: string;
285
- message: string;
286
- engine: string;
287
- delivery: "queued";
288
- timestampMs: number;
289
- } | {
290
- type: "OneshotSteerDelivered";
291
- runId: string;
292
- nodeId: "steer";
293
- messageId: string;
294
- engine: string;
295
- delivery: "delivered";
296
- timestampMs: number;
297
- } | {
298
- type: "OneshotSteerAcknowledged";
299
- runId: string;
300
- nodeId: "steer";
301
- messageId: string;
302
- engine: string;
303
- delivery: "agent-acked";
304
- timestampMs: number;
305
- } | {
306
- type: "OneshotSteerFailed";
307
- runId: string;
308
- nodeId: "steer";
309
- messageId: string;
310
- message?: string;
311
- engine?: string;
312
- delivery: "failed";
313
- error: string;
314
- resumed?: boolean;
315
- recoveryError?: string;
316
- timestampMs: number;
317
- } | {
318
- type: "OneshotRestartRequested";
319
- runId: string;
320
- restartedAsRunId: string;
321
- priorStatus: string;
322
- timestampMs: number;
323
- } | {
324
- type: "OneshotRestartLaunched";
325
- runId: string;
326
- restartedAsRunId: string;
327
- pid: number | null;
328
- timestampMs: number;
329
- } | {
330
- type: "OneshotRestartFailed";
331
- runId: string;
332
- restartedAsRunId: string;
333
- error: string;
334
- timestampMs: number;
335
- } | {
336
- type: "SandboxCreated";
337
- runId: string;
338
- sandboxId: string;
339
- runtime: "bubblewrap" | "docker" | "codeplane";
340
- configJson: string;
341
- timestampMs: number;
342
- } | {
343
- type: "SandboxShipped";
344
- runId: string;
345
- sandboxId: string;
346
- runtime: "bubblewrap" | "docker" | "codeplane";
347
- bundleSizeBytes: number;
348
- timestampMs: number;
349
- } | {
350
- type: "SandboxHeartbeat";
351
- runId: string;
352
- sandboxId: string;
353
- remoteRunId?: string;
354
- progress?: number;
355
- timestampMs: number;
356
- } | {
357
- type: "SandboxBundleReceived";
358
- runId: string;
359
- sandboxId: string;
360
- bundleSizeBytes: number;
361
- patchCount: number;
362
- hasOutputs: boolean;
363
- timestampMs: number;
364
- } | {
365
- type: "SandboxCompleted";
366
- runId: string;
367
- sandboxId: string;
368
- remoteRunId?: string;
369
- runtime: "bubblewrap" | "docker" | "codeplane";
370
- status: "finished" | "failed" | "cancelled";
371
- durationMs: number;
372
- timestampMs: number;
373
- } | {
374
- type: "SandboxFailed";
375
- runId: string;
376
- sandboxId: string;
377
- runtime: "bubblewrap" | "docker" | "codeplane";
378
- error: unknown;
379
- timestampMs: number;
380
- } | {
381
- type: "SandboxDiffReviewRequested";
382
- runId: string;
383
- sandboxId: string;
384
- patchCount: number;
385
- totalDiffLines: number;
386
- timestampMs: number;
387
- } | {
388
- type: "SandboxDiffAccepted";
389
- runId: string;
390
- sandboxId: string;
391
- patchCount: number;
392
- timestampMs: number;
393
- } | {
394
- type: "SandboxDiffRejected";
395
- runId: string;
396
- sandboxId: string;
397
- reason?: string;
398
- timestampMs: number;
399
- } | {
400
- type: "FrameCommitted";
401
- runId: string;
402
- frameNo: number;
403
- xmlHash: string;
404
- trigger?: {
405
- reason: string;
406
- nodeId?: string;
407
- iteration?: number;
408
- };
409
- timestampMs: number;
410
- } | {
411
- type: "NodePending";
412
- runId: string;
413
- nodeId: string;
414
- iteration: number;
415
- timestampMs: number;
416
- } | {
417
- type: "NodeStarted";
418
- runId: string;
419
- nodeId: string;
420
- iteration: number;
421
- attempt: number;
422
- /** Deterministic child run launched by a childRun subflow node. */
423
- childRunId?: string;
424
- timestampMs: number;
425
- } | {
426
- type: "TaskHeartbeat";
427
- runId: string;
428
- nodeId: string;
429
- iteration: number;
430
- attempt: number;
431
- hasData: boolean;
432
- dataSizeBytes: number;
433
- intervalMs?: number;
434
- timestampMs: number;
435
- } | {
436
- type: "TaskHeartbeatTimeout";
437
- runId: string;
438
- nodeId: string;
439
- iteration: number;
440
- attempt: number;
441
- lastHeartbeatAtMs: number;
442
- timeoutMs: number;
443
- timestampMs: number;
444
- } | {
445
- type: "NodeFinished";
446
- runId: string;
447
- nodeId: string;
448
- iteration: number;
449
- attempt: number;
450
- timestampMs: number;
451
- } | {
452
- type: "NodeFailed";
453
- runId: string;
454
- nodeId: string;
455
- iteration: number;
456
- attempt: number;
457
- error: unknown;
458
- timestampMs: number;
459
- } | {
460
- type: "NodeStalled";
461
- runId: string;
462
- nodeId: string;
463
- iteration: number;
464
- attempt: number;
465
- identicalFailures: number;
466
- signature: string;
467
- error: unknown;
468
- timestampMs: number;
469
- } | {
470
- type: "NodeCancelled";
471
- runId: string;
472
- nodeId: string;
473
- iteration: number;
474
- attempt?: number;
475
- reason?: string;
476
- timestampMs: number;
477
- } | {
478
- type: "NodeSkipped";
479
- runId: string;
480
- nodeId: string;
481
- iteration: number;
482
- timestampMs: number;
483
- } | {
484
- type: "NodeRetrying";
485
- runId: string;
486
- nodeId: string;
487
- iteration: number;
488
- attempt: number;
489
- timestampMs: number;
490
- } | {
491
- type: "NodeWaitingApproval";
492
- runId: string;
493
- nodeId: string;
494
- iteration: number;
495
- timestampMs: number;
496
- } | {
497
- type: "NodeWaitingTimer";
498
- runId: string;
499
- nodeId: string;
500
- iteration: number;
501
- firesAtMs: number;
502
- timestampMs: number;
503
- } | {
504
- type: "ApprovalRequested";
505
- runId: string;
506
- nodeId: string;
507
- iteration: number;
508
- timestampMs: number;
509
- } | {
510
- type: "ApprovalGranted";
511
- runId: string;
512
- nodeId: string;
513
- iteration: number;
514
- timestampMs: number;
515
- } | {
516
- type: "ApprovalAutoApproved";
517
- runId: string;
518
- nodeId: string;
519
- iteration: number;
520
- timestampMs: number;
521
- } | {
522
- type: "ApprovalDenied";
523
- runId: string;
524
- nodeId: string;
525
- iteration: number;
526
- timestampMs: number;
527
- } | {
528
- type: "SteerQueued";
529
- runId: string;
530
- nodeId: string;
531
- steerId: string;
532
- message: string;
533
- author?: string;
534
- timestampMs: number;
535
- } | {
536
- type: "SteerConsumed";
537
- runId: string;
538
- nodeId: string;
539
- iteration: number;
540
- attempt: number;
541
- steerId: string;
542
- timestampMs: number;
543
- } | {
544
- type: "SteerExpired";
545
- runId: string;
546
- nodeId: string;
547
- steerId: string;
548
- timestampMs: number;
549
- } | {
550
- type: "ToolCallStarted";
551
- runId: string;
552
- nodeId: string;
553
- iteration: number;
554
- attempt: number;
555
- toolCallId: string;
556
- toolName: string;
557
- seq: number;
558
- timestampMs: number;
559
- } | {
560
- type: "ToolCallFinished";
561
- runId: string;
562
- nodeId: string;
563
- iteration: number;
564
- attempt: number;
565
- toolCallId: string;
566
- toolName: string;
567
- seq: number;
568
- status: "success" | "error";
569
- timestampMs: number;
570
- } | {
571
- type: "NodeOutput";
572
- runId: string;
573
- nodeId: string;
574
- iteration: number;
575
- attempt: number;
576
- text: string;
577
- stream: "stdout" | "stderr";
578
- timestampMs: number;
579
- } | {
580
- type: "AgentEvent";
581
- runId: string;
582
- nodeId: string;
583
- iteration: number;
584
- attempt: number;
585
- engine: string;
586
- event: AgentCliEvent;
587
- timestampMs: number;
588
- } | {
589
- type: "RetryTaskStarted";
590
- runId: string;
591
- nodeId: string;
592
- iteration: number;
593
- resetDependents: boolean;
594
- resetNodes: string[];
595
- timestampMs: number;
596
- } | {
597
- type: "RetryTaskFinished";
598
- runId: string;
599
- nodeId: string;
600
- iteration: number;
601
- resetNodes: string[];
602
- success: boolean;
603
- error?: string;
604
- timestampMs: number;
605
- } | {
606
- type: "RevertStarted";
607
- runId: string;
608
- nodeId: string;
609
- iteration: number;
610
- attempt: number;
611
- jjPointer: string;
612
- timestampMs: number;
613
- } | {
614
- type: "RevertFinished";
615
- runId: string;
616
- nodeId: string;
617
- iteration: number;
618
- attempt: number;
619
- jjPointer: string;
620
- success: boolean;
621
- error?: string;
622
- timestampMs: number;
623
- } | {
624
- type: "TimeTravelStarted";
625
- runId: string;
626
- nodeId: string;
627
- iteration: number;
628
- attempt: number;
629
- jjPointer?: string;
630
- timestampMs: number;
631
- } | {
632
- type: "TimeTravelFinished";
633
- runId: string;
634
- nodeId: string;
635
- iteration: number;
636
- attempt: number;
637
- jjPointer?: string;
638
- success: boolean;
639
- vcsRestored: boolean;
640
- resetNodes: string[];
641
- error?: string;
642
- timestampMs: number;
643
- } | {
644
- type: "TimeTravelJumped";
645
- runId: string;
646
- fromFrameNo: number;
647
- toFrameNo: number;
648
- timestampMs: number;
649
- caller?: string;
650
- } | {
651
- type: "EffectRevertStarted";
652
- runId: string;
653
- operation: string;
654
- kind: "tool" | "task";
655
- toolName: string;
656
- nodeId: string;
657
- iteration: number;
658
- attempt: number;
659
- seq: number;
660
- effectStatus: "succeeded" | "unknown";
661
- timestampMs: number;
662
- } | {
663
- type: "EffectRevertFinished";
664
- runId: string;
665
- operation: string;
666
- kind: "tool" | "task";
667
- toolName: string;
668
- nodeId: string;
669
- iteration: number;
670
- attempt: number;
671
- seq: number;
672
- timestampMs: number;
673
- } | {
674
- type: "EffectRevertFailed";
675
- runId: string;
676
- operation: string;
677
- kind: "tool" | "task";
678
- toolName: string;
679
- nodeId: string;
680
- iteration: number;
681
- attempt: number;
682
- seq: number;
683
- error: string;
684
- timestampMs: number;
685
- } | {
686
- type: "SideEffectBoundaryCrossed";
687
- runId: string;
688
- opId: string;
689
- operation: string;
690
- report: {
691
- blocking: unknown[];
692
- revertible: unknown[];
693
- warnings: unknown[];
694
- };
695
- parentRunId?: string;
696
- warningOnly?: boolean;
697
- lateCompletion?: boolean;
698
- archivedByOp?: string;
699
- timestampMs: number;
700
- } | {
701
- type: "WorkflowReloadDetected";
702
- runId: string;
703
- changedFiles: string[];
704
- timestampMs: number;
705
- } | {
706
- type: "WorkflowReloaded";
707
- runId: string;
708
- generation: number;
709
- changedFiles: string[];
710
- timestampMs: number;
711
- } | {
712
- type: "WorkflowReloadFailed";
713
- runId: string;
714
- error: unknown;
715
- changedFiles: string[];
716
- timestampMs: number;
717
- } | {
718
- type: "WorkflowReloadUnsafe";
719
- runId: string;
720
- reason: string;
721
- changedFiles: string[];
722
- timestampMs: number;
723
- } | {
724
- type: "ScorerStarted";
725
- runId: string;
726
- nodeId: string;
727
- scorerId: string;
728
- scorerName: string;
729
- timestampMs: number;
730
- } | {
731
- type: "ScorerFinished";
732
- runId: string;
733
- nodeId: string;
734
- scorerId: string;
735
- scorerName: string;
736
- score: number;
737
- timestampMs: number;
738
- } | {
739
- type: "ScorerFailed";
740
- runId: string;
741
- nodeId: string;
742
- scorerId: string;
743
- scorerName: string;
744
- error: unknown;
745
- timestampMs: number;
746
- } | {
747
- type: "TokenUsageReported";
748
- runId: string;
749
- nodeId: string;
750
- iteration: number;
751
- attempt: number;
752
- model: string;
753
- agent: string;
754
- inputTokens: number;
755
- /** Non-cached input tokens. Falls back to inputTokens when the provider omits the breakdown. */
756
- freshInputTokens?: number;
757
- outputTokens: number;
758
- cacheReadTokens?: number;
759
- cacheWriteTokens?: number;
760
- reasoningTokens?: number;
761
- /** Estimated USD cost from Smithers' built-in model price table. */
762
- costUsd?: number;
763
- timestampMs: number;
764
- } | {
765
- type: "SnapshotCaptured";
766
- runId: string;
767
- frameNo: number;
768
- contentHash: string;
769
- timestampMs: number;
770
- } | {
771
- type: "RunForked";
772
- runId: string;
773
- parentRunId: string;
774
- parentFrameNo: number;
775
- branchLabel?: string;
776
- timestampMs: number;
777
- } | {
778
- type: "ReplayStarted";
779
- runId: string;
780
- parentRunId: string;
781
- parentFrameNo: number;
782
- restoreVcs: boolean;
783
- timestampMs: number;
784
- } | {
785
- type: "MemoryFactSet";
786
- runId: string;
787
- namespace: string;
788
- key: string;
789
- timestampMs: number;
790
- } | {
791
- type: "MemoryRecalled";
792
- runId: string;
793
- namespace: string;
794
- query: string;
795
- resultCount: number;
796
- timestampMs: number;
797
- } | {
798
- type: "MemoryMessageSaved";
799
- runId: string;
800
- threadId: string;
801
- role: string;
802
- timestampMs: number;
803
- } | {
804
- type: "OpenApiToolCalled";
805
- runId: string;
806
- operationId: string;
807
- method: string;
808
- path: string;
809
- durationMs: number;
810
- status: "success" | "error";
811
- timestampMs: number;
812
- } | {
813
- type: "TimerCreated";
814
- runId: string;
815
- timerId: string;
816
- firesAtMs: number;
817
- timerType: "duration" | "absolute";
818
- timestampMs: number;
819
- } | {
820
- type: "TimerFired";
821
- runId: string;
822
- timerId: string;
823
- firesAtMs: number;
824
- firedAtMs: number;
825
- delayMs: number;
826
- timestampMs: number;
827
- } | {
828
- type: "TimerCancelled";
829
- runId: string;
830
- timerId: string;
831
- timestampMs: number;
832
- } | {
833
- type: "AgentTraceEvent";
834
- runId: string;
835
- nodeId: string;
836
- iteration: number;
837
- attempt: number;
838
- trace: CanonicalAgentTraceEvent;
839
- timestampMs: number;
840
- } | {
841
- type: "AgentTraceSummary";
842
- runId: string;
843
- nodeId: string;
844
- iteration: number;
845
- attempt: number;
846
- summary: AgentTraceSummary;
847
- timestampMs: number;
848
- } | {
849
- type: "AgentSessionEvent";
850
- runId: string;
851
- nodeId: string;
852
- iteration: number;
853
- attempt: number;
854
- transcript: AgentSessionTranscriptEvent;
855
- timestampMs: number;
856
- };
857
-
858
- type MetricName = string;
859
-
860
- type SmithersMetricEvent = {
861
- readonly type: string;
862
- readonly [key: string]: unknown;
863
- };
864
- type CounterEntry = {
865
- readonly type: "counter";
866
- value: number;
867
- readonly labels: MetricLabels$1;
868
- };
869
- type GaugeEntry = {
870
- readonly type: "gauge";
871
- value: number;
872
- readonly labels: MetricLabels$1;
873
- };
874
- type HistogramEntry = {
875
- readonly type: "histogram";
876
- sum: number;
877
- count: number;
878
- readonly labels: MetricLabels$1;
879
- readonly buckets: Map<number, number>;
880
- };
881
- type MetricEntry = CounterEntry | GaugeEntry | HistogramEntry;
882
- type MetricsSnapshot$1 = ReadonlyMap<string, MetricEntry>;
883
- type MetricsServiceShape$3 = {
884
- readonly increment: (name: MetricName, labels?: MetricLabels$1) => Effect.Effect<void>;
885
- readonly incrementBy: (name: MetricName, value: number, labels?: MetricLabels$1) => Effect.Effect<void>;
886
- readonly gauge: (name: MetricName, value: number, labels?: MetricLabels$1) => Effect.Effect<void>;
887
- readonly histogram: (name: MetricName, value: number, labels?: MetricLabels$1) => Effect.Effect<void>;
888
- readonly recordEvent: (event: SmithersMetricEvent) => Effect.Effect<void>;
889
- readonly updateProcessMetrics: () => Effect.Effect<void>;
890
- readonly updateAsyncExternalWaitPending: (kind: "approval" | "event", delta: number) => Effect.Effect<void>;
891
- readonly renderPrometheus: () => Effect.Effect<string>;
892
- readonly snapshot: () => Effect.Effect<MetricsSnapshot$1>;
893
- };
894
-
895
- type CorrelationContext$5 = {
896
- runId: string;
897
- nodeId?: string;
898
- iteration?: number;
899
- attempt?: number;
900
- workflowName?: string;
901
- parentRunId?: string;
902
- traceId?: string;
903
- spanId?: string;
904
- };
905
-
906
- type CorrelationPatch$5 = Partial<CorrelationContext$5> | undefined | null;
907
-
908
- type MetricsService = Context.ServiceClass.Shape<"MetricsService", MetricsServiceShape$2>;
909
- declare const MetricsService: Context.ServiceClass<MetricsService, "MetricsService", MetricsServiceShape$2>;
910
- type MetricsServiceShape$2 = MetricsServiceShape$3;
911
-
912
- type SmithersObservability = Context.ServiceClass.Shape<"SmithersObservability", SmithersObservabilityService$1>;
913
- declare const SmithersObservability: Context.ServiceClass<SmithersObservability, "SmithersObservability", SmithersObservabilityService$1>;
914
- type SmithersObservabilityService$1 = SmithersObservabilityService$2;
915
-
916
- declare const prometheusContentType: "text/plain; version=0.0.4; charset=utf-8";
917
-
918
- declare namespace smithersSpanNames {
919
- let run: string;
920
- let task: string;
921
- let agent: string;
922
- let tool: string;
923
- }
924
-
925
- /**
926
- * @returns {import("effect/Tracer").AnySpan | undefined}
927
- */
928
- declare function getCurrentSmithersTraceSpan(): effect_Tracer.AnySpan | undefined;
929
-
930
- /**
931
- * @returns {| Readonly<Record<string, string>> | undefined}
932
- */
933
- declare function getCurrentSmithersTraceAnnotations(): Readonly<Record<string, string>> | undefined;
934
-
935
- /**
936
- * @typedef {Readonly<Record<string, unknown>>} SmithersSpanAttributesInput
937
- */
938
- /**
939
- * @param {SmithersSpanAttributesInput} [attributes]
940
- * @returns {Record<string, unknown>}
941
- */
942
- declare function makeSmithersSpanAttributes(attributes?: SmithersSpanAttributesInput): Record<string, unknown>;
943
- type SmithersSpanAttributesInput = Readonly<Record<string, unknown>>;
944
-
945
- /**
946
- * @param {Readonly<Record<string, unknown>>} [attributes]
947
- * @returns {Effect.Effect<void>}
948
- */
949
- declare function annotateSmithersTrace(attributes?: Readonly<Record<string, unknown>>): Effect.Effect<void>;
950
-
951
- /**
952
- * @template A, E, R
953
- * @param {string} name
954
- * @param {Effect.Effect<A, E, R>} effect
955
- * @param {Readonly<Record<string, unknown>>} [attributes]
956
- * @param {Omit<import("effect/Tracer").SpanOptions, "attributes" | "kind"> & { readonly kind?: import("effect/Tracer").SpanKind; }} [_options]
957
- * @returns {Effect.Effect<A, E, Exclude<R, import("effect/Tracer").ParentSpan>>}
958
- */
959
- declare function withSmithersSpan<A, E, R>(name: string, effect: Effect.Effect<A, E, R>, attributes?: Readonly<Record<string, unknown>>, _options?: Omit<effect_Tracer.SpanOptions, "attributes" | "kind"> & {
960
- readonly kind?: effect_Tracer.SpanKind;
961
- }): Effect.Effect<A, E, Exclude<R, effect_Tracer.ParentSpan>>;
962
-
963
- type SmithersMetricType = "counter" | "gauge" | "histogram";
964
-
965
- type SmithersMetricUnit = "count" | "milliseconds" | "seconds" | "bytes" | "tokens" | "ratio" | "depth";
966
-
967
- type SmithersMetricDefinition$1 = {
968
- readonly key: string;
969
- readonly metric: Metric.Metric<any, any>;
970
- readonly name: string;
971
- readonly prometheusName: string;
972
- readonly type: SmithersMetricType;
973
- readonly label: string;
974
- readonly unit?: SmithersMetricUnit;
975
- readonly description?: string;
976
- readonly labels?: readonly string[];
977
- readonly boundaries?: readonly number[];
978
- readonly defaultLabels?: readonly Readonly<Record<string, string>>[];
979
- };
980
-
981
- /**
982
- * @returns {string}
983
- */
984
- declare function renderPrometheusMetrics(): string;
985
-
986
- /**
987
- * @param {SmithersObservabilityOptions} [options]
988
- * @returns {ResolvedSmithersObservabilityOptions}
989
- */
990
- declare function resolveSmithersObservabilityOptions(options?: SmithersObservabilityOptions$3): ResolvedSmithersObservabilityOptions$1;
991
- type ResolvedSmithersObservabilityOptions$1 = ResolvedSmithersObservabilityOptions$2;
992
- type SmithersObservabilityOptions$3 = SmithersObservabilityOptions$4;
993
-
994
- declare const smithersMetrics: {
995
- [k: string]: effect_Metric.Metric<any, any>;
996
- };
997
-
998
- /** @type {Layer.Layer<MetricsService, never, never>} */
999
- declare const MetricsServiceLive: Layer.Layer<MetricsService, never, never>;
1000
-
1001
- /** @typedef {import("./SmithersObservabilityOptions.ts").SmithersObservabilityOptions} SmithersObservabilityOptions */
1002
- /**
1003
- * @param {SmithersObservabilityOptions} [options]
1004
- */
1005
- declare function createSmithersOtelLayer(options?: SmithersObservabilityOptions$2): Layer.Layer<never, never, never>;
1006
- type SmithersObservabilityOptions$2 = SmithersObservabilityOptions$4;
1007
-
1008
- type TracingServiceShape$1 = {
1009
- readonly withSpan: <A, E, R>(name: string, effect: Effect.Effect<A, E, R>, attributes?: Record<string, unknown>) => Effect.Effect<A, E, R>;
1010
- readonly annotate: (attributes: Record<string, unknown>) => Effect.Effect<void>;
1011
- readonly withCorrelation: <A, E, R>(context: CorrelationPatch$5, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
1012
- };
1013
-
1014
- type TracingService = Context.ServiceClass.Shape<"TracingService", TracingServiceShape>;
1015
- declare const TracingService: Context.ServiceClass<TracingService, "TracingService", TracingServiceShape>;
1016
- /** @type {Layer.Layer<TracingService, never, never>} */
1017
- declare const TracingServiceLive: Layer.Layer<TracingService, never, never>;
1018
- type TracingServiceShape = TracingServiceShape$1;
1019
-
1020
- /**
1021
- * @param {SmithersObservabilityOptions} [options]
1022
- */
1023
- declare function createSmithersObservabilityLayer(options?: SmithersObservabilityOptions$1): Layer.Layer<MetricsService | TracingService | SmithersObservability | BunContext.BunServices, never, never>;
1024
- type SmithersObservabilityOptions$1 = SmithersObservabilityOptions$4;
1025
-
1026
- declare const createSmithersRuntimeLayer: typeof createSmithersObservabilityLayer;
1027
-
1028
- /**
1029
- * @param {string} name
1030
- * @returns {string}
1031
- */
1032
- declare function toPrometheusMetricName(name: string): string;
1033
-
1034
- /**
1035
- * @returns {Effect.Effect<void>}
1036
- */
1037
- declare function updateProcessMetrics(): Effect.Effect<void>;
1038
-
1039
- /**
1040
- * @param {SmithersEvent} event
1041
- * @returns {Effect.Effect<void>}
1042
- */
1043
- declare function trackEvent(event: SmithersEvent$1): Effect.Effect<void>;
1044
- type SmithersEvent$1 = SmithersEvent$2;
1045
-
1046
- declare const smithersMetricCatalog: SmithersMetricDefinition$1[];
1047
-
1048
- /** @type {MetricsServiceShape} */
1049
- declare const metricsServiceAdapter: MetricsServiceShape$1;
1050
- type MetricsServiceShape$1 = MetricsServiceShape$3;
1051
-
1052
- declare const runsTotal: Metric.Counter<number>;
1053
-
1054
- declare const nodesStarted: Metric.Counter<number>;
1055
-
1056
- declare const nodesFinished: Metric.Counter<number>;
1057
-
1058
- declare const nodesFailed: Metric.Counter<number>;
1059
-
1060
- declare const toolCallsTotal: Metric.Counter<number>;
1061
-
1062
- declare const cacheHits: Metric.Counter<number>;
1063
-
1064
- declare const cacheMisses: Metric.Counter<number>;
1065
-
1066
- declare const dbRetries: Metric.Counter<number>;
1067
-
1068
- declare const dbTransactionRollbacks: Metric.Counter<number>;
1069
-
1070
- declare const dbTransactionRetries: Metric.Counter<number>;
1071
-
1072
- declare const hotReloads: Metric.Counter<number>;
1073
-
1074
- declare const hotReloadFailures: Metric.Counter<number>;
1075
-
1076
- declare const httpRequests: Metric.Counter<number>;
1077
-
1078
- declare const approvalsRequested: Metric.Counter<number>;
1079
-
1080
- declare const approvalsGranted: Metric.Counter<number>;
1081
-
1082
- declare const approvalsDenied: Metric.Counter<number>;
1083
-
1084
- declare const timersCreated: Metric.Counter<number>;
1085
-
1086
- declare const timersFired: Metric.Counter<number>;
1087
-
1088
- declare const timersCancelled: Metric.Counter<number>;
1089
-
1090
- declare const sandboxCreatedTotal: Metric.Counter<number>;
1091
-
1092
- declare const sandboxCompletedTotal: Metric.Counter<number>;
1093
-
1094
- declare const scorerEventsStarted: Metric.Counter<number>;
1095
-
1096
- declare const scorerEventsFinished: Metric.Counter<number>;
1097
-
1098
- declare const scorerEventsFailed: Metric.Counter<number>;
1099
-
1100
- declare const tokensInputTotal: Metric.Counter<number>;
1101
-
1102
- declare const tokensOutputTotal: Metric.Counter<number>;
1103
-
1104
- declare const tokensCacheReadTotal: Metric.Counter<number>;
1105
-
1106
- declare const tokensCacheWriteTotal: Metric.Counter<number>;
1107
-
1108
- declare const tokensReasoningTotal: Metric.Counter<number>;
1109
-
1110
- declare const tokensContextWindowBucketTotal: Metric.Counter<number>;
1111
-
1112
- declare const runsFinishedTotal: Metric.Counter<number>;
1113
-
1114
- declare const runsFailedTotal: Metric.Counter<number>;
1115
-
1116
- declare const runsCancelledTotal: Metric.Counter<number>;
1117
-
1118
- declare const runsResumedTotal: Metric.Counter<number>;
1119
-
1120
- declare const runsContinuedTotal: Metric.Counter<number>;
1121
-
1122
- declare const errorsTotal: Metric.Counter<number>;
1123
-
1124
- declare const nodeRetriesTotal: Metric.Counter<number>;
1125
-
1126
- declare const toolCallErrorsTotal: Metric.Counter<number>;
1127
-
1128
- declare const toolOutputTruncatedTotal: Metric.Counter<number>;
1129
-
1130
- declare const eventsEmittedTotal: Metric.Counter<number>;
1131
-
1132
- declare const snapshotsCaptured: Metric.Counter<number>;
1133
-
1134
- declare const runForksCreated: Metric.Counter<number>;
1135
-
1136
- declare const replaysStarted: Metric.Counter<number>;
1137
-
1138
- declare const activeRuns: Metric.Gauge<number>;
1139
-
1140
- declare const activeNodes: Metric.Gauge<number>;
1141
-
1142
- declare const schedulerQueueDepth: Metric.Gauge<number>;
1143
-
1144
- declare const sandboxActive: Metric.Gauge<number>;
1145
-
1146
- declare const approvalPending: Metric.Gauge<number>;
1147
-
1148
- declare const externalWaitAsyncPending: Metric.Gauge<number>;
1149
-
1150
- declare const timersPending: Metric.Gauge<number>;
1151
-
1152
- declare const schedulerConcurrencyUtilization: Metric.Gauge<number>;
1153
-
1154
- declare const processUptimeSeconds: Metric.Gauge<number>;
1155
-
1156
- declare const processMemoryRssBytes: Metric.Gauge<number>;
1157
-
1158
- declare const processHeapUsedBytes: Metric.Gauge<number>;
1159
-
1160
- declare const nodeDuration: Metric.Histogram<number>;
1161
-
1162
- declare const attemptDuration: Metric.Histogram<number>;
1163
-
1164
- declare const toolDuration: Metric.Histogram<number>;
1165
-
1166
- declare const dbQueryDuration: Metric.Histogram<number>;
1167
-
1168
- declare const dbTransactionDuration: Metric.Histogram<number>;
1169
-
1170
- declare const httpRequestDuration: Metric.Histogram<number>;
1171
-
1172
- declare const hotReloadDuration: Metric.Histogram<number>;
1173
-
1174
- declare const vcsDuration: Metric.Histogram<number>;
1175
-
1176
- declare const tokensInputPerCall: Metric.Histogram<number>;
1177
-
1178
- declare const tokensOutputPerCall: Metric.Histogram<number>;
1179
-
1180
- declare const tokensContextWindowPerCall: Metric.Histogram<number>;
1181
-
1182
- declare const runDuration: Metric.Histogram<number>;
1183
-
1184
- declare const promptSizeBytes: Metric.Histogram<number>;
1185
-
1186
- declare const responseSizeBytes: Metric.Histogram<number>;
1187
-
1188
- declare const approvalWaitDuration: Metric.Histogram<number>;
1189
-
1190
- declare const timerDelayDuration: Metric.Histogram<number>;
1191
-
1192
- declare const schedulerWaitDuration: Metric.Histogram<number>;
1193
-
1194
- declare const runsAncestryDepth: Metric.Histogram<number>;
1195
-
1196
- declare const runsCarriedStateBytes: Metric.Histogram<number>;
1197
-
1198
- declare const sandboxDurationMs: Metric.Histogram<number>;
1199
-
1200
- declare const sandboxBundleSizeBytes: Metric.Histogram<number>;
1201
-
1202
- declare const sandboxTransportDurationMs: Metric.Histogram<number>;
1203
-
1204
- declare const sandboxPatchCount: Metric.Histogram<number>;
1205
-
1206
- declare const snapshotDuration: Metric.Histogram<number>;
1207
-
1208
- declare const rewindTotal: Metric.Counter<number>;
1209
-
1210
- declare const rewindRollbackTotal: Metric.Counter<number>;
1211
-
1212
- declare const rewindDurationMs: Metric.Histogram<number>;
1213
-
1214
- declare const rewindFramesDeleted: Metric.Histogram<number>;
1215
-
1216
- declare const rewindSandboxesReverted: Metric.Histogram<number>;
1217
-
1218
- declare const correlationContextFiberRef: Context.Reference<undefined>;
1219
-
1220
- type CorrelationContextServiceShape$1 = {
1221
- readonly current: () => Effect.Effect<CorrelationContext$5 | undefined>;
1222
- readonly withCorrelation: <A, E, R>(patch: CorrelationPatch$5, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
1223
- readonly toLogAnnotations: (context?: CorrelationContext$5 | null) => Record<string, unknown> | undefined;
1224
- };
1225
-
1226
- type CorrelationContextService = Context.ServiceClass.Shape<"CorrelationContextService", CorrelationContextServiceShape>;
1227
- declare const CorrelationContextService: Context.ServiceClass<CorrelationContextService, "CorrelationContextService", CorrelationContextServiceShape>;
1228
- type CorrelationContextServiceShape = CorrelationContextServiceShape$1;
1229
-
1230
- /** @type {Layer.Layer<CorrelationContextService, never, never>} */
1231
- declare const CorrelationContextLive: Layer.Layer<CorrelationContextService, never, never>;
1232
-
1233
- /**
1234
- * @param {CorrelationContext | null} [base]
1235
- * @param {CorrelationPatch} [patch]
1236
- * @returns {CorrelationContext | undefined}
1237
- */
1238
- declare function mergeCorrelationContext(base?: CorrelationContext$4 | null, patch?: CorrelationPatch$4): CorrelationContext$4 | undefined;
1239
- type CorrelationContext$4 = CorrelationContext$5;
1240
- type CorrelationPatch$4 = CorrelationPatch$5;
1241
-
1242
- /** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
1243
- /**
1244
- * @returns {CorrelationContext | undefined}
1245
- */
1246
- declare function getCurrentCorrelationContext(): CorrelationContext$3 | undefined;
1247
- type CorrelationContext$3 = CorrelationContext$5;
1248
-
1249
- /** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
1250
- /**
1251
- * @returns {Effect.Effect< CorrelationContext | undefined >}
1252
- */
1253
- declare function getCurrentCorrelationContextEffect(): Effect.Effect<CorrelationContext$2 | undefined>;
1254
- type CorrelationContext$2 = CorrelationContext$5;
1255
-
1256
- /** @typedef {import("./CorrelationPatch.ts").CorrelationPatch} CorrelationPatch */
1257
- /**
1258
- * @template T
1259
- * @param {CorrelationPatch} patch
1260
- * @param {() => T} fn
1261
- * @returns {T}
1262
- */
1263
- declare function runWithCorrelationContext<T>(patch: CorrelationPatch$3, fn: () => T): T;
1264
- type CorrelationPatch$3 = CorrelationPatch$5;
1265
-
1266
- /** @typedef {import("./CorrelationPatch.ts").CorrelationPatch} CorrelationPatch */
1267
- /**
1268
- * Bridge the Effect-tracked correlation context onto the imperative
1269
- * AsyncLocalStorage store so plain (non-Effect) `getCurrentCorrelationContext()`
1270
- * reads — e.g. from the imperative logger — see the active run/node correlation
1271
- * while the effect executes.
1272
- *
1273
- * IMPORTANT: run the resulting effect with `Effect.runPromise`/`runFork`, never
1274
- * `Effect.runSync`. The acquire step calls `AsyncLocalStorage.enterWith()`, which
1275
- * mutates the *caller's* async context. Under `runSync` the caller is whatever
1276
- * synchronous context invoked it (e.g. a test-runner's root context); enabling
1277
- * ALS async-hooks there leaks into every subsequent timer/promise on that
1278
- * context. `runPromise`/`runFork` execute on an ephemeral fiber context, keeping
1279
- * the enterWith scoped to that fiber.
1280
- *
1281
- * @template A, E, R
1282
- * @param {Effect.Effect<A, E, R>} effect
1283
- * @param {CorrelationPatch} patch
1284
- */
1285
- declare function withCorrelationContext<A, E, R>(effect: Effect.Effect<A, E, R>, patch: CorrelationPatch$2): Effect.Effect<A, E, R>;
1286
- type CorrelationPatch$2 = CorrelationPatch$5;
1287
-
1288
- /**
1289
- * @template A, E, R
1290
- * @param {Effect.Effect<A, E, R>} effect
1291
- */
1292
- declare function withCurrentCorrelationContext<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
1293
-
1294
- /** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
1295
- /**
1296
- * @param {CorrelationContext | null} [context]
1297
- * @returns {Record<string, unknown> | undefined}
1298
- */
1299
- declare function correlationContextToLogAnnotations(context?: CorrelationContext$1 | null): Record<string, unknown> | undefined;
1300
- type CorrelationContext$1 = CorrelationContext$5;
1301
-
1302
- /**
1303
- * Temporary compatibility shim for legacy, non-Effect callers.
1304
- *
1305
- * Unlike the FiberRef-based core implementation
1306
- * ({@link import("./_coreCorrelation/updateCurrentCorrelationContext.js").updateCurrentCorrelationContext}),
1307
- * which returns an Effect and sets a fresh merged context on the
1308
- * `correlationContextFiberRef`, this shim runs synchronously and applies the
1309
- * patch by **mutating the current context object in place** via
1310
- * `Object.assign(current, next)`. Any references already holding the current
1311
- * context object will observe the mutation. This in-place semantics is
1312
- * intentional and exists only to preserve behavior for callers that captured a
1313
- * context reference before the Effect-based API existed.
1314
- *
1315
- * If there is no current context, the patch is a no-op (nothing is created).
1316
- *
1317
- * @deprecated Prefer the Effect-returning
1318
- * `updateCurrentCorrelationContext` from
1319
- * `@smthrs/observability` (the `_coreCorrelation` version),
1320
- * which does not mutate shared state. This shim will be removed once legacy
1321
- * callers migrate.
1322
- *
1323
- * @param {CorrelationPatch} patch
1324
- * @returns {void}
1325
- */
1326
- declare function updateCurrentCorrelationContext(patch: CorrelationPatch$1): void;
1327
- type CorrelationPatch$1 = CorrelationPatch$5;
1328
-
1329
- /**
1330
- * Scope imperative Smithers logs to one host-owned Effect runner. Unlike
1331
- * {@link setSmithersLogRunner}, this is concurrency-safe: parallel embedded
1332
- * engine instances keep their loggers isolated across awaits and timers.
1333
- *
1334
- * @template T
1335
- * @param {SmithersLogRunner} runner
1336
- * @param {() => T} execute
1337
- * @returns {T}
1338
- */
1339
- declare function runWithSmithersLogRunner<T>(runner: SmithersLogRunner, execute: () => T): T;
1340
- /**
1341
- * Install the Effect runtime used by fire-and-forget observability logs.
1342
- * Returns a restore function so tests and embedded hosts can scope overrides.
1343
- *
1344
- * @param {SmithersLogRunner | null} runner
1345
- * @returns {() => void}
1346
- */
1347
- declare function setSmithersLogRunner(runner: SmithersLogRunner | null): () => void;
1348
- /**
1349
- * @param {string} message
1350
- * @param {LogAnnotations} [annotations]
1351
- * @param {string} [span]
1352
- */
1353
- declare function logDebug(message: string, annotations?: LogAnnotations, span?: string): void;
1354
- /**
1355
- * @param {string} message
1356
- * @param {LogAnnotations} [annotations]
1357
- * @param {string} [span]
1358
- */
1359
- declare function logInfo(message: string, annotations?: LogAnnotations, span?: string): void;
1360
- /**
1361
- * @param {string} message
1362
- * @param {LogAnnotations} [annotations]
1363
- * @param {string} [span]
1364
- */
1365
- declare function logWarning(message: string, annotations?: LogAnnotations, span?: string): void;
1366
- /**
1367
- * @param {string} message
1368
- * @param {LogAnnotations} [annotations]
1369
- * @param {string} [span]
1370
- */
1371
- declare function logError(message: string, annotations?: LogAnnotations, span?: string): void;
1372
- type SmithersLogRunner = {
1373
- runFork: (effect: Effect.Effect<void, never, never>) => unknown;
1374
- runPromise: (effect: Effect.Effect<void, never, never>) => Promise<void>;
1375
- };
1376
- type LogAnnotations = Record<string, unknown> | undefined;
1377
-
1378
- type CorrelationContext = CorrelationContext$5;
1379
- type CorrelationPatch = CorrelationPatch$5;
1380
- type CorrelationContextPatch = CorrelationPatch;
1381
- type MetricLabels = MetricLabels$1;
1382
- type MetricsServiceShape = MetricsServiceShape$3;
1383
- type MetricsSnapshot = MetricsSnapshot$1;
1384
- type ResolvedSmithersObservabilityOptions = ResolvedSmithersObservabilityOptions$2;
1385
- type RunCancellationSource = RunCancellationSource$1;
1386
- type SmithersEvent = SmithersEvent$2;
1387
- type SmithersLogFormat = SmithersLogFormat$1;
1388
- type SmithersMetricDefinition = SmithersMetricDefinition$2;
1389
- type SmithersObservabilityOptions = SmithersObservabilityOptions$4;
1390
- type SmithersObservabilityService = SmithersObservabilityService$2;
1391
-
1392
- export { type CorrelationContext, CorrelationContextLive, type CorrelationContextPatch, CorrelationContextService, type CorrelationPatch, type MetricLabels, MetricsService, MetricsServiceLive, type MetricsServiceShape, type MetricsSnapshot, type ResolvedSmithersObservabilityOptions, type RunCancellationSource, type SmithersEvent, type SmithersLogFormat, type SmithersMetricDefinition, SmithersObservability, type SmithersObservabilityOptions, type SmithersObservabilityService, TracingService, TracingServiceLive, activeNodes, activeRuns, annotateSmithersTrace, approvalPending, approvalWaitDuration, approvalsDenied, approvalsGranted, approvalsRequested, attemptDuration, cacheHits, cacheMisses, correlationContextFiberRef, correlationContextToLogAnnotations, createSmithersObservabilityLayer, createSmithersOtelLayer, createSmithersRuntimeLayer, dbQueryDuration, dbRetries, dbTransactionDuration, dbTransactionRetries, dbTransactionRollbacks, errorsTotal, eventsEmittedTotal, externalWaitAsyncPending, getCurrentCorrelationContext, getCurrentCorrelationContextEffect, getCurrentSmithersTraceAnnotations, getCurrentSmithersTraceSpan, hotReloadDuration, hotReloadFailures, hotReloads, httpRequestDuration, httpRequests, logDebug, logError, logInfo, logWarning, makeSmithersSpanAttributes, mergeCorrelationContext, metricsServiceAdapter, nodeDuration, nodeRetriesTotal, nodesFailed, nodesFinished, nodesStarted, processHeapUsedBytes, processMemoryRssBytes, processUptimeSeconds, prometheusContentType, promptSizeBytes, renderPrometheusMetrics, replaysStarted, resolveSmithersObservabilityOptions, responseSizeBytes, rewindDurationMs, rewindFramesDeleted, rewindRollbackTotal, rewindSandboxesReverted, rewindTotal, runDuration, runForksCreated, runWithCorrelationContext, runWithSmithersLogRunner, runsAncestryDepth, runsCancelledTotal, runsCarriedStateBytes, runsContinuedTotal, runsFailedTotal, runsFinishedTotal, runsResumedTotal, runsTotal, sandboxActive, sandboxBundleSizeBytes, sandboxCompletedTotal, sandboxCreatedTotal, sandboxDurationMs, sandboxPatchCount, sandboxTransportDurationMs, schedulerConcurrencyUtilization, schedulerQueueDepth, schedulerWaitDuration, scorerEventsFailed, scorerEventsFinished, scorerEventsStarted, setSmithersLogRunner, smithersMetricCatalog, smithersMetrics, smithersSpanNames, snapshotDuration, snapshotsCaptured, timerDelayDuration, timersCancelled, timersCreated, timersFired, timersPending, toPrometheusMetricName, tokensCacheReadTotal, tokensCacheWriteTotal, tokensContextWindowBucketTotal, tokensContextWindowPerCall, tokensInputPerCall, tokensInputTotal, tokensOutputPerCall, tokensOutputTotal, tokensReasoningTotal, toolCallErrorsTotal, toolCallsTotal, toolDuration, toolOutputTruncatedTotal, trackEvent as trackSmithersEvent, updateCurrentCorrelationContext, updateProcessMetrics, vcsDuration, withCorrelationContext, withCurrentCorrelationContext, withSmithersSpan };