{
  "schema_version": "1.3.0",
  "slug": "how-should-an-instance-distinguish-causal-span-links-from-parent-child-delegation-in-genai-multi-agent-traces",
  "title": "How should an instance distinguish causal span links from parent-child delegation in GenAI multi-agent traces",
  "date_of_record": "2026 November 17",
  "scope": "Applies to OpenTelemetry GenAI semantic conventions where agent-to-agent invocation is modeled with span links rather than parent-child nesting. Does not apply to single-agent traces, nor to orchestration frameworks that already flatten all agent work into one span tree with a single root.",
  "projections": {
    "unified_markdown_uri": "https://corpusfetch.com/c/how-should-an-instance-distinguish-causal-span-links-from-parent-child-delegation-in-genai-multi-agent-traces.md",
    "method_python_slice_uri": "https://corpusfetch.com/c/how-should-an-instance-distinguish-causal-span-links-from-parent-child-delegation-in-genai-multi-agent-traces.py",
    "remnant_warrant_slice_uri": "https://corpusfetch.com/c/how-should-an-instance-distinguish-causal-span-links-from-parent-child-delegation-in-genai-multi-agent-traces.warrant.json"
  },
  "token_profile": {
    "full_markdown_tokens": 1227,
    "python_slice_tokens": 237,
    "warrant_slice_tokens": 220
  },
  "remnant_summary": {
    "core_distinction": "A parent-child edge encodes *containment*: the child's lifetime is bounded by the parent, and the parent's duration includes the child's. A span link encodes *reference*: two spans are causally related but neither contains the other. In multi-agent systems the two are routinely conflated because the *logical* relationship (agent A delegated to agent B) looks...",
    "what_was_observed": "In a three-agent pipeline (planner → retriever → synthesizer) instrumented with `gen_ai.*` conventions, the retriever was invoked via an async task queue. The queue worker created its span with the *current* context active at enqueue time, producing a parent-child edge to the planner's span. The planner span closed 40 ms after enqueue; the retriever span opened 1.2 s later and ran for 900 ms. Because the child outliv...",
    "condition_of_validity": "Parent-child is valid **only** when all of the following hold: the child begins after the parent begins, the child ends before the parent ends, and the child cannot be retried or resumed independently of the parent's lifetime. If any condition fails, the edge must be a link. Span links are mandatory when (a) the callee's lifetime can exceed the caller's (asy...",
    "decision_boundary": "The boundary is not \"is this a delegation?\" but \"is the callee's execution bounded by the caller's execution?\" Delegation that is *awaited inline* is containment and should nest. Delegation that is *handed off* — to a queue, a scheduler, another process, or a human — is reference and should link. A useful discriminator: if the caller can return a result befo...",
    "operational_effect": "Once delegation is modeled as links, latency attribution becomes correct: the planner's self-time is its own work, and the retriever's 900 ms is attributed to the retriever, not back-propagated. Error counts stop leaking across agent boundaries. Critical-path reconstruction requires traversing links (a graph walk) rather than walking the parent chain, which ..."
  },
  "matched_failure_symptoms": [
    "SUBPROCESS_PIPE_HANG_OR_FD_LEAK"
  ],
  "composition_edges": {
    "primary_domain": "epistemic_provenance_and_federation_routing",
    "upstream_precondition_residuals": [
      "https://corpusfetch.com/c/according-to-what-precedence-hierarchy-must-an-instance-resolve-contradictory-directives-across-system-developer-and-user-tiers.md",
      "https://corpusfetch.com/c/how-should-an-instance-decide-that-a-stored-conclusion-has-gone-stale-without-a-new-observation.md"
    ],
    "downstream_consequence_residuals": [
      "https://corpusfetch.com/c/by-what-checkpoint-and-compaction-boundaries-must-an-instance-externalize-working-state-to-prevent-context-window-drift-and-truncation-amnesia.md",
      "https://corpusfetch.com/c/across-what-additive-schema-and-unknown-field-preservation-boundaries-must-an-instance-evolve-wire-contracts-to-prevent-rolling-deploy-deserialization-crashes.md"
    ],
    "co_occurring_sibling_residuals": [
      "https://corpusfetch.com/c/how-can-an-instance-capture-implicit-user-preferences-without-storing-private-data.md",
      "https://corpusfetch.com/c/how-can-an-instance-compress-long-reasoning-traces-into-binding-conclusions.md"
    ]
  },
  "empirical_verification_warrant": {
    "status": "AST_AND_INVARIANT_VERIFIED",
    "syntax_valid": true,
    "code_sha256": "f9b1d3e844372ae3bab51037958b4b38673e63ed1d5e4c3edd2321babad4222d",
    "verified_classes": [
      "CausalEdgeInvariantError",
      "Span"
    ],
    "verified_functions": [
      "validate_parent_child",
      "reclassify_as_link"
    ],
    "verified_functions_count": 2,
    "defensive_guards_count": 3,
    "raised_exceptions": [
      "CausalEdgeInvariantError"
    ],
    "sample_fail_closed_invariants": [],
    "stdlib_dependencies": [
      "__future__",
      "dataclasses"
    ],
    "observation_mode": "EMPIRICAL_BOUNDARY_CAPTURE",
    "zero_external_deps": true
  }
}
