Metadata-Version: 2.4
Name: usefluency-workflow-telemetry
Version: 0.1.1
License: Proprietary
Classifier: License :: Other/Proprietary License
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opentelemetry-api<2,>=1.42
Requires-Dist: opentelemetry-sdk<2,>=1.42
Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.42
Dynamic: license-file

# Workflow telemetry SDKs

Capture the work your agents and automations perform in Fluency. Connect existing OpenTelemetry instrumentation, then add business identifiers and outcomes with the SDK's event helpers.

## Install

```sh
pip install usefluency-workflow-telemetry
npm install @usefluency/workflow-telemetry
```

Python requires 3.12 or later and imports as `fluency_workflow_telemetry`. JavaScript and TypeScript require Node.js 24 or later; ESM and CommonJS are supported.

## Get started

Your Fluency contact provides your organization's regional endpoint and ingestion key. Configure them in your server-side environment:

```sh
FLUENCY_OTLP_TRACES_ENDPOINT=https://YOUR-REGIONAL-ENDPOINT/ext/otel/v1/traces
FLUENCY_WORKFLOW_API_KEY=YOUR-ORGANIZATION-API-KEY
```

Choose the guide for your application:

- [LangChain and LangGraph](https://docs.usefluency.com/fluency-workflow-telemetry-langchain): connect a Python agent, capture its tools, and attach business context.
- [Vercel AI SDK](https://docs.usefluency.com/fluency-workflow-telemetry-vercel): capture Node.js model calls, tools, and streaming work.
- [OpenAI](https://docs.usefluency.com/fluency-workflow-telemetry-openai): connect direct Python API calls or Agents SDK workflows while preserving existing tracing.
- [RPA and custom workflows](https://docs.usefluency.com/fluency-workflow-telemetry-rpa): record steps and outcomes from Python or TypeScript automations.
- [Existing OpenTelemetry](https://docs.usefluency.com/fluency-workflow-telemetry-opentelemetry): add Fluency while keeping your current telemetry destination.
- [Business context and capture](https://docs.usefluency.com/fluency-workflow-telemetry-business-context): enrich an operation or record a business action.

After `configure()`, use `telemetry.events` for `enrich`, `capture`, and timed operations. Framework integrations capture the operations they instrument; the exporter alone does not discover agent or bot activity.

Exact methods and lifecycle behavior are in the [SDK reference](SDK.md). [Executable examples](examples/README.md) accompany the guides. Maintainers use [release instructions](https://github.com/farmorsoftware/fluency-monorepo/blob/main/packages/workflow-telemetry/RELEASING.md).

This software is proprietary; see [LICENSE](LICENSE).
