@smthrs/observability 0.34.0 → 1.0.0-rc.3

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 -798
  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 -1343
  182. package/src/index.js +0 -136
  183. package/src/kindPhase.js +0 -17
  184. package/src/logging.js +0 -248
  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 -1185
  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
@@ -1,1185 +0,0 @@
1
- import { Effect, Metric } from 'effect';
2
-
3
- type SmithersMetricUnit$2 = "count" | "milliseconds" | "seconds" | "bytes" | "tokens" | "ratio" | "depth";
4
-
5
- type SmithersMetricType$2 = "counter" | "gauge" | "histogram";
6
-
7
- type MetricLabels = Readonly<Record<string, string | number | boolean>>;
8
-
9
- type SmithersMetricDefinition$2 = {
10
- readonly key: string;
11
- readonly name: string;
12
- readonly prometheusName: string;
13
- readonly type: SmithersMetricType$2;
14
- readonly label: string;
15
- readonly unit?: SmithersMetricUnit$2;
16
- readonly labels?: readonly string[];
17
- readonly defaultLabels?: readonly MetricLabels[];
18
- readonly boundaries?: readonly number[];
19
- };
20
-
21
- /**
22
- * @param {string} name
23
- * @returns {string}
24
- */
25
- declare function toPrometheusMetricName(name: string): string;
26
-
27
- /**
28
- * @returns {Effect.Effect<void>}
29
- */
30
- declare function updateProcessMetrics(): Effect.Effect<void>;
31
-
32
- /**
33
- * @param {"approval" | "event"} kind
34
- * @param {number} delta
35
- * @returns {Effect.Effect<void>}
36
- */
37
- declare function updateAsyncExternalWaitPending(kind: "approval" | "event", delta: number): Effect.Effect<void>;
38
-
39
- type AgentFamily = "pi" | "codex" | "claude-code" | "antigravity" | "gemini" | "kimi" | "openai" | "anthropic" | "amp" | "forge" | "unknown";
40
- type AgentCaptureMode = "sdk-events" | "rpc-events" | "cli-json-stream" | "cli-json" | "cli-text" | "artifact-import";
41
- type TraceCompleteness = "full-observed" | "partial-observed" | "final-only" | "capture-failed";
42
- 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";
43
- type CanonicalAgentTraceEventPhase = "agent" | "turn" | "message" | "tool" | "session" | "capture" | "artifact";
44
- type CanonicalAgentTraceEvent = {
45
- traceVersion: "1";
46
- runId: string;
47
- workflowPath?: string;
48
- workflowHash?: string;
49
- nodeId: string;
50
- iteration: number;
51
- attempt: number;
52
- timestampMs: number;
53
- event: {
54
- sequence: number;
55
- kind: CanonicalAgentTraceEventKind;
56
- phase: CanonicalAgentTraceEventPhase;
57
- };
58
- source: {
59
- agentFamily: AgentFamily;
60
- captureMode: AgentCaptureMode;
61
- rawType?: string;
62
- rawEventId?: string;
63
- observed: boolean;
64
- };
65
- traceCompleteness: TraceCompleteness;
66
- payload: Record<string, unknown> | null;
67
- raw: unknown;
68
- redaction: {
69
- applied: boolean;
70
- ruleIds: string[];
71
- };
72
- annotations: Record<string, string | number | boolean>;
73
- };
74
- type AgentTraceSummary = {
75
- traceVersion: "1";
76
- runId: string;
77
- workflowPath?: string;
78
- workflowHash?: string;
79
- nodeId: string;
80
- iteration: number;
81
- attempt: number;
82
- traceStartedAtMs: number;
83
- traceFinishedAtMs: number;
84
- agentFamily: AgentFamily;
85
- agentId?: string;
86
- model?: string;
87
- captureMode: AgentCaptureMode;
88
- traceCompleteness: TraceCompleteness;
89
- unsupportedEventKinds: CanonicalAgentTraceEventKind[];
90
- missingExpectedEventKinds: CanonicalAgentTraceEventKind[];
91
- rawArtifactRefs: string[];
92
- };
93
- type AgentSessionTranscriptEvent = {
94
- transcriptVersion: "1";
95
- runId: string;
96
- workflowPath?: string;
97
- workflowHash?: string;
98
- nodeId: string;
99
- iteration: number;
100
- attempt: number;
101
- timestampMs: number;
102
- event: {
103
- sequence: number;
104
- rowType: string;
105
- };
106
- source: {
107
- agentFamily: AgentFamily;
108
- captureMode: AgentCaptureMode;
109
- ingestSource: "live" | "artifact";
110
- observedLive: boolean;
111
- providerSessionId?: string;
112
- providerThreadId?: string;
113
- };
114
- raw: unknown;
115
- redaction: {
116
- applied: boolean;
117
- ruleIds: string[];
118
- };
119
- annotations: Record<string, string | number | boolean>;
120
- };
121
-
122
- type RunStatus = "running" | "waiting-approval" | "waiting-event" | "waiting-timer" | "waiting-quota" | "paused" | "finished" | "continued" | "failed" | "cancelled";
123
- type RunState = "running" | "waiting-approval" | "waiting-event" | "waiting-timer" | "waiting-quota" | "paused" | "recovering" | "stale" | "orphaned" | "failed" | "cancelled" | "succeeded" | "unknown";
124
- type AgentCliActionKind = "turn" | "command" | "tool" | "file_change" | "web_search" | "todo_list" | "reasoning" | "warning" | "note";
125
- type AgentCliActionPhase = "started" | "updated" | "completed";
126
- type AgentCliEventLevel = "debug" | "info" | "warning" | "error";
127
- type AgentCliStartedEvent = {
128
- type: "started";
129
- engine: string;
130
- title: string;
131
- resume?: string;
132
- detail?: Record<string, unknown>;
133
- };
134
- type AgentCliActionEvent = {
135
- type: "action";
136
- engine: string;
137
- phase: AgentCliActionPhase;
138
- entryType?: "thought" | "message";
139
- action: {
140
- id: string;
141
- kind: AgentCliActionKind;
142
- title: string;
143
- detail?: Record<string, unknown>;
144
- };
145
- message?: string;
146
- ok?: boolean;
147
- level?: AgentCliEventLevel;
148
- };
149
- type AgentCliCompletedEvent = {
150
- type: "completed";
151
- engine: string;
152
- ok: boolean;
153
- answer?: string;
154
- error?: string;
155
- resume?: string;
156
- usage?: Record<string, unknown>;
157
- };
158
- type AgentCliEvent = AgentCliStartedEvent | AgentCliActionEvent | AgentCliCompletedEvent;
159
- type SmithersEvent$2 = {
160
- type: "SupervisorStarted";
161
- runId: string;
162
- pollIntervalMs: number;
163
- staleThresholdMs: number;
164
- timestampMs: number;
165
- } | {
166
- type: "SupervisorPollCompleted";
167
- runId: string;
168
- staleCount: number;
169
- resumedCount: number;
170
- skippedCount: number;
171
- durationMs: number;
172
- timestampMs: number;
173
- } | {
174
- type: "RunAutoResumed";
175
- runId: string;
176
- lastHeartbeatAtMs: number | null;
177
- staleDurationMs: number;
178
- timestampMs: number;
179
- } | {
180
- type: "RunAutoResumeSkipped";
181
- runId: string;
182
- reason: "pid-alive" | "missing-workflow" | "rate-limited";
183
- timestampMs: number;
184
- } | {
185
- type: "RunStarted";
186
- runId: string;
187
- timestampMs: number;
188
- } | {
189
- type: "RunStatusChanged";
190
- runId: string;
191
- status: RunStatus;
192
- timestampMs: number;
193
- } | {
194
- type: "RunStateChanged";
195
- runId: string;
196
- before: RunState;
197
- after: RunState;
198
- timestampMs: number;
199
- } | {
200
- type: "RunFinished";
201
- runId: string;
202
- timestampMs: number;
203
- /**
204
- * Tasks that ended `failed` but were tolerated (continueOnFail / transient
205
- * agent failures) so the run still finished. Present only when `> 0` — the
206
- * run "succeeded" while these children failed. See `docs/runtime/run-state.mdx`.
207
- */
208
- failedChildren?: number;
209
- /** Task state keys (`nodeId::iteration`) counted by `failedChildren`. */
210
- failedChildKeys?: readonly string[];
211
- } | {
212
- type: "RunFailed";
213
- runId: string;
214
- error: unknown;
215
- timestampMs: number;
216
- } | {
217
- type: "RunCancelled";
218
- runId: string;
219
- timestampMs: number;
220
- } | {
221
- type: "RunContinuedAsNew";
222
- runId: string;
223
- newRunId: string;
224
- iteration: number;
225
- carriedStateSize: number;
226
- ancestryDepth?: number;
227
- timestampMs: number;
228
- } | {
229
- type: "RunHijackRequested";
230
- runId: string;
231
- target?: string;
232
- timestampMs: number;
233
- } | {
234
- type: "RunHijacked";
235
- runId: string;
236
- nodeId: string;
237
- iteration: number;
238
- attempt: number;
239
- engine: string;
240
- mode: "native-cli" | "conversation";
241
- resume?: string | null;
242
- cwd: string;
243
- timestampMs: number;
244
- } | {
245
- type: "OneshotSteerQueued";
246
- runId: string;
247
- nodeId: "steer";
248
- messageId: string;
249
- message: string;
250
- engine: string;
251
- delivery: "queued";
252
- timestampMs: number;
253
- } | {
254
- type: "OneshotSteerDelivered";
255
- runId: string;
256
- nodeId: "steer";
257
- messageId: string;
258
- engine: string;
259
- delivery: "delivered";
260
- timestampMs: number;
261
- } | {
262
- type: "OneshotSteerAcknowledged";
263
- runId: string;
264
- nodeId: "steer";
265
- messageId: string;
266
- engine: string;
267
- delivery: "agent-acked";
268
- timestampMs: number;
269
- } | {
270
- type: "OneshotSteerFailed";
271
- runId: string;
272
- nodeId: "steer";
273
- messageId: string;
274
- message?: string;
275
- engine?: string;
276
- delivery: "failed";
277
- error: string;
278
- resumed?: boolean;
279
- recoveryError?: string;
280
- timestampMs: number;
281
- } | {
282
- type: "OneshotRestartRequested";
283
- runId: string;
284
- restartedAsRunId: string;
285
- priorStatus: string;
286
- timestampMs: number;
287
- } | {
288
- type: "OneshotRestartLaunched";
289
- runId: string;
290
- restartedAsRunId: string;
291
- pid: number | null;
292
- timestampMs: number;
293
- } | {
294
- type: "OneshotRestartFailed";
295
- runId: string;
296
- restartedAsRunId: string;
297
- error: string;
298
- timestampMs: number;
299
- } | {
300
- type: "SandboxCreated";
301
- runId: string;
302
- sandboxId: string;
303
- runtime: "bubblewrap" | "docker" | "codeplane";
304
- configJson: string;
305
- timestampMs: number;
306
- } | {
307
- type: "SandboxShipped";
308
- runId: string;
309
- sandboxId: string;
310
- runtime: "bubblewrap" | "docker" | "codeplane";
311
- bundleSizeBytes: number;
312
- timestampMs: number;
313
- } | {
314
- type: "SandboxHeartbeat";
315
- runId: string;
316
- sandboxId: string;
317
- remoteRunId?: string;
318
- progress?: number;
319
- timestampMs: number;
320
- } | {
321
- type: "SandboxBundleReceived";
322
- runId: string;
323
- sandboxId: string;
324
- bundleSizeBytes: number;
325
- patchCount: number;
326
- hasOutputs: boolean;
327
- timestampMs: number;
328
- } | {
329
- type: "SandboxCompleted";
330
- runId: string;
331
- sandboxId: string;
332
- remoteRunId?: string;
333
- runtime: "bubblewrap" | "docker" | "codeplane";
334
- status: "finished" | "failed" | "cancelled";
335
- durationMs: number;
336
- timestampMs: number;
337
- } | {
338
- type: "SandboxFailed";
339
- runId: string;
340
- sandboxId: string;
341
- runtime: "bubblewrap" | "docker" | "codeplane";
342
- error: unknown;
343
- timestampMs: number;
344
- } | {
345
- type: "SandboxDiffReviewRequested";
346
- runId: string;
347
- sandboxId: string;
348
- patchCount: number;
349
- totalDiffLines: number;
350
- timestampMs: number;
351
- } | {
352
- type: "SandboxDiffAccepted";
353
- runId: string;
354
- sandboxId: string;
355
- patchCount: number;
356
- timestampMs: number;
357
- } | {
358
- type: "SandboxDiffRejected";
359
- runId: string;
360
- sandboxId: string;
361
- reason?: string;
362
- timestampMs: number;
363
- } | {
364
- type: "FrameCommitted";
365
- runId: string;
366
- frameNo: number;
367
- xmlHash: string;
368
- trigger?: {
369
- reason: string;
370
- nodeId?: string;
371
- iteration?: number;
372
- };
373
- timestampMs: number;
374
- } | {
375
- type: "NodePending";
376
- runId: string;
377
- nodeId: string;
378
- iteration: number;
379
- timestampMs: number;
380
- } | {
381
- type: "NodeStarted";
382
- runId: string;
383
- nodeId: string;
384
- iteration: number;
385
- attempt: number;
386
- /** Deterministic child run launched by a childRun subflow node. */
387
- childRunId?: string;
388
- timestampMs: number;
389
- } | {
390
- type: "TaskHeartbeat";
391
- runId: string;
392
- nodeId: string;
393
- iteration: number;
394
- attempt: number;
395
- hasData: boolean;
396
- dataSizeBytes: number;
397
- intervalMs?: number;
398
- timestampMs: number;
399
- } | {
400
- type: "TaskHeartbeatTimeout";
401
- runId: string;
402
- nodeId: string;
403
- iteration: number;
404
- attempt: number;
405
- lastHeartbeatAtMs: number;
406
- timeoutMs: number;
407
- timestampMs: number;
408
- } | {
409
- type: "NodeFinished";
410
- runId: string;
411
- nodeId: string;
412
- iteration: number;
413
- attempt: number;
414
- timestampMs: number;
415
- } | {
416
- type: "NodeFailed";
417
- runId: string;
418
- nodeId: string;
419
- iteration: number;
420
- attempt: number;
421
- error: unknown;
422
- timestampMs: number;
423
- } | {
424
- type: "NodeCancelled";
425
- runId: string;
426
- nodeId: string;
427
- iteration: number;
428
- attempt?: number;
429
- reason?: string;
430
- timestampMs: number;
431
- } | {
432
- type: "NodeSkipped";
433
- runId: string;
434
- nodeId: string;
435
- iteration: number;
436
- timestampMs: number;
437
- } | {
438
- type: "NodeRetrying";
439
- runId: string;
440
- nodeId: string;
441
- iteration: number;
442
- attempt: number;
443
- timestampMs: number;
444
- } | {
445
- type: "NodeWaitingApproval";
446
- runId: string;
447
- nodeId: string;
448
- iteration: number;
449
- timestampMs: number;
450
- } | {
451
- type: "NodeWaitingTimer";
452
- runId: string;
453
- nodeId: string;
454
- iteration: number;
455
- firesAtMs: number;
456
- timestampMs: number;
457
- } | {
458
- type: "ApprovalRequested";
459
- runId: string;
460
- nodeId: string;
461
- iteration: number;
462
- timestampMs: number;
463
- } | {
464
- type: "ApprovalGranted";
465
- runId: string;
466
- nodeId: string;
467
- iteration: number;
468
- timestampMs: number;
469
- } | {
470
- type: "ApprovalAutoApproved";
471
- runId: string;
472
- nodeId: string;
473
- iteration: number;
474
- timestampMs: number;
475
- } | {
476
- type: "ApprovalDenied";
477
- runId: string;
478
- nodeId: string;
479
- iteration: number;
480
- timestampMs: number;
481
- } | {
482
- type: "SteerQueued";
483
- runId: string;
484
- nodeId: string;
485
- steerId: string;
486
- message: string;
487
- author?: string;
488
- timestampMs: number;
489
- } | {
490
- type: "SteerConsumed";
491
- runId: string;
492
- nodeId: string;
493
- iteration: number;
494
- attempt: number;
495
- steerId: string;
496
- timestampMs: number;
497
- } | {
498
- type: "SteerExpired";
499
- runId: string;
500
- nodeId: string;
501
- steerId: string;
502
- timestampMs: number;
503
- } | {
504
- type: "ToolCallStarted";
505
- runId: string;
506
- nodeId: string;
507
- iteration: number;
508
- attempt: number;
509
- toolCallId: string;
510
- toolName: string;
511
- seq: number;
512
- timestampMs: number;
513
- } | {
514
- type: "ToolCallFinished";
515
- runId: string;
516
- nodeId: string;
517
- iteration: number;
518
- attempt: number;
519
- toolCallId: string;
520
- toolName: string;
521
- seq: number;
522
- status: "success" | "error";
523
- timestampMs: number;
524
- } | {
525
- type: "NodeOutput";
526
- runId: string;
527
- nodeId: string;
528
- iteration: number;
529
- attempt: number;
530
- text: string;
531
- stream: "stdout" | "stderr";
532
- timestampMs: number;
533
- } | {
534
- type: "AgentEvent";
535
- runId: string;
536
- nodeId: string;
537
- iteration: number;
538
- attempt: number;
539
- engine: string;
540
- event: AgentCliEvent;
541
- timestampMs: number;
542
- } | {
543
- type: "RetryTaskStarted";
544
- runId: string;
545
- nodeId: string;
546
- iteration: number;
547
- resetDependents: boolean;
548
- resetNodes: string[];
549
- timestampMs: number;
550
- } | {
551
- type: "RetryTaskFinished";
552
- runId: string;
553
- nodeId: string;
554
- iteration: number;
555
- resetNodes: string[];
556
- success: boolean;
557
- error?: string;
558
- timestampMs: number;
559
- } | {
560
- type: "RevertStarted";
561
- runId: string;
562
- nodeId: string;
563
- iteration: number;
564
- attempt: number;
565
- jjPointer: string;
566
- timestampMs: number;
567
- } | {
568
- type: "RevertFinished";
569
- runId: string;
570
- nodeId: string;
571
- iteration: number;
572
- attempt: number;
573
- jjPointer: string;
574
- success: boolean;
575
- error?: string;
576
- timestampMs: number;
577
- } | {
578
- type: "TimeTravelStarted";
579
- runId: string;
580
- nodeId: string;
581
- iteration: number;
582
- attempt: number;
583
- jjPointer?: string;
584
- timestampMs: number;
585
- } | {
586
- type: "TimeTravelFinished";
587
- runId: string;
588
- nodeId: string;
589
- iteration: number;
590
- attempt: number;
591
- jjPointer?: string;
592
- success: boolean;
593
- vcsRestored: boolean;
594
- resetNodes: string[];
595
- error?: string;
596
- timestampMs: number;
597
- } | {
598
- type: "TimeTravelJumped";
599
- runId: string;
600
- fromFrameNo: number;
601
- toFrameNo: number;
602
- timestampMs: number;
603
- caller?: string;
604
- } | {
605
- type: "EffectRevertStarted";
606
- runId: string;
607
- operation: string;
608
- kind: "tool" | "task";
609
- toolName: string;
610
- nodeId: string;
611
- iteration: number;
612
- attempt: number;
613
- seq: number;
614
- effectStatus: "succeeded" | "unknown";
615
- timestampMs: number;
616
- } | {
617
- type: "EffectRevertFinished";
618
- runId: string;
619
- operation: string;
620
- kind: "tool" | "task";
621
- toolName: string;
622
- nodeId: string;
623
- iteration: number;
624
- attempt: number;
625
- seq: number;
626
- timestampMs: number;
627
- } | {
628
- type: "EffectRevertFailed";
629
- runId: string;
630
- operation: string;
631
- kind: "tool" | "task";
632
- toolName: string;
633
- nodeId: string;
634
- iteration: number;
635
- attempt: number;
636
- seq: number;
637
- error: string;
638
- timestampMs: number;
639
- } | {
640
- type: "SideEffectBoundaryCrossed";
641
- runId: string;
642
- opId: string;
643
- operation: string;
644
- report: {
645
- blocking: unknown[];
646
- revertible: unknown[];
647
- warnings: unknown[];
648
- };
649
- parentRunId?: string;
650
- warningOnly?: boolean;
651
- lateCompletion?: boolean;
652
- archivedByOp?: string;
653
- timestampMs: number;
654
- } | {
655
- type: "WorkflowReloadDetected";
656
- runId: string;
657
- changedFiles: string[];
658
- timestampMs: number;
659
- } | {
660
- type: "WorkflowReloaded";
661
- runId: string;
662
- generation: number;
663
- changedFiles: string[];
664
- timestampMs: number;
665
- } | {
666
- type: "WorkflowReloadFailed";
667
- runId: string;
668
- error: unknown;
669
- changedFiles: string[];
670
- timestampMs: number;
671
- } | {
672
- type: "WorkflowReloadUnsafe";
673
- runId: string;
674
- reason: string;
675
- changedFiles: string[];
676
- timestampMs: number;
677
- } | {
678
- type: "ScorerStarted";
679
- runId: string;
680
- nodeId: string;
681
- scorerId: string;
682
- scorerName: string;
683
- timestampMs: number;
684
- } | {
685
- type: "ScorerFinished";
686
- runId: string;
687
- nodeId: string;
688
- scorerId: string;
689
- scorerName: string;
690
- score: number;
691
- timestampMs: number;
692
- } | {
693
- type: "ScorerFailed";
694
- runId: string;
695
- nodeId: string;
696
- scorerId: string;
697
- scorerName: string;
698
- error: unknown;
699
- timestampMs: number;
700
- } | {
701
- type: "TokenUsageReported";
702
- runId: string;
703
- nodeId: string;
704
- iteration: number;
705
- attempt: number;
706
- model: string;
707
- agent: string;
708
- inputTokens: number;
709
- outputTokens: number;
710
- cacheReadTokens?: number;
711
- cacheWriteTokens?: number;
712
- reasoningTokens?: number;
713
- timestampMs: number;
714
- } | {
715
- type: "SnapshotCaptured";
716
- runId: string;
717
- frameNo: number;
718
- contentHash: string;
719
- timestampMs: number;
720
- } | {
721
- type: "RunForked";
722
- runId: string;
723
- parentRunId: string;
724
- parentFrameNo: number;
725
- branchLabel?: string;
726
- timestampMs: number;
727
- } | {
728
- type: "ReplayStarted";
729
- runId: string;
730
- parentRunId: string;
731
- parentFrameNo: number;
732
- restoreVcs: boolean;
733
- timestampMs: number;
734
- } | {
735
- type: "MemoryFactSet";
736
- runId: string;
737
- namespace: string;
738
- key: string;
739
- timestampMs: number;
740
- } | {
741
- type: "MemoryRecalled";
742
- runId: string;
743
- namespace: string;
744
- query: string;
745
- resultCount: number;
746
- timestampMs: number;
747
- } | {
748
- type: "MemoryMessageSaved";
749
- runId: string;
750
- threadId: string;
751
- role: string;
752
- timestampMs: number;
753
- } | {
754
- type: "OpenApiToolCalled";
755
- runId: string;
756
- operationId: string;
757
- method: string;
758
- path: string;
759
- durationMs: number;
760
- status: "success" | "error";
761
- timestampMs: number;
762
- } | {
763
- type: "TimerCreated";
764
- runId: string;
765
- timerId: string;
766
- firesAtMs: number;
767
- timerType: "duration" | "absolute";
768
- timestampMs: number;
769
- } | {
770
- type: "TimerFired";
771
- runId: string;
772
- timerId: string;
773
- firesAtMs: number;
774
- firedAtMs: number;
775
- delayMs: number;
776
- timestampMs: number;
777
- } | {
778
- type: "TimerCancelled";
779
- runId: string;
780
- timerId: string;
781
- timestampMs: number;
782
- } | {
783
- type: "AgentTraceEvent";
784
- runId: string;
785
- nodeId: string;
786
- iteration: number;
787
- attempt: number;
788
- trace: CanonicalAgentTraceEvent;
789
- timestampMs: number;
790
- } | {
791
- type: "AgentTraceSummary";
792
- runId: string;
793
- nodeId: string;
794
- iteration: number;
795
- attempt: number;
796
- summary: AgentTraceSummary;
797
- timestampMs: number;
798
- } | {
799
- type: "AgentSessionEvent";
800
- runId: string;
801
- nodeId: string;
802
- iteration: number;
803
- attempt: number;
804
- transcript: AgentSessionTranscriptEvent;
805
- timestampMs: number;
806
- };
807
- type SmithersEvent$1 = SmithersEvent$2;
808
-
809
- /**
810
- * @param {SmithersEvent} event
811
- * @returns {Effect.Effect<void>}
812
- */
813
- declare function trackEvent(event: SmithersEvent): Effect.Effect<void>;
814
- type SmithersEvent = SmithersEvent$1;
815
-
816
- type SmithersMetricType$1 = "counter" | "gauge" | "histogram";
817
-
818
- type SmithersMetricUnit$1 = "count" | "milliseconds" | "seconds" | "bytes" | "tokens" | "ratio" | "depth";
819
-
820
- type SmithersMetricDefinition$1 = {
821
- readonly key: string;
822
- readonly metric: Metric.Metric<any, any>;
823
- readonly name: string;
824
- readonly prometheusName: string;
825
- readonly type: SmithersMetricType$1;
826
- readonly label: string;
827
- readonly unit?: SmithersMetricUnit$1;
828
- readonly description?: string;
829
- readonly labels?: readonly string[];
830
- readonly boundaries?: readonly number[];
831
- readonly defaultLabels?: readonly Readonly<Record<string, string>>[];
832
- };
833
-
834
- declare const smithersMetricCatalog: SmithersMetricDefinition$1[];
835
-
836
- declare const smithersMetricCatalogByKey: Map<string, SmithersMetricDefinition$1>;
837
-
838
- declare const smithersMetricCatalogByName: Map<string, SmithersMetricDefinition$1>;
839
-
840
- declare const smithersMetricCatalogByPrometheusName: Map<string, SmithersMetricDefinition$1>;
841
-
842
- type MetricName = string;
843
-
844
- type SmithersMetricEvent = {
845
- readonly type: string;
846
- readonly [key: string]: unknown;
847
- };
848
- type CounterEntry = {
849
- readonly type: "counter";
850
- value: number;
851
- readonly labels: MetricLabels;
852
- };
853
- type GaugeEntry = {
854
- readonly type: "gauge";
855
- value: number;
856
- readonly labels: MetricLabels;
857
- };
858
- type HistogramEntry = {
859
- readonly type: "histogram";
860
- sum: number;
861
- count: number;
862
- readonly labels: MetricLabels;
863
- readonly buckets: Map<number, number>;
864
- };
865
- type MetricEntry = CounterEntry | GaugeEntry | HistogramEntry;
866
- type MetricsSnapshot = ReadonlyMap<string, MetricEntry>;
867
- type MetricsServiceShape$1 = {
868
- readonly increment: (name: MetricName, labels?: MetricLabels) => Effect.Effect<void>;
869
- readonly incrementBy: (name: MetricName, value: number, labels?: MetricLabels) => Effect.Effect<void>;
870
- readonly gauge: (name: MetricName, value: number, labels?: MetricLabels) => Effect.Effect<void>;
871
- readonly histogram: (name: MetricName, value: number, labels?: MetricLabels) => Effect.Effect<void>;
872
- readonly recordEvent: (event: SmithersMetricEvent) => Effect.Effect<void>;
873
- readonly updateProcessMetrics: () => Effect.Effect<void>;
874
- readonly updateAsyncExternalWaitPending: (kind: "approval" | "event", delta: number) => Effect.Effect<void>;
875
- readonly renderPrometheus: () => Effect.Effect<string>;
876
- readonly snapshot: () => Effect.Effect<MetricsSnapshot>;
877
- };
878
-
879
- /** @type {MetricsServiceShape} */
880
- declare const metricsServiceAdapter: MetricsServiceShape;
881
- type MetricsServiceShape = MetricsServiceShape$1;
882
-
883
- declare const runsTotal: Metric.Counter<number>;
884
-
885
- declare const nodesStarted: Metric.Counter<number>;
886
-
887
- declare const nodesFinished: Metric.Counter<number>;
888
-
889
- declare const nodesFailed: Metric.Counter<number>;
890
-
891
- declare const toolCallsTotal: Metric.Counter<number>;
892
-
893
- declare const cacheHits: Metric.Counter<number>;
894
-
895
- declare const cacheMisses: Metric.Counter<number>;
896
-
897
- declare const dbRetries: Metric.Counter<number>;
898
-
899
- declare const dbTransactionRollbacks: Metric.Counter<number>;
900
-
901
- declare const dbTransactionRetries: Metric.Counter<number>;
902
-
903
- declare const hotReloads: Metric.Counter<number>;
904
-
905
- declare const hotReloadFailures: Metric.Counter<number>;
906
-
907
- declare const httpRequests: Metric.Counter<number>;
908
-
909
- declare const approvalsRequested: Metric.Counter<number>;
910
-
911
- declare const approvalsGranted: Metric.Counter<number>;
912
-
913
- declare const approvalsDenied: Metric.Counter<number>;
914
-
915
- declare const timersCreated: Metric.Counter<number>;
916
-
917
- declare const timersFired: Metric.Counter<number>;
918
-
919
- declare const timersCancelled: Metric.Counter<number>;
920
-
921
- declare const sandboxCreatedTotal: Metric.Counter<number>;
922
-
923
- declare const sandboxCompletedTotal: Metric.Counter<number>;
924
-
925
- declare const alertsFiredTotal: Metric.Counter<number>;
926
-
927
- declare const alertsAcknowledgedTotal: Metric.Counter<number>;
928
-
929
- declare const alertsResolvedTotal: Metric.Counter<number>;
930
-
931
- declare const alertsSilencedTotal: Metric.Counter<number>;
932
-
933
- declare const alertsReopenedTotal: Metric.Counter<number>;
934
-
935
- declare const alertsEscalatedTotal: Metric.Counter<number>;
936
-
937
- declare const alertDeliveriesAttempted: Metric.Counter<number>;
938
-
939
- declare const alertDeliveriesSuppressed: Metric.Counter<number>;
940
-
941
- declare const scorerEventsStarted: Metric.Counter<number>;
942
-
943
- declare const scorerEventsFinished: Metric.Counter<number>;
944
-
945
- declare const scorerEventsFailed: Metric.Counter<number>;
946
-
947
- declare const tokensInputTotal: Metric.Counter<number>;
948
-
949
- declare const tokensOutputTotal: Metric.Counter<number>;
950
-
951
- declare const tokensCacheReadTotal: Metric.Counter<number>;
952
-
953
- declare const tokensCacheWriteTotal: Metric.Counter<number>;
954
-
955
- declare const tokensReasoningTotal: Metric.Counter<number>;
956
-
957
- declare const tokensContextWindowBucketTotal: Metric.Counter<number>;
958
-
959
- declare const runsFinishedTotal: Metric.Counter<number>;
960
-
961
- declare const runsFailedTotal: Metric.Counter<number>;
962
-
963
- declare const runsCancelledTotal: Metric.Counter<number>;
964
-
965
- declare const runsResumedTotal: Metric.Counter<number>;
966
-
967
- declare const runsContinuedTotal: Metric.Counter<number>;
968
-
969
- declare const supervisorPollsTotal: Metric.Counter<number>;
970
-
971
- declare const supervisorStaleDetected: Metric.Counter<number>;
972
-
973
- declare const supervisorResumedTotal: Metric.Counter<number>;
974
-
975
- declare const supervisorSkippedTotal: Metric.Counter<number>;
976
-
977
- declare const errorsTotal: Metric.Counter<number>;
978
-
979
- declare const nodeRetriesTotal: Metric.Counter<number>;
980
-
981
- declare const toolCallErrorsTotal: Metric.Counter<number>;
982
-
983
- declare const toolOutputTruncatedTotal: Metric.Counter<number>;
984
-
985
- declare const agentInvocationsTotal: Metric.Counter<number>;
986
-
987
- declare const agentTokensTotal: Metric.Counter<number>;
988
-
989
- declare const agentErrorsTotal: Metric.Counter<number>;
990
-
991
- declare const agentRetriesTotal: Metric.Counter<number>;
992
-
993
- declare const agentEventsTotal: Metric.Counter<number>;
994
-
995
- declare const agentSessionsTotal: Metric.Counter<number>;
996
-
997
- declare const agentActionsTotal: Metric.Counter<number>;
998
-
999
- declare const gatewayConnectionsTotal: Metric.Counter<number>;
1000
-
1001
- declare const gatewayConnectionsClosedTotal: Metric.Counter<number>;
1002
-
1003
- declare const gatewayMessagesReceivedTotal: Metric.Counter<number>;
1004
-
1005
- declare const gatewayMessagesSentTotal: Metric.Counter<number>;
1006
-
1007
- declare const gatewayRpcCallsTotal: Metric.Counter<number>;
1008
-
1009
- declare const gatewayErrorsTotal: Metric.Counter<number>;
1010
-
1011
- declare const gatewayRunsStartedTotal: Metric.Counter<number>;
1012
-
1013
- declare const gatewayRunsCompletedTotal: Metric.Counter<number>;
1014
-
1015
- declare const gatewayApprovalDecisionsTotal: Metric.Counter<number>;
1016
-
1017
- declare const gatewaySignalsTotal: Metric.Counter<number>;
1018
-
1019
- declare const gatewayAuthEventsTotal: Metric.Counter<number>;
1020
-
1021
- declare const gatewayHeartbeatTicksTotal: Metric.Counter<number>;
1022
-
1023
- declare const gatewayCronTriggersTotal: Metric.Counter<number>;
1024
-
1025
- declare const gatewayWebhooksReceivedTotal: Metric.Counter<number>;
1026
-
1027
- declare const gatewayWebhooksVerifiedTotal: Metric.Counter<number>;
1028
-
1029
- declare const gatewayWebhooksRejectedTotal: Metric.Counter<number>;
1030
-
1031
- declare const devtoolsSubscribeTotal: Metric.Counter<number>;
1032
-
1033
- declare const devtoolsEventTotal: Metric.Counter<number>;
1034
-
1035
- declare const devtoolsBackpressureDisconnectTotal: Metric.Counter<number>;
1036
-
1037
- declare const gatewayRunEventBackpressureDisconnectTotal: Metric.Counter<number>;
1038
-
1039
- declare const eventsEmittedTotal: Metric.Counter<number>;
1040
-
1041
- declare const taskHeartbeatsTotal: Metric.Counter<number>;
1042
-
1043
- declare const taskHeartbeatTimeoutTotal: Metric.Counter<number>;
1044
-
1045
- declare const memoryFactReads: Metric.Counter<number>;
1046
-
1047
- declare const memoryFactWrites: Metric.Counter<number>;
1048
-
1049
- declare const memoryRecallQueries: Metric.Counter<number>;
1050
-
1051
- declare const memoryMessageSaves: Metric.Counter<number>;
1052
-
1053
- declare const openApiToolCallsTotal: Metric.Counter<number>;
1054
-
1055
- declare const openApiToolCallErrorsTotal: Metric.Counter<number>;
1056
-
1057
- declare const scorersStarted: Metric.Counter<number>;
1058
-
1059
- declare const scorersFinished: Metric.Counter<number>;
1060
-
1061
- declare const scorersFailed: Metric.Counter<number>;
1062
-
1063
- declare const snapshotsCaptured: Metric.Counter<number>;
1064
-
1065
- declare const runForksCreated: Metric.Counter<number>;
1066
-
1067
- declare const replaysStarted: Metric.Counter<number>;
1068
-
1069
- declare const activeRuns: Metric.Gauge<number>;
1070
-
1071
- declare const activeNodes: Metric.Gauge<number>;
1072
-
1073
- declare const schedulerQueueDepth: Metric.Gauge<number>;
1074
-
1075
- declare const sandboxActive: Metric.Gauge<number>;
1076
-
1077
- declare const alertsActive: Metric.Gauge<number>;
1078
-
1079
- declare const attentionBacklog: Metric.Gauge<number>;
1080
-
1081
- declare const gatewayConnectionsActive: Metric.Gauge<number>;
1082
-
1083
- declare const approvalPending: Metric.Gauge<number>;
1084
-
1085
- declare const externalWaitAsyncPending: Metric.Gauge<number>;
1086
-
1087
- declare const timersPending: Metric.Gauge<number>;
1088
-
1089
- declare const schedulerConcurrencyUtilization: Metric.Gauge<number>;
1090
-
1091
- declare const processUptimeSeconds: Metric.Gauge<number>;
1092
-
1093
- declare const processMemoryRssBytes: Metric.Gauge<number>;
1094
-
1095
- declare const processHeapUsedBytes: Metric.Gauge<number>;
1096
-
1097
- declare const devtoolsActiveSubscribers: Metric.Gauge<number>;
1098
-
1099
- declare const nodeDuration: Metric.Histogram<number>;
1100
-
1101
- declare const attemptDuration: Metric.Histogram<number>;
1102
-
1103
- declare const toolDuration: Metric.Histogram<number>;
1104
-
1105
- declare const dbQueryDuration: Metric.Histogram<number>;
1106
-
1107
- declare const dbTransactionDuration: Metric.Histogram<number>;
1108
-
1109
- declare const httpRequestDuration: Metric.Histogram<number>;
1110
-
1111
- declare const hotReloadDuration: Metric.Histogram<number>;
1112
-
1113
- declare const vcsDuration: Metric.Histogram<number>;
1114
-
1115
- declare const agentDurationMs: Metric.Histogram<number>;
1116
-
1117
- declare const tokensInputPerCall: Metric.Histogram<number>;
1118
-
1119
- declare const tokensOutputPerCall: Metric.Histogram<number>;
1120
-
1121
- declare const tokensContextWindowPerCall: Metric.Histogram<number>;
1122
-
1123
- declare const runDuration: Metric.Histogram<number>;
1124
-
1125
- declare const promptSizeBytes: Metric.Histogram<number>;
1126
-
1127
- declare const responseSizeBytes: Metric.Histogram<number>;
1128
-
1129
- declare const approvalWaitDuration: Metric.Histogram<number>;
1130
-
1131
- declare const timerDelayDuration: Metric.Histogram<number>;
1132
-
1133
- declare const gatewayRpcDuration: Metric.Histogram<number>;
1134
-
1135
- declare const schedulerWaitDuration: Metric.Histogram<number>;
1136
-
1137
- declare const supervisorPollDuration: Metric.Histogram<number>;
1138
-
1139
- declare const supervisorResumeLag: Metric.Histogram<number>;
1140
-
1141
- declare const runsAncestryDepth: Metric.Histogram<number>;
1142
-
1143
- declare const runsCarriedStateBytes: Metric.Histogram<number>;
1144
-
1145
- declare const sandboxDurationMs: Metric.Histogram<number>;
1146
-
1147
- declare const sandboxBundleSizeBytes: Metric.Histogram<number>;
1148
-
1149
- declare const sandboxTransportDurationMs: Metric.Histogram<number>;
1150
-
1151
- declare const sandboxPatchCount: Metric.Histogram<number>;
1152
-
1153
- declare const heartbeatDataSizeBytes: Metric.Histogram<number>;
1154
-
1155
- declare const heartbeatIntervalMs: Metric.Histogram<number>;
1156
-
1157
- declare const memoryRecallDuration: Metric.Histogram<number>;
1158
-
1159
- declare const openApiToolDuration: Metric.Histogram<number>;
1160
-
1161
- declare const scorerDuration: Metric.Histogram<number>;
1162
-
1163
- declare const snapshotDuration: Metric.Histogram<number>;
1164
-
1165
- declare const devtoolsSnapshotBuildMs: Metric.Histogram<number>;
1166
-
1167
- declare const devtoolsDeltaBuildMs: Metric.Histogram<number>;
1168
-
1169
- declare const devtoolsEventBytes: Metric.Histogram<number>;
1170
-
1171
- declare const rewindTotal: Metric.Counter<number>;
1172
-
1173
- declare const rewindRollbackTotal: Metric.Counter<number>;
1174
-
1175
- declare const rewindDurationMs: Metric.Histogram<number>;
1176
-
1177
- declare const rewindFramesDeleted: Metric.Histogram<number>;
1178
-
1179
- declare const rewindSandboxesReverted: Metric.Histogram<number>;
1180
-
1181
- type SmithersMetricDefinition = SmithersMetricDefinition$2;
1182
- type SmithersMetricType = SmithersMetricType$2;
1183
- type SmithersMetricUnit = SmithersMetricUnit$2;
1184
-
1185
- export { type SmithersMetricDefinition, type SmithersMetricType, type SmithersMetricUnit, activeNodes, activeRuns, agentActionsTotal, agentDurationMs, agentErrorsTotal, agentEventsTotal, agentInvocationsTotal, agentRetriesTotal, agentSessionsTotal, agentTokensTotal, alertDeliveriesAttempted, alertDeliveriesSuppressed, alertsAcknowledgedTotal, alertsActive, alertsEscalatedTotal, alertsFiredTotal, alertsReopenedTotal, alertsResolvedTotal, alertsSilencedTotal, approvalPending, approvalWaitDuration, approvalsDenied, approvalsGranted, approvalsRequested, attemptDuration, attentionBacklog, cacheHits, cacheMisses, dbQueryDuration, dbRetries, dbTransactionDuration, dbTransactionRetries, dbTransactionRollbacks, devtoolsActiveSubscribers, devtoolsBackpressureDisconnectTotal, devtoolsDeltaBuildMs, devtoolsEventBytes, devtoolsEventTotal, devtoolsSnapshotBuildMs, devtoolsSubscribeTotal, errorsTotal, eventsEmittedTotal, externalWaitAsyncPending, gatewayApprovalDecisionsTotal, gatewayAuthEventsTotal, gatewayConnectionsActive, gatewayConnectionsClosedTotal, gatewayConnectionsTotal, gatewayCronTriggersTotal, gatewayErrorsTotal, gatewayHeartbeatTicksTotal, gatewayMessagesReceivedTotal, gatewayMessagesSentTotal, gatewayRpcCallsTotal, gatewayRpcDuration, gatewayRunEventBackpressureDisconnectTotal, gatewayRunsCompletedTotal, gatewayRunsStartedTotal, gatewaySignalsTotal, gatewayWebhooksReceivedTotal, gatewayWebhooksRejectedTotal, gatewayWebhooksVerifiedTotal, heartbeatDataSizeBytes, heartbeatIntervalMs, hotReloadDuration, hotReloadFailures, hotReloads, httpRequestDuration, httpRequests, memoryFactReads, memoryFactWrites, memoryMessageSaves, memoryRecallDuration, memoryRecallQueries, metricsServiceAdapter, nodeDuration, nodeRetriesTotal, nodesFailed, nodesFinished, nodesStarted, openApiToolCallErrorsTotal, openApiToolCallsTotal, openApiToolDuration, processHeapUsedBytes, processMemoryRssBytes, processUptimeSeconds, promptSizeBytes, replaysStarted, responseSizeBytes, rewindDurationMs, rewindFramesDeleted, rewindRollbackTotal, rewindSandboxesReverted, rewindTotal, runDuration, runForksCreated, runsAncestryDepth, runsCancelledTotal, runsCarriedStateBytes, runsContinuedTotal, runsFailedTotal, runsFinishedTotal, runsResumedTotal, runsTotal, sandboxActive, sandboxBundleSizeBytes, sandboxCompletedTotal, sandboxCreatedTotal, sandboxDurationMs, sandboxPatchCount, sandboxTransportDurationMs, schedulerConcurrencyUtilization, schedulerQueueDepth, schedulerWaitDuration, scorerDuration, scorerEventsFailed, scorerEventsFinished, scorerEventsStarted, scorersFailed, scorersFinished, scorersStarted, smithersMetricCatalog, smithersMetricCatalogByKey, smithersMetricCatalogByName, smithersMetricCatalogByPrometheusName, snapshotDuration, snapshotsCaptured, supervisorPollDuration, supervisorPollsTotal, supervisorResumeLag, supervisorResumedTotal, supervisorSkippedTotal, supervisorStaleDetected, taskHeartbeatTimeoutTotal, taskHeartbeatsTotal, timerDelayDuration, timersCancelled, timersCreated, timersFired, timersPending, toPrometheusMetricName, tokensCacheReadTotal, tokensCacheWriteTotal, tokensContextWindowBucketTotal, tokensContextWindowPerCall, tokensInputPerCall, tokensInputTotal, tokensOutputPerCall, tokensOutputTotal, tokensReasoningTotal, toolCallErrorsTotal, toolCallsTotal, toolDuration, toolOutputTruncatedTotal, trackEvent, updateAsyncExternalWaitPending, updateProcessMetrics, vcsDuration };