feat: bump versions to 1.15.15

[joaomdmoura]

Note

Medium Risk
Expands default telemetry collection for flows, a privacy-sensitive area, though method names, errors, and flow state are explicitly excluded. Changes event-listener wiring that runs on every flow execution.

Overview
Previously, flows only reported that they started. Finish, fail, pause, resume, method-failure, and input events reached the console and stopped there. This wires those lifecycle signals into telemetry and tags each flow as internal (agent executor, memory encode/recall) or user-authored so internal bookkeeping no longer swamps daily counts.

New spans and features

• Flow Completed with duration_ms and outcome (completed/failed), emitted separately from start so aborted runs still count
• Flow Paused and Flow Method Failed (flow name only — no method names or error text)
• Feature usage for HITL pause, input requested/received, and conversation-turn failure
• Start spans now carry origin and a string resumed flag (keyed off pending feedback, not checkpoint restore)

Marks AgentExecutor, EncodingFlow, and RecallFlow with is_crewai_internal. Documents the new defaulted Flow Lifecycle Signals row in telemetry docs (EN/AR/KO/PT-BR). Bumps all packages to 1.15.15.

^{Reviewed by Cursor Bugbot for commit 77c68bd. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
crewai	🟡 Building	–	Aug 12, 2026, 1:02 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[coderabbitai]

📝 Walkthrough

Walkthrough

Changes

Flow telemetry

Layer / File(s)	Summary
Telemetry contracts and runtime state lib/crewai/src/crewai/telemetry/telemetry.py, lib/crewai/src/crewai/flow/runtime/__init__.py, lib/crewai/src/crewai/experimental/agent_executor.py, lib/crewai/src/crewai/memory/*	Telemetry spans now record flow origin, resume state, completion duration, outcomes, pauses, and method failures. Runtime classes track internal-flow status and telemetry state.
Lifecycle event handling lib/crewai/src/crewai/events/event_listener.py	Flow events now emit telemetry for starts, resumes, completions, failures, pauses, inputs, conversation failures, and method failures.
Lifecycle telemetry validation lib/crewai/tests/telemetry/test_flow_telemetry.py, lib/crewai/tests/telemetry/test_telemetry.py, lib/crewai/tests/utilities/test_events.py	Tests cover outcomes, duration, privacy, origin, resume behavior, suppression behavior, and checkpoint restoration.
Telemetry documentation docs/edge/*/telemetry.mdx	Localized documentation describes flow lifecycle signals and recorded or excluded data.

Release metadata alignment

Layer / File(s)	Summary
Package version updates lib/cli/src/crewai_cli/__init__.py, lib/crewai-core/src/crewai_core/__init__.py, lib/crewai-files/src/crewai_files/__init__.py, lib/crewai-tools/src/crewai_tools/__init__.py, lib/crewai/src/crewai/__init__.py, lib/devtools/src/crewai_devtools/__init__.py	Package versions are updated from 1.15.14 to 1.15.15.
Dependency pin updates lib/cli/pyproject.toml, lib/crewai-tools/pyproject.toml, lib/crewai/pyproject.toml	Dependency pins are updated to 1.15.15.

Sequence Diagram(s)

sequenceDiagram
  participant Flow
  participant FlowEventListener
  participant Telemetry
  Flow->>FlowEventListener: Emit flow start or resume
  FlowEventListener->>Telemetry: Record Flow Execution
  Flow->>FlowEventListener: Emit pause, input, or failure
  FlowEventListener->>Telemetry: Record lifecycle signal
  Flow->>FlowEventListener: Emit completion or failure
  FlowEventListener->>Telemetry: Record duration and outcome

Loading

Suggested reviewers: lucasgomide, lorenzejay

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 35.23% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the version bump, which is a real part of the changeset, but it does not mention the primary telemetry changes.
Description check	✅ Passed	The description clearly explains the flow telemetry changes, privacy behavior, internal-flow tagging, documentation updates, and version bump.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/bump-version-1.15.15

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 77c68bd. Configure here.}

[coderabbitai]

Actionable comments posted: 2

🧹 Nitpick comments (1)

lib/crewai/tests/telemetry/test_flow_telemetry.py (1)

409-439: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Share the StubLLM definition between the two Crew-based tests.

test_crewais_own_agent_executor_is_tagged_internal and test_infrastructure_flows_do_not_pollute_outcome_signals declare identical StubLLM classes and build the same agent, task, and crew. Extract a module-level StubLLM and a small _run_crew() helper.

♻️ Proposed refactor

# Module level, near the fixtures:
def _run_crew() -> None:
    """Run a minimal Crew so the internal AgentExecutor flow executes."""
    from crewai import Agent, Crew, Task
    from crewai.llms.base_llm import BaseLLM

    class StubLLM(BaseLLM):
        def __init__(self) -> None:
            super().__init__(model="stub-model")

        def call(self, messages, **kwargs) -> str:
            return "Final Answer: done"

        def supports_function_calling(self) -> bool:
            return False

        def supports_stop_words(self) -> bool:
            return False

        def get_context_window_size(self) -> int:
            return 8192

    agent = Agent(role="R", goal="G", backstory="B", llm=StubLLM())
    task = Task(description="Do it", expected_output="A result", agent=agent)
    Crew(agents=[agent], tasks=[task]).kickoff()

Both tests then call _run_crew() in place of the duplicated block.

Also applies to: 552-590

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@lib/crewai/tests/telemetry/test_flow_telemetry.py` around lines 409 - 439,
Extract the duplicated StubLLM definition and Crew setup from
test_crewais_own_agent_executor_is_tagged_internal and
test_infrastructure_flows_do_not_pollute_outcome_signals into a module-level
StubLLM and a _run_crew() helper. Keep the helper’s behavior identical, then
replace both inline setup blocks with _run_crew() calls.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/edge/en/telemetry.mdx`:
- Line 64: Update the Flow Lifecycle Signals privacy statement to acknowledge
that flow_name is retained and users must keep flow names free of personal
information, while preserving that method names and error messages are not
recorded. Apply equivalent wording in docs/edge/en/telemetry.mdx lines 64-64,
docs/edge/ar/telemetry.mdx lines 64-64, docs/edge/ko/telemetry.mdx lines 62-62,
and docs/edge/pt-BR/telemetry.mdx lines 64-64.

In `@lib/crewai/tests/telemetry/test_flow_telemetry.py`:
- Around line 220-234: Update StubProvider.request_input in
test_requesting_input_reports_both_sides to construct InputResponse with
text="typed answer" instead of the unsupported value argument, preserving the
existing telemetry assertions.

---

Nitpick comments:
In `@lib/crewai/tests/telemetry/test_flow_telemetry.py`:
- Around line 409-439: Extract the duplicated StubLLM definition and Crew setup
from test_crewais_own_agent_executor_is_tagged_internal and
test_infrastructure_flows_do_not_pollute_outcome_signals into a module-level
StubLLM and a _run_crew() helper. Keep the helper’s behavior identical, then
replace both inline setup blocks with _run_crew() calls.

🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 017a8a1f-9e5d-4ec6-a8aa-183c6aff3948

📥 Commits

Reviewing files that changed from the base of the PR and between 7642e61 and 77c68bd.

📒 Files selected for processing (22)

• docs/edge/ar/telemetry.mdx
• docs/edge/en/telemetry.mdx
• docs/edge/ko/telemetry.mdx
• docs/edge/pt-BR/telemetry.mdx
• lib/cli/pyproject.toml
• lib/cli/src/crewai_cli/__init__.py
• lib/crewai-core/src/crewai_core/__init__.py
• lib/crewai-files/src/crewai_files/__init__.py
• lib/crewai-tools/pyproject.toml
• lib/crewai-tools/src/crewai_tools/__init__.py
• lib/crewai/pyproject.toml
• lib/crewai/src/crewai/__init__.py
• lib/crewai/src/crewai/events/event_listener.py
• lib/crewai/src/crewai/experimental/agent_executor.py
• lib/crewai/src/crewai/flow/runtime/__init__.py
• lib/crewai/src/crewai/memory/encoding_flow.py
• lib/crewai/src/crewai/memory/recall_flow.py
• lib/crewai/src/crewai/telemetry/telemetry.py
• lib/crewai/tests/telemetry/test_flow_telemetry.py
• lib/crewai/tests/telemetry/test_telemetry.py
• lib/crewai/tests/utilities/test_events.py
• lib/devtools/src/crewai_devtools/__init__.py

[alex-clawd]

LGTM.