Metadata-Version: 2.4
Name: forgesight-api
Version: 0.1.0
Summary: ForgeSight — locked telemetry contracts (domain model + SPIs). Vendor-neutral, zero backend deps.
Project-URL: Homepage, https://github.com/Scaffoldic/forgesight
Project-URL: Repository, https://github.com/Scaffoldic/forgesight
Project-URL: Issues, https://github.com/Scaffoldic/forgesight/issues
Project-URL: Changelog, https://github.com/Scaffoldic/forgesight/blob/main/docs/releases/v0.1.md
Author: kjoshi
License-Expression: Apache-2.0
Keywords: ai-agents,llm,observability,opentelemetry,telemetry
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Monitoring
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: typing-extensions>=4.10
Description-Content-Type: text/markdown

# forgesight-api

The locked contract layer for [ForgeSight](https://github.com/Scaffoldic/forgesight) —
the vendor-neutral, OpenTelemetry-first telemetry SDK for AI agents.

This package contains **only** the stable surface every other package implements:

- the **domain model** — `AgentRun`, `WorkflowRun`, `Step`, `LLMCall`, `ToolCall`,
  `MCPCall`, `TokenUsage`, the `Record`/`LifecycleEvent` value types, and the
  `RunStatus`/`Kind` enums;
- the four **SPIs** — `TelemetryExporter`, `Interceptor`, `EventListener`,
  `PricingProvider`.

It has **no I/O and no backend or model-provider dependencies** (stdlib +
`typing-extensions` only). AgentForge and third-party agents depend on this package
to stay free of vendor lock-in.

See the [feature spec](https://github.com/Scaffoldic/forgesight/blob/main/docs/features/feat-001-core-domain-model-and-contracts.md)
and [ADR-0002](https://github.com/Scaffoldic/forgesight/blob/main/docs/adr/0002-three-tier-vendor-neutral-packaging.md).

## License

Apache-2.0
