bytedance/deer-flow · error · HTTPException

str(exc)

Error message

str(exc)

What it means

Error "str(exc)" thrown in bytedance/deer-flow.

Source

Thrown at backend/app/gateway/routers/threads.py:534

    branched_from_message_id: str
    workspace_clone_mode: str
    # "seeded" | "skipped_empty" | "failed" — whether the parent history was
    # copied into the branch's run-event feed (see branch_thread).
    history_seed_mode: str


# ---------------------------------------------------------------------------
# Helpers
# ---------------------------------------------------------------------------


def _delete_thread_data(thread_id: str, paths: Paths | None = None, *, user_id: str | None = None) -> ThreadDeleteResponse:
    """Delete local persisted filesystem data for a thread."""
    path_manager = paths or get_paths()
    try:
        path_manager.delete_thread_dir(thread_id, user_id=user_id)
    except ValueError as exc:
        raise HTTPException(status_code=422, detail=str(exc)) from exc
    except FileNotFoundError:
        # Not critical — thread data may not exist on disk
        logger.debug("No local thread data to delete for %s", sanitize_log_param(thread_id))
        return ThreadDeleteResponse(success=True, message=f"No local data for {thread_id}")
    except Exception as exc:
        logger.exception("Failed to delete thread data for %s", sanitize_log_param(thread_id))
        raise HTTPException(status_code=500, detail="Failed to delete local thread data.") from exc

    logger.info("Deleted local thread data for %s", sanitize_log_param(thread_id))
    return ThreadDeleteResponse(success=True, message=f"Deleted local thread data for {thread_id}")


async def _fetch_raw_pending_writes(checkpointer: Any, config: dict[str, Any]) -> list[Any]:
    """Fetch pending writes attached to a specific checkpoint.

    Snapshot ``tasks`` only reflect writes that were pending while a task was
    still scheduled; writes attached to the latest checkpoint afterwards
    (rollback reattachment, worker error fallback) never surface there, so the

View on GitHub (pinned to 1dd6ba1acb)

Solutions

1. Check the Gateway logs for the full exception behind str(exc).
2. Verify the request parameters (thread id, pagination cursor) are valid and retry.

When it happens

Trigger: Thrown at backend/app/gateway/routers/threads.py:534 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of bytedance/deer-flow@1dd6ba1acb (2026-08-14). Data as JSON: /api/errors/451f276f4b149d29. Report an issue: GitHub.