langgenius/dify

[Refactor/Chore] migrate to TypedDict

Open

#32863 opened on Mar 2, 2026

View on GitHub
 (46 comments) (1 reaction) (4 assignees)TypeScript (141,412 stars) (22,210 forks)batch import
good first issue🙏 help wanted

Description

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • This is only for refactors or chores; if you would like to ask a question, please head to Discussions.
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：）
  • Please do not modify this template :) and fill in all the required fields.

Description

now codebase is full of : dict, -> dict -> Mapping : Mapping

we should use TypedDict whenever possible.

@dosu give me a list of file need to change.

and show how to change.

Motivation

No response

Additional Context

No response

Contributor guide

Tech stack
python
Domain
backend
Issue type
refactor
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
blocked
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
PythonType hintsTypedDict
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
25
Research direction
The issue is to migrate all plain `dict`, `Mapping` type hints to TypedDict across the Python codebase. The issue has 4 assignees and 46 comments, indicating it is actively claimed and discussed. A first time contributor should instead look for issues with no assignees or a 'help wanted' label. The migration involves identifying function signatures and variable annotations using `dict` or `Mapping` and replacing them with specific TypedDict classes. Example files to examine are in core modules; see the issue for discussion.