add Tracer Span.addLinks, for dynamically linking spans

[tim-smart]

No description provided.

[changeset-bot]

🦋 Changeset detected

Latest commit: b629c90

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 36 packages

Name	Type
@effect/opentelemetry	Major
effect	Minor
@effect/cli	Major
@effect/cluster-browser	Major
@effect/cluster-node	Major
@effect/cluster-workflow	Major
@effect/cluster	Major
@effect/experimental	Major
@effect/platform-browser	Major
@effect/platform-bun	Major
@effect/platform-node-shared	Major
@effect/platform-node	Major
@effect/platform	Major
@effect/printer-ansi	Major
@effect/printer	Major
@effect/rpc-http	Major
@effect/rpc	Major
@effect/sql-clickhouse	Major
@effect/sql-d1	Major
@effect/sql-drizzle	Major
@effect/sql-kysely	Major
@effect/sql-libsql	Major
@effect/sql-mssql	Major
@effect/sql-mysql2	Major
@effect/sql-pg	Major
@effect/sql-sqlite-bun	Major
@effect/sql-sqlite-do	Major
@effect/sql-sqlite-node	Major
@effect/sql-sqlite-react-native	Major
@effect/sql-sqlite-wasm	Major
@effect/sql	Major
@effect/typeclass	Major
@effect/vitest	Major
@effect/ai	Major
@effect/ai-anthropic	Major
@effect/ai-openai	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[mikearnaldi]

maybe Effect.spanAddLink(), or even Effect.link()

[tim-smart]

maybe Effect.spanAddLink(), or even Effect.link()

We already have:

• Effect.linkSpan
• Effect.annotateSpan
• Effect.annotateCurrentSpan

So we just need an api for linking to the current span (not regional)

Effect.linkCurrentSpan or Effect.linkToCurrentSpan were some options.

[mikearnaldi]

• Effect.linkSpan

we don't have Effect.linkSpan we have Effect.linkSpans, we will need to re-think naming in 4.0 as it's very unclear from the name what Effect.linkSpans does, probably something like Effect.addLinkToChildSpans or similar