@runtypelabs/flue-otel 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,105 @@
+# @runtypelabs/flue-otel
+
+## 0.4.0
+
+### Minor Changes
+
+- 21f5bbb: Make the producing instrumentation's version detectable server-side. `@runtypelabs/flue-otel` now stamps `runtype.adapter.name` / `runtype.adapter.version` on each run's `invoke_agent` span, so a trace identifies its producer without the customer wiring `runtypeFlueResourceAttributes` into their SDK `Resource`. OTLP trace ingest resolves the pair (resource level first, envelope span second) and records it on the run's log row as `otlpAdapterName` / `otlpAdapterVersion`, regardless of logging policy.
+
+## 0.3.0
+
+### Minor Changes
+
+- 01df868: Add an opt-in `content` option that emits tool arguments (`gen_ai.tool.call.arguments`, at span open) and tool results (`gen_ai.tool.call.result`, before span end) on `execute_tool` spans, so a Flue run's tool cards in Runtype show their input and output. Off by default; per-kind switches, a per-value `maxChars` ceiling with an explicit truncation marker (clamped to the ingest per-attribute ceiling), and a `redact` hook. A failed tool's result, the host's shell call, and prompts/completions are still never sent.
+
+## 0.2.2
+
+### Patch Changes
+
+- 5f00348: Carry Workers AI `gatewayLogId` and `providerFinishReason` onto the chat span
+
+  Flue's `turn` event carries two allowlisted raw-provider fields that
+  `@runtypelabs/flue-otel` previously dropped. Both are now emitted on the `chat`
+  span as `runtype.*` extension attributes, gated on presence so an absent value
+  costs nothing:
+  - `runtype.gateway.log_id` — the response's own gateway log id (e.g.
+    Cloudflare AI Gateway's `cf-aig-log-id`), a pointer to the request in the
+    customer's own AI Gateway dashboard without shipping the content.
+  - `runtype.provider.finish_reason` — the provider's exact finish value before
+    normalization (e.g. Workers AI's `tool_calls` behind the normalized
+    `toolUse`), for diagnosis when a run stops unexpectedly.
+
+  Both attribute names are added to the shared `RUNTYPE_ATTRIBUTES` vocabulary
+  (`packages/shared/src/otlp-runtype-semconv.ts`) so the emit side and the ingest
+  side stay in step. They are additive diagnostics and do not count toward the
+  achieved fidelity tier.
+
+## 0.2.1
+
+### Patch Changes
+
+- 625c455: Rewrite the README from first principles. It now leads with install, quick
+  start and the no-SDK recipe, then configuration, attribution, shutdown, and
+  what the package emits, instead of narrating how the package differs from
+  earlier instrumentations.
+
+## 0.2.0
+
+### Minor Changes
+
+- 2439b84: New package: `@runtypelabs/flue-otel`, an OpenTelemetry instrumentation for Flue
+  agents that reports runs to Runtype at `t2-runtype` fidelity.
+
+  Stock `@flue/opentelemetry` already exports GenAI semconv spans, and the ingest
+  normalizer shipped in #7336 lifts those to t2 by reading Flue's own `flue.*`
+  identifiers. This package is the client-side complement, for the facts a
+  server-side normalizer structurally cannot reach:
+  - **Absolute loop position.** `runtype.turn.index` / `runtype.iteration` are
+    deliberately NOT derived at ingest, because Flue puts no absolute ordinal on
+    the wire and ranking opaque turn ids ranks whatever the export batch happened
+    to carry — a five-turn run whose closing batch holds two turns would be
+    recorded as two iterations. In process the count is exact.
+  - **A run-level usage roll-up on the envelope.** Summed from `turn` leaves, so a
+    split export cannot lose the total: the batch carrying the terminal carries
+    the complete sum by construction.
+  - **Per-agent attribution for N agents in one process**, via the span-level
+    `runtype.agent.id` placement, keyed by Flue agent name.
+  - **One `invoke_agent` span per trace.** Stock opens a nested one for every
+    `task` delegation, which is a coin flip over which invocation bounds the run
+    (ingest's envelope selection is first-match over exporter-controlled array
+    order). Here a delegation is reported as an `execute_tool` span typed
+    `subagent`, and the sub-agent's work gets a non-agent `flue.task` span.
+
+  Works on both Flue lines (`>=1.0.0-beta.9` and 2.x) from one entry point, via a
+  capability probe rather than version comparison. Depends on `@opentelemetry/api`
+  only — no SDK, no provider, no exporter, no flush; the application owns those.
+
+  Emits no content in this release: no prompts, completions, tool arguments or
+  results, error messages, or stack traces.
+
+  `@runtypelabs/shared` exports the wire stop-reason tuple as `WIRE_STOP_REASONS`
+  (the zod enum is now derived from it, so the two cannot disagree). The ingest
+  reader writes `runtype.stop_reason` to `agent_executions.stop_reason` verbatim
+  with no enum validation, so an external producer has to spell those six strings
+  itself; exporting the tuple is what lets the producer's contract test pin its
+  copy and turn a rename into a red build instead of a silently wrong column.
+
+### Patch Changes
+
+- 3b4f69c: License `@runtypelabs/flue-otel` under MIT rather than Apache-2.0, and ship the
+  license text in the published tarball.
+
+  The package declared `Apache-2.0` in `package.json` and in its README while
+  carrying no license file at all, so the published artifact asserted a grant
+  whose terms it never included. `LICENSE` is now added to `files`, matching how
+  every other published package here (`cli`, `python-sdk`, `ruby-sdk`,
+  `java-sdk`, `php-sdk`) ships its license.
+
+- 3b4f69c: Normalize package authorship and copyright metadata.
+
+  The `author` field reads `Runtype` rather than `Runtype Labs` across every
+  workspace package that set it, and the copyright holder in each license file is
+  now `Runtype, Inc` — replacing `Travrse Labs, Inc` in the CLI and the four Fern
+  SDKs, and the `Runtype Labs` that the new `flue-otel` license was written with.
+
+  Metadata only: no source, dependency, or behavior change.

package/README.md

@@ -106,7 +106,10 @@ subscriber. Its key is exported as `RUNTYPE_FLUE_INSTRUMENTATION_KEY`.
 
 - `runtypeFlueResourceAttributes({ agentId? })` builds the `runtype.*` resource
   attributes (`schema.version`, `adapter.name`, `adapter.version`, and
-  `agent.id` when given). Spread it into your SDK `Resource`.
+  `agent.id` when given). Spread it into your SDK `Resource`. The adapter pair
+  is also stamped on each run's `invoke_agent` span, so Runtype can tell which
+  version produced a trace even when the resource is not wired; the resource
+  placement still wins where both are present.
 - `GEN_AI` and `RUNTYPE`: the attribute-name constants this package emits by
   default; `GEN_AI_CONTENT`: the two it emits under the `content` opt-in.
 - `DEFAULT_CONTENT_MAX_CHARS` and `INGEST_CONTENT_ATTRIBUTE_CEILING`: the

package/dist/index.cjs

@@ -154,7 +154,7 @@ function isHighSurrogate(code) {
 }
 
 // package.json
-var version = "0.3.0";
+var version = "0.4.0";
 
 // src/semconv.ts
 var GEN_AI = {
@@ -340,7 +340,12 @@ function createFlueProjection(options = {}) {
           // any inbound id; it does not key the row, which stays derived from
           // the trace id.
           ...isEnvelope && event.submissionId ? { [RUNTYPE.executionId]: event.submissionId } : {},
-          ...isEnvelope && agentId ? { [RUNTYPE.agentId]: agentId } : {}
+          ...isEnvelope && agentId ? { [RUNTYPE.agentId]: agentId } : {},
+          // WHY(README.md): the resource placement is the customer's to wire and is routinely skipped.
+          ...isEnvelope ? {
+            [RUNTYPE.adapterName]: ADAPTER_NAME,
+            [RUNTYPE.adapterVersion]: ADAPTER_VERSION
+          } : {}
         }
       }
     ];

package/dist/index.mjs

@@ -118,7 +118,7 @@ function isHighSurrogate(code) {
 }
 
 // package.json
-var version = "0.3.0";
+var version = "0.4.0";
 
 // src/semconv.ts
 var GEN_AI = {
@@ -304,7 +304,12 @@ function createFlueProjection(options = {}) {
           // any inbound id; it does not key the row, which stays derived from
           // the trace id.
           ...isEnvelope && event.submissionId ? { [RUNTYPE.executionId]: event.submissionId } : {},
-          ...isEnvelope && agentId ? { [RUNTYPE.agentId]: agentId } : {}
+          ...isEnvelope && agentId ? { [RUNTYPE.agentId]: agentId } : {},
+          // WHY(README.md): the resource placement is the customer's to wire and is routinely skipped.
+          ...isEnvelope ? {
+            [RUNTYPE.adapterName]: ADAPTER_NAME,
+            [RUNTYPE.adapterVersion]: ADAPTER_VERSION
+          } : {}
         }
       }
     ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/flue-otel",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "OpenTelemetry instrumentation for Flue agents that emits GenAI semconv spans plus Runtype's runtype.* extension vocabulary, so a Flue run lands in Runtype at full fidelity.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -31,11 +31,11 @@
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/context-async-hooks": "^2.1.0",
     "@opentelemetry/sdk-trace-base": "^2.1.0",
+    "@runtypelabs/execution-ingest": "0.6.18",
+    "@runtypelabs/shared": "3.35.1",
     "tsup": "^8.0.2",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.0",
-    "@runtypelabs/execution-ingest": "0.6.12",
-    "@runtypelabs/shared": "3.32.0"
+    "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public"