@atrim/instrument-node 0.7.1-dev.14fdea7.20260108232436 → 0.7.1-dev.764c183.20260110203528

package/target/dist/index.js

@@ -89,6 +89,25 @@ var AutoInstrumentationConfigSchema = z.object({
     // Naming rules (first match wins)
     rules: z.array(SpanNamingRuleSchema).default([])
   }).default({}),
+  // Span relationship configuration for forked fibers
+  // Controls how child fiber spans relate to their parent/forking context
+  span_relationships: z.object({
+    // Relationship type between forked fiber spans and their parent context
+    // - 'parent-child': Use parent-child relationship (default, traditional tracing)
+    //   Parent span shows child as nested. Works well with most observability tools.
+    // - 'span-links': Use span links (semantically correct for async forks per OTel spec)
+    //   Fibers get independent traces linked to parent. Better for long-running fibers.
+    // - 'both': Create parent-child AND add span links
+    //   Maximum visibility but may create redundant data.
+    type: z.enum(["parent-child", "span-links", "both"]).default("parent-child"),
+    // Custom attributes to add to span links (only used when type includes links)
+    link_attributes: z.object({
+      // Link type identifier
+      "link.type": z.string().default("fork"),
+      // Custom attributes (key-value pairs)
+      custom: z.record(z.string()).optional()
+    }).optional()
+  }).default({}),
   // Pattern-based filtering
   filter: z.object({
     // Only trace spans matching these patterns (empty = trace all)