@agimon-ai/po-log

Session metrics, findings, and sink status for Po.

Part of the Po distribution.

The extension aggregates telemetry it observes in-process and can query historical data from @agimon-ai/po-logsink.

Alpha: metric attribution and UI contracts may change between releases.

Requirements

• Node.js 24 or newer

Install

po init include Log in default.packages in .po/modes.yaml. Remove it or move it to a named layer to change which major modes load it.

What is collected

The in-process aggregator tracks operational records such as turn token totals, cache use, tool calls and failures, operation durations, recent errors, and event counts. It derives findings from those records without requiring an external sink.

Historical panels resolve a sink over HTTP first and then use the Log Sink CLI fallback. Without a reachable sink, current-session headline metrics, findings, errors, and tool metrics still work; historical top-consumer and burn-rate views are unavailable. Sink failures are reported in status rather than failing the Pi session.

Turn cost attribution is contextual: when a turn invokes several tools, the emitted turn total can be associated with each participating tool. This is not a precise per-tool share.

Telemetry controls

File fallback is opt-in through host options. The absence of a configured or reachable endpoint does not prevent in-process aggregation. Exceptions and caller-supplied attributes can still be sensitive; do not assume "metadata" is harmless.

Public API

import { deriveFindings, LogMetricsAggregator } from '@agimon-ai/po-log';

Development

pnpm build
pnpm typecheck
pnpm test
pnpm lint

Maintained by Agimon.

License

Business Source License 1.1: free for personal use, organisations under USD 1M revenue, non-profits and education. See LICENSE and https://agimon.ai/licensing.