@agimon-ai/doompi-log 0.0.1-alpha.28 → 0.0.1-alpha.29

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 (2) hide show
  1. package/README.md +21 -7
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -4,7 +4,8 @@ Session metrics, findings, sink status, and a Log Metrics overlay for Pi.
4
4
 
5
5
  Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
6
6
 
7
- The extension aggregates telemetry it observes in-process and can query historical data from `@agimon-ai/log-sink-mcp`.
7
+ The extension aggregates telemetry it observes in-process and can query historical data from
8
+ `@agimon-ai/log-sink-mcp`.
8
9
 
9
10
  > **Alpha:** metric attribution and UI contracts may change between releases.
10
11
 
@@ -26,11 +27,18 @@ Use `SPC h l` to open the current session's Log Metrics overlay.
26
27
 
27
28
  ## What is collected
28
29
 
29
- The in-process aggregator tracks operational records such as turn token totals, cache use, tool calls and failures, operation durations, recent errors, and event counts. It derives findings from those records without requiring an external sink.
30
+ The in-process aggregator tracks operational records such as turn token totals, cache use, tool
31
+ calls and failures, operation durations, recent errors, and event counts. It derives findings from
32
+ those records without requiring an external sink.
30
33
 
31
- Historical panels resolve a sink over HTTP first and then use the Log Sink CLI fallback. Without a reachable sink, current-session headline, findings, errors, and tool metrics still work; historical top-consumer and burn-rate views are unavailable. Sink failures are reported in status rather than failing the Pi session.
34
+ Historical panels resolve a sink over HTTP first and then use the Log Sink CLI fallback. Without a
35
+ reachable sink, current-session headline metrics, findings, errors, and tool metrics still work;
36
+ historical top-consumer and burn-rate views are unavailable. Sink failures are reported in status
37
+ rather than failing the Pi session.
32
38
 
33
- Turn cost attribution is contextual: when a turn invokes several tools, the emitted turn total can be associated with each participating tool. The overlay uses that value for ranking, not as a precise per-tool share.
39
+ Turn cost attribution is contextual: when a turn invokes several tools, the emitted turn total can
40
+ be associated with each participating tool. The overlay uses that value for ranking, not as a
41
+ precise per-tool share.
34
42
 
35
43
  Keys: `r` refreshes, `g` changes dimension, `p` changes period, `?` opens details, and Escape closes.
36
44
 
@@ -42,9 +50,12 @@ Keys: `r` refreshes, `g` changes dimension, `p` changes period, `?` opens detail
42
50
  | `OTEL_SDK_DISABLED` | Disables OpenTelemetry SDK export |
43
51
  | `AGENT_OTEL_TRACES` | Enables/disables trace export; logs can remain enabled |
44
52
 
45
- File fallback is opt-in through host options. No configured/reachable endpoint does not prevent in-process aggregation. Exceptions and caller-supplied attributes can still be sensitive; do not assume “metadata” is harmless.
53
+ File fallback is opt-in through host options. The absence of a configured or reachable endpoint
54
+ does not prevent in-process aggregation. Exceptions and caller-supplied attributes can still be
55
+ sensitive; do not assume "metadata" is harmless.
46
56
 
47
- The overlay requires a TUI. The aggregator, findings, and metrics-source APIs can be embedded in headless hosts.
57
+ The overlay requires a TUI. The aggregator, findings, and metrics-source APIs can be embedded in
58
+ headless hosts.
48
59
 
49
60
  ## Public API
50
61
 
@@ -57,7 +68,10 @@ import {
57
68
  } from '@agimon-ai/doompi-log';
58
69
  ```
59
70
 
60
- `installDoomLogRuntime` installs package resources into the package plugin fiber supplied by the shared runner-scoped Cordis host. Normal Pi activation should use the discovered `extensions/pi` entry, which connects to that host and disposes its plugin fiber before releasing the host lease. Focused exports provide metrics types, the metrics source, and the overlay component.
71
+ Normal Pi activation should use the discovered `extensions/pi` entry. Host integrations can call
72
+ `installDoomLogRuntime` to install package resources into the shared runner-scoped Cordis host. The
73
+ extension entry manages its plugin lifecycle and releases the host lease when the Pi session shuts
74
+ down. Focused exports provide metrics types, the metrics source, and the overlay component.
61
75
 
62
76
  ## Development
63
77
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agimon-ai/doompi-log",
3
- "version": "0.0.1-alpha.28",
3
+ "version": "0.0.1-alpha.29",
4
4
  "description": "Pi session metrics, findings, sink status, and a Log Metrics overlay for agent observability.",
5
5
  "keywords": [
6
6
  "agent-observability",
@@ -60,8 +60,8 @@
60
60
  "dependencies": {
61
61
  "@agimon-ai/log-sink-mcp": "0.29.16",
62
62
  "@deepseek-ai/cordis": "4.0.1",
63
- "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.28",
64
- "@agimon-ai/doompi-telemetry": "0.0.1-alpha.28"
63
+ "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.29",
64
+ "@agimon-ai/doompi-telemetry": "0.0.1-alpha.29"
65
65
  },
66
66
  "devDependencies": {
67
67
  "@earendil-works/pi-coding-agent": "0.84.2",
@@ -71,7 +71,7 @@
71
71
  "tsdown": "0.22.14",
72
72
  "typescript": "7.0.2",
73
73
  "vitest": "4.1.11",
74
- "@agimon-ai/doompi-ui": "0.0.1-alpha.28"
74
+ "@agimon-ai/doompi-ui": "0.0.1-alpha.29"
75
75
  },
76
76
  "peerDependencies": {
77
77
  "@earendil-works/pi-coding-agent": "0.84.2",