@agimon-ai/po-log 0.0.0-alpha.0

package/dist/metrics.d.mts

@@ -0,0 +1,2 @@
+import { S as TURN_FINISHED_RECORD, _ as MAX_RETAINED_TOKEN_BUCKETS, a as LogMetricsAggregator, b as TOOL_TOKEN_SAMPLE_RECORD, c as LogMetricsEventCount, d as LogMetricsSnapshot, f as LogMetricsTokenTotals, g as MAX_RETAINED_STATE_PER_TOOL, h as MAX_RETAINED_METRIC_NAMES, i as API_ERROR_RECORD, l as LogMetricsOperationDuration, m as LogMetricsToolLatency, n as LogMetricsFindingSeverity, o as LogMetricsAggregatorOptions, p as LogMetricsToolCost, r as deriveFindings, s as LogMetricsError, t as LogMetricsFinding, u as LogMetricsRecorder, v as METRIC_OVERFLOW_NAME, x as TURN_FAILED_RECORD, y as TOOL_RESULT_RECORD } from "./index-CTZMUfTZ.mjs";
+export { API_ERROR_RECORD, LogMetricsAggregator, type LogMetricsAggregatorOptions, type LogMetricsError, type LogMetricsEventCount, type LogMetricsFinding, type LogMetricsFindingSeverity, type LogMetricsOperationDuration, type LogMetricsRecorder, type LogMetricsSnapshot, type LogMetricsTokenTotals, type LogMetricsToolCost, type LogMetricsToolLatency, MAX_RETAINED_METRIC_NAMES, MAX_RETAINED_STATE_PER_TOOL, MAX_RETAINED_TOKEN_BUCKETS, METRIC_OVERFLOW_NAME, TOOL_RESULT_RECORD, TOOL_TOKEN_SAMPLE_RECORD, TURN_FAILED_RECORD, TURN_FINISHED_RECORD, deriveFindings };

package/dist/metrics.mjs

@@ -0,0 +1,2 @@
+import { a as MAX_RETAINED_TOKEN_BUCKETS, c as TOOL_TOKEN_SAMPLE_RECORD, d as deriveFindings, i as MAX_RETAINED_STATE_PER_TOOL, l as TURN_FAILED_RECORD, n as LogMetricsAggregator, o as METRIC_OVERFLOW_NAME, r as MAX_RETAINED_METRIC_NAMES, s as TOOL_RESULT_RECORD, t as API_ERROR_RECORD, u as TURN_FINISHED_RECORD } from "./metrics-DywCpDJ_.mjs";
+export { API_ERROR_RECORD, LogMetricsAggregator, MAX_RETAINED_METRIC_NAMES, MAX_RETAINED_STATE_PER_TOOL, MAX_RETAINED_TOKEN_BUCKETS, METRIC_OVERFLOW_NAME, TOOL_RESULT_RECORD, TOOL_TOKEN_SAMPLE_RECORD, TURN_FAILED_RECORD, TURN_FINISHED_RECORD, deriveFindings };

package/dist/metricsSource-DXZLawQu.mjs

@@ -0,0 +1,130 @@
+import { createAsyncLogMetricsReader, resolveLogSinkInstance, resolveLogSinkPort } from "@agimon-ai/log-sink-mcp";
+//#region src/services/metricsSource/index.ts
+/**
+* Historical metrics access for the `SPC h l` overlay.
+*
+* Two transports, in order: the running sink's HTTP API, then a worker-backed
+* database reader. The sink daemon is long-lived and often lags the installed
+* package, so a daemon that rejects newer query parameters is treated as
+* unavailable rather than fatal. SQLite queries run in the package worker so a
+* one-day window cannot freeze the TUI.
+*
+* Both transports resolve the sink instance from the same identity the Pi
+* telemetry extension writes under. Without it log-sink falls back to
+* `npm_package_name`, which a running Pi process does not set, so the reader
+* would land on the local instance while the writer exported to the global one
+* and the panel would report an empty history that no session ever filled.
+*/
+const HTTP_TIMEOUT_MS = 5e3;
+/**
+* The overlay ranks one tool, but a page pairing tool calls against failure
+* counts needs a denominator for every tool that failed, so callers ask.
+*/
+const DEFAULT_TOOL_LIMIT = 1;
+/** The panel ranks consumers, so ask for the biggest rather than the most recent. */
+const TOKEN_SORT = "total-tokens";
+const FILTER_QUERY_KEYS = {
+	sessionId: "sessionId",
+	agentName: "agentName",
+	model: "model",
+	provider: "provider"
+};
+function filterEntries(params) {
+	const filter = params.filter;
+	if (filter === void 0) return [];
+	return Object.keys(FILTER_QUERY_KEYS).flatMap((key) => {
+		const value = filter[key];
+		return value === void 0 || value === "" ? [] : [[key, value]];
+	});
+}
+function searchParams(params) {
+	const search = new URLSearchParams({
+		groupBy: params.groupBy,
+		period: params.period,
+		sort: TOKEN_SORT,
+		limit: String(params.limit),
+		toolLimit: String(params.toolLimit ?? DEFAULT_TOOL_LIMIT)
+	});
+	for (const [key, value] of filterEntries(params)) search.set(FILTER_QUERY_KEYS[key], value);
+	return search.toString();
+}
+async function queryHttp(endpoint, params, fetchImpl) {
+	const response = await fetchImpl(`${endpoint}/api/metrics?${searchParams(params)}`, { signal: AbortSignal.timeout(HTTP_TIMEOUT_MS) });
+	if (!response.ok) throw new Error(`sink responded ${response.status}`);
+	const body = await response.json();
+	if (body.error || !Array.isArray(body.timeline)) throw new Error(body.error ?? "sink is an older version");
+	return body;
+}
+/**
+* A malformed `.logsink.yaml` must not take the overlay down with it. Both
+* transports still run when resolution fails; they fall back to log-sink's own
+* resolution and the panel reports an unknown instance.
+*/
+function resolveInstance(identity) {
+	try {
+		const resolved = resolveLogSinkInstance(identity);
+		return {
+			scope: resolved.scope,
+			dbPath: resolved.dbPath,
+			...resolved.registeredName === void 0 ? {} : { registeredName: resolved.registeredName }
+		};
+	} catch {
+		return;
+	}
+}
+function createMetricsSource(options = {}) {
+	const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+	const identity = {
+		env: options.env,
+		cwd: options.cwd,
+		packageName: options.packageName,
+		serviceName: options.serviceName
+	};
+	let transport;
+	let endpoint;
+	const instance = resolveInstance(identity);
+	let workerReader = options.workerReader;
+	const resolveEndpoint = async () => {
+		if (endpoint !== void 0) return endpoint ?? void 0;
+		try {
+			endpoint = (await resolveLogSinkPort({
+				...identity,
+				healthCheck: true
+			}))?.endpoint ?? null;
+		} catch {
+			endpoint = null;
+		}
+		return endpoint ?? void 0;
+	};
+	return {
+		lastTransport: () => transport,
+		instance: () => instance,
+		async query(params) {
+			const httpEndpoint = await resolveEndpoint();
+			if (httpEndpoint && fetchImpl) try {
+				const report = await queryHttp(httpEndpoint, params, fetchImpl);
+				transport = "http";
+				return report;
+			} catch {
+				endpoint = null;
+			}
+			workerReader ??= createAsyncLogMetricsReader(instance === void 0 ? { cwd: options.cwd } : { dbPath: instance.dbPath });
+			const report = await workerReader.getMetrics(params.filter, {
+				groupBy: params.groupBy,
+				period: params.period,
+				sort: TOKEN_SORT,
+				limit: params.limit,
+				toolLimit: params.toolLimit ?? DEFAULT_TOOL_LIMIT
+			});
+			transport = "worker";
+			return report;
+		},
+		async close() {
+			await workerReader?.close();
+		}
+	};
+}
+//#endregion
+export { createMetricsSource as t };
+
+//# sourceMappingURL=metricsSource-DXZLawQu.mjs.map

package/dist/metricsSource-DXZLawQu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsSource-DXZLawQu.mjs","names":[],"sources":["../src/services/metricsSource/index.ts"],"sourcesContent":["/**\n * Historical metrics access for the `SPC h l` overlay.\n *\n * Two transports, in order: the running sink's HTTP API, then a worker-backed\n * database reader. The sink daemon is long-lived and often lags the installed\n * package, so a daemon that rejects newer query parameters is treated as\n * unavailable rather than fatal. SQLite queries run in the package worker so a\n * one-day window cannot freeze the TUI.\n *\n * Both transports resolve the sink instance from the same identity the Pi\n * telemetry extension writes under. Without it log-sink falls back to\n * `npm_package_name`, which a running Pi process does not set, so the reader\n * would land on the local instance while the writer exported to the global one\n * and the panel would report an empty history that no session ever filled.\n */\nimport {\n  createAsyncLogMetricsReader,\n  type AsyncLogMetricsReader,\n  type LogMetricsReport,\n  resolveLogSinkInstance,\n  resolveLogSinkPort,\n} from '@agimon-ai/log-sink-mcp';\n\nimport type { MetricsInstance, MetricsQueryParams, MetricsSource, MetricsTransport } from '../../types/metricsSource';\n\nconst HTTP_TIMEOUT_MS = 5000;\n/**\n * The overlay ranks one tool, but a page pairing tool calls against failure\n * counts needs a denominator for every tool that failed, so callers ask.\n */\nconst DEFAULT_TOOL_LIMIT = 1;\n/** The panel ranks consumers, so ask for the biggest rather than the most recent. */\nconst TOKEN_SORT = 'total-tokens';\n\n/** The identity both transports resolve their sink instance from. */\ninterface ResolveIdentity {\n  env?: NodeJS.ProcessEnv;\n  cwd?: string;\n  packageName?: string;\n  serviceName?: string;\n}\n\nexport interface MetricsSourceOptions {\n  env?: NodeJS.ProcessEnv;\n  cwd?: string;\n  /** Identity the sink is registered under; must match the telemetry writer's. */\n  packageName?: string;\n  serviceName?: string;\n  /** Overrides HTTP transport discovery in tests. */\n  fetchImpl?: typeof fetch;\n  /** Overrides the worker-backed reader in tests. */\n  workerReader?: Pick<AsyncLogMetricsReader, 'getMetrics' | 'close'>;\n}\n\nconst FILTER_QUERY_KEYS = {\n  sessionId: 'sessionId',\n  agentName: 'agentName',\n  model: 'model',\n  provider: 'provider',\n} as const;\n\nfunction filterEntries(params: MetricsQueryParams): [keyof typeof FILTER_QUERY_KEYS, string][] {\n  const filter = params.filter;\n  if (filter === undefined) return [];\n  return (Object.keys(FILTER_QUERY_KEYS) as (keyof typeof FILTER_QUERY_KEYS)[]).flatMap((key) => {\n    const value = filter[key];\n    return value === undefined || value === '' ? [] : [[key, value] as [keyof typeof FILTER_QUERY_KEYS, string]];\n  });\n}\n\nfunction searchParams(params: MetricsQueryParams): string {\n  const search = new URLSearchParams({\n    groupBy: params.groupBy,\n    period: params.period,\n    sort: TOKEN_SORT,\n    limit: String(params.limit),\n    toolLimit: String(params.toolLimit ?? DEFAULT_TOOL_LIMIT),\n  });\n  for (const [key, value] of filterEntries(params)) search.set(FILTER_QUERY_KEYS[key], value);\n  return search.toString();\n}\n\nasync function queryHttp(\n  endpoint: string,\n  params: MetricsQueryParams,\n  fetchImpl: typeof fetch,\n): Promise<LogMetricsReport> {\n  const response = await fetchImpl(`${endpoint}/api/metrics?${searchParams(params)}`, {\n    signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),\n  });\n  if (!response.ok) throw new Error(`sink responded ${response.status}`);\n\n  const body = (await response.json()) as LogMetricsReport & { error?: string };\n  // An older daemon rejects unknown group-by values and omits the timeline.\n  if (body.error || !Array.isArray(body.timeline)) throw new Error(body.error ?? 'sink is an older version');\n  return body;\n}\n\n/**\n * A malformed `.logsink.yaml` must not take the overlay down with it. Both\n * transports still run when resolution fails; they fall back to log-sink's own\n * resolution and the panel reports an unknown instance.\n */\nfunction resolveInstance(identity: ResolveIdentity): MetricsInstance | undefined {\n  try {\n    const resolved = resolveLogSinkInstance(identity);\n    return {\n      scope: resolved.scope,\n      dbPath: resolved.dbPath,\n      ...(resolved.registeredName === undefined ? {} : { registeredName: resolved.registeredName }),\n    };\n  } catch {\n    return undefined;\n  }\n}\n\nexport function createMetricsSource(options: MetricsSourceOptions = {}): MetricsSource {\n  const fetchImpl = options.fetchImpl ?? globalThis.fetch;\n  const identity = {\n    env: options.env,\n    cwd: options.cwd,\n    packageName: options.packageName,\n    serviceName: options.serviceName,\n  };\n  let transport: MetricsTransport | undefined;\n  let endpoint: string | undefined | null;\n  const instance = resolveInstance(identity);\n  let workerReader = options.workerReader;\n\n  const resolveEndpoint = async (): Promise<string | undefined> => {\n    if (endpoint !== undefined) return endpoint ?? undefined;\n    try {\n      const resolved = await resolveLogSinkPort({ ...identity, healthCheck: true });\n      endpoint = resolved?.endpoint ?? null;\n    } catch {\n      endpoint = null;\n    }\n    return endpoint ?? undefined;\n  };\n\n  return {\n    lastTransport: () => transport,\n    instance: () => instance,\n    async query(params) {\n      const httpEndpoint = await resolveEndpoint();\n      if (httpEndpoint && fetchImpl) {\n        try {\n          const report = await queryHttp(httpEndpoint, params, fetchImpl);\n          transport = 'http';\n          return report;\n        } catch {\n          // A stale or unhealthy daemon must not hide data the worker can still read.\n          endpoint = null;\n        }\n      }\n\n      workerReader ??= createAsyncLogMetricsReader(\n        instance === undefined ? { cwd: options.cwd } : { dbPath: instance.dbPath },\n      );\n      const report = await workerReader.getMetrics(params.filter, {\n        groupBy: params.groupBy,\n        period: params.period,\n        sort: TOKEN_SORT,\n        limit: params.limit,\n        toolLimit: params.toolLimit ?? DEFAULT_TOOL_LIMIT,\n      });\n      transport = 'worker';\n      return report;\n    },\n    async close() {\n      await workerReader?.close();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/metricsSource-DdwQNzoY.cjs

@@ -0,0 +1,135 @@
+let _agimon_ai_log_sink_mcp = require("@agimon-ai/log-sink-mcp");
+//#region src/services/metricsSource/index.ts
+/**
+* Historical metrics access for the `SPC h l` overlay.
+*
+* Two transports, in order: the running sink's HTTP API, then a worker-backed
+* database reader. The sink daemon is long-lived and often lags the installed
+* package, so a daemon that rejects newer query parameters is treated as
+* unavailable rather than fatal. SQLite queries run in the package worker so a
+* one-day window cannot freeze the TUI.
+*
+* Both transports resolve the sink instance from the same identity the Pi
+* telemetry extension writes under. Without it log-sink falls back to
+* `npm_package_name`, which a running Pi process does not set, so the reader
+* would land on the local instance while the writer exported to the global one
+* and the panel would report an empty history that no session ever filled.
+*/
+const HTTP_TIMEOUT_MS = 5e3;
+/**
+* The overlay ranks one tool, but a page pairing tool calls against failure
+* counts needs a denominator for every tool that failed, so callers ask.
+*/
+const DEFAULT_TOOL_LIMIT = 1;
+/** The panel ranks consumers, so ask for the biggest rather than the most recent. */
+const TOKEN_SORT = "total-tokens";
+const FILTER_QUERY_KEYS = {
+	sessionId: "sessionId",
+	agentName: "agentName",
+	model: "model",
+	provider: "provider"
+};
+function filterEntries(params) {
+	const filter = params.filter;
+	if (filter === void 0) return [];
+	return Object.keys(FILTER_QUERY_KEYS).flatMap((key) => {
+		const value = filter[key];
+		return value === void 0 || value === "" ? [] : [[key, value]];
+	});
+}
+function searchParams(params) {
+	const search = new URLSearchParams({
+		groupBy: params.groupBy,
+		period: params.period,
+		sort: TOKEN_SORT,
+		limit: String(params.limit),
+		toolLimit: String(params.toolLimit ?? DEFAULT_TOOL_LIMIT)
+	});
+	for (const [key, value] of filterEntries(params)) search.set(FILTER_QUERY_KEYS[key], value);
+	return search.toString();
+}
+async function queryHttp(endpoint, params, fetchImpl) {
+	const response = await fetchImpl(`${endpoint}/api/metrics?${searchParams(params)}`, { signal: AbortSignal.timeout(HTTP_TIMEOUT_MS) });
+	if (!response.ok) throw new Error(`sink responded ${response.status}`);
+	const body = await response.json();
+	if (body.error || !Array.isArray(body.timeline)) throw new Error(body.error ?? "sink is an older version");
+	return body;
+}
+/**
+* A malformed `.logsink.yaml` must not take the overlay down with it. Both
+* transports still run when resolution fails; they fall back to log-sink's own
+* resolution and the panel reports an unknown instance.
+*/
+function resolveInstance(identity) {
+	try {
+		const resolved = (0, _agimon_ai_log_sink_mcp.resolveLogSinkInstance)(identity);
+		return {
+			scope: resolved.scope,
+			dbPath: resolved.dbPath,
+			...resolved.registeredName === void 0 ? {} : { registeredName: resolved.registeredName }
+		};
+	} catch {
+		return;
+	}
+}
+function createMetricsSource(options = {}) {
+	const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+	const identity = {
+		env: options.env,
+		cwd: options.cwd,
+		packageName: options.packageName,
+		serviceName: options.serviceName
+	};
+	let transport;
+	let endpoint;
+	const instance = resolveInstance(identity);
+	let workerReader = options.workerReader;
+	const resolveEndpoint = async () => {
+		if (endpoint !== void 0) return endpoint ?? void 0;
+		try {
+			endpoint = (await (0, _agimon_ai_log_sink_mcp.resolveLogSinkPort)({
+				...identity,
+				healthCheck: true
+			}))?.endpoint ?? null;
+		} catch {
+			endpoint = null;
+		}
+		return endpoint ?? void 0;
+	};
+	return {
+		lastTransport: () => transport,
+		instance: () => instance,
+		async query(params) {
+			const httpEndpoint = await resolveEndpoint();
+			if (httpEndpoint && fetchImpl) try {
+				const report = await queryHttp(httpEndpoint, params, fetchImpl);
+				transport = "http";
+				return report;
+			} catch {
+				endpoint = null;
+			}
+			workerReader ??= (0, _agimon_ai_log_sink_mcp.createAsyncLogMetricsReader)(instance === void 0 ? { cwd: options.cwd } : { dbPath: instance.dbPath });
+			const report = await workerReader.getMetrics(params.filter, {
+				groupBy: params.groupBy,
+				period: params.period,
+				sort: TOKEN_SORT,
+				limit: params.limit,
+				toolLimit: params.toolLimit ?? DEFAULT_TOOL_LIMIT
+			});
+			transport = "worker";
+			return report;
+		},
+		async close() {
+			await workerReader?.close();
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "createMetricsSource", {
+	enumerable: true,
+	get: function() {
+		return createMetricsSource;
+	}
+});
+
+//# sourceMappingURL=metricsSource-DdwQNzoY.cjs.map

package/dist/metricsSource-DdwQNzoY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsSource-DdwQNzoY.cjs","names":["resolveLogSinkInstance","resolveLogSinkPort","createAsyncLogMetricsReader"],"sources":["../src/services/metricsSource/index.ts"],"sourcesContent":["/**\n * Historical metrics access for the `SPC h l` overlay.\n *\n * Two transports, in order: the running sink's HTTP API, then a worker-backed\n * database reader. The sink daemon is long-lived and often lags the installed\n * package, so a daemon that rejects newer query parameters is treated as\n * unavailable rather than fatal. SQLite queries run in the package worker so a\n * one-day window cannot freeze the TUI.\n *\n * Both transports resolve the sink instance from the same identity the Pi\n * telemetry extension writes under. Without it log-sink falls back to\n * `npm_package_name`, which a running Pi process does not set, so the reader\n * would land on the local instance while the writer exported to the global one\n * and the panel would report an empty history that no session ever filled.\n */\nimport {\n  createAsyncLogMetricsReader,\n  type AsyncLogMetricsReader,\n  type LogMetricsReport,\n  resolveLogSinkInstance,\n  resolveLogSinkPort,\n} from '@agimon-ai/log-sink-mcp';\n\nimport type { MetricsInstance, MetricsQueryParams, MetricsSource, MetricsTransport } from '../../types/metricsSource';\n\nconst HTTP_TIMEOUT_MS = 5000;\n/**\n * The overlay ranks one tool, but a page pairing tool calls against failure\n * counts needs a denominator for every tool that failed, so callers ask.\n */\nconst DEFAULT_TOOL_LIMIT = 1;\n/** The panel ranks consumers, so ask for the biggest rather than the most recent. */\nconst TOKEN_SORT = 'total-tokens';\n\n/** The identity both transports resolve their sink instance from. */\ninterface ResolveIdentity {\n  env?: NodeJS.ProcessEnv;\n  cwd?: string;\n  packageName?: string;\n  serviceName?: string;\n}\n\nexport interface MetricsSourceOptions {\n  env?: NodeJS.ProcessEnv;\n  cwd?: string;\n  /** Identity the sink is registered under; must match the telemetry writer's. */\n  packageName?: string;\n  serviceName?: string;\n  /** Overrides HTTP transport discovery in tests. */\n  fetchImpl?: typeof fetch;\n  /** Overrides the worker-backed reader in tests. */\n  workerReader?: Pick<AsyncLogMetricsReader, 'getMetrics' | 'close'>;\n}\n\nconst FILTER_QUERY_KEYS = {\n  sessionId: 'sessionId',\n  agentName: 'agentName',\n  model: 'model',\n  provider: 'provider',\n} as const;\n\nfunction filterEntries(params: MetricsQueryParams): [keyof typeof FILTER_QUERY_KEYS, string][] {\n  const filter = params.filter;\n  if (filter === undefined) return [];\n  return (Object.keys(FILTER_QUERY_KEYS) as (keyof typeof FILTER_QUERY_KEYS)[]).flatMap((key) => {\n    const value = filter[key];\n    return value === undefined || value === '' ? [] : [[key, value] as [keyof typeof FILTER_QUERY_KEYS, string]];\n  });\n}\n\nfunction searchParams(params: MetricsQueryParams): string {\n  const search = new URLSearchParams({\n    groupBy: params.groupBy,\n    period: params.period,\n    sort: TOKEN_SORT,\n    limit: String(params.limit),\n    toolLimit: String(params.toolLimit ?? DEFAULT_TOOL_LIMIT),\n  });\n  for (const [key, value] of filterEntries(params)) search.set(FILTER_QUERY_KEYS[key], value);\n  return search.toString();\n}\n\nasync function queryHttp(\n  endpoint: string,\n  params: MetricsQueryParams,\n  fetchImpl: typeof fetch,\n): Promise<LogMetricsReport> {\n  const response = await fetchImpl(`${endpoint}/api/metrics?${searchParams(params)}`, {\n    signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),\n  });\n  if (!response.ok) throw new Error(`sink responded ${response.status}`);\n\n  const body = (await response.json()) as LogMetricsReport & { error?: string };\n  // An older daemon rejects unknown group-by values and omits the timeline.\n  if (body.error || !Array.isArray(body.timeline)) throw new Error(body.error ?? 'sink is an older version');\n  return body;\n}\n\n/**\n * A malformed `.logsink.yaml` must not take the overlay down with it. Both\n * transports still run when resolution fails; they fall back to log-sink's own\n * resolution and the panel reports an unknown instance.\n */\nfunction resolveInstance(identity: ResolveIdentity): MetricsInstance | undefined {\n  try {\n    const resolved = resolveLogSinkInstance(identity);\n    return {\n      scope: resolved.scope,\n      dbPath: resolved.dbPath,\n      ...(resolved.registeredName === undefined ? {} : { registeredName: resolved.registeredName }),\n    };\n  } catch {\n    return undefined;\n  }\n}\n\nexport function createMetricsSource(options: MetricsSourceOptions = {}): MetricsSource {\n  const fetchImpl = options.fetchImpl ?? globalThis.fetch;\n  const identity = {\n    env: options.env,\n    cwd: options.cwd,\n    packageName: options.packageName,\n    serviceName: options.serviceName,\n  };\n  let transport: MetricsTransport | undefined;\n  let endpoint: string | undefined | null;\n  const instance = resolveInstance(identity);\n  let workerReader = options.workerReader;\n\n  const resolveEndpoint = async (): Promise<string | undefined> => {\n    if (endpoint !== undefined) return endpoint ?? undefined;\n    try {\n      const resolved = await resolveLogSinkPort({ ...identity, healthCheck: true });\n      endpoint = resolved?.endpoint ?? null;\n    } catch {\n      endpoint = null;\n    }\n    return endpoint ?? undefined;\n  };\n\n  return {\n    lastTransport: () => transport,\n    instance: () => instance,\n    async query(params) {\n      const httpEndpoint = await resolveEndpoint();\n      if (httpEndpoint && fetchImpl) {\n        try {\n          const report = await queryHttp(httpEndpoint, params, fetchImpl);\n          transport = 'http';\n          return report;\n        } catch {\n          // A stale or unhealthy daemon must not hide data the worker can still read.\n          endpoint = null;\n        }\n      }\n\n      workerReader ??= createAsyncLogMetricsReader(\n        instance === undefined ? { cwd: options.cwd } : { dbPath: instance.dbPath },\n      );\n      const report = await workerReader.getMetrics(params.filter, {\n        groupBy: params.groupBy,\n        period: params.period,\n        sort: TOKEN_SORT,\n        limit: params.limit,\n        toolLimit: params.toolLimit ?? DEFAULT_TOOL_LIMIT,\n      });\n      transport = 'worker';\n      return report;\n    },\n    async close() {\n      await workerReader?.close();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/metricsSource-cZnErdv4.d.mts

@@ -0,0 +1,51 @@
+import { LogMetricsGroupBy, LogMetricsPeriod, LogMetricsReport } from "@agimon-ai/log-sink-mcp";
+//#region src/types/metricsSource.d.ts
+/**
+ * Narrowing one query to a single group, for a reader who clicked a row.
+ *
+ * Every field is optional and callers that pass none behave exactly as before,
+ * which is what keeps the TUI overlay unaffected. The sink echoes the filters
+ * it actually applied back on the report, so a caller can tell an honoured
+ * filter from one an older daemon ignored rather than presenting unfiltered
+ * numbers as filtered ones.
+ */
+interface MetricsFilter {
+  sessionId?: string;
+  agentName?: string;
+  model?: string;
+  provider?: string;
+}
+interface MetricsQueryParams {
+  groupBy: LogMetricsGroupBy;
+  period: LogMetricsPeriod;
+  limit: number;
+  /** How many tool rows to rank; defaults to the overlay's one. */
+  toolLimit?: number;
+  filter?: MetricsFilter;
+}
+type MetricsQuery = (params: MetricsQueryParams) => Promise<LogMetricsReport>;
+type MetricsTransport = 'http' | 'worker';
+/**
+ * The log-sink instance the history transports read.
+ *
+ * A local instance is scoped to one repository and a global one is shared, so
+ * an empty history panel means something different in each case. The overlay
+ * reports this rather than leaving the reader to guess which database answered.
+ */
+interface MetricsInstance {
+  scope: 'local' | 'global';
+  dbPath: string;
+  /** The name that selected the scope: the package the sink is registered under. */
+  registeredName?: string;
+}
+interface MetricsSource {
+  query: MetricsQuery;
+  lastTransport(): MetricsTransport | undefined;
+  /** Undefined when instance resolution failed; the transports still work. */
+  instance?(): MetricsInstance | undefined;
+  /** Releases a lazily created worker-backed reader. */
+  close?(): Promise<void>;
+}
+//#endregion
+export { MetricsTransport as a, MetricsSource as i, MetricsQuery as n, MetricsQueryParams as r, MetricsInstance as t };
+//# sourceMappingURL=metricsSource-cZnErdv4.d.mts.map

package/dist/metricsSource-cZnErdv4.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsSource-cZnErdv4.d.mts","names":[],"sources":["../src/types/metricsSource.ts"],"mappings":";;;;;;;;;;;UAWiB;EACf;EACA;EACA;EACA;;UAGe;EACf,SAAS;EACT,QAAQ;EACR;;EAEA;EACA,SAAS;;KAGC,gBAAgB,QAAQ,uBAAuB,QAAQ;KAEvD;;;;;;;;UASK;EACf;EACA;;EAEA;;UAGe;EACf,OAAO;EACP,iBAAiB;;EAEjB,aAAa;;EAEb,UAAU"}

package/dist/metricsSource.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_metricsSource = require("./metricsSource-DdwQNzoY.cjs");
+exports.createMetricsSource = require_metricsSource.createMetricsSource;

package/dist/metricsSource.d.mts

@@ -0,0 +1,18 @@
+import { a as MetricsTransport, i as MetricsSource, n as MetricsQuery, r as MetricsQueryParams, t as MetricsInstance } from "./metricsSource-cZnErdv4.mjs";
+import { AsyncLogMetricsReader } from "@agimon-ai/log-sink-mcp";
+//#region src/services/metricsSource/index.d.ts
+interface MetricsSourceOptions {
+  env?: NodeJS.ProcessEnv;
+  cwd?: string;
+  /** Identity the sink is registered under; must match the telemetry writer's. */
+  packageName?: string;
+  serviceName?: string;
+  /** Overrides HTTP transport discovery in tests. */
+  fetchImpl?: typeof fetch;
+  /** Overrides the worker-backed reader in tests. */
+  workerReader?: Pick<AsyncLogMetricsReader, 'getMetrics' | 'close'>;
+}
+export declare function createMetricsSource(options?: MetricsSourceOptions): MetricsSource;
+//#endregion
+export type { MetricsInstance, MetricsQuery, MetricsQueryParams, MetricsSource, MetricsSourceOptions, MetricsTransport };
+//# sourceMappingURL=metricsSource.d.mts.map

package/dist/metricsSource.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsSource.d.mts","names":[],"sources":["../src/services/metricsSource/index.ts"],"mappings":";;;UA0CiB;EACf,MAAM,OAAO;EACb;;EAEA;EACA;;EAEA,mBAAmB;;EAEnB,eAAe,KAAK;;wBAiEN,oBAAoB,UAAS,uBAA4B"}

package/dist/metricsSource.mjs

@@ -0,0 +1,2 @@
+import { t as createMetricsSource } from "./metricsSource-DXZLawQu.mjs";
+export { createMetricsSource };

package/llms.txt

@@ -0,0 +1,7 @@
+# Po Log
+
+Session telemetry and evidence-based agent diagnostics.
+
+## Help
+
+- [po-debug-agent](./src/prompts/po-debug-agent/SKILL.md): Diagnose captured failures and token usage without changing the sink or exposing secrets.

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "@agimon-ai/po-log",
+  "version": "0.0.0-alpha.0",
+  "description": "Session metrics, findings, and sink status for headless agent observability.",
+  "keywords": [
+    "agent-observability",
+    "ai",
+    "coding-agent",
+    "developer-tools",
+    "log-sink",
+    "logging",
+    "metrics",
+    "pi-extension",
+    "pi-package",
+    "po",
+    "telemetry"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/po/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/po.git",
+    "directory": "packages/default/po-log"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "src/prompts"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./apiContracts": {
+      "types": "./dist/apiContracts.d.mts",
+      "import": "./dist/apiContracts.mjs",
+      "require": "./dist/apiContracts.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./extensions/web": {
+      "import": "./dist/extensions/web.mjs"
+    },
+    "./metrics": {
+      "types": "./dist/metrics.d.mts",
+      "import": "./dist/metrics.mjs",
+      "require": "./dist/metrics.cjs"
+    },
+    "./metricsSource": {
+      "types": "./dist/metricsSource.d.mts",
+      "import": "./dist/metricsSource.mjs",
+      "require": "./dist/metricsSource.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@agimon-ai/log-sink-mcp": "0.30.12",
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@agimon-ai/po-telemetry": "0.0.0-alpha.0",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.0",
+    "@agimon-ai/po-web-security": "0.0.0-alpha.0",
+    "@deepseek-ai/cordis": "4.0.4",
+    "hono": "4.13.12",
+    "typebox": "1.3.34"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.0",
+    "@agimon-ai/po-ui": "0.0.0-alpha.0",
+    "@earendil-works/pi-coding-agent": "1.0.2",
+    "@modelcontextprotocol/client": "2.2.0",
+    "@tanstack/react-store": "0.11.2",
+    "@tanstack/store": "0.11.2",
+    "@types/node": "26.6.4",
+    "@types/react": "19.3.0",
+    "@vitest/coverage-v8": "5.0.3",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "1.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "global",
+      "workspace",
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "poWeb": {
+    "pluginId": "log",
+    "channels": [],
+    "client": "./dist/extensions/web.mjs",
+    "scopes": [
+      "global",
+      "session"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/prompts/po-debug-agent/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: po-debug-agent
+description: Debug a Po 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.
+---
+
+# Debug a Po agent
+
+Start with the user's symptom and an expected outcome. Identify the affected session and the shortest reproduction. Do not attribute a failure to the model before checking the tools and runtime it depends on.
+
+## Read captured evidence
+
+While Help is active, call `help_status` to see which diagnostics are actually available. Use `diagnose_agent` for the current session, initially with the default one-day window. Use `period: week` only when the relevant run is older. The tool has no arbitrary session or filesystem selector.
+
+The result distinguishes unavailable data, an empty window, and captured evidence. `capturedIssues` describes the records inspected, not every failure that ever happened. Zero captured records does not establish that telemetry was working. Token coverage describes usage records, not completeness of the event stream. Tool token samples belong to the containing turn and are not exclusive tool cost.
+
+If setup or capabilities are suspect, use `diagnose_setup` and the configuration, domain, mode, or skill guidance identified by the failed check. Preserve the current selection and unrelated settings.
+
+## Investigate beyond the summary
+
+The diagnostic deliberately omits prompts, raw error messages, tool inputs, and trace bodies. It does not open a sink or repair logging. Use existing authorized repository tools and the installed log-sink CLI only when deeper investigation is necessary. Resolve the same sink identity as the writer, keep queries restricted to the current session, and inspect the CLI's installed help before selecting unsupported query options. Verify trace ownership against that session before reading a trace; a guessed trace ID is not authorization.
+
+When no shell or trace reader is available, report that capability limitation. Do not invent evidence or enable a server, domain, or permission merely to make a command available.
+
+## Propose and verify a repair
+
+Separate observations from hypotheses. Present the smallest change and the expected verification. Configuration changes, model changes, package installation, authentication, restarts, and repairs use existing approval and permission boundaries. Help activation grants none of those actions by itself.
+
+Never clear logs, restart or stop a sink as part of diagnosis, or paste credentials and raw private logs into a report. After an authorized change, reproduce the original symptom and report the observed result and remaining evidence gaps.