@agimon-ai/doompi-log 0.0.1-alpha.82 → 0.0.1-alpha.84

package/dist/agentDiagnostics-C2KgHmsD.mjs

@@ -0,0 +1,183 @@
+import { l as PACKAGE_NAME } from "./telemetryEnabled-B6g7R7BP.mjs";
+import { t as createMetricsSource } from "./metricsSource-DXZLawQu.mjs";
+import { defineTool } from "@agimon-ai/doompi-core/piExtension";
+import { DOOM_HELP_WHEN } from "@agimon-ai/doompi-core/help";
+import { Check } from "typebox/value";
+import { Type } from "typebox";
+//#region src/constants/diagnostics.ts
+const DIAGNOSE_AGENT_NAME = "diagnose_agent";
+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.";
+const AGENT_DIAGNOSTIC_TIMEOUT_MS = 15e3;
+const AGENT_ISSUE_CATEGORIES = [
+	"tool_failure",
+	"infrastructure_failure",
+	"caller_error",
+	"expected_failure",
+	"page_state",
+	"api_error",
+	"api_refusal",
+	"api_retries_exhausted",
+	"tool_rejected",
+	"log_error"
+];
+const AGENT_DIAGNOSTIC_SKILL = {
+	name: "doompi-debug-agent",
+	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."
+};
+//#endregion
+//#region src/schemas/agentDiagnostics.ts
+const count = Type.Number({ minimum: 0 });
+const coverage = Type.Number({
+	minimum: 0,
+	maximum: 100
+});
+const agentDiagnosticParameters = Type.Object({
+	period: Type.Optional(Type.Union([Type.Literal("day"), Type.Literal("week")])),
+	toolLimit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 20
+	}))
+}, { additionalProperties: false });
+/** Validate only the fields we return. Extra upstream fields never cross this boundary. */
+const scopedMetricsSchema = Type.Object({
+	groupBy: Type.Literal("session"),
+	period: Type.Union([Type.Literal("day"), Type.Literal("week")]),
+	filters: Type.Object({ sessionId: Type.String({ minLength: 1 }) }),
+	totals: Type.Object({
+		totalRecords: count,
+		issueCount: count,
+		usageEventCount: count,
+		inputTokens: count,
+		outputTokens: count,
+		totalTokens: count,
+		cachedInputTokens: count,
+		reasoningOutputTokens: count,
+		tokenCoveragePercent: coverage
+	}),
+	groups: Type.Array(Type.Object({
+		sessionId: Type.String({ minLength: 1 }),
+		byCategory: Type.Record(Type.String(), count)
+	}), { maxItems: 1 }),
+	tools: Type.Object({
+		returnedTools: count,
+		rows: Type.Array(Type.Object({
+			toolName: Type.String({
+				minLength: 1,
+				maxLength: 128,
+				pattern: "^[A-Za-z0-9_./:-]+$"
+			}),
+			invocationCount: count,
+			toolCallTurn: Type.Object({
+				samples: count,
+				avgTotalTokens: count,
+				p90TotalTokens: count
+			})
+		}), { maxItems: 20 })
+	})
+});
+//#endregion
+//#region src/services/agentDiagnostics/index.ts
+async function readAgentDiagnostics(source, sessionId, input, signal) {
+	const period = input.period ?? "day";
+	const limit = input.toolLimit ?? 10;
+	signal.throwIfAborted();
+	let onAbort = () => {};
+	try {
+		const report = await Promise.race([source.query({
+			groupBy: "session",
+			period,
+			limit: 1,
+			toolLimit: limit,
+			filter: { sessionId }
+		}), new Promise((_resolve, reject) => {
+			onAbort = () => reject(signal.reason);
+			signal.addEventListener("abort", onAbort, { once: true });
+			if (signal.aborted) onAbort();
+		})]);
+		signal.throwIfAborted();
+		if (!Check(scopedMetricsSchema, report) || report.filters.sessionId !== sessionId || report.period !== period || report.groups.some((group) => group.sessionId !== sessionId)) return {
+			evidence: "unavailable",
+			code: "METRICS_SCOPE_NOT_CONFIRMED",
+			scope: "current-session",
+			period
+		};
+		const totals = report.totals;
+		return {
+			scope: "current-session",
+			period,
+			evidence: totals.totalRecords === 0 ? "empty" : "available",
+			transport: source.lastTransport(),
+			capturedRecords: totals.totalRecords,
+			capturedIssues: totals.issueCount,
+			issuesByCategory: Object.fromEntries(AGENT_ISSUE_CATEGORIES.map((category) => [category, report.groups[0]?.byCategory[category] ?? 0])),
+			usage: {
+				inputTokens: totals.inputTokens,
+				outputTokens: totals.outputTokens,
+				totalTokens: totals.totalTokens,
+				cachedInputTokens: totals.cachedInputTokens,
+				reasoningOutputTokens: totals.reasoningOutputTokens,
+				usageEventCount: totals.usageEventCount,
+				tokenCoveragePercent: totals.tokenCoveragePercent
+			},
+			tools: report.tools.rows.slice(0, limit).map((tool) => ({
+				name: tool.toolName,
+				invocations: tool.invocationCount,
+				sampledTurns: tool.toolCallTurn.samples,
+				averageTurnTokens: tool.toolCallTurn.avgTotalTokens,
+				p90TurnTokens: tool.toolCallTurn.p90TotalTokens
+			})),
+			toolRowLimit: limit,
+			limitReached: report.tools.rows.length >= limit,
+			captureCompleteness: "not-reported",
+			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."
+		};
+	} catch (error) {
+		if (signal.aborted) throw error;
+		return {
+			evidence: "unavailable",
+			code: "METRICS_UNAVAILABLE",
+			scope: "current-session",
+			period
+		};
+	} finally {
+		signal.removeEventListener("abort", onAbort);
+	}
+}
+function createAgentDiagnosticsTool(readScope, authorize) {
+	return defineTool({
+		name: DIAGNOSE_AGENT_NAME,
+		description: DIAGNOSE_AGENT_DESCRIPTION,
+		parameters: agentDiagnosticParameters,
+		when: DOOM_HELP_WHEN,
+		executionMode: "serial",
+		async execute(input, execution) {
+			const active = authorize(execution.signal);
+			const signal = AbortSignal.any([active, AbortSignal.timeout(AGENT_DIAGNOSTIC_TIMEOUT_MS)]);
+			const scope = readScope();
+			if (!scope.sessionId) throw new Error("Agent diagnostics require an active session.");
+			const source = createMetricsSource({
+				packageName: PACKAGE_NAME,
+				serviceName: "pi",
+				...scope.options
+			});
+			try {
+				const report = await readAgentDiagnostics(source, scope.sessionId, input, signal);
+				signal.throwIfAborted();
+				authorize(execution.signal);
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(report, null, 2)
+					}],
+					details: report
+				};
+			} finally {
+				await source.close?.();
+			}
+		}
+	});
+}
+//#endregion
+export { AGENT_DIAGNOSTIC_SKILL as n, DIAGNOSE_AGENT_NAME as r, createAgentDiagnosticsTool as t };
+
+//# sourceMappingURL=agentDiagnostics-C2KgHmsD.mjs.map

package/dist/agentDiagnostics-C2KgHmsD.mjs.map

@@ -0,0 +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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"}

package/dist/agentDiagnostics-XrO2jPyN.cjs

@@ -0,0 +1,200 @@
+const require_telemetryEnabled = require("./telemetryEnabled-BJ2BKyps.cjs");
+const require_metricsSource = require("./metricsSource-DdwQNzoY.cjs");
+let _agimon_ai_doompi_core_piExtension = require("@agimon-ai/doompi-core/piExtension");
+let _agimon_ai_doompi_core_help = require("@agimon-ai/doompi-core/help");
+let typebox_value = require("typebox/value");
+let typebox = require("typebox");
+//#region src/constants/diagnostics.ts
+const DIAGNOSE_AGENT_NAME = "diagnose_agent";
+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.";
+const AGENT_DIAGNOSTIC_TIMEOUT_MS = 15e3;
+const AGENT_ISSUE_CATEGORIES = [
+	"tool_failure",
+	"infrastructure_failure",
+	"caller_error",
+	"expected_failure",
+	"page_state",
+	"api_error",
+	"api_refusal",
+	"api_retries_exhausted",
+	"tool_rejected",
+	"log_error"
+];
+const AGENT_DIAGNOSTIC_SKILL = {
+	name: "doompi-debug-agent",
+	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."
+};
+//#endregion
+//#region src/schemas/agentDiagnostics.ts
+const count = typebox.Type.Number({ minimum: 0 });
+const coverage = typebox.Type.Number({
+	minimum: 0,
+	maximum: 100
+});
+const agentDiagnosticParameters = typebox.Type.Object({
+	period: typebox.Type.Optional(typebox.Type.Union([typebox.Type.Literal("day"), typebox.Type.Literal("week")])),
+	toolLimit: typebox.Type.Optional(typebox.Type.Integer({
+		minimum: 1,
+		maximum: 20
+	}))
+}, { additionalProperties: false });
+/** Validate only the fields we return. Extra upstream fields never cross this boundary. */
+const scopedMetricsSchema = typebox.Type.Object({
+	groupBy: typebox.Type.Literal("session"),
+	period: typebox.Type.Union([typebox.Type.Literal("day"), typebox.Type.Literal("week")]),
+	filters: typebox.Type.Object({ sessionId: typebox.Type.String({ minLength: 1 }) }),
+	totals: typebox.Type.Object({
+		totalRecords: count,
+		issueCount: count,
+		usageEventCount: count,
+		inputTokens: count,
+		outputTokens: count,
+		totalTokens: count,
+		cachedInputTokens: count,
+		reasoningOutputTokens: count,
+		tokenCoveragePercent: coverage
+	}),
+	groups: typebox.Type.Array(typebox.Type.Object({
+		sessionId: typebox.Type.String({ minLength: 1 }),
+		byCategory: typebox.Type.Record(typebox.Type.String(), count)
+	}), { maxItems: 1 }),
+	tools: typebox.Type.Object({
+		returnedTools: count,
+		rows: typebox.Type.Array(typebox.Type.Object({
+			toolName: typebox.Type.String({
+				minLength: 1,
+				maxLength: 128,
+				pattern: "^[A-Za-z0-9_./:-]+$"
+			}),
+			invocationCount: count,
+			toolCallTurn: typebox.Type.Object({
+				samples: count,
+				avgTotalTokens: count,
+				p90TotalTokens: count
+			})
+		}), { maxItems: 20 })
+	})
+});
+//#endregion
+//#region src/services/agentDiagnostics/index.ts
+async function readAgentDiagnostics(source, sessionId, input, signal) {
+	const period = input.period ?? "day";
+	const limit = input.toolLimit ?? 10;
+	signal.throwIfAborted();
+	let onAbort = () => {};
+	try {
+		const report = await Promise.race([source.query({
+			groupBy: "session",
+			period,
+			limit: 1,
+			toolLimit: limit,
+			filter: { sessionId }
+		}), new Promise((_resolve, reject) => {
+			onAbort = () => reject(signal.reason);
+			signal.addEventListener("abort", onAbort, { once: true });
+			if (signal.aborted) onAbort();
+		})]);
+		signal.throwIfAborted();
+		if (!(0, typebox_value.Check)(scopedMetricsSchema, report) || report.filters.sessionId !== sessionId || report.period !== period || report.groups.some((group) => group.sessionId !== sessionId)) return {
+			evidence: "unavailable",
+			code: "METRICS_SCOPE_NOT_CONFIRMED",
+			scope: "current-session",
+			period
+		};
+		const totals = report.totals;
+		return {
+			scope: "current-session",
+			period,
+			evidence: totals.totalRecords === 0 ? "empty" : "available",
+			transport: source.lastTransport(),
+			capturedRecords: totals.totalRecords,
+			capturedIssues: totals.issueCount,
+			issuesByCategory: Object.fromEntries(AGENT_ISSUE_CATEGORIES.map((category) => [category, report.groups[0]?.byCategory[category] ?? 0])),
+			usage: {
+				inputTokens: totals.inputTokens,
+				outputTokens: totals.outputTokens,
+				totalTokens: totals.totalTokens,
+				cachedInputTokens: totals.cachedInputTokens,
+				reasoningOutputTokens: totals.reasoningOutputTokens,
+				usageEventCount: totals.usageEventCount,
+				tokenCoveragePercent: totals.tokenCoveragePercent
+			},
+			tools: report.tools.rows.slice(0, limit).map((tool) => ({
+				name: tool.toolName,
+				invocations: tool.invocationCount,
+				sampledTurns: tool.toolCallTurn.samples,
+				averageTurnTokens: tool.toolCallTurn.avgTotalTokens,
+				p90TurnTokens: tool.toolCallTurn.p90TotalTokens
+			})),
+			toolRowLimit: limit,
+			limitReached: report.tools.rows.length >= limit,
+			captureCompleteness: "not-reported",
+			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."
+		};
+	} catch (error) {
+		if (signal.aborted) throw error;
+		return {
+			evidence: "unavailable",
+			code: "METRICS_UNAVAILABLE",
+			scope: "current-session",
+			period
+		};
+	} finally {
+		signal.removeEventListener("abort", onAbort);
+	}
+}
+function createAgentDiagnosticsTool(readScope, authorize) {
+	return (0, _agimon_ai_doompi_core_piExtension.defineTool)({
+		name: DIAGNOSE_AGENT_NAME,
+		description: DIAGNOSE_AGENT_DESCRIPTION,
+		parameters: agentDiagnosticParameters,
+		when: _agimon_ai_doompi_core_help.DOOM_HELP_WHEN,
+		executionMode: "serial",
+		async execute(input, execution) {
+			const active = authorize(execution.signal);
+			const signal = AbortSignal.any([active, AbortSignal.timeout(AGENT_DIAGNOSTIC_TIMEOUT_MS)]);
+			const scope = readScope();
+			if (!scope.sessionId) throw new Error("Agent diagnostics require an active session.");
+			const source = require_metricsSource.createMetricsSource({
+				packageName: require_telemetryEnabled.PACKAGE_NAME,
+				serviceName: "pi",
+				...scope.options
+			});
+			try {
+				const report = await readAgentDiagnostics(source, scope.sessionId, input, signal);
+				signal.throwIfAborted();
+				authorize(execution.signal);
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(report, null, 2)
+					}],
+					details: report
+				};
+			} finally {
+				await source.close?.();
+			}
+		}
+	});
+}
+//#endregion
+Object.defineProperty(exports, "AGENT_DIAGNOSTIC_SKILL", {
+	enumerable: true,
+	get: function() {
+		return AGENT_DIAGNOSTIC_SKILL;
+	}
+});
+Object.defineProperty(exports, "DIAGNOSE_AGENT_NAME", {
+	enumerable: true,
+	get: function() {
+		return DIAGNOSE_AGENT_NAME;
+	}
+});
+Object.defineProperty(exports, "createAgentDiagnosticsTool", {
+	enumerable: true,
+	get: function() {
+		return createAgentDiagnosticsTool;
+	}
+});
+
+//# sourceMappingURL=agentDiagnostics-XrO2jPyN.cjs.map

package/dist/agentDiagnostics-XrO2jPyN.cjs.map

@@ -0,0 +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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"}

package/dist/extensions/pi.cjs

@@ -4,8 +4,11 @@ Object.defineProperties(exports, {
 });
 const require_telemetryEnabled = require("../telemetryEnabled-BJ2BKyps.cjs");
 const require_logRuntime = require("../logRuntime-DcD32EjA.cjs");
+const require_agentDiagnostics = require("../agentDiagnostics-XrO2jPyN.cjs");
 let _agimon_ai_doompi_core_piExtension = require("@agimon-ai/doompi-core/piExtension");
 let _agimon_ai_doompi_core_extensionFile = require("@agimon-ai/doompi-core/extensionFile");
+let _agimon_ai_doompi_core_cordisHost = require("@agimon-ai/doompi-core/cordisHost");
+let _agimon_ai_doompi_core_help = require("@agimon-ai/doompi-core/help");
 let _agimon_ai_doompi_core_readiness = require("@agimon-ai/doompi-core/readiness");
 let _agimon_ai_doompi_telemetry = require("@agimon-ai/doompi-telemetry");
 //#region src/services/piTelemetry/index.ts
@@ -341,13 +344,40 @@ const createLogPiRoot = ({ context, options }) => {
 	const view = require_logRuntime.createLogViewRuntime((ctx) => telemetry.waitForSession(ctx), options);
 	telemetry = createPiTelemetryRuntime(context, view.telemetryOptions, true);
 	let shutdown;
+	const gate = (0, _agimon_ai_doompi_core_help.createPiHelpToolGate)(require_telemetryEnabled.PACKAGE_NAME, [require_agentDiagnostics.DIAGNOSE_AGENT_NAME]);
+	let session;
+	const bindSession = (cordis) => {
+		cordis.inject([_agimon_ai_doompi_core_cordisHost.DOOM_CORDIS_SESSION_SERVICE], (child) => {
+			const current = (0, _agimon_ai_doompi_core_cordisHost.requireDoomCordisSession)(child);
+			session = current;
+			return () => {
+				if (session === current) session = void 0;
+			};
+		});
+	};
 	return {
 		value: {
 			telemetry,
 			view,
+			diagnosticTool: require_agentDiagnostics.createAgentDiagnosticsTool(() => {
+				if (!session) throw new Error("Agent diagnostics require the current session.");
+				return {
+					sessionId: session.sessionId,
+					options: {
+						cwd: session.context.cwd,
+						env: { ...options?.env ?? process.env },
+						serviceName: options?.serviceName ?? "pi"
+					}
+				};
+			}, (signal) => gate.assertActive(require_agentDiagnostics.DIAGNOSE_AGENT_NAME, signal)),
 			sessionShutdown: (event, ctx) => shutdown ??= telemetry.finishSession(event.reason, ctx)
 		},
-		services: view.services,
+		services: [
+			...gate.services,
+			bindSession,
+			...view.services
+		],
+		onStart: gate.onStart,
 		async onDispose() {
 			await view.onDispose();
 			await telemetry.onDispose();
@@ -397,12 +427,26 @@ var turn_end_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHoo
 //#region src/extensions/workspaces/sessions/(backend)/hook/turn-start.cli.ts
 var turn_start_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)((context) => context.root.telemetry.events.turn_start);
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/doompi-debug-agent.cli.ts
+var doompi_debug_agent_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineResource)({
+	source: require_telemetryEnabled.PACKAGE_NAME,
+	moduleUrl: require("url").pathToFileURL(__filename).href,
+	skills: [require_agentDiagnostics.AGENT_DIAGNOSTIC_SKILL]
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/tool/diagnose_agent.cli.ts
+var diagnose_agent_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineTool)((context) => context.root.diagnosticTool);
+//#endregion
 //#region generated/pi.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;
 const many = (value, context) => {
 	const resolved = typeof value === "function" ? value(context) : value;
 	return Array.isArray(resolved) ? resolved : [resolved];
 };
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
 const extension = (0, _agimon_ai_doompi_core_piExtension.definePiExtension)("@agimon-ai/doompi-log", async (context) => {
 	const scopeSession = await root_cli_default(context);
 	const contextSession = {
@@ -428,6 +472,10 @@ const extension = (0, _agimon_ai_doompi_core_piExtension.definePiExtension)("@ag
 			turn_end: at(turn_end_cli_default, contextSession),
 			turn_start: at(turn_start_cli_default, contextSession)
 		},
+		get resources() {
+			return [at(doompi_debug_agent_cli_default, contextSession)];
+		},
+		...(0, _agimon_ai_doompi_core_piExtension.piToolContributions)("@agimon-ai/doompi-log", [via({ name: "diagnose_agent" }, at(diagnose_agent_cli_default, contextSession))]),
 		services: [...scopeSession.services ?? []]
 	};
 });