@agimon-ai/doompi-log 0.0.1-alpha.9 → 0.0.1-alpha.90

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 (115) hide show
  1. package/README.md +68 -21
  2. package/dist/agentDiagnostics-C2KgHmsD.mjs +183 -0
  3. package/dist/agentDiagnostics-C2KgHmsD.mjs.map +1 -0
  4. package/dist/agentDiagnostics-XrO2jPyN.cjs +200 -0
  5. package/dist/agentDiagnostics-XrO2jPyN.cjs.map +1 -0
  6. package/dist/apiContracts.cjs +145 -0
  7. package/dist/apiContracts.cjs.map +1 -0
  8. package/dist/apiContracts.d.mts +53 -0
  9. package/dist/apiContracts.d.mts.map +1 -0
  10. package/dist/apiContracts.mjs +140 -0
  11. package/dist/apiContracts.mjs.map +1 -0
  12. package/dist/extensions/pi.cjs +485 -1
  13. package/dist/extensions/pi.cjs.map +1 -1
  14. package/dist/extensions/pi.d.mts +4 -3
  15. package/dist/extensions/pi.d.mts.map +1 -1
  16. package/dist/extensions/pi.mjs +480 -1
  17. package/dist/extensions/pi.mjs.map +1 -1
  18. package/dist/extensions/server.cjs +739 -0
  19. package/dist/extensions/server.cjs.map +1 -0
  20. package/dist/extensions/server.d.mts +5 -0
  21. package/dist/extensions/server.d.mts.map +1 -0
  22. package/dist/extensions/server.mjs +711 -0
  23. package/dist/extensions/server.mjs.map +1 -0
  24. package/dist/extensions/web.mjs +1020 -0
  25. package/dist/extensions/web.mjs.map +1 -0
  26. package/dist/findings-Bo4IHNpr.cjs +165 -0
  27. package/dist/findings-Bo4IHNpr.cjs.map +1 -0
  28. package/dist/findings-DAKeRG4O.mjs +160 -0
  29. package/dist/findings-DAKeRG4O.mjs.map +1 -0
  30. package/dist/index-BTk12VKU.d.mts +165 -0
  31. package/dist/index-BTk12VKU.d.mts.map +1 -0
  32. package/dist/{extension.d.mts → index-Bxykybjr.d.mts} +11 -12
  33. package/dist/index-Bxykybjr.d.mts.map +1 -0
  34. package/dist/index-CLHBiYfn.d.mts +23 -0
  35. package/dist/index-CLHBiYfn.d.mts.map +1 -0
  36. package/dist/index.cjs +18 -1
  37. package/dist/index.d.mts +5 -4
  38. package/dist/index.mjs +5 -1
  39. package/dist/logMetricsOverlay-Bj9L8YLJ.cjs +708 -0
  40. package/dist/logMetricsOverlay-Bj9L8YLJ.cjs.map +1 -0
  41. package/dist/logMetricsOverlay-Cd_D2KeU.d.mts +151 -0
  42. package/dist/logMetricsOverlay-Cd_D2KeU.d.mts.map +1 -0
  43. package/dist/logMetricsOverlay-osmlxd12.mjs +703 -0
  44. package/dist/logMetricsOverlay-osmlxd12.mjs.map +1 -0
  45. package/dist/logRuntime-CCVbCzaK.mjs +98 -0
  46. package/dist/logRuntime-CCVbCzaK.mjs.map +1 -0
  47. package/dist/logRuntime-DcD32EjA.cjs +109 -0
  48. package/dist/logRuntime-DcD32EjA.cjs.map +1 -0
  49. package/dist/metrics-C7vwHHjG.cjs +410 -0
  50. package/dist/metrics-C7vwHHjG.cjs.map +1 -0
  51. package/dist/metrics-DXTxQN4U.mjs +351 -0
  52. package/dist/metrics-DXTxQN4U.mjs.map +1 -0
  53. package/dist/metrics.cjs +14 -2
  54. package/dist/metrics.d.mts +3 -94
  55. package/dist/metrics.mjs +3 -2
  56. package/dist/metricsOverlay.cjs +3 -0
  57. package/dist/metricsOverlay.d.mts +2 -0
  58. package/dist/metricsOverlay.mjs +2 -0
  59. package/dist/metricsSource-DXZLawQu.mjs +130 -0
  60. package/dist/metricsSource-DXZLawQu.mjs.map +1 -0
  61. package/dist/metricsSource-DdwQNzoY.cjs +135 -0
  62. package/dist/metricsSource-DdwQNzoY.cjs.map +1 -0
  63. package/dist/metricsSource-cZnErdv4.d.mts +51 -0
  64. package/dist/metricsSource-cZnErdv4.d.mts.map +1 -0
  65. package/dist/metricsSource.cjs +3 -2
  66. package/dist/metricsSource.d.mts +11 -18
  67. package/dist/metricsSource.d.mts.map +1 -1
  68. package/dist/metricsSource.mjs +2 -2
  69. package/dist/telemetryEnabled-B6g7R7BP.mjs +20 -0
  70. package/dist/telemetryEnabled-B6g7R7BP.mjs.map +1 -0
  71. package/dist/telemetryEnabled-BJ2BKyps.cjs +73 -0
  72. package/dist/telemetryEnabled-BJ2BKyps.cjs.map +1 -0
  73. package/llms.txt +7 -0
  74. package/package.json +91 -26
  75. package/src/prompts/doompi-debug-agent/SKILL.md +28 -0
  76. package/dist/_virtual/_rolldown/runtime.cjs +0 -1
  77. package/dist/extension.cjs +0 -2
  78. package/dist/extension.cjs.map +0 -1
  79. package/dist/extension.d.cts +0 -33
  80. package/dist/extension.d.cts.map +0 -1
  81. package/dist/extension.d.mts.map +0 -1
  82. package/dist/extension.mjs +0 -2
  83. package/dist/extension.mjs.map +0 -1
  84. package/dist/extensions/pi.d.cts +0 -4
  85. package/dist/extensions/pi.d.cts.map +0 -1
  86. package/dist/index.d.cts +0 -4
  87. package/dist/metrics.cjs.map +0 -1
  88. package/dist/metrics.d.cts +0 -94
  89. package/dist/metrics.d.cts.map +0 -1
  90. package/dist/metrics.d.mts.map +0 -1
  91. package/dist/metrics.mjs.map +0 -1
  92. package/dist/metricsSource.cjs.map +0 -1
  93. package/dist/metricsSource.d.cts +0 -25
  94. package/dist/metricsSource.d.cts.map +0 -1
  95. package/dist/metricsSource.mjs.map +0 -1
  96. package/dist/tui/doomOverlay.cjs +0 -2
  97. package/dist/tui/doomOverlay.cjs.map +0 -1
  98. package/dist/tui/doomOverlay.d.cts +0 -63
  99. package/dist/tui/doomOverlay.d.cts.map +0 -1
  100. package/dist/tui/doomOverlay.d.mts +0 -63
  101. package/dist/tui/doomOverlay.d.mts.map +0 -1
  102. package/dist/tui/doomOverlay.mjs +0 -2
  103. package/dist/tui/doomOverlay.mjs.map +0 -1
  104. package/dist/tui/metricsOverlay.cjs +0 -2
  105. package/dist/tui/metricsOverlay.cjs.map +0 -1
  106. package/dist/tui/metricsOverlay.d.cts +0 -71
  107. package/dist/tui/metricsOverlay.d.cts.map +0 -1
  108. package/dist/tui/metricsOverlay.d.mts +0 -71
  109. package/dist/tui/metricsOverlay.d.mts.map +0 -1
  110. package/dist/tui/metricsOverlay.mjs +0 -2
  111. package/dist/tui/metricsOverlay.mjs.map +0 -1
  112. package/dist/tui/rendering.cjs +0 -2
  113. package/dist/tui/rendering.cjs.map +0 -1
  114. package/dist/tui/rendering.mjs +0 -2
  115. package/dist/tui/rendering.mjs.map +0 -1
package/README.md CHANGED
@@ -1,40 +1,87 @@
1
1
  # @agimon-ai/doompi-log
2
2
 
3
- Pi log-sink telemetry extension with session-local metrics and a Log Metrics overlay.
3
+ Session metrics, findings, sink status, and a Log Metrics overlay for Pi.
4
4
 
5
- Session-local metrics and a log metrics overlay, backed by log-sink telemetry.
5
+ Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
6
6
 
7
- Part of [Doompi](https://www.npmjs.com/package/@agimon-ai/doompi), a coding agent that loads
8
- only the skills and tools you name. This package is composed by Doompi and is not usually
9
- installed on its own.
7
+ The extension aggregates telemetry it observes in-process and can query historical data from
8
+ `@agimon-ai/log-sink-mcp`.
9
+
10
+ > **Alpha:** metric attribution and UI contracts may change between releases.
11
+
12
+ ## Requirements
13
+
14
+ - Node.js 22.19.0 or newer
15
+ - Pi 0.85.0 and Pi TUI 0.85.0
10
16
 
11
17
  ## Install
12
18
 
19
+ `doompi init` and `dpi init` include Log in `default.packages` in `.doom/modes.yaml`. Remove it
20
+ or move it to a named layer to change which major modes load it. Pi discovers its sole extension
21
+ entry through `package.json.pi.extensions`. For standalone Pi:
22
+
13
23
  ```bash
14
- npm install @agimon-ai/doompi-log
24
+ pi install npm:@agimon-ai/doompi-log
15
25
  ```
16
26
 
17
- ## How it loads
27
+ Use `SPC h l` to open the current session's Log Metrics overlay.
28
+
29
+ ## What is collected
30
+
31
+ The in-process aggregator tracks operational records such as turn token totals, cache use, tool
32
+ calls and failures, operation durations, recent errors, and event counts. It derives findings from
33
+ those records without requiring an external sink.
34
+
35
+ Historical panels resolve a sink over HTTP first and then use the Log Sink CLI fallback. Without a
36
+ reachable sink, current-session headline metrics, findings, errors, and tool metrics still work;
37
+ historical top-consumer and burn-rate views are unavailable. Sink failures are reported in status
38
+ rather than failing the Pi session.
39
+
40
+ Turn cost attribution is contextual: when a turn invokes several tools, the emitted turn total can
41
+ be associated with each participating tool. The overlay uses that value for ranking, not as a
42
+ precise per-tool share.
43
+
44
+ Keys: `r` refreshes, `g` changes dimension, `p` changes period, `?` opens details, and Escape closes.
18
45
 
19
- Doompi loads this unconditionally. It is core, not a layer, so it does not appear in
20
- `.doom/modes.yaml`: making it optional would only create broken configurations.
46
+ ## Telemetry controls
21
47
 
22
- Extension entry: `@agimon-ai/doompi-log/extensions/pi`
48
+ | Variable | Effect |
49
+ | -------------------------- | ------------------------------------------------------ |
50
+ | `AGENT_TELEMETRY_DISABLED` | Disables the extension's telemetry export |
51
+ | `OTEL_SDK_DISABLED` | Disables OpenTelemetry SDK export |
52
+ | `AGENT_OTEL_TRACES` | Enables/disables trace export; logs can remain enabled |
23
53
 
24
- ## Leader
54
+ File fallback is opt-in through host options. The absence of a configured or reachable endpoint
55
+ does not prevent in-process aggregation. Exceptions and caller-supplied attributes can still be
56
+ sensitive; do not assume "metadata" is harmless.
25
57
 
26
- `SPC h l` opens log metrics, once the extension is loaded.
58
+ The overlay requires a TUI. The aggregator, findings, and metrics-source APIs can be embedded in
59
+ headless hosts.
27
60
 
28
- ## Entry points
61
+ ## Public API
62
+
63
+ ```ts
64
+ import { deriveFindings, LogMetricsAggregator, openLogMetricsOverlay } from '@agimon-ai/doompi-log';
65
+ ```
66
+
67
+ Normal Pi activation uses `extensions/pi`. Composition hosts await `doomLogExtension.install(context, pi)`
68
+ from that entry. The helper owns registrations and cleanup. Session shutdown flushes final telemetry
69
+ before `onDispose` releases the telemetry handle. Optional UI services follow provider replacement.
70
+
71
+ `src/extensions/` declares the Pi, server, and web plugins. Controllers handle events and HTTP requests,
72
+ services own aggregation and sink queries, and `src/tui/` owns terminal presentation. Flat `src/exports/`
73
+ modules expose reusable APIs. The overlay component is available through `metrics-overlay`.
74
+
75
+ ## Development
76
+
77
+ ```bash
78
+ pnpm build
79
+ pnpm typecheck
80
+ pnpm test
81
+ pnpm lint
82
+ ```
29
83
 
30
- | Import |
31
- | ------------------------------------------ |
32
- | `@agimon-ai/doompi-log` |
33
- | `@agimon-ai/doompi-log/extension` |
34
- | `@agimon-ai/doompi-log/extensions/pi` |
35
- | `@agimon-ai/doompi-log/metrics` |
36
- | `@agimon-ai/doompi-log/metricsSource` |
37
- | `@agimon-ai/doompi-log/tui/metricsOverlay` |
84
+ Maintained by [Agimon](https://agimon.ai/about).
38
85
 
39
86
  ## License
40
87
 
@@ -0,0 +1,183 @@
1
+ import { l as PACKAGE_NAME } from "./telemetryEnabled-B6g7R7BP.mjs";
2
+ import { t as createMetricsSource } from "./metricsSource-DXZLawQu.mjs";
3
+ import { defineTool } from "@agimon-ai/doompi-core/piExtension";
4
+ import { DOOM_HELP_WHEN } from "@agimon-ai/doompi-core/help";
5
+ import { Check } from "typebox/value";
6
+ import { Type } from "typebox";
7
+ //#region src/constants/diagnostics.ts
8
+ const DIAGNOSE_AGENT_NAME = "diagnose_agent";
9
+ const DIAGNOSE_AGENT_DESCRIPTION = "Inspect captured failures and token usage for the current DoomPi session. Read-only, bounded to the last day or week; omits prompts, tool arguments, credentials, and unrelated sessions.";
10
+ const AGENT_DIAGNOSTIC_TIMEOUT_MS = 15e3;
11
+ const AGENT_ISSUE_CATEGORIES = [
12
+ "tool_failure",
13
+ "infrastructure_failure",
14
+ "caller_error",
15
+ "expected_failure",
16
+ "page_state",
17
+ "api_error",
18
+ "api_refusal",
19
+ "api_retries_exhausted",
20
+ "tool_rejected",
21
+ "log_error"
22
+ ];
23
+ const AGENT_DIAGNOSTIC_SKILL = {
24
+ name: "doompi-debug-agent",
25
+ description: "Debug a DoomPi agent using session-scoped failure and usage evidence. Distinguish missing telemetry from a healthy run, diagnose expensive or failed tools, and investigate deeper traces without exposing secrets or changing the sink."
26
+ };
27
+ //#endregion
28
+ //#region src/schemas/agentDiagnostics.ts
29
+ const count = Type.Number({ minimum: 0 });
30
+ const coverage = Type.Number({
31
+ minimum: 0,
32
+ maximum: 100
33
+ });
34
+ const agentDiagnosticParameters = Type.Object({
35
+ period: Type.Optional(Type.Union([Type.Literal("day"), Type.Literal("week")])),
36
+ toolLimit: Type.Optional(Type.Integer({
37
+ minimum: 1,
38
+ maximum: 20
39
+ }))
40
+ }, { additionalProperties: false });
41
+ /** Validate only the fields we return. Extra upstream fields never cross this boundary. */
42
+ const scopedMetricsSchema = Type.Object({
43
+ groupBy: Type.Literal("session"),
44
+ period: Type.Union([Type.Literal("day"), Type.Literal("week")]),
45
+ filters: Type.Object({ sessionId: Type.String({ minLength: 1 }) }),
46
+ totals: Type.Object({
47
+ totalRecords: count,
48
+ issueCount: count,
49
+ usageEventCount: count,
50
+ inputTokens: count,
51
+ outputTokens: count,
52
+ totalTokens: count,
53
+ cachedInputTokens: count,
54
+ reasoningOutputTokens: count,
55
+ tokenCoveragePercent: coverage
56
+ }),
57
+ groups: Type.Array(Type.Object({
58
+ sessionId: Type.String({ minLength: 1 }),
59
+ byCategory: Type.Record(Type.String(), count)
60
+ }), { maxItems: 1 }),
61
+ tools: Type.Object({
62
+ returnedTools: count,
63
+ rows: Type.Array(Type.Object({
64
+ toolName: Type.String({
65
+ minLength: 1,
66
+ maxLength: 128,
67
+ pattern: "^[A-Za-z0-9_./:-]+$"
68
+ }),
69
+ invocationCount: count,
70
+ toolCallTurn: Type.Object({
71
+ samples: count,
72
+ avgTotalTokens: count,
73
+ p90TotalTokens: count
74
+ })
75
+ }), { maxItems: 20 })
76
+ })
77
+ });
78
+ //#endregion
79
+ //#region src/services/agentDiagnostics/index.ts
80
+ async function readAgentDiagnostics(source, sessionId, input, signal) {
81
+ const period = input.period ?? "day";
82
+ const limit = input.toolLimit ?? 10;
83
+ signal.throwIfAborted();
84
+ let onAbort = () => {};
85
+ try {
86
+ const report = await Promise.race([source.query({
87
+ groupBy: "session",
88
+ period,
89
+ limit: 1,
90
+ toolLimit: limit,
91
+ filter: { sessionId }
92
+ }), new Promise((_resolve, reject) => {
93
+ onAbort = () => reject(signal.reason);
94
+ signal.addEventListener("abort", onAbort, { once: true });
95
+ if (signal.aborted) onAbort();
96
+ })]);
97
+ signal.throwIfAborted();
98
+ if (!Check(scopedMetricsSchema, report) || report.filters.sessionId !== sessionId || report.period !== period || report.groups.some((group) => group.sessionId !== sessionId)) return {
99
+ evidence: "unavailable",
100
+ code: "METRICS_SCOPE_NOT_CONFIRMED",
101
+ scope: "current-session",
102
+ period
103
+ };
104
+ const totals = report.totals;
105
+ return {
106
+ scope: "current-session",
107
+ period,
108
+ evidence: totals.totalRecords === 0 ? "empty" : "available",
109
+ transport: source.lastTransport(),
110
+ capturedRecords: totals.totalRecords,
111
+ capturedIssues: totals.issueCount,
112
+ issuesByCategory: Object.fromEntries(AGENT_ISSUE_CATEGORIES.map((category) => [category, report.groups[0]?.byCategory[category] ?? 0])),
113
+ usage: {
114
+ inputTokens: totals.inputTokens,
115
+ outputTokens: totals.outputTokens,
116
+ totalTokens: totals.totalTokens,
117
+ cachedInputTokens: totals.cachedInputTokens,
118
+ reasoningOutputTokens: totals.reasoningOutputTokens,
119
+ usageEventCount: totals.usageEventCount,
120
+ tokenCoveragePercent: totals.tokenCoveragePercent
121
+ },
122
+ tools: report.tools.rows.slice(0, limit).map((tool) => ({
123
+ name: tool.toolName,
124
+ invocations: tool.invocationCount,
125
+ sampledTurns: tool.toolCallTurn.samples,
126
+ averageTurnTokens: tool.toolCallTurn.avgTotalTokens,
127
+ p90TurnTokens: tool.toolCallTurn.p90TotalTokens
128
+ })),
129
+ toolRowLimit: limit,
130
+ limitReached: report.tools.rows.length >= limit,
131
+ captureCompleteness: "not-reported",
132
+ limitations: "Only captured records in this window are represented. Empty data is not proof of a healthy run. Token coverage is not event-capture coverage; per-tool token samples describe the containing turn, not exclusive tool cost. Raw prompts, error messages, tool arguments and traces are omitted. Use doompi-debug-agent for deeper authorized investigation."
133
+ };
134
+ } catch (error) {
135
+ if (signal.aborted) throw error;
136
+ return {
137
+ evidence: "unavailable",
138
+ code: "METRICS_UNAVAILABLE",
139
+ scope: "current-session",
140
+ period
141
+ };
142
+ } finally {
143
+ signal.removeEventListener("abort", onAbort);
144
+ }
145
+ }
146
+ function createAgentDiagnosticsTool(readScope, authorize) {
147
+ return defineTool({
148
+ name: DIAGNOSE_AGENT_NAME,
149
+ description: DIAGNOSE_AGENT_DESCRIPTION,
150
+ parameters: agentDiagnosticParameters,
151
+ when: DOOM_HELP_WHEN,
152
+ executionMode: "serial",
153
+ async execute(input, execution) {
154
+ const active = authorize(execution.signal);
155
+ const signal = AbortSignal.any([active, AbortSignal.timeout(AGENT_DIAGNOSTIC_TIMEOUT_MS)]);
156
+ const scope = readScope();
157
+ if (!scope.sessionId) throw new Error("Agent diagnostics require an active session.");
158
+ const source = createMetricsSource({
159
+ packageName: PACKAGE_NAME,
160
+ serviceName: "pi",
161
+ ...scope.options
162
+ });
163
+ try {
164
+ const report = await readAgentDiagnostics(source, scope.sessionId, input, signal);
165
+ signal.throwIfAborted();
166
+ authorize(execution.signal);
167
+ return {
168
+ content: [{
169
+ type: "text",
170
+ text: JSON.stringify(report, null, 2)
171
+ }],
172
+ details: report
173
+ };
174
+ } finally {
175
+ await source.close?.();
176
+ }
177
+ }
178
+ });
179
+ }
180
+ //#endregion
181
+ export { AGENT_DIAGNOSTIC_SKILL as n, DIAGNOSE_AGENT_NAME as r, createAgentDiagnosticsTool as t };
182
+
183
+ //# sourceMappingURL=agentDiagnostics-C2KgHmsD.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agentDiagnostics-C2KgHmsD.mjs","names":["HELP_WHEN"],"sources":["../src/constants/diagnostics.ts","../src/schemas/agentDiagnostics.ts","../src/services/agentDiagnostics/index.ts"],"sourcesContent":["export const DIAGNOSE_AGENT_NAME = 'diagnose_agent';\nexport const DIAGNOSE_AGENT_DESCRIPTION =\n 'Inspect captured failures and token usage for the current DoomPi session. Read-only, bounded to the last day or week; omits prompts, tool arguments, credentials, and unrelated sessions.';\nexport const AGENT_DIAGNOSTIC_TOOL_LIMIT = 10;\nexport const AGENT_DIAGNOSTIC_MAX_TOOLS = 20;\nexport const AGENT_DIAGNOSTIC_TIMEOUT_MS = 15_000;\nexport const AGENT_ISSUE_CATEGORIES = [\n 'tool_failure',\n 'infrastructure_failure',\n 'caller_error',\n 'expected_failure',\n 'page_state',\n 'api_error',\n 'api_refusal',\n 'api_retries_exhausted',\n 'tool_rejected',\n 'log_error',\n] as const;\nexport const AGENT_DIAGNOSTIC_SKILL = {\n name: 'doompi-debug-agent',\n description:\n 'Debug a DoomPi agent using session-scoped failure and usage evidence. Distinguish missing telemetry from a healthy run, diagnose expensive or failed tools, and investigate deeper traces without exposing secrets or changing the sink.',\n} as const;\n","import { Type } from 'typebox';\n\nimport { AGENT_DIAGNOSTIC_MAX_TOOLS } from '../constants/diagnostics';\n\nconst count = Type.Number({ minimum: 0 });\nconst coverage = Type.Number({ minimum: 0, maximum: 100 });\nexport const agentDiagnosticParameters = Type.Object(\n {\n period: Type.Optional(Type.Union([Type.Literal('day'), Type.Literal('week')])),\n toolLimit: Type.Optional(Type.Integer({ minimum: 1, maximum: AGENT_DIAGNOSTIC_MAX_TOOLS })),\n },\n { additionalProperties: false },\n);\n\n/** Validate only the fields we return. Extra upstream fields never cross this boundary. */\nexport const scopedMetricsSchema = Type.Object({\n groupBy: Type.Literal('session'),\n period: Type.Union([Type.Literal('day'), Type.Literal('week')]),\n filters: Type.Object({ sessionId: Type.String({ minLength: 1 }) }),\n totals: Type.Object({\n totalRecords: count,\n issueCount: count,\n usageEventCount: count,\n inputTokens: count,\n outputTokens: count,\n totalTokens: count,\n cachedInputTokens: count,\n reasoningOutputTokens: count,\n tokenCoveragePercent: coverage,\n }),\n groups: Type.Array(\n Type.Object({\n sessionId: Type.String({ minLength: 1 }),\n byCategory: Type.Record(Type.String(), count),\n }),\n { maxItems: 1 },\n ),\n tools: Type.Object({\n returnedTools: count,\n rows: Type.Array(\n Type.Object({\n toolName: Type.String({ minLength: 1, maxLength: 128, pattern: '^[A-Za-z0-9_./:-]+$' }),\n invocationCount: count,\n toolCallTurn: Type.Object({ samples: count, avgTotalTokens: count, p90TotalTokens: count }),\n }),\n { maxItems: AGENT_DIAGNOSTIC_MAX_TOOLS },\n ),\n }),\n});\n","import { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/doompi-core/help';\nimport { defineTool } from '@agimon-ai/doompi-core/piExtension';\nimport type { Static } from 'typebox';\nimport { Check } from 'typebox/value';\n\nimport {\n AGENT_DIAGNOSTIC_TIMEOUT_MS,\n AGENT_DIAGNOSTIC_TOOL_LIMIT,\n AGENT_ISSUE_CATEGORIES,\n DIAGNOSE_AGENT_DESCRIPTION,\n DIAGNOSE_AGENT_NAME,\n} from '../../constants/diagnostics';\nimport { PACKAGE_NAME, SERVICE_NAME } from '../../constants/telemetry';\nimport { agentDiagnosticParameters, scopedMetricsSchema } from '../../schemas/agentDiagnostics';\nimport type { MetricsSource } from '../../types/metricsSource';\nimport { createMetricsSource, type MetricsSourceOptions } from '../metricsSource';\n\nexport async function readAgentDiagnostics(\n source: MetricsSource,\n sessionId: string,\n input: Static<typeof agentDiagnosticParameters>,\n signal: AbortSignal,\n) {\n const period = input.period ?? 'day';\n const limit = input.toolLimit ?? AGENT_DIAGNOSTIC_TOOL_LIMIT;\n signal.throwIfAborted();\n let onAbort = () => {};\n try {\n const report: unknown = await Promise.race([\n source.query({ groupBy: 'session', period, limit: 1, toolLimit: limit, filter: { sessionId } }),\n new Promise<never>((_resolve, reject) => {\n onAbort = () => reject(signal.reason);\n signal.addEventListener('abort', onAbort, { once: true });\n if (signal.aborted) onAbort();\n }),\n ]);\n signal.throwIfAborted();\n if (\n !Check(scopedMetricsSchema, report) ||\n report.filters.sessionId !== sessionId ||\n report.period !== period ||\n report.groups.some((group) => group.sessionId !== sessionId)\n ) {\n return { evidence: 'unavailable', code: 'METRICS_SCOPE_NOT_CONFIRMED', scope: 'current-session', period };\n }\n const totals = report.totals;\n return {\n scope: 'current-session',\n period,\n evidence: totals.totalRecords === 0 ? 'empty' : 'available',\n transport: source.lastTransport(),\n capturedRecords: totals.totalRecords,\n capturedIssues: totals.issueCount,\n issuesByCategory: Object.fromEntries(\n AGENT_ISSUE_CATEGORIES.map((category) => [category, report.groups[0]?.byCategory[category] ?? 0]),\n ),\n usage: {\n inputTokens: totals.inputTokens,\n outputTokens: totals.outputTokens,\n totalTokens: totals.totalTokens,\n cachedInputTokens: totals.cachedInputTokens,\n reasoningOutputTokens: totals.reasoningOutputTokens,\n usageEventCount: totals.usageEventCount,\n tokenCoveragePercent: totals.tokenCoveragePercent,\n },\n tools: report.tools.rows.slice(0, limit).map((tool) => ({\n name: tool.toolName,\n invocations: tool.invocationCount,\n sampledTurns: tool.toolCallTurn.samples,\n averageTurnTokens: tool.toolCallTurn.avgTotalTokens,\n p90TurnTokens: tool.toolCallTurn.p90TotalTokens,\n })),\n toolRowLimit: limit,\n limitReached: report.tools.rows.length >= limit,\n captureCompleteness: 'not-reported',\n limitations:\n 'Only captured records in this window are represented. Empty data is not proof of a healthy run. Token coverage is not event-capture coverage; per-tool token samples describe the containing turn, not exclusive tool cost. Raw prompts, error messages, tool arguments and traces are omitted. Use doompi-debug-agent for deeper authorized investigation.',\n };\n } catch (error) {\n if (signal.aborted) throw error;\n return { evidence: 'unavailable', code: 'METRICS_UNAVAILABLE', scope: 'current-session', period };\n } finally {\n signal.removeEventListener('abort', onAbort);\n }\n}\n\nexport function createAgentDiagnosticsTool(\n readScope: () => { sessionId: string; options: MetricsSourceOptions },\n authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n return defineTool({\n name: DIAGNOSE_AGENT_NAME,\n description: DIAGNOSE_AGENT_DESCRIPTION,\n parameters: agentDiagnosticParameters,\n when: HELP_WHEN,\n executionMode: 'serial',\n async execute(input, execution) {\n const active = authorize(execution.signal);\n const signal = AbortSignal.any([active, AbortSignal.timeout(AGENT_DIAGNOSTIC_TIMEOUT_MS)]);\n const scope = readScope();\n if (!scope.sessionId) throw new Error('Agent diagnostics require an active session.');\n const source = createMetricsSource({ packageName: PACKAGE_NAME, serviceName: SERVICE_NAME, ...scope.options });\n try {\n const report = await readAgentDiagnostics(source, scope.sessionId, input, signal);\n signal.throwIfAborted();\n authorize(execution.signal);\n return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n } finally {\n await source.close?.();\n }\n },\n });\n}\n"],"mappings":"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"}
@@ -0,0 +1,200 @@
1
+ const require_telemetryEnabled = require("./telemetryEnabled-BJ2BKyps.cjs");
2
+ const require_metricsSource = require("./metricsSource-DdwQNzoY.cjs");
3
+ let _agimon_ai_doompi_core_piExtension = require("@agimon-ai/doompi-core/piExtension");
4
+ let _agimon_ai_doompi_core_help = require("@agimon-ai/doompi-core/help");
5
+ let typebox_value = require("typebox/value");
6
+ let typebox = require("typebox");
7
+ //#region src/constants/diagnostics.ts
8
+ const DIAGNOSE_AGENT_NAME = "diagnose_agent";
9
+ const DIAGNOSE_AGENT_DESCRIPTION = "Inspect captured failures and token usage for the current DoomPi session. Read-only, bounded to the last day or week; omits prompts, tool arguments, credentials, and unrelated sessions.";
10
+ const AGENT_DIAGNOSTIC_TIMEOUT_MS = 15e3;
11
+ const AGENT_ISSUE_CATEGORIES = [
12
+ "tool_failure",
13
+ "infrastructure_failure",
14
+ "caller_error",
15
+ "expected_failure",
16
+ "page_state",
17
+ "api_error",
18
+ "api_refusal",
19
+ "api_retries_exhausted",
20
+ "tool_rejected",
21
+ "log_error"
22
+ ];
23
+ const AGENT_DIAGNOSTIC_SKILL = {
24
+ name: "doompi-debug-agent",
25
+ description: "Debug a DoomPi agent using session-scoped failure and usage evidence. Distinguish missing telemetry from a healthy run, diagnose expensive or failed tools, and investigate deeper traces without exposing secrets or changing the sink."
26
+ };
27
+ //#endregion
28
+ //#region src/schemas/agentDiagnostics.ts
29
+ const count = typebox.Type.Number({ minimum: 0 });
30
+ const coverage = typebox.Type.Number({
31
+ minimum: 0,
32
+ maximum: 100
33
+ });
34
+ const agentDiagnosticParameters = typebox.Type.Object({
35
+ period: typebox.Type.Optional(typebox.Type.Union([typebox.Type.Literal("day"), typebox.Type.Literal("week")])),
36
+ toolLimit: typebox.Type.Optional(typebox.Type.Integer({
37
+ minimum: 1,
38
+ maximum: 20
39
+ }))
40
+ }, { additionalProperties: false });
41
+ /** Validate only the fields we return. Extra upstream fields never cross this boundary. */
42
+ const scopedMetricsSchema = typebox.Type.Object({
43
+ groupBy: typebox.Type.Literal("session"),
44
+ period: typebox.Type.Union([typebox.Type.Literal("day"), typebox.Type.Literal("week")]),
45
+ filters: typebox.Type.Object({ sessionId: typebox.Type.String({ minLength: 1 }) }),
46
+ totals: typebox.Type.Object({
47
+ totalRecords: count,
48
+ issueCount: count,
49
+ usageEventCount: count,
50
+ inputTokens: count,
51
+ outputTokens: count,
52
+ totalTokens: count,
53
+ cachedInputTokens: count,
54
+ reasoningOutputTokens: count,
55
+ tokenCoveragePercent: coverage
56
+ }),
57
+ groups: typebox.Type.Array(typebox.Type.Object({
58
+ sessionId: typebox.Type.String({ minLength: 1 }),
59
+ byCategory: typebox.Type.Record(typebox.Type.String(), count)
60
+ }), { maxItems: 1 }),
61
+ tools: typebox.Type.Object({
62
+ returnedTools: count,
63
+ rows: typebox.Type.Array(typebox.Type.Object({
64
+ toolName: typebox.Type.String({
65
+ minLength: 1,
66
+ maxLength: 128,
67
+ pattern: "^[A-Za-z0-9_./:-]+$"
68
+ }),
69
+ invocationCount: count,
70
+ toolCallTurn: typebox.Type.Object({
71
+ samples: count,
72
+ avgTotalTokens: count,
73
+ p90TotalTokens: count
74
+ })
75
+ }), { maxItems: 20 })
76
+ })
77
+ });
78
+ //#endregion
79
+ //#region src/services/agentDiagnostics/index.ts
80
+ async function readAgentDiagnostics(source, sessionId, input, signal) {
81
+ const period = input.period ?? "day";
82
+ const limit = input.toolLimit ?? 10;
83
+ signal.throwIfAborted();
84
+ let onAbort = () => {};
85
+ try {
86
+ const report = await Promise.race([source.query({
87
+ groupBy: "session",
88
+ period,
89
+ limit: 1,
90
+ toolLimit: limit,
91
+ filter: { sessionId }
92
+ }), new Promise((_resolve, reject) => {
93
+ onAbort = () => reject(signal.reason);
94
+ signal.addEventListener("abort", onAbort, { once: true });
95
+ if (signal.aborted) onAbort();
96
+ })]);
97
+ signal.throwIfAborted();
98
+ if (!(0, typebox_value.Check)(scopedMetricsSchema, report) || report.filters.sessionId !== sessionId || report.period !== period || report.groups.some((group) => group.sessionId !== sessionId)) return {
99
+ evidence: "unavailable",
100
+ code: "METRICS_SCOPE_NOT_CONFIRMED",
101
+ scope: "current-session",
102
+ period
103
+ };
104
+ const totals = report.totals;
105
+ return {
106
+ scope: "current-session",
107
+ period,
108
+ evidence: totals.totalRecords === 0 ? "empty" : "available",
109
+ transport: source.lastTransport(),
110
+ capturedRecords: totals.totalRecords,
111
+ capturedIssues: totals.issueCount,
112
+ issuesByCategory: Object.fromEntries(AGENT_ISSUE_CATEGORIES.map((category) => [category, report.groups[0]?.byCategory[category] ?? 0])),
113
+ usage: {
114
+ inputTokens: totals.inputTokens,
115
+ outputTokens: totals.outputTokens,
116
+ totalTokens: totals.totalTokens,
117
+ cachedInputTokens: totals.cachedInputTokens,
118
+ reasoningOutputTokens: totals.reasoningOutputTokens,
119
+ usageEventCount: totals.usageEventCount,
120
+ tokenCoveragePercent: totals.tokenCoveragePercent
121
+ },
122
+ tools: report.tools.rows.slice(0, limit).map((tool) => ({
123
+ name: tool.toolName,
124
+ invocations: tool.invocationCount,
125
+ sampledTurns: tool.toolCallTurn.samples,
126
+ averageTurnTokens: tool.toolCallTurn.avgTotalTokens,
127
+ p90TurnTokens: tool.toolCallTurn.p90TotalTokens
128
+ })),
129
+ toolRowLimit: limit,
130
+ limitReached: report.tools.rows.length >= limit,
131
+ captureCompleteness: "not-reported",
132
+ limitations: "Only captured records in this window are represented. Empty data is not proof of a healthy run. Token coverage is not event-capture coverage; per-tool token samples describe the containing turn, not exclusive tool cost. Raw prompts, error messages, tool arguments and traces are omitted. Use doompi-debug-agent for deeper authorized investigation."
133
+ };
134
+ } catch (error) {
135
+ if (signal.aborted) throw error;
136
+ return {
137
+ evidence: "unavailable",
138
+ code: "METRICS_UNAVAILABLE",
139
+ scope: "current-session",
140
+ period
141
+ };
142
+ } finally {
143
+ signal.removeEventListener("abort", onAbort);
144
+ }
145
+ }
146
+ function createAgentDiagnosticsTool(readScope, authorize) {
147
+ return (0, _agimon_ai_doompi_core_piExtension.defineTool)({
148
+ name: DIAGNOSE_AGENT_NAME,
149
+ description: DIAGNOSE_AGENT_DESCRIPTION,
150
+ parameters: agentDiagnosticParameters,
151
+ when: _agimon_ai_doompi_core_help.DOOM_HELP_WHEN,
152
+ executionMode: "serial",
153
+ async execute(input, execution) {
154
+ const active = authorize(execution.signal);
155
+ const signal = AbortSignal.any([active, AbortSignal.timeout(AGENT_DIAGNOSTIC_TIMEOUT_MS)]);
156
+ const scope = readScope();
157
+ if (!scope.sessionId) throw new Error("Agent diagnostics require an active session.");
158
+ const source = require_metricsSource.createMetricsSource({
159
+ packageName: require_telemetryEnabled.PACKAGE_NAME,
160
+ serviceName: "pi",
161
+ ...scope.options
162
+ });
163
+ try {
164
+ const report = await readAgentDiagnostics(source, scope.sessionId, input, signal);
165
+ signal.throwIfAborted();
166
+ authorize(execution.signal);
167
+ return {
168
+ content: [{
169
+ type: "text",
170
+ text: JSON.stringify(report, null, 2)
171
+ }],
172
+ details: report
173
+ };
174
+ } finally {
175
+ await source.close?.();
176
+ }
177
+ }
178
+ });
179
+ }
180
+ //#endregion
181
+ Object.defineProperty(exports, "AGENT_DIAGNOSTIC_SKILL", {
182
+ enumerable: true,
183
+ get: function() {
184
+ return AGENT_DIAGNOSTIC_SKILL;
185
+ }
186
+ });
187
+ Object.defineProperty(exports, "DIAGNOSE_AGENT_NAME", {
188
+ enumerable: true,
189
+ get: function() {
190
+ return DIAGNOSE_AGENT_NAME;
191
+ }
192
+ });
193
+ Object.defineProperty(exports, "createAgentDiagnosticsTool", {
194
+ enumerable: true,
195
+ get: function() {
196
+ return createAgentDiagnosticsTool;
197
+ }
198
+ });
199
+
200
+ //# sourceMappingURL=agentDiagnostics-XrO2jPyN.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agentDiagnostics-XrO2jPyN.cjs","names":["Type","Check","defineTool","HELP_WHEN","createMetricsSource","PACKAGE_NAME"],"sources":["../src/constants/diagnostics.ts","../src/schemas/agentDiagnostics.ts","../src/services/agentDiagnostics/index.ts"],"sourcesContent":["export const DIAGNOSE_AGENT_NAME = 'diagnose_agent';\nexport const DIAGNOSE_AGENT_DESCRIPTION =\n 'Inspect captured failures and token usage for the current DoomPi session. Read-only, bounded to the last day or week; omits prompts, tool arguments, credentials, and unrelated sessions.';\nexport const AGENT_DIAGNOSTIC_TOOL_LIMIT = 10;\nexport const AGENT_DIAGNOSTIC_MAX_TOOLS = 20;\nexport const AGENT_DIAGNOSTIC_TIMEOUT_MS = 15_000;\nexport const AGENT_ISSUE_CATEGORIES = [\n 'tool_failure',\n 'infrastructure_failure',\n 'caller_error',\n 'expected_failure',\n 'page_state',\n 'api_error',\n 'api_refusal',\n 'api_retries_exhausted',\n 'tool_rejected',\n 'log_error',\n] as const;\nexport const AGENT_DIAGNOSTIC_SKILL = {\n name: 'doompi-debug-agent',\n description:\n 'Debug a DoomPi agent using session-scoped failure and usage evidence. Distinguish missing telemetry from a healthy run, diagnose expensive or failed tools, and investigate deeper traces without exposing secrets or changing the sink.',\n} as const;\n","import { Type } from 'typebox';\n\nimport { AGENT_DIAGNOSTIC_MAX_TOOLS } from '../constants/diagnostics';\n\nconst count = Type.Number({ minimum: 0 });\nconst coverage = Type.Number({ minimum: 0, maximum: 100 });\nexport const agentDiagnosticParameters = Type.Object(\n {\n period: Type.Optional(Type.Union([Type.Literal('day'), Type.Literal('week')])),\n toolLimit: Type.Optional(Type.Integer({ minimum: 1, maximum: AGENT_DIAGNOSTIC_MAX_TOOLS })),\n },\n { additionalProperties: false },\n);\n\n/** Validate only the fields we return. Extra upstream fields never cross this boundary. */\nexport const scopedMetricsSchema = Type.Object({\n groupBy: Type.Literal('session'),\n period: Type.Union([Type.Literal('day'), Type.Literal('week')]),\n filters: Type.Object({ sessionId: Type.String({ minLength: 1 }) }),\n totals: Type.Object({\n totalRecords: count,\n issueCount: count,\n usageEventCount: count,\n inputTokens: count,\n outputTokens: count,\n totalTokens: count,\n cachedInputTokens: count,\n reasoningOutputTokens: count,\n tokenCoveragePercent: coverage,\n }),\n groups: Type.Array(\n Type.Object({\n sessionId: Type.String({ minLength: 1 }),\n byCategory: Type.Record(Type.String(), count),\n }),\n { maxItems: 1 },\n ),\n tools: Type.Object({\n returnedTools: count,\n rows: Type.Array(\n Type.Object({\n toolName: Type.String({ minLength: 1, maxLength: 128, pattern: '^[A-Za-z0-9_./:-]+$' }),\n invocationCount: count,\n toolCallTurn: Type.Object({ samples: count, avgTotalTokens: count, p90TotalTokens: count }),\n }),\n { maxItems: AGENT_DIAGNOSTIC_MAX_TOOLS },\n ),\n }),\n});\n","import { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/doompi-core/help';\nimport { defineTool } from '@agimon-ai/doompi-core/piExtension';\nimport type { Static } from 'typebox';\nimport { Check } from 'typebox/value';\n\nimport {\n AGENT_DIAGNOSTIC_TIMEOUT_MS,\n AGENT_DIAGNOSTIC_TOOL_LIMIT,\n AGENT_ISSUE_CATEGORIES,\n DIAGNOSE_AGENT_DESCRIPTION,\n DIAGNOSE_AGENT_NAME,\n} from '../../constants/diagnostics';\nimport { PACKAGE_NAME, SERVICE_NAME } from '../../constants/telemetry';\nimport { agentDiagnosticParameters, scopedMetricsSchema } from '../../schemas/agentDiagnostics';\nimport type { MetricsSource } from '../../types/metricsSource';\nimport { createMetricsSource, type MetricsSourceOptions } from '../metricsSource';\n\nexport async function readAgentDiagnostics(\n source: MetricsSource,\n sessionId: string,\n input: Static<typeof agentDiagnosticParameters>,\n signal: AbortSignal,\n) {\n const period = input.period ?? 'day';\n const limit = input.toolLimit ?? AGENT_DIAGNOSTIC_TOOL_LIMIT;\n signal.throwIfAborted();\n let onAbort = () => {};\n try {\n const report: unknown = await Promise.race([\n source.query({ groupBy: 'session', period, limit: 1, toolLimit: limit, filter: { sessionId } }),\n new Promise<never>((_resolve, reject) => {\n onAbort = () => reject(signal.reason);\n signal.addEventListener('abort', onAbort, { once: true });\n if (signal.aborted) onAbort();\n }),\n ]);\n signal.throwIfAborted();\n if (\n !Check(scopedMetricsSchema, report) ||\n report.filters.sessionId !== sessionId ||\n report.period !== period ||\n report.groups.some((group) => group.sessionId !== sessionId)\n ) {\n return { evidence: 'unavailable', code: 'METRICS_SCOPE_NOT_CONFIRMED', scope: 'current-session', period };\n }\n const totals = report.totals;\n return {\n scope: 'current-session',\n period,\n evidence: totals.totalRecords === 0 ? 'empty' : 'available',\n transport: source.lastTransport(),\n capturedRecords: totals.totalRecords,\n capturedIssues: totals.issueCount,\n issuesByCategory: Object.fromEntries(\n AGENT_ISSUE_CATEGORIES.map((category) => [category, report.groups[0]?.byCategory[category] ?? 0]),\n ),\n usage: {\n inputTokens: totals.inputTokens,\n outputTokens: totals.outputTokens,\n totalTokens: totals.totalTokens,\n cachedInputTokens: totals.cachedInputTokens,\n reasoningOutputTokens: totals.reasoningOutputTokens,\n usageEventCount: totals.usageEventCount,\n tokenCoveragePercent: totals.tokenCoveragePercent,\n },\n tools: report.tools.rows.slice(0, limit).map((tool) => ({\n name: tool.toolName,\n invocations: tool.invocationCount,\n sampledTurns: tool.toolCallTurn.samples,\n averageTurnTokens: tool.toolCallTurn.avgTotalTokens,\n p90TurnTokens: tool.toolCallTurn.p90TotalTokens,\n })),\n toolRowLimit: limit,\n limitReached: report.tools.rows.length >= limit,\n captureCompleteness: 'not-reported',\n limitations:\n 'Only captured records in this window are represented. Empty data is not proof of a healthy run. Token coverage is not event-capture coverage; per-tool token samples describe the containing turn, not exclusive tool cost. Raw prompts, error messages, tool arguments and traces are omitted. Use doompi-debug-agent for deeper authorized investigation.',\n };\n } catch (error) {\n if (signal.aborted) throw error;\n return { evidence: 'unavailable', code: 'METRICS_UNAVAILABLE', scope: 'current-session', period };\n } finally {\n signal.removeEventListener('abort', onAbort);\n }\n}\n\nexport function createAgentDiagnosticsTool(\n readScope: () => { sessionId: string; options: MetricsSourceOptions },\n authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n return defineTool({\n name: DIAGNOSE_AGENT_NAME,\n description: DIAGNOSE_AGENT_DESCRIPTION,\n parameters: agentDiagnosticParameters,\n when: HELP_WHEN,\n executionMode: 'serial',\n async execute(input, execution) {\n const active = authorize(execution.signal);\n const signal = AbortSignal.any([active, AbortSignal.timeout(AGENT_DIAGNOSTIC_TIMEOUT_MS)]);\n const scope = readScope();\n if (!scope.sessionId) throw new Error('Agent diagnostics require an active session.');\n const source = createMetricsSource({ packageName: PACKAGE_NAME, serviceName: SERVICE_NAME, ...scope.options });\n try {\n const report = await readAgentDiagnostics(source, scope.sessionId, input, signal);\n signal.throwIfAborted();\n authorize(execution.signal);\n return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n } finally {\n await source.close?.();\n }\n },\n });\n}\n"],"mappings":"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"}