@tangle-network/sdk-telemetry 0.1.8

package/LICENSE

@@ -0,0 +1,11 @@
+Copyright (c) 2025 Tangle Network
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. No part of this Software may be reproduced, distributed, or
+transmitted in any form or by any means, including photocopying, recording, or
+other electronic or mechanical methods, without the prior written permission of
+Tangle Network.
+
+For licensing inquiries, contact: hello@tangle.tools

package/README.md

@@ -0,0 +1,24 @@
+# @tangle-network/sdk-telemetry
+
+Usage tracking, credit management, execution-trace collection, and telemetry
+export for the Agent Dev Container SDK.
+
+## LLM call capture
+
+Capture LLM calls (model, tokens, latency, prompt/completion) with
+[OpenLLMetry](https://github.com/traceloop/openllmetry), which auto-instruments
+the raw OpenAI/Anthropic SDKs plus 10+ frameworks and emits standard OpenTelemetry
+`gen_ai.*` spans.
+
+1. Instrument your app with OpenLLMetry (`traceloop-sdk` for Python,
+   `@traceloop/node-server-sdk` for Node).
+2. Point its OTLP exporter at our trace ingest:
+   `POST /v1/otlp/v1/traces` (the intelligence OTLP/HTTP-JSON adapter).
+
+Our ingest reads the standard `gen_ai.*` attribute keys directly off the span
+attribute bag — model from `gen_ai.request.model`, tokens from
+`gen_ai.usage.prompt_tokens` / `gen_ai.usage.completion_tokens` (and the
+`input_tokens` / `output_tokens` spellings). The reader candidate arrays live in
+`packages/sdk-core/src/telemetry/genai-attributes.ts`; the ingest reader is
+`parseGenAiAttribution` (`products/intelligence/api/src/lib/trace-attribution.ts`).
+No bespoke provider wrapper is required.