Metadata-Version: 2.5
Name: airprompter-agent-telemetry
Version: 0.3.0
Summary: The content-free telemetry spool and its uploader for AirPrompter agents: minute windows as append-only segments (or in memory on serverless), the host budget, and direct-to-object-store upload under a grant.
Project-URL: Homepage, https://github.com/airprompter/airprompter-agent-sdk
Project-URL: Source, https://github.com/airprompter/airprompter-agent-sdk/tree/main/sdk-python/packages/telemetry
Project-URL: Protocol, https://github.com/airprompter/airprompter-agent-sdk/tree/main/protocol
Project-URL: Changelog, https://github.com/airprompter/airprompter-agent-sdk/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/airprompter/airprompter-agent-sdk/issues
Author: AirPrompter
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: agent,airprompter,governance,llm,prompts
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: airprompter-agent-core==0.3.0
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# airprompter-agent-telemetry

The content-free telemetry spool and its uploader: minute windows per
`(tag, versionId, arm, model, status, errorClass)` written as append-only
NDJSON segments (`DirectorySink`) or held in memory on a serverless host
(`MemorySink`), the host budget, and `SpoolUploader` — direct to your
prefix in object storage under a short-lived grant. The row shape
(`airprompter_agent_core.telemetry.rows`) has no field for prompt text,
output or an end-user identifier. Never imports the sync or the runtime
distribution.

```python
from airprompter_agent_telemetry import SpoolWriter, DirectorySink, Observation, WriterIdentity
```

One of five distributions released in lockstep — `airprompter-agent-core`,
`-sync`, `-runtime`, `-telemetry` and the facade `airprompter-agent` — one
version, exact-pinned siblings, mirroring the TypeScript packages one for
one. The full README and the parity matrix are in
[`sdk-python/README.md`](https://github.com/airprompter/airprompter-agent-sdk/tree/main/sdk-python);
the protocol is in [`protocol/`](https://github.com/airprompter/airprompter-agent-sdk/tree/main/protocol).
BSD-3-Clause.
