refactor(web): remove variable inspect panel React.FC

.agents/skills/e2e-cucumber-playwright/SKILL.md

@@ -7,14 +7,12 @@ description: Use when writing, changing, or reviewing Cucumber and Playwright te
 
 `e2e/AGENTS.md` owns the suite architecture, lifecycle, commands, tags, generated-client boundaries, fixtures, and cleanup contracts. Read the nearest feature-scoped `AGENTS.md` when one exists. This skill adds no parallel package policy.
 
-Cucumber owns scenario and hook execution and reporting. Playwright provides browser automation, contexts, pages, locators, actions, assertions, request, and tracing APIs; protocol exceptions remain with the package-defined owner. Their timeout domains remain separate, and importing from `@playwright/test` does not make Playwright Test runner configuration, fixtures, or retries applicable to this suite.
-
 ## Topic Routing
 
 Read only the bundled reference required by the change:
 
 - Locator, assertion, isolation, or waiting decisions: [`references/playwright-best-practices.md`][playwright]
-- Scenario wording, step granularity, expressions, World state, hook visibility, or tag design: [`references/cucumber-best-practices.md`][cucumber]
+- Scenario wording, step granularity, expressions, or tag design: [`references/cucumber-best-practices.md`][cucumber]
 
 Check current official Playwright or Cucumber documentation before introducing a framework pattern that local code and references do not already establish.
 
@@ -25,7 +23,7 @@ Check current official Playwright or Cucumber documentation before introducing a
 3. Read the target scenario, matching step definitions, and lifecycle files only when session or shared state matters.
 4. Reuse an existing step when wording and behavior match; add one coherent scenario or step when they do not.
 5. Keep browser actions and assertions at the public user boundary; keep setup, seed, polling, and cleanup at their package-defined owners.
-6. For changes, run the narrowest tagged scenario and package checks documented in `e2e/AGENTS.md`; broaden only for shared hooks, tags, or support changes.
+6. Run the narrowest tagged scenario and package checks documented in `e2e/AGENTS.md`; broaden only for shared hooks, tags, or support changes.
 
 For review requests, lead with reproducible correctness failures, flake sources, or demonstrated architecture drift. Report the behavior verified and any external-runtime, browser, or environment gap.
 

.agents/skills/e2e-cucumber-playwright/references/cucumber-best-practices.md

@@ -4,18 +4,15 @@ Use this reference when writing or reviewing Gherkin scenarios, step definitions
 
 Official sources:
 
-- https://cucumber.io/docs/bdd/better-gherkin
-- https://cucumber.io/docs/gherkin/reference
-- https://cucumber.io/docs/gherkin/step-organization
-- https://cucumber.io/docs/cucumber/state
+- https://cucumber.io/docs/guides/10-minute-tutorial
+- https://cucumber.io/docs/cucumber/step-definitions
 - https://cucumber.io/docs/cucumber/cucumber-expressions
-- https://github.com/cucumber/cucumber-js/blob/main/docs/support_files/world.md
 
 ## What Matters Most
 
 ### 1. Treat scenarios as executable specifications
 
-Cucumber scenarios should usually describe behavior declaratively, not reproduce an interaction script.
+Cucumber scenarios should describe examples of behavior, not test implementation recipes.
 
 Apply it like this:
 
@@ -23,15 +20,11 @@ Apply it like this:
 - avoid UI-internal wording such as selector details, DOM structure, or component names
 - keep language concrete enough that the scenario reads like living documentation
 
-Procedural detail is appropriate when the interaction mechanism is the behavior under test, such as keyboard navigation, focus movement, or a required multi-actor sequence.
-
 ### 2. Keep scenarios focused
 
-A scenario should prove one business rule or coherent outcome. Cucumber's three-to-five-step recommendation is a review heuristic, not a hard limit: when a scenario is longer, check for multiple outcomes, incidental setup, or UI procedure that can move behind a domain step.
+A scenario should usually prove one workflow or business outcome. If a scenario wanders across several unrelated behaviors, split it.
 
-Use `Given` for initial context, `When` for the event, and `Then` for the expected outcome. Restarting those phases is a prompt to review the narrative, not an automatic failure. Avoid hidden dependencies on another scenario's side effects.
-
-Use `Rule` when several examples illustrate one named business rule. Use a short `Background` only for shared context the reader needs to understand; do not hide fixture preparation, runtime readiness, or long setup there.
+Keep each scenario centered on one coherent outcome. Avoid hidden dependencies on another scenario's side effects, and keep unavoidable setup outside the behavior narrative unless the precondition matters to the specification.
 
 ### 3. Reuse steps, but only when behavior really matches
 
@@ -52,8 +45,6 @@ Write a new step when:
 
 Do not optimize for a low step count by making vague steps. Optimize for a small set of truthful, domain-owned steps.
 
-Step definitions share one global matching namespace regardless of their directory. Organize them by domain capability and avoid feature-coupled glue or expressions broad enough to overlap unrelated behavior.
-
 ### 4. Prefer Cucumber Expressions
 
 Use Cucumber Expressions for parameters unless regex is clearly necessary.
@@ -71,24 +62,18 @@ Use regex for a bounded natural-language alternative only when it keeps Gherkin
 
 ### 5. Keep step definitions thin and meaningful
 
-Step definitions are glue between Gherkin and automation, not a second abstraction language. A step should express one coherent domain action or outcome; it may call several implementation helpers when that keeps UI mechanics out of the specification.
+Step definitions are glue between Gherkin and automation, not a second abstraction language.
 
-Cucumber creates a new World for each scenario. Keep scenario state there rather than in module globals. Cucumber.js supports a `world` proxy for arrow functions, but this suite consistently uses typed `async function (this: DifyWorld, ...)` so ownership and TypeScript discovery remain explicit.
-
-Hooks are invisible to feature readers. Keep them for low-level browser lifecycle, cleanup, and diagnostics; express business-relevant context in Gherkin.
+Keep each step to one user-visible action or assertion. In JavaScript and TypeScript, use `async function` when the step reads Cucumber World state because Cucumber binds `this`; do not leak state across scenarios through module globals.
 
 ### 6. Use tags intentionally
 
-Tags may communicate stable capability grouping, selection, fixture dependency, or conditional-hook intent. A tag changes runtime behavior only when a runner, seed profile, or hook owns that meaning.
+Tags should communicate selection or execution intent, not become ad hoc metadata. A tag does not change runtime behavior unless configuration or hooks implement it.
 
 ## Review Questions
 
 - Does the scenario read like a real example of product behavior?
-- Does it prove one outcome, or combine several independent phases?
 - Are the steps behavior-oriented instead of implementation-oriented?
-- Is procedural wording necessary to the behavior being tested?
 - Is a reused step still truthful in this feature?
-- Could a new expression overlap an existing step in the global namespace?
-- Would `Rule` clarify the business rule, or would `Background` hide important setup?
 - Is a new tag documenting real behavior, or inventing semantics that the suite does not implement?
 - Would a new reader understand the outcome without opening the step-definition file?

.agents/skills/e2e-cucumber-playwright/references/playwright-best-practices.md

@@ -6,12 +6,8 @@ Official sources:
 
 - https://playwright.dev/docs/best-practices
 - https://playwright.dev/docs/locators
-- https://playwright.dev/docs/actionability
 - https://playwright.dev/docs/test-assertions
-- https://playwright.dev/docs/test-timeouts
 - https://playwright.dev/docs/browser-contexts
-- https://playwright.dev/docs/events
-- https://playwright.dev/docs/trace-viewer
 
 ## What Matters Most
 
@@ -25,22 +21,28 @@ Apply it like this:
 - keep scenario state in the runner's scenario-owned context rather than module globals
 - model special authentication or session setup through explicit per-scenario fixtures rather than shared mutable state
 
-### 2. Select locators by user contract
+### 2. Prefer user-facing locators
 
-Prefer built-in locators that match how the target is exposed to users:
+Playwright recommends built-in locators that reflect what users perceive on the page.
 
-- interactive controls: role and accessible name
-- form controls: associated label; use placeholder when it is the relevant stable contract, especially when no label exists
-- non-interactive content: visible text or the relevant text alternative
-- elements without a meaningful user-facing contract: an intentional test id
+Preferred order:
 
-This is a semantic choice, not a fixed ranking. Do not add incorrect roles or accessible names solely to satisfy a locator. When the product element should have user-facing semantics, fix that contract instead.
+1. `getByRole`
+2. `getByLabel`
+3. `getByPlaceholder`
+4. `getByText`
+5. `getByTestId` when an explicit test contract is the most stable option
 
 Avoid raw CSS/XPath selectors unless no stable user-facing contract exists and adding one is not practical.
 
-Locators are strict for single-element actions. Scope to a stable region or use `filter({ has, hasText })` to make the intended target unique. Treat `.first()`, `.last()`, or `.nth()` as a review signal: the positional choice should be intentional and stable, not merely silence ambiguity.
+Also remember:
 
-### 3. Use web-first assertions with the right timeout owner
+- repeated content usually needs scoping to a stable container
+- exact text matching is often too brittle when role/name or label already exists
+- `getByTestId` is acceptable when semantics are weak but the contract is intentional
+- when a real UI region, card, status, or icon lacks an accessible name, prefer adding that semantic contract in product code before falling back to `getByTestId`
+
+### 3. Use web-first assertions
 
 Playwright assertions auto-wait and retry. Prefer them over manual state inspection.
 
@@ -62,8 +64,6 @@ If a condition genuinely needs custom retry logic, use Playwright's polling/asse
 
 Use `expect.poll` for non-DOM truth such as API state, backend eventual consistency, generated resources, or captured browser events. For DOM state, use locator assertions so Playwright can apply actionability and web-first retry semantics.
 
-Cucumber step and hook timeouts, Playwright locator/action timeouts, and Playwright assertion timeouts are separate budgets. `browserContext.setDefaultTimeout()` does not change the default five-second assertion timeout. Put an explicit longer assertion timeout only on the readiness owner that needs it; do not raise an outer timeout to mask a shorter inner failure.
-
 ### 4. Let actions wait for actionability
 
 Locator actions already wait for the element to be actionable. Do not preface every click/fill with extra timing logic unless the action needs a specific visible/ready assertion for clarity.
@@ -77,20 +77,15 @@ Bad pattern:
 
 - stack arbitrary waits before every action
 - wait on unstable implementation details instead of the visible state the user cares about
-- use `force: true` to bypass a real hit-target, overlay, or disabled-state failure
-
-When synchronizing on a one-shot popup, download, request, or response, create the wait before triggering the action, then await the event. A scenario-owned listener may instead capture events for a later assertion. Do not use `networkidle` as an application-readiness assertion; wait for the user-visible state or owned backend contract.
 
 ### 5. Match debugging to the active harness
 
-Playwright supports traces, screenshots, page snapshots, and browser logs. Configure artifact capture in Cucumber hooks instead of adding parallel diagnostics to individual scenarios. If tracing is introduced, use `browserContext.tracing`; Playwright Test options such as `trace: 'on-first-retry'`, projects, workers, fixtures, reporters, and retries do not configure this harness.
+Playwright supports traces, screenshots, page snapshots, and browser logs. Configure artifact capture at the runner boundary instead of adding parallel diagnostics to individual scenarios.
 
 ## Review Questions
 
 - Would this locator survive DOM refactors that do not change user-visible behavior?
-- Is a positional locator expressing product order, or hiding an ambiguous match?
 - Is this assertion using Playwright's retrying semantics?
-- Does an explicit timeout belong to the condition that is actually slow?
-- Was an event wait registered before the action that emits it?
+- Is any explicit wait masking a real readiness problem?
 - Does this code preserve per-scenario isolation?
 - Is a new abstraction really needed, or does it bypass the runner's scenario-owned context and lifecycle?

.agents/skills/frontend-code-review/SKILL.md

@@ -27,7 +27,7 @@ Read only the packs matched by the diff:
 - Stable Dify runtime invariants in the named paths: [`references/dify-invariants.md`][dify-invariants]
 - General TypeScript or styling quality not owned above: [`references/code-quality.md`][code-quality]
 
-Read `packages/dify-ui/README.md`, `packages/dify-ui/AGENTS.md`, `packages/dify-ui/docs/overlays.md`, or `web/docs/test.md` only when the reviewed code falls under that contract. Check current official documentation when local code and bundled references do not settle a framework, browser, or accessibility behavior.
+Read `packages/dify-ui/README.md`, `packages/dify-ui/AGENTS.md`, `web/docs/overlay.md`, or `web/docs/test.md` only when the reviewed code falls under that contract. Check current official documentation when local code and bundled references do not settle a framework, browser, or accessibility behavior.
 
 ## Severity And Output
 

.agents/skills/frontend-code-review/references/accessibility-ui.md

@@ -2,8 +2,6 @@
 
 Accessibility findings are first-class review findings. Treat broken keyboard access, missing accessible names, focus loss, and unreachable popup content as correctness bugs, not polish.
 
-## Review Evidence
-
 Before finalizing UI or accessibility findings, fetch the latest Web Interface Guidelines as a required baseline:
 
 ```text
@@ -23,26 +21,13 @@ Flag:
 
 - Clickable `div` or `span` used for actions.
 - Router navigation implemented with button or `onClick` when a `Link` / `<a>` is the real semantic element.
-- Icon-only controls without an accessible name; follow the naming rules below and the Dify UI `IconButton` contract.
+- Icon-only buttons without `aria-label` or `aria-labelledby`.
 - Decorative icons missing `aria-hidden="true"`.
 - Images without `alt`; use `alt=""` only when truly decorative.
 - Heading levels that skip hierarchy in page-level content.
 
 Prefer semantic HTML before ARIA.
 
-## Accessible Names And Descriptions
-
-Read [Accessible names and descriptions] when a change affects labels, ARIA naming, help/error relationships, or hidden text. That document owns the shared implementation and review contract.
-
-Flag violations supported by the final rendered behavior:
-
-- Missing or insufficient names, redundant name overrides, or naming attributes prohibited by the element's role.
-- Overrides that omit visible label wording or suppress necessary descendant information.
-- Broken or stale label/description references, including relationships lost when responsive content or overlays unmount.
-- Descriptions used instead of names, repeated help text, or essential structured content available only as a flattened description.
-
-Inspect the computed name and description in the relevant state. Matching an `aria-label` string to nearby text alone does not prove redundancy.
-
 ## Keyboard And Focus
 
 Flag:
@@ -63,6 +48,7 @@ Flag:
 - Missing stable `name` on form fields that submit or validate.
 - Incorrect input `type`, `inputMode`, `autoComplete`, or `spellCheck` for email, token, URL, number, search, code, or username fields.
 - Labels that are not clickable.
+- Submit buttons disabled before a request starts, preventing normal submit behavior.
 - Non-submit buttons inside forms missing `type="button"`.
 - Errors not associated with fields or not reachable by screen readers.
 - Error recovery that does not focus or expose the first invalid field.
@@ -70,17 +56,13 @@ Flag:
 - Placeholder text used as the only label.
 - Password managers accidentally triggered on non-auth fields because autocomplete is missing or wrong.
 
-Prefer visible labels and associate them through the appropriate field primitive, a native `label`, or `aria-labelledby`. Do not duplicate an existing label with hidden text or `aria-label`; follow [Accessible names and descriptions] when no suitable visible label exists.
+Prefer visible labels. If visible surrounding text already labels the control, use a visually hidden label or a precise `aria-label`.
 
 ## Disabled, Loading, And Async States
 
 Flag:
 
-- Loading controls whose accessible name disappears, or whose user-relevant progress has no
-  feature-owned status path. Follow the Dify UI Button contract for focused loading buttons; do not
-  add `aria-busy` to a button as a generic pending-state substitute.
-- The same pending state passed to both Dify UI Button `loading` and `disabled`, which duplicates
-  state ownership and obscures whether `disabled` expresses independent unavailability.
+- Loading state without `aria-busy`, `role="status"`, or another accessible update path when it changes user interaction.
 - Spinner or decorative loading icon exposed to screen readers.
 - Disabled controls that hide the reason users cannot proceed.
 - `aria-disabled` used without manually blocking click, Space, and Enter.
@@ -125,5 +107,3 @@ Flag:
 - Images without dimensions.
 - Loading copy using `...` instead of `…`.
 - Hardcoded dates, times, numbers, or currency formats instead of `Intl.*`.
-
-[Accessible names and descriptions]: ../../../../packages/dify-ui/docs/accessible-names-and-descriptions.md

.agents/skills/frontend-code-review/references/component-architecture.md

@@ -12,9 +12,7 @@ Flag:
 - A page/tab-level section component becoming the data owner without needing a shared snapshot or shared loading/error/empty UI.
 - Feature code promoted to shared only because it appears once or might be reused later.
 
-Accept repeated TanStack Query hooks for the same key and input in Client Component siblings under one QueryClient;
-shared cache is not a reason to hoist. Separate Server Component QueryClients do not share it, so request-level
-deduplication needs an identified request-local cache or verified framework or transport owner.
+Accept repeated TanStack Query calls in siblings when each component independently consumes the data. Cache deduplication is not a reason to hoist by itself.
 
 ## Component Boundaries
 
@@ -63,7 +61,7 @@ Flag effects that:
 - Transform props/state for rendering.
 - Copy one state value into another representing the same concept.
 - Handle user actions that belong in event handlers.
-- Reset local state from props or visibility when derivation, a stable semantic identity, or the intended mounted owner already expresses the lifecycle.
+- Reset state from props when a keyed reset, stable ID, or render-time derivation would work.
 - Fetch data that belongs in framework APIs or TanStack Query.
 
 If an effect remains, it must synchronize with a named external system: browser API, subscription, timer, analytics-on-visibility, non-React widget, or imperative DOM integration.
@@ -73,24 +71,11 @@ If an effect remains, it must synchronize with a named external system: browser
 Flag:
 
 - Storing derived booleans, disabled flags, default tabs, or loading labels that can be calculated from current query/feature state.
-- Per-session state held by a longer-lived visibility coordinator and cleared through an open-state Effect or a generated key when the primitive's mounted-content lifecycle already matches the intended state lifetime.
-- A DOM field mirrored into competing prop, default, and React state sources when editing does not require those sources to synchronize.
 - Local state used to fake server data or generated contract fields.
 - UI state persisted to localStorage when it is live app state.
 - Feature-local mock shells wired to unrelated existing APIs before the real API is confirmed.
 
-Review state lifetime before its storage mechanism. For a hidden surface, distinguish the
-visibility coordinator from mounted content. State private to one mounted session belongs in that
-content owner; promote it only when the draft must survive that content owner's unmount or another
-owner coordinates it. A stable semantic identity key may create a new snapshot when the represented
-identity changes; a generated key is not a routine reset command.
-
-Prefer render-time derivation. Keep true local state for user choices, transient input, controlled
-popups, and feature UI state that has no server source. Submit-only DOM fields may remain
-uncontrolled; use local controlled state when React must own the current value to drive rendering
-or coordination. Observing change events or tracking a derived fact such as dirty state does not
-require mirroring the field value. Do not flag controlled state by itself without a concrete
-competing-source, stale-state, or ownership defect.
+Prefer render-time derivation. Keep true local state for user choices, transient input, controlled popups, and feature UI state that has no server source.
 
 ## Navigation
 

.agents/skills/frontend-code-review/references/data-query-contracts.md

@@ -22,22 +22,10 @@ Flag:
 - Fake fallback IDs or placeholder inputs used to force a query to run.
 - Query results copied into local state for rendering.
 - Shared query behavior such as invalidation, stale defaults, or retry rules reimplemented at call sites.
-- Deprecated imperative reads such as `fetchQuery`, `prefetchQuery`, `ensureQueryData`, or their infinite variants when
-  the current `query` or `infiniteQuery` contract applies.
+- `prefetchQuery` treated as a hard gate or as returning data/errors to the caller.
 
 Use `useQuery(consoleQuery.xxx.queryOptions(...))` or `useQuery(marketplaceQuery.xxx.queryOptions(...))` directly unless a feature hook performs real orchestration.
 
-For imperative access, treat the choices as independent dimensions:
-
-- `query` or `infiniteQuery` resolves the generated query and returns its data.
-- `staleTime` decides whether cached data satisfies this call: `0` treats it as stale, a finite value accepts a freshness
-  window, `Infinity` accepts it until invalidation, and `'static'` accepts available data even after invalidation.
-- `select` projects the resolved value without replacing cached query-function data. An imperative query defaults to no
-  retries when `retry` is not configured; `enabled` is observer-only, so guard before a conditional call.
-- `await` blocks the current flow, `return` transfers the Promise to the caller, and `void` discards the result without
-  handling rejection. Handle rejection before discarding a potentially rejecting Promise; use `.catch(noop)` only for
-  intentional silence or feedback owned elsewhere, and preserve rejection for hard gates.
-
 ## Mutations
 
 Flag:
@@ -56,18 +44,12 @@ Flag:
 
 - Request-time auth, setup, workspace role, or tenant decisions moved into static `next.config redirects()`.
 - Dynamic role gates depending on `workspaces.current` implemented as static path redirects.
-- Authorization logic depending on an imperative query whose rejection is swallowed.
+- Authorization logic depending on soft `prefetchQuery`.
 - Removing a client fallback before server API unavailable behavior is defined.
 - Global placeholder query contracts introduced to solve a route-local Suspense issue.
 - Branding-sensitive UI reading placeholder defaults without checking pending/placeholder state.
-- A Server Component rendering or passing an imperative query result that the browser can independently revalidate,
-  leaving server and client output with different owners.
-- A non-blocking Server Component query without pending-query dehydration, Next-compatible error redaction, a
-  `HydrationBoundary` covering the same-key client consumer, or an explicit Suspense and SSR-content decision.
 
-Hard gates await `query` or `infiniteQuery` and preserve rejection; soft prefetches handle failure at the fallback owner.
-Treat Server Components as prefetch-and-dehydrate owners by default, rendering returned data only under exclusive server
-ownership or a freshness contract that prevents server/client drift.
+Separate hard gates from soft prefetches. `fetchQuery` can be a server decision boundary; `prefetchQuery` is cache warmup.
 
 ## Workspace And Tenant
 

.agents/skills/frontend-code-review/references/dify-ui.md

@@ -1,29 +1,141 @@
-# Dify UI Review Routing
+# Dify UI Rules
 
-Use this reference when a review touches `packages/dify-ui/` or consumes
-`@langgenius/dify-ui/*`. It routes to owner documentation; it does not redefine package
-contracts.
+Use these rules whenever a review touches `packages/dify-ui/` or code consuming `@langgenius/dify-ui/*`.
 
-Read `packages/dify-ui/AGENTS.md` and the primitive implementation first, then only the matching
-owner:
+Before finalizing findings for those files, read the current local docs that apply:
 
-| Review area                                | Canonical owner                                                     |
-| ------------------------------------------ | ------------------------------------------------------------------- |
-| Package boundary and document routing      | `packages/dify-ui/AGENTS.md`                                        |
-| Imports, exports, public types, and anatomy | `packages/dify-ui/docs/authoring.md`                                 |
-| Button or icon-only actions                | `packages/dify-ui/src/button/README.md`, `packages/dify-ui/src/icon-button/README.md` |
-| Compound inputs                            | `packages/dify-ui/src/input-group/README.md`                         |
-| Forms and field semantics                  | `packages/dify-ui/docs/forms.md`                                     |
-| Selection and typed values                 | `packages/dify-ui/docs/selection.md`                                 |
-| Portals, layers, and floating surfaces     | `packages/dify-ui/docs/overlays.md`                                  |
-| Tailwind and radius tokens                 | `packages/dify-ui/docs/styling.md`                                   |
-| Package tests and Storybook                | `packages/dify-ui/docs/testing.md`                                   |
+- `packages/dify-ui/README.md`
+- `packages/dify-ui/AGENTS.md`
+- `web/docs/overlay.md` for floating UI
+- `packages/dify-ui/src/<primitive>/index.tsx` for the primitive being changed or consumed
 
-For consumer code under `web/`, also read `web/AGENTS.md` for application-owned reuse policy and
-`packages/dify-ui/README.md` for the available public subpaths.
+## Package Boundary
 
-Treat the implementation, public types, tests, and stories as evidence for the documented
-contract. If they disagree, identify the actual owner before reporting a finding. Read current
-official Base UI documentation and installed type declarations for upstream-derived behavior.
-Report only a reproducible contract violation or observable defect, not a preference inferred from
-this routing file.
+Flag in `packages/dify-ui`:
+
+- Imports from `web/`.
+- Dependencies on Next.js, i18n, ky, Jotai, Zustand, TanStack Query, oRPC, or business APIs.
+- Business-specific component behavior that belongs in `web/`.
+- Multiple unrelated primitives in one component folder.
+
+`packages/dify-ui` is a primitive layer: Base UI headless components + `cva` + `cn` + Dify design tokens.
+
+## Imports And Exports
+
+Flag:
+
+- Consumer imports from `@langgenius/dify-ui` without a subpath.
+- Missing `package.json#exports` entry for a new primitive.
+- Internal package imports using workspace subpaths instead of relative paths.
+- Exported props using internal-only types that consumers cannot import from the component subpath.
+- Canonical primitive boundaries or their associated public types using a redundant `Root` suffix when no higher-level convenience component exists in the same subpath.
+
+Consumers use subpath exports such as `@langgenius/dify-ui/button`.
+
+Canonical boundaries use the primitive name and matching public types (`Select` / `SelectProps`). Keep `Root` only to distinguish a low-level anatomy root from a higher-level convenience component (`CheckboxRoot` / `Checkbox`); implementation aliases should still show their Base UI source (`BaseSelect.Root.Props`).
+
+## Props And State
+
+Flag:
+
+- Flattened props where related values need a discriminated union, such as `value` / `defaultValue`, `multiple` / `value`, or `clearable` / `onChange`.
+- React state used only to mirror Base UI state for class names.
+- JavaScript conditional class logic for visual states that the Dify UI/Base UI primitive already exposes through `data-*` attributes or CSS variables.
+- Controlled props added when uncontrolled DOM state or CSS variables would be enough.
+- Thin wrappers that rename Base UI parts without adding semantics.
+- Generic Base UI selection primitives wrapped without preserving their value generics, such as `Select.Root<Value, Multiple>`, `RadioGroup<Value>`, or `Radio.Root<Value>`.
+- Shared select/radio option components that type selected values as `string` while callers pass enums, unions, booleans, numbers, objects, or nullable placeholder values.
+
+Prefer Base UI/Dify UI data attributes and CSS variables for visual state: `data-open`, `data-checked`, `data-disabled`, `data-highlighted`, `data-popup-open`, `group-data-*`, `peer-data-*`, `has-[:focus-visible]`, and primitive CSS variables such as anchor width or transform origin. Use JS conditional classes for product/business state that the primitive does not expose.
+
+For non-string `Select` and `RadioGroup` values, prefer explicit domain generics at the root and at child value carriers. JSX children do not inherit the parent generic, so `RadioGroup<PromptMode>` should compose with `Radio<PromptMode>`, `RadioItem<PromptMode>`, or option values from a typed collection. For `Select`, prefer the Base UI `items` collection pattern for typed value-to-label rendering, and flag string coercion helpers used only to recover display labels.
+
+## Forms
+
+Flag:
+
+- Form-like UI using unrelated `Input` and `Button` pieces without a submit boundary.
+- Text-like fields not composed through `Field`, `FieldLabel`, and `FieldControl` when using Dify UI form semantics.
+- Select fields using `FieldLabel` instead of `SelectLabel`.
+- Slider fields using a generic label instead of `SliderLabel`.
+- Checkbox/radio groups missing `Fieldset` and `FieldsetLegend`.
+- Field errors or descriptions rendered without `FieldDescription` / `FieldError` relationships.
+
+`Form` is the submit boundary. Dify UI form primitives are not a form state-management framework; business validation and schema-driven behavior belong in `web/`.
+
+## Overlay Contract
+
+Flag:
+
+- Legacy web overlay imports in new or modified code.
+- Manual portals around Dify UI overlay primitives.
+- Call-site `z-*` overrides on overlays.
+- Missing root `isolation: isolate` assumptions when debugging overlay stacking.
+- Repeated backdrop, z-index, or portal chrome at call sites.
+- Tooltip used for infotips, long text, or interactive content.
+
+All Dify UI body-portalled overlays use `z-50`. Toast uses `z-60`. DOM order handles stacking between overlays.
+
+## Primitive Selection
+
+Flag:
+
+- `Tabs` used for simple mode/filter/view selection where `SegmentedControl` is the semantic primitive.
+- `SegmentedControl` used where `tablist` / `tabpanel` semantics are required.
+- `Select` used for searchable or free-form input.
+- `Combobox` used for unrestricted search text where no selected option is remembered.
+- `Autocomplete` used for closed-list selection.
+- Tooltip or PreviewCard used for content that must be reachable on touch or by screen readers.
+
+Use:
+
+- `Autocomplete` for free-form text with optional suggestions.
+- `Combobox` for searchable selected values from a collection.
+- `Select` for closed, scannable option sets.
+- `Popover` for infotips, help text, rich content, or interactions.
+
+## Bad Usage Patterns To Flag
+
+Flag:
+
+- Manually recreating UI behavior or chrome already owned by `@langgenius/dify-ui/*` or `web/app/components/base/*`, such as buttons, inputs, toggle groups, popovers, dropdown menus, alert dialogs, switches, avatars, scroll areas, toasts, borders, focus states, disabled states, segmented controls, or existing feature components.
+- Styling a raw Base UI primitive directly in `web/` when a Dify UI primitive exists.
+- Wrapping a Dify UI primitive in a feature component that hides its label, error, disabled, or focus contract.
+- Replacing a semantic primitive with a generic `div` plus classes to match a screenshot.
+- Using `Tooltip` because it is visually convenient when the content is actually help text or needs touch access.
+- Adding a `z-*` override to make a child popup appear over a parent dialog.
+- Adding a new app-level wrapper around Dialog, Drawer, Popover, Select, or Combobox that repeats portal/backdrop/positioner logic.
+- Using dify-ui `Input` as a drop-in replacement for legacy inputs that include search, clear, copy, unit, localized placeholder, or number normalization behavior.
+- Building a form row from loose text and controls instead of the matching Field/Form primitives.
+- Adding component state only to style `data-open`, `data-checked`, `data-disabled`, or highlighted states that Base UI already exposes.
+- Passing booleans down only so children can toggle classes already expressible with primitive `data-*` selectors.
+
+## Tokens, Radius, And Styling
+
+Flag:
+
+- `radius-*` class names.
+- Custom Tailwind `borderRadius` extension for Figma radius values.
+- Generic colors where semantic Dify tokens exist.
+- Hardcoded design values where Dify tokens, component variants, or documented Figma radius mappings exist.
+- `!` important modifiers used to fight primitive styles instead of fixing the variant, selector, or component composition.
+- Manual class strings that duplicate primitive variants.
+- `min-w-(--anchor-width)` on picker popups when it defeats viewport clamping.
+
+Use the Figma radius mapping from `packages/dify-ui/README.md`; for example `--radius/sm` maps to `rounded-md`, and `--radius/md` maps to `rounded-lg`.
+
+Use `!` only for a tightly scoped compatibility override after confirming the primitive API, data attributes, and selector structure cannot express the state.
+
+## Focus Details
+
+Flag focus rings attached to the wrong element. For example, Base UI `Slider.Thumb` focuses an internal `input[type=range]`, so the visible thumb wrapper needs `has-[:focus-visible]` rather than direct wrapper `focus-visible`.
+
+## Custom SVG Icons
+
+Flag:
+
+- New generated React icon components or JSON files under `web/app/components/base/icons/src/...` for custom SVG icons.
+- Custom SVG icons consumed outside the Tailwind `i-custom-*` icon class pipeline.
+- Generated `packages/iconify-collections/custom-*/icons.json` diffs where unrelated existing icons lost or changed intrinsic `width` or `height`.
+
+New custom SVG icons belong in `packages/iconify-collections/assets/...`. Regenerate with `pnpm --filter @dify/iconify-collections generate`, validate with `pnpm --filter @dify/iconify-collections check:dimensions`, and consume the generated icon with Tailwind `i-custom-*` classes.

.agents/skills/frontend-code-review/references/testing.md

@@ -9,7 +9,6 @@ Flag missing coverage when a change alters a reachable contract such as:
 - User interaction, navigation, form submission, validation, or permissions.
 - Query or mutation behavior, URL state, persistence, or one-shot signals.
 - Loading, error, empty, and recovery states that users can encounter.
-- A hidden surface whose close-and-reopen behavior changes whether in-progress state resets or persists.
 - Accessibility-critical labels, keyboard flow, focus, disabled state, or overlay behavior.
 - A regression-prone business rule or bug fix that can be reproduced through a public boundary.
 

.agents/skills/frontend-testing/SKILL.md

@@ -13,4 +13,4 @@ description: Use when writing or changing Vitest or React Testing Library tests
 4. Run the focused spec before the affected suite and relevant static checks.
 5. Report the behavior verified and any remaining browser, visual, or end-to-end risk.
 
-Recommend deleting low-value tests as readily as adding missing behavior coverage. Use `web/docs/test.md` for policy and Web commands; use `packages/dify-ui/docs/testing.md` for Dify UI commands.
+Recommend deleting low-value tests as readily as adding missing behavior coverage. Use `web/docs/test.md` for policy and Web commands; use the `packages/dify-ui/README.md` Development section for Dify UI commands.

.agents/skills/how-to-write-component/SKILL.md

@@ -9,11 +9,10 @@ Use this skill to route component architecture decisions to its bundled referenc
 
 ## First Decisions
 
-| Question | Default | Choose differently when |
+| Question | Default | Promote only when |
 | --- | --- | --- |
 | Where should code live? | In the product workflow, route, or feature owner. | Several verticals need the same stable contract. |
-| Who owns state and handlers? | The lowest owner that consumes them and whose lifetime matches the state. | Another owner coordinates the value or it must survive the local owner's unmount. |
-| Should React control a value? | Leave submit-only DOM fields uncontrolled. | The workflow must own the current value to drive rendering or coordination. |
+| Who owns state and handlers? | The lowest visual owner that consumes them. | A parent coordinates one workflow or consistent snapshot. |
 | Should state enter Jotai? | Keep component and form state local. | Siblings need one source of truth or scoped workflow persistence. |
 | Who owns URL state? | Next.js route APIs and `nuqs`. | Atoms require a read-only route-identity bridge. |
 | Who owns remote state? | TanStack Query at the lowest consumer. | Atom state drives the query or shared derivations consume it. |
@@ -25,20 +24,15 @@ Use this skill to route component architecture decisions to its bundled referenc
 - Component moves, module boundaries, props, types, or owner placement: read [`references/ownership.md`][ownership].
 - Jotai, form drafts, route identity, URL state, or persistence: read [`references/state.md`][state].
 - Generated contracts, nullable API data, Query, mutations, SSR, auth, or workspace state: read [`references/data.md`][data].
-- Hotkeys, focus, dialogs, menus, popovers, or other secondary surfaces: read [`references/interactions.md`][interactions] and the overlay guide it references when applicable. Also read [`references/state.md`][state] when the surface owns a draft or other local session state.
+- Hotkeys, focus, dialogs, menus, popovers, or other secondary surfaces: read [`references/interactions.md`][interactions] and the overlay guide it references when applicable.
 - Effects, navigation, memoization, preloading, or render cost: read [`references/runtime.md`][runtime].
 
 ## Workflow
 
-1. Identify the behavior owner, the required state lifetime, and the public contract being changed.
+1. Identify the behavior owner and the public contract being changed.
 2. Read the nearby implementation, tests, and only the routed skill references.
 3. Implement one coherent vertical slice. Do not expand into equivalent patterns elsewhere unless the current contract cannot be completed without them.
-4. Verify observable behavior at the narrowest sufficient boundary, then run the checks documented by the owning package: `web/docs/test.md` or `web/docs/lint.md` for Web, and `packages/dify-ui/docs/testing.md` for Dify UI.
-
-## Tailwind CSS
-
-- Write canonical Tailwind v4 classes; prefer canonical utilities over equivalent arbitrary values.
-- Common forms include `w-105` instead of `w-[420px]`, `px-2.25` instead of `px-[9px]`, `bg-linear-to-b` instead of `bg-gradient-to-b`, `wrap-break-word` instead of `break-words`, and `field-sizing-content` instead of `[field-sizing:content]`.
+4. Verify observable behavior at the narrowest sufficient boundary, then run the checks documented by the owning package: `web/docs/test.md` or `web/docs/lint.md` for Web, and the `packages/dify-ui/README.md` Development section for Dify UI.
 
 [data]: references/data.md
 [interactions]: references/interactions.md

.agents/skills/how-to-write-component/references/data.md

@@ -18,9 +18,7 @@ Read this document when a component consumes generated contracts, nullable API v
 - If query input comes from atom state, keep it in `atomWithQuery`; do not unwrap the atom in a component solely to call `useQuery`.
 - For missing required input, branch the whole generated input with `skipToken`. Add `enabled` only for an independent execution condition; do not put `skipToken` inside a placeholder payload or coerce IDs to empty strings.
 - Return generated `queryOptions()`, `infiniteOptions()`, or `mutationOptions()` directly from TanStack Query atoms. Pass supported options into the generated call instead of spreading into a parallel object.
-- For the same logical request, preserve key, input, operation, and result contracts. Reuse exact options only when
-  transport, context, and cache policy are shared; imperative and observer freshness may differ. Do not extract a helper
-  merely to reuse input construction.
+- Share the exact options between prefetch and render when they represent the same request. Do not extract option helpers merely to reuse input construction.
 - Avoid pass-through service hooks that only rename generated options. Keep feature hooks for actual orchestration or shared domain behavior.
 
 ## Mutations And Cache
@@ -33,21 +31,12 @@ Read this document when a component consumes generated contracts, nullable API v
 ## Prefetch And Hidden Surfaces
 
 - Prefetch expensive secondary content from the trigger or menu-open event when it benefits the visible path. Do not mount hidden subscribers solely to warm the cache.
-- Use `query` or `infiniteQuery` for imperative access. `staleTime` defines cache acceptance; `select` projects the return
-  value without replacing cached query-function data. Imperative queries default to no retries when `retry` is not
-  configured, and observer-only `enabled` does not prevent an imperative call.
-- `await` blocks, `return` transfers the Promise, and `void` discards its value without handling rejection. Handle
-  rejection before discarding a potentially rejecting Promise; use `.catch(noop)` only for intentional silence or
-  feedback owned elsewhere. Hard server gates await the query and preserve rejection.
+- `prefetchQuery` is cache warmup, not an authorization or availability gate. Use a hard fetch boundary when the server must decide whether rendering may proceed.
 
 ## SSR, Authentication, And Workspace
 
 - Static configuration owns path-invariant routing. Request-dependent authentication, setup, role, and tenant decisions belong to SSR or runtime decision boundaries.
 - Distinguish soft SSR cache warming from authoritative decisions. Prefetched or placeholder data must not grant access or represent successful availability.
-- Treat Server Components as query prefetch-and-dehydrate owners by default. Do not render or pass an imperative query
-  result when a browser observer can revalidate the same data unless ownership and freshness explicitly prevent drift.
-- Non-blocking RSC streaming requires pending-query dehydration without redacting Next.js server errors, a
-  `HydrationBoundary` around the same-key client consumer, and Suspense when that content must be server-rendered.
 - Never reuse tenant-scoped state after switching workspaces. Discard it at the switch boundary or isolate it by workspace identity.
 - Do not make product or authorization decisions from bootstrap defaults. Wait for authoritative data, or render an explicit loading or error state.
 - Keep loading and Suspense behavior inside the feature that owns the request. Do not add fake global data merely to bypass that boundary.

.agents/skills/how-to-write-component/references/interactions.md

@@ -1,6 +1,6 @@
 # Component Interactions And Overlays
 
-Read this document when a change involves application hotkeys, focus, dialogs, menus, popovers, or other secondary surfaces. Overlay primitive selection and layering are owned by the [overlay contract].
+Read this document when a change involves application hotkeys, focus, dialogs, menus, popovers, or other secondary surfaces. Overlay primitive selection and layering are owned by the [overlay guide].
 
 ## Focus And Semantics
 
@@ -20,13 +20,12 @@ Read this document when a change involves application hotkeys, focus, dialogs, m
 
 ## Secondary Surfaces
 
-- Follow the [overlay contract] for primitive choice and shared mechanics. The nearest consumer `AGENTS.md` owns application-specific composite reuse policy.
+- Follow `web/docs/overlay.md` for primitive choice. Dify UI primitives are the default, with package-approved Web wrappers such as `Infotip` where the overlay guide allows them.
 - Separate behavior ownership from placement ownership: the action may own trigger, open state, and menu content while the caller owns slots, offsets, and alignment.
 - Keep menu and dialog surfaces as siblings when a menu command opens a dialog. Mount the dialog outside popup content.
-- Keep overlay open-state ownership separate from content-session ownership. A controlled root does not require controlled fields or root-owned drafts.
-- Match transient state to the primitive's content mount lifecycle. State below an unmounting content boundary gets a fresh instance after unmount; intentionally kept-mounted content needs an explicit persistence or reset policy.
-- Keep a controlled overlay root at its coordination owner so the primitive can complete exit transitions, focus restoration, and detached-handle behavior. Do not conditionally remove the root to reset content state, and use keys only for stable semantic identity.
-- Place query subscriptions and mutation observers at the owner whose lifetime matches when they should run. Mounted-session work may belong inside content; work that must start or stop exactly with `open` needs an explicit open-state condition.
-- Prefer primitive-owned open state unless another owner must observe or coordinate it. Analytics callbacks and local cleanup alone do not require a controlled root.
+- Mount controlled overlays unconditionally unless unmounting is required for performance or reset semantics. Prefer keyed or owner-local reset over conditional wrappers.
+- Put query and mutation work inside dialog or alert-dialog content when it should mount only after opening.
+- Prefer uncontrolled roots when the primitive can own open state. Use controlled state only for business coordination, analytics, cleanup, or explicit reset behavior.
+- Do not add manual portals or call-site z-index escalation. Fix ownership and stacking structure at the shared boundary.
 
-[overlay contract]: ../../../../packages/dify-ui/docs/overlays.md
+[overlay guide]: ../../../../web/docs/overlay.md

.agents/skills/how-to-write-component/references/ownership.md

@@ -12,11 +12,9 @@ Read this document when adding, moving, splitting, or refactoring React componen
 
 ## Component Ownership
 
-- Put state, data access, loading, empty, error, and handlers in the lowest owner that uses them and whose mounted lifetime matches the required persistence.
-- Keep coordination in a parent only when it needs one consistent snapshot, the value must intentionally survive the local owner's unmount, or the parent coordinates submission, shared selection, batch behavior, navigation, or cross-section loading and errors.
-- Repeated TanStack Query hooks for the same key and input in Client Component siblings under one QueryClient are
-  acceptable; shared cache is not a reason to hoist. Separate Server Component QueryClients do not share it, so
-  request-level deduplication needs an identified request-local cache or verified framework or transport owner.
+- Put state, data access, loading, empty, error, and handlers in the lowest visual owner that uses them.
+- Keep coordination in a parent only when it needs one consistent snapshot or coordinates submission, shared selection, batch behavior, navigation, or cross-section loading and errors.
+- Repeated TanStack Query calls in siblings are acceptable when each sibling independently consumes the data; the cache already deduplicates requests.
 - Pass stable domain identity across boundaries. Do not pass raw server data together with separately derived flags for the same concept.
 - One pass-through prop layer is acceptable. Repeated forwarding means ownership should move closer to the consumer or into feature-scoped shared state.
 - Do not replace prop drilling with one large view-model hook. Move each query, derived value, and handler to the concrete owner that consumes it.
@@ -25,8 +23,7 @@ Read this document when adding, moving, splitting, or refactoring React componen
 ## Boundaries
 
 - State-heavy wizards, drawers, modals, and secondary workflows can form a small vertical surface with an entrypoint, optional feature-local state, and shallow owners matching real visual regions.
-- The entrypoint owns route integration, provider wiring, placement, and open-state coordination. A content or session owner keeps state scoped to that mounted surface.
-- Judge hook lifetime by the component that declares the hook and the primitive's mount contract, not only by where its rendered controls appear in JSX.
+- The entrypoint owns route integration, provider wiring, close behavior, and mounting. Composition owners handle workflow branches; the closest visual owner handles section branches.
 - Separate hidden dialogs, dropdowns, and popovers into small local owners when their content obscures the parent flow.
 - Keep cohesive forms, menu bodies, and one-off helpers local unless they have their own state, reuse, or semantic boundary.
 - Avoid wrapper components and wrapper DOM that only rename props, pass children through, or hide the real primitive. A wrapper must own behavior, validation, state, accessibility, layout, or library integration.

.agents/skills/how-to-write-component/references/runtime.md

@@ -4,10 +4,9 @@ Read this document when a change introduces Effects, navigation side effects, me
 
 ## Effects
 
-- Keep render pure: do not read or write `ref.current` during render except for predictable null-guarded lazy initialization. Update interaction-owned refs in event handlers, synchronize external-system refs after commit, and use state or derivation for rendered values.
 - Use Effects only to synchronize with a named external system such as a browser API, subscription, timer, analytics integration, non-React widget, or imperative DOM API.
 - Do not use Effects to transform render state, handle user actions, copy query data, reset state from props, or fetch data owned by framework APIs or TanStack Query.
-- Initialize query-backed form sessions after their defaults are available instead of copying data through Effects. Use a stable semantic identity key when the represented identity changes; use the intended surface lifecycle for per-session reset.
+- Initialize query-backed forms with keyed remounts or surface-entry hydration instead of copying data through Effects.
 
 ## Navigation
 

.agents/skills/how-to-write-component/references/state.md

@@ -9,12 +9,10 @@ Read this document when a change involves Jotai, form drafts, route identity, sh
 - Keep server and cache state in TanStack Query. Use existing feature stores for complex, high-frequency interaction state such as workflow canvas drag, resize, and runtime panels.
 - Use feature-owned storage only for low-frequency client preferences, dismissed notices, and UI defaults. Live application state does not belong in local storage.
 
-## Forms And Sessions
+## Forms
 
-- Keep form state in the narrowest owner whose lifetime matches the draft. A draft scoped to one mounted surface belongs to that content or session owner; a draft that must survive its current owner's unmount belongs to an explicit longer-lived feature owner.
-- Prefer uncontrolled fields when values are only read at submit time. Use local controlled state only when React must own the current value to drive dependent UI or linked fields; track derived facts such as dirty state without mirroring the field value. Controlledness does not decide whether a draft is local or persisted.
-- For query-backed defaults, establish the form session after the required defaults are available. `defaultValue` initializes the current mount; a stable semantic identity key may create a fresh snapshot when the represented identity changes. Do not use a generated key as a routine reset command.
-- Promote drafts beyond the session only when another owner reacts to in-progress values, several workflow steps share one draft, or the draft must intentionally survive unmounting. Start with the lowest shared React owner; use feature-scoped atoms only when their coordination or persistence contract is needed.
+- Prefer uncontrolled Dify UI form and field controls when values are only read at submit time. Initialize query-backed defaults with `defaultValue` and keyed remounts.
+- Promote form values to atoms only when another owner reacts to in-progress values, the draft must survive scoped unmounting, or several workflow steps edit the same draft.
 - Keep validation, source priority, fallback behavior, dirty checks, and payload assembly in the workflow that owns submission.
 
 ## Route And URL State

.devcontainer/devcontainer.json

@@ -12,7 +12,7 @@
 	"features": {
 		"ghcr.io/devcontainers/features/node:1": {
 			"nodeGypDependencies": true,
-			"version": "24.20.0"
+			"version": "lts"
 		},
 		"ghcr.io/devcontainers-extra/features/npm-package:1": {
 			"package": "typescript",
@@ -46,4 +46,4 @@
 	// Configure tool-specific properties.
 	// "customizations": {},
 	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-}
+}

.editorconfig

@@ -37,7 +37,3 @@ indent_size = 2
 [package.json]
 indent_style = space
 indent_size = 2
-
-# Oxlint writes its generated suppression baseline without a final newline.
-[oxlint-suppressions.json]
-insert_final_newline = false

.gemini/config.yaml

@@ -0,0 +1,13 @@
+have_fun: false
+memory_config:
+  disabled: false
+code_review:
+  disable: true
+  comment_severity_threshold: MEDIUM
+  max_review_comments: -1
+  pull_request_opened:
+    help: false
+    summary: false
+    code_review: false
+    include_drafts: false
+ignore_patterns: []

.github/CODEOWNERS

@@ -28,7 +28,6 @@
 
 # E2E
 /e2e/ @lyzno1
-/.github/workflows/web-e2e.yml @lyzno1
 
 # Backend (default owner, more specific rules below will override)
 /api/ @QuantumGhost
@@ -246,7 +245,7 @@
 
 # Frontend - Billing and Education
 /web/app/components/billing/ @iamjoel @zxhlyh
-/web/app/education/ @iamjoel @zxhlyh
+/web/app/education-apply/ @iamjoel @zxhlyh
 
 # Frontend - Workspace
 /web/app/components/header/account-dropdown/workplace-selector/ @iamjoel @zxhlyh
@@ -268,9 +267,5 @@
 /web/app/auth/refresh/route.ts @iamjoel @lyzno1
 /web/service/server.ts @iamjoel @lyzno1
 
-# Frontend - Browser Mode Tests
-/web/app/**/*.browser.spec.ts @lyzno1
-/web/app/**/*.browser.spec.tsx @lyzno1
-
 # Docker
 /docker/* @laipz8200

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,7 +1,7 @@
 name: '🕷️ Bug report'
 description: Report errors or unexpected behavior
 labels:
-  - 🐞 bug
+  - bug
 body:
   - type: checkboxes
     attributes:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,7 +1,7 @@
 name: '⭐ Feature or enhancement request'
 description: Propose something new.
 labels:
-  - 💪 enhancement
+  - enhancement
 body:
   - type: checkboxes
     attributes:

.github/actions/setup-web/action.yml

@@ -4,13 +4,13 @@ description: Set up Node.js, Vite+, pnpm, and web dependencies
 runs:
   using: composite
   steps:
-    - name: Setup pnpm and Node.js
-      uses: pnpm/setup@703c52620218391530e48b9e8870d5c0082e1b9b # v2.1.0
+    - name: Setup pnpm
+      uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
       with:
-        install: false
+        run_install: false
     - name: Setup Vite+
-      uses: voidzero-dev/setup-vp@1b32467adbe183473499fd9d5d372c3ed9641754 # v1.18.0
+      uses: voidzero-dev/setup-vp@143f5f385f39b1b753ffed1a01ad443811855c8b # v1.16.1
       with:
-        node-manager: false
+        node-version-file: .nvmrc
         cache: true
         run-install: true

.github/labeler.yml

@@ -6,6 +6,7 @@ web:
           - 'package.json'
           - 'pnpm-lock.yaml'
           - 'pnpm-workspace.yaml'
+          - '.nvmrc'
 
 e2e:
   - changed-files:

.github/linters/.yaml-lint.yml

@@ -4,8 +4,6 @@ extends: default
 rules:
   brackets:
     max-spaces-inside: 1
-  comments:
-    min-spaces-from-content: 1
   comments-indentation: disable
   document-start: disable
   line-length: disable

.github/pull_request_template.md

@@ -21,4 +21,4 @@
 - [ ] I understand that this PR may be closed in case there was no previous discussion or issues. (This doesn't apply to typos!)
 - [ ] I've added a test for each change that was introduced, and I tried as much as possible to make a single atomic change.
 - [ ] I've updated the documentation accordingly.
-- [ ] I ran `make lint && make type-check` (backend) and `vp staged` (frontend) to appease the lint gods
+- [ ] I ran `make lint && make type-check` (backend) and `cd web && pnpm exec vp staged` (frontend) to appease the lint gods

.github/workflows/accessibility-e2e.yml

@@ -36,7 +36,7 @@ concurrency:
 jobs:
   accessibility:
     name: WCAG Level ${{ inputs.level == 'a' && 'A' || 'AA' }} · ${{ inputs.page }}
-    runs-on: ubuntu-24.04
+    runs-on: depot-ubuntu-24.04-4
     timeout-minutes: 120
     defaults:
       run:
@@ -52,7 +52,7 @@ jobs:
         uses: ./.github/actions/setup-web
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: '3.12'

.github/workflows/api-tests.yml

@@ -35,7 +35,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: ${{ matrix.python-version }}
@@ -71,10 +71,10 @@ jobs:
           retention-days: 1
 
   api-integration:
-    name: API Integration Tests (${{ matrix.python-version }}, shard ${{ matrix.shardIndex }}/${{ matrix.shardTotal }})
-    runs-on: depot-ubuntu-24.04-4
+    name: API Integration Tests
+    runs-on: depot-ubuntu-24.04
     env:
-      COVERAGE_FILE: coverage-integration-${{ matrix.python-version }}-${{ matrix.shardIndex }}
+      COVERAGE_FILE: coverage-integration
       STORAGE_TYPE: opendal
       OPENDAL_SCHEME: fs
       OPENDAL_FS_ROOT: /tmp/dify-storage
@@ -82,17 +82,9 @@ jobs:
       run:
         shell: bash
     strategy:
-      fail-fast: false
       matrix:
         python-version:
           - '3.12'
-        shardIndex:
-          - 1
-          - 2
-          - 3
-          - 4
-        shardTotal:
-          - 4
 
     steps:
       - name: Checkout code
@@ -102,7 +94,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: ${{ matrix.python-version }}
@@ -120,8 +112,6 @@ jobs:
             -p no:benchmark \
             --start-middleware \
             -n auto \
-            --shard-index "${{ matrix.shardIndex }}" \
-            --shard-total "${{ matrix.shardTotal }}" \
             --timeout "${PYTEST_TIMEOUT:-180}" \
             api/tests/integration_tests/workflow \
             api/tests/integration_tests/tools \
@@ -130,9 +120,8 @@ jobs:
       - name: Upload integration coverage data
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
-          name: api-coverage-integration-${{ matrix.python-version }}-${{ matrix.shardIndex }}
-          path: ${{ env.COVERAGE_FILE }}
-          if-no-files-found: error
+          name: api-coverage-integration
+          path: coverage-integration
           retention-days: 1
 
   api-coverage:
@@ -156,7 +145,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: '3.12'
@@ -182,15 +171,12 @@ jobs:
           echo "" >> "$GITHUB_STEP_SUMMARY"
 
           unit_coverage="$(find coverage-data -type f -name coverage-unit -print -quit)"
-          mapfile -t integration_coverage < <(find coverage-data -type f -name 'coverage-integration-*' -print | sort)
+          integration_coverage="$(find coverage-data -type f -name coverage-integration -print -quit)"
           : "${unit_coverage:?coverage-unit artifact not found}"
-          if [[ "${#integration_coverage[@]}" -ne 4 ]]; then
-            echo "expected 4 integration coverage artifacts, found ${#integration_coverage[@]}" >&2
-            exit 1
-          fi
+          : "${integration_coverage:?coverage-integration artifact not found}"
 
           report_file="$(mktemp)"
-          uv run --project api coverage combine "$unit_coverage" "${integration_coverage[@]}"
+          uv run --project api coverage combine "$unit_coverage" "$integration_coverage"
           uv run --project api coverage report --show-missing | tee "$report_file"
           echo "Summary: \`$(tail -n 1 "$report_file")\`" >> "$GITHUB_STEP_SUMMARY"
           {

.github/workflows/autofix.yml

@@ -5,6 +5,8 @@ on:
   merge_group:
     branches: ['main']
     types: [checks_requested]
+  push:
+    branches: ['main']
 permissions:
   contents: read
 
@@ -30,6 +32,28 @@ jobs:
             docker/.env.example
             docker/docker-compose-template.yaml
             docker/docker-compose.yaml
+      - name: Check web inputs
+        if: github.event_name != 'merge_group'
+        id: web-changes
+        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        with:
+          files: |
+            web/**
+            cli/**
+            e2e/**
+            packages/**
+            sdks/nodejs-client/**
+            package.json
+            pnpm-lock.yaml
+            pnpm-workspace.yaml
+            .nvmrc
+            vite.config.ts
+            lint.config.ts
+            eslint.config.mjs
+            oxlint-suppressions.json
+            eslint-suppressions.json
+            .vscode/**
+            .github/**
       - name: Check api inputs
         if: github.event_name != 'merge_group'
         id: api-changes
@@ -58,13 +82,13 @@ jobs:
             dify-agent/**/*.py
             dify-agent/pyproject.toml
             dify-agent/uv.lock
-      - if: github.event_name != 'merge_group' && (steps.docker-compose-changes.outputs.any_changed == 'true' || steps.api-changes.outputs.any_changed == 'true' || steps.frontend-contract-changes.outputs.any_changed == 'true' || steps.dify-agent-changes.outputs.any_changed == 'true')
+      - if: github.event_name != 'merge_group'
         uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version: '3.11'
 
-      - if: github.event_name != 'merge_group' && (steps.api-changes.outputs.any_changed == 'true' || steps.frontend-contract-changes.outputs.any_changed == 'true' || steps.dify-agent-changes.outputs.any_changed == 'true')
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+      - if: github.event_name != 'merge_group'
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
 
       - name: Generate Docker Compose
         if: github.event_name != 'merge_group' && steps.docker-compose-changes.outputs.any_changed == 'true'
@@ -94,6 +118,12 @@ jobs:
           # Format code
           uv run ruff format .
 
+      - name: count migration progress
+        if: github.event_name != 'merge_group' && steps.api-changes.outputs.any_changed == 'true'
+        run: |
+          cd api
+          ./cnt_base.sh
+
       - name: ast-grep
         if: github.event_name != 'merge_group' && steps.api-changes.outputs.any_changed == 'true'
         run: |
@@ -125,7 +155,7 @@ jobs:
           find . -name "*.py.bak" -type f -delete
 
       - name: Setup web environment
-        if: github.event_name != 'merge_group' && steps.frontend-contract-changes.outputs.any_changed == 'true'
+        if: github.event_name != 'merge_group'
         uses: ./.github/actions/setup-web
 
       - name: Generate API docs
@@ -138,5 +168,13 @@ jobs:
         if: github.event_name != 'merge_group' && steps.frontend-contract-changes.outputs.any_changed == 'true'
         run: pnpm --dir packages/contracts gen-api-contract
 
+      - name: ESLint fallback autofix
+        if: github.event_name != 'merge_group' && steps.web-changes.outputs.any_changed == 'true'
+        run: pnpm lint:eslint:fix --quiet || true
+
+      - name: Vite+ static autofix
+        if: github.event_name != 'merge_group' && (steps.web-changes.outputs.any_changed == 'true' || steps.frontend-contract-changes.outputs.any_changed == 'true')
+        run: vp check --fix || true
+
       - if: github.event_name != 'merge_group'
         uses: autofix-ci/action@c5b2d67aa2274e7b5a18224e8171550871fc7e4a # v1.3.4

.github/workflows/build-push.yml

@@ -103,7 +103,7 @@ jobs:
           password: ${{ env.DOCKERHUB_TOKEN }}
 
       - name: Set up Depot CLI
-        uses: depot/setup-action@91bc8495a33ebfc504ffc89e5674379ccf23c29c # v1.7.2
+        uses: depot/setup-action@15c09a5f77a0840ad4bce955686522a257853461 # v1.7.1
 
       - name: Extract metadata for Docker
         id: meta
@@ -160,7 +160,7 @@ jobs:
             file: 'docker/Dockerfile'
     steps:
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@37fe631027851001ddb9b187196cc803df7f5f0e # v4.3.0
+        uses: docker/setup-buildx-action@bb05f3f5519dd87d3ba754cc423b652a5edd6d2c # v4.2.0
 
       - name: Validate Docker image
         uses: docker/build-push-action@53b7df96c91f9c12dcc8a07bcb9ccacbed38856a # v7.3.0
@@ -229,32 +229,3 @@ jobs:
           IMAGE_VERSION: ${{ steps.meta.outputs.version }}
         run: |
           docker buildx imagetools inspect "$IMAGE_NAME:$IMAGE_VERSION"
-
-  sync-e2b-template:
-    needs: create-manifest
-    runs-on: ubuntu-24.04
-    if: github.repository == 'langgenius/dify' && startsWith(github.ref, 'refs/tags/')
-    strategy:
-      matrix:
-        include:
-          - project: dev
-            api_key_secret: E2B_API_KEY_DEV
-          - project: prod
-            api_key_secret: E2B_API_KEY_PROD
-    steps:
-      - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@37fe631027851001ddb9b187196cc803df7f5f0e # v4.3.0
-
-      - name: Login to Docker Hub
-        uses: docker/login-action@dbcb813823bdd20940b903addbd779551569679f # v4.6.0
-        with:
-          username: ${{ env.DOCKERHUB_USER }}
-          password: ${{ env.DOCKERHUB_TOKEN }}
-
-      - name: Sync E2B Template (${{ matrix.project }})
-        env:
-          E2B_API_KEY: ${{ secrets[matrix.api_key_secret] }}
-        run: ./dify-agent-runtime/docker/sync-e2b-template.sh

.github/workflows/cli-e2e.yml

@@ -87,9 +87,10 @@ jobs:
         with:
           bun-version: latest
 
-      - uses: pnpm/setup@703c52620218391530e48b9e8870d5c0082e1b9b # v2.1.0
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
         with:
-          install: false
+          package_json_field: packageManager
+          run_install: false
 
       - name: Install CLI dependencies
         working-directory: cli
@@ -111,7 +112,7 @@ jobs:
   # ════════════════════════════════════════════════════════════════════════════
   suite-framework-output-error:
     name: 'Suite: framework + output + error-handling'
-    if: ${{ inputs.suite_framework_output_error }}
+    if: ${{ inputs.suite_framework_output_error != 'false' }}
     needs: provision
     runs-on: ubuntu-latest
     timeout-minutes: 20
@@ -128,8 +129,10 @@ jobs:
 
       - uses: ./.github/actions/setup-web
       - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
+        with: { bun-version: latest }
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+        with: { package_json_field: packageManager, run_install: false }
+      - run: pnpm install --frozen-lockfile
       - run: pnpm tree:gen
 
       - name: Run framework + output + error-handling
@@ -156,7 +159,7 @@ jobs:
   # ════════════════════════════════════════════════════════════════════════════
   suite-discovery:
     name: 'Suite: discovery'
-    if: ${{ inputs.suite_discovery }}
+    if: ${{ inputs.suite_discovery != 'false' }}
     needs: provision
     runs-on: ubuntu-latest
     timeout-minutes: 20
@@ -173,8 +176,10 @@ jobs:
 
       - uses: ./.github/actions/setup-web
       - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
+        with: { bun-version: latest }
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+        with: { package_json_field: packageManager, run_install: false }
+      - run: pnpm install --frozen-lockfile
       - run: pnpm tree:gen
 
       - name: Run discovery suite
@@ -202,7 +207,7 @@ jobs:
   # ════════════════════════════════════════════════════════════════════════════
   suite-run:
     name: 'Suite: run / ${{ matrix.name }}'
-    if: ${{ inputs.suite_run }}
+    if: ${{ inputs.suite_run != 'false' }}
     needs: provision
     runs-on: ubuntu-latest
     timeout-minutes: 20
@@ -234,8 +239,10 @@ jobs:
 
       - uses: ./.github/actions/setup-web
       - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
+        with: { bun-version: latest }
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+        with: { package_json_field: packageManager, run_install: false }
+      - run: pnpm install --frozen-lockfile
       - run: pnpm tree:gen
 
       - name: 'Run run/${{ matrix.name }}'
@@ -277,7 +284,7 @@ jobs:
   # ════════════════════════════════════════════════════════════════════════════
   suite-auth-safe:
     name: 'Suite: auth (login / status / whoami)'
-    if: ${{ inputs.suite_auth }}
+    if: ${{ inputs.suite_auth != 'false' }}
     needs: provision
     runs-on: ubuntu-latest
     timeout-minutes: 15
@@ -294,8 +301,10 @@ jobs:
 
       - uses: ./.github/actions/setup-web
       - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
+        with: { bun-version: latest }
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+        with: { package_json_field: packageManager, run_install: false }
+      - run: pnpm install --frozen-lockfile
       - run: pnpm tree:gen
 
       - name: Run auth/login + status + whoami
@@ -324,7 +333,7 @@ jobs:
   suite-last:
     name: 'Suite: auth-use + devices + logout + agent (last, serial)'
     # Runs when auth is selected; also runs after all parallel jobs finish
-    if: ${{ inputs.suite_auth || inputs.suite_agent }}
+    if: ${{ inputs.suite_auth != 'false' || inputs.suite_agent != 'false' }}
     needs:
       - provision
       - suite-framework-output-error
@@ -348,8 +357,10 @@ jobs:
 
       - uses: ./.github/actions/setup-web
       - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
+        with: { bun-version: latest }
+      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
+        with: { package_json_field: packageManager, run_install: false }
+      - run: pnpm install --frozen-lockfile
       - run: pnpm tree:gen
 
       - name: Run use / devices / logout / agent (serial)

.github/workflows/cli-release.yml

@@ -7,22 +7,12 @@ on:
         description: Dify release tag to attach difyctl assets to (blank = latest stable)
         required: false
         type: string
-      dry_run:
-        description: Build and checksum only — skip asset upload and stale-asset prune
-        required: false
-        type: boolean
-        default: false
   workflow_call:
     inputs:
       release_tag:
         description: Dify release tag to attach difyctl assets to (blank = latest stable)
         required: false
         type: string
-      dry_run:
-        description: Build and checksum only — skip asset upload and stale-asset prune
-        required: false
-        type: boolean
-        default: false
   release:
     types: [released]
 
@@ -49,8 +39,11 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Export manifest to env
+        run: node scripts/release-naming.mjs github-env >> "$GITHUB_ENV"
+
       - name: Validate manifest
-        run: node scripts/release-naming.mjs validate
+        run: scripts/release-validate-manifest.sh
 
       - name: Resolve target Dify release
         id: resolve
@@ -82,6 +75,15 @@ jobs:
           DIFY_TAG: ${{ steps.resolve.outputs.dify_tag }}
         run: node scripts/release-naming.mjs compat-check "$DIFY_TAG"
 
+      - name: Reject duplicate difyctl version
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if gh api "repos/${GITHUB_REPOSITORY}/git/ref/tags/${difyctlTag}" >/dev/null 2>&1; then
+              echo "::error::difyctl ${version} already released (tag ${difyctlTag} exists); bump cli/package.json version"
+              exit 1
+          fi
+
   release:
     name: build + attach standalone binaries (all targets)
     needs: validate
@@ -118,7 +120,6 @@ jobs:
 
       - name: Compile standalone binaries (all targets)
         run: |
-          CLI_VERSION="$version" \
           DIFYCTL_COMMIT="$(git rev-parse HEAD)" \
           DIFYCTL_BUILD_DATE="$(git log -1 --format=%cI HEAD)" \
             pnpm build:bin
@@ -127,7 +128,6 @@ jobs:
         run: scripts/release-write-checksums.sh
 
       - name: Attach difyctl assets to Dify release
-        if: ${{ !inputs.dry_run }}
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
@@ -135,7 +135,6 @@ jobs:
               --repo "$GITHUB_REPOSITORY" --clobber
 
       - name: Prune stale difyctl assets
-        if: ${{ !inputs.dry_run }}
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
@@ -150,3 +149,18 @@ jobs:
                         --repo "$GITHUB_REPOSITORY" --yes
                 fi
               done
+
+      - name: Create provenance tag
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          ref="refs/tags/${difyctlTag}"
+          sha="$(git rev-parse HEAD)"
+          status="$(gh api -X POST "repos/${GITHUB_REPOSITORY}/git/refs" \
+                -f ref="$ref" -f sha="$sha" --silent --include 2>/dev/null \
+                | awk 'NR==1 {print $2; exit}' || true)"
+          case "$status" in
+              201) echo "::notice::created ${ref}" ;;
+              422) echo "::notice::tag ${ref} already exists; skipping (immutable)" ;;
+              *)   echo "::error::provenance tag ${ref} not created (HTTP ${status:-unknown})"; exit 1 ;;
+          esac

.github/workflows/cli-tests.yml

@@ -44,7 +44,7 @@ jobs:
 
       - name: Validate release manifest
         if: matrix.os == 'depot-ubuntu-24.04'
-        run: node scripts/release-naming.mjs validate
+        run: scripts/release-validate-manifest.sh
 
       - name: CI pipeline (tree, coverage, build)
         run: pnpm run ci

.github/workflows/db-migration-test.yml

@@ -19,7 +19,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: '3.12'
@@ -40,7 +40,7 @@ jobs:
           cp envs/middleware.env.example middleware.env
 
       - name: Set up Middlewares
-        uses: hoverkraft-tech/compose-action@ee6af68587292d72db67743171809c19787df4c9 # v3.1.0
+        uses: hoverkraft-tech/compose-action@11beaa1c2dae4e8ed7b1665aa074723b6cecb0e4 # v3.0.0
         with:
           compose-file: |
             docker/docker-compose.middleware.yaml
@@ -69,7 +69,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: '3.12'
@@ -94,7 +94,7 @@ jobs:
           sed -i 's/DB_USERNAME=postgres/DB_USERNAME=mysql/' middleware.env
 
       - name: Set up Middlewares
-        uses: hoverkraft-tech/compose-action@ee6af68587292d72db67743171809c19787df4c9 # v3.1.0
+        uses: hoverkraft-tech/compose-action@11beaa1c2dae4e8ed7b1665aa074723b6cecb0e4 # v3.0.0
         with:
           compose-file: |
             docker/docker-compose.middleware.yaml

.github/workflows/deploy-hitl-im-dev.yml

@@ -1,25 +0,0 @@
-name: Deploy HITL IM Dev
-
-on:
-  workflow_run:
-    workflows: ['Build and Push API & Web']
-    branches:
-      - 'build/feat/hitl-im-dev'
-    types:
-      - completed
-
-jobs:
-  deploy:
-    runs-on: depot-ubuntu-24.04
-    if: |
-      github.event.workflow_run.conclusion == 'success' &&
-      github.event.workflow_run.head_branch == 'build/feat/hitl-im-dev'
-    steps:
-      - name: Deploy to server
-        uses: appleboy/ssh-action@0ff4204d59e8e51228ff73bce53f80d53301dee2 # v1.2.5
-        with:
-          host: ${{ secrets.HITL_SSH_HOST }}
-          username: ${{ secrets.SSH_USER }}
-          key: ${{ secrets.SSH_PRIVATE_KEY }}
-          script: |
-            ${{ vars.SSH_SCRIPT || secrets.SSH_SCRIPT }}

.github/workflows/dify-agent-tests.yml

@@ -1,47 +0,0 @@
-name: Dify Agent Tests
-
-on:
-  workflow_call:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: dify-agent-tests-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-jobs:
-  dify-agent-unit:
-    name: Dify Agent Unit Tests
-    runs-on: depot-ubuntu-24.04
-    defaults:
-      run:
-        shell: bash
-        working-directory: dify-agent
-    strategy:
-      matrix:
-        python-version:
-          - '3.12'
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          fetch-depth: 0
-          persist-credentials: false
-
-      - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
-        with:
-          enable-cache: true
-          python-version: ${{ matrix.python-version }}
-          cache-dependency-glob: dify-agent/uv.lock
-
-      - name: Check UV lockfile
-        run: uv lock --check
-
-      - name: Install dependencies
-        run: uv sync --extra server --dev
-
-      - name: Run unit tests
-        run: uv run pytest

.github/workflows/docker-build.yml

@@ -65,7 +65,7 @@ jobs:
             file: 'docker/Dockerfile'
     steps:
       - name: Set up Depot CLI
-        uses: depot/setup-action@91bc8495a33ebfc504ffc89e5674379ccf23c29c # v1.7.2
+        uses: depot/setup-action@15c09a5f77a0840ad4bce955686522a257853461 # v1.7.1
 
       - name: Build Docker Image
         uses: depot/build-push-action@98e78adca7817480b8185f474a400b451d74e287 # v1.18.0
@@ -96,7 +96,7 @@ jobs:
             file: 'docker/Dockerfile'
     steps:
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@37fe631027851001ddb9b187196cc803df7f5f0e # v4.3.0
+        uses: docker/setup-buildx-action@bb05f3f5519dd87d3ba754cc423b652a5edd6d2c # v4.2.0
 
       - name: Build Docker Image
         uses: docker/build-push-action@53b7df96c91f9c12dcc8a07bcb9ccacbed38856a # v7.3.0

.github/workflows/main-ci.yml

@@ -15,10 +15,8 @@ permissions:
   statuses: write
 
 concurrency:
-  # Pull request deduplication is owned by skip-duplicate-actions so pre_job can
-  # publish should_skip before required status finalizers run.
-  group: main-ci-${{ github.event.merge_group.head_sha || github.run_id }}
-  cancel-in-progress: ${{ github.event_name == 'merge_group' }}
+  group: main-ci-${{ github.event.pull_request.number || github.event.merge_group.head_sha || github.run_id }}
+  cancel-in-progress: true
 
 jobs:
   pre_job:
@@ -37,6 +35,8 @@ jobs:
   # Check which paths were changed to determine which tests to run
   check-changes:
     name: Check Changed Files
+    needs: pre_job
+    if: needs.pre_job.outputs.should_skip != 'true'
     runs-on: depot-ubuntu-24.04
     outputs:
       api-changed: ${{ steps.changes.outputs.api }}
@@ -46,12 +46,6 @@ jobs:
       vdb-changed: ${{ steps.changes.outputs.vdb }}
       migration-changed: ${{ steps.changes.outputs.migration }}
       sandbox-runtime-changed: ${{ steps.changes.outputs.sandbox-runtime }}
-      dify-agent-changed: ${{ steps.changes.outputs.dify-agent }}
-      python-style-changed: ${{ steps.changes.outputs.python-style }}
-      dify-agent-style-changed: ${{ steps.changes.outputs.dify-agent-style }}
-      web-style-changed: ${{ steps.changes.outputs.web-style }}
-      ts-common-style-changed: ${{ steps.changes.outputs.ts-common-style }}
-      superlinter-changed: ${{ steps.changes.outputs.superlinter }}
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - uses: dorny/paths-filter@ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d # v4.0.3
@@ -85,6 +79,7 @@ jobs:
               - 'pnpm-workspace.yaml'
               - 'lint.config.ts'
               - '.npmrc'
+              - '.nvmrc'
               - '.github/workflows/cli-tests.yml'
               - '.github/actions/setup-web/**'
             web:
@@ -93,6 +88,7 @@ jobs:
               - 'package.json'
               - 'pnpm-lock.yaml'
               - 'pnpm-workspace.yaml'
+              - '.nvmrc'
               - '.github/workflows/main-ci.yml'
               - '.github/workflows/web-tests.yml'
               - '.github/actions/setup-web/**'
@@ -106,6 +102,7 @@ jobs:
               - 'package.json'
               - 'pnpm-lock.yaml'
               - 'pnpm-workspace.yaml'
+              - '.nvmrc'
               - 'docker/docker-compose.middleware.yaml'
               - 'docker/envs/middleware.env.example'
               - '.github/workflows/web-e2e.yml'
@@ -139,9 +136,6 @@ jobs:
             sandbox-runtime:
               - 'dify-agent-runtime/**'
               - '.github/workflows/sandbox-runtime-tests.yml'
-            dify-agent:
-              - 'dify-agent/**'
-              - '.github/workflows/dify-agent-tests.yml'
             migration:
               - 'api/migrations/**'
               - 'api/.env.example'
@@ -153,58 +147,6 @@ jobs:
               - 'docker/generate_docker_compose'
               - 'docker/ssrf_proxy/**'
               - 'docker/volumes/sandbox/conf/**'
-            python-style:
-              - 'api/**'
-              - 'scripts/ast_grep_guard.py'
-              - 'scripts/check_no_new_getattr.py'
-              - 'scripts/check_no_new_controller_sqlalchemy.py'
-              - 'scripts/lint_controller_sqlalchemy.py'
-              - 'scripts/ast_grep_rules/no_new_getattr.yml'
-              - 'scripts/ast_grep_rules/no_new_controller_sqlalchemy.yml'
-              - '.github/workflows/style.yml'
-              - '.github/workflows/main-ci.yml'
-            dify-agent-style:
-              - 'dify-agent/**'
-              - '.github/workflows/style.yml'
-              - '.github/workflows/main-ci.yml'
-            web-style:
-              - 'web/**'
-              - 'e2e/**'
-              - 'sdks/nodejs-client/**'
-              - 'packages/**'
-              - 'package.json'
-              - 'pnpm-lock.yaml'
-              - 'pnpm-workspace.yaml'
-              - 'knip.config.ts'
-              - 'scripts/check-web-production-unused-after-knip-fix.mjs'
-              - '.github/workflows/style.yml'
-              - '.github/actions/setup-web/**'
-            ts-common-style:
-              - 'web/**'
-              - 'cli/**'
-              - 'e2e/**'
-              - 'sdks/nodejs-client/**'
-              - 'packages/**'
-              - 'package.json'
-              - 'pnpm-lock.yaml'
-              - 'pnpm-workspace.yaml'
-              - 'vite.config.ts'
-              - 'lint.config.ts'
-              - 'eslint.config.mjs'
-              - 'knip.config.ts'
-              - 'scripts/check-web-production-unused-after-knip-fix.mjs'
-              - 'oxlint-suppressions.json'
-              - 'eslint-suppressions.json'
-              - '.vscode/**'
-              - '.github/**'
-            superlinter:
-              - '**.sh'
-              - '**.yaml'
-              - '**.yml'
-              - '**Dockerfile'
-              - 'dev/**'
-              - '.editorconfig'
-              - '.vite-hooks/**'
 
   # Run tests in parallel while always emitting stable required checks.
   api-tests-run:
@@ -451,20 +393,11 @@ jobs:
 
   style-check:
     name: Style Check
-    if: ${{ always() }}
-    needs:
-      - pre_job
-      - check-changes
+    needs: pre_job
+    if: needs.pre_job.outputs.should_skip != 'true'
     uses: ./.github/workflows/style.yml
     with:
       base-rev: ${{ github.event.pull_request.base.sha || github.event.merge_group.base_sha }}
-      classification-succeeded: ${{ needs.check-changes.result == 'success' }}
-      run-python-style: ${{ needs.check-changes.outputs.python-style-changed == 'true' }}
-      run-dify-agent-style: ${{ needs.check-changes.outputs.dify-agent-style-changed == 'true' }}
-      run-web-style: ${{ needs.check-changes.outputs.web-style-changed == 'true' }}
-      run-ts-common-style: ${{ needs.check-changes.outputs.ts-common-style-changed == 'true' }}
-      run-superlinter: ${{ needs.check-changes.outputs.superlinter-changed == 'true' }}
-      skip-checks: ${{ needs.pre_job.outputs.should_skip == 'true' }}
 
   vdb-tests-run:
     name: Run VDB Tests
@@ -643,63 +576,3 @@ jobs:
 
           echo "Sandbox runtime tests were not required, but the skip job finished with result: $SKIP_RESULT" >&2
           exit 1
-
-  dify-agent-tests-run:
-    name: Run Dify Agent Tests
-    needs:
-      - pre_job
-      - check-changes
-    if: needs.pre_job.outputs.should_skip != 'true' && needs.check-changes.outputs.dify-agent-changed == 'true'
-    uses: ./.github/workflows/dify-agent-tests.yml
-    secrets: inherit
-
-  dify-agent-tests-skip:
-    name: Skip Dify Agent Tests
-    needs:
-      - pre_job
-      - check-changes
-    if: needs.pre_job.outputs.should_skip != 'true' && needs.check-changes.outputs.dify-agent-changed != 'true'
-    runs-on: depot-ubuntu-24.04
-    steps:
-      - name: Report skipped dify agent tests
-        run: echo "No dify-agent-related changes detected; skipping dify agent tests."
-
-  dify-agent-tests:
-    name: Dify Agent Tests
-    if: ${{ always() }}
-    needs:
-      - pre_job
-      - check-changes
-      - dify-agent-tests-run
-      - dify-agent-tests-skip
-    runs-on: depot-ubuntu-24.04
-    steps:
-      - name: Finalize Dify Agent Tests status
-        env:
-          SHOULD_SKIP_WORKFLOW: ${{ needs.pre_job.outputs.should_skip }}
-          TESTS_CHANGED: ${{ needs.check-changes.outputs.dify-agent-changed }}
-          RUN_RESULT: ${{ needs.dify-agent-tests-run.result }}
-          SKIP_RESULT: ${{ needs.dify-agent-tests-skip.result }}
-        run: |
-          if [[ "$SHOULD_SKIP_WORKFLOW" == 'true' ]]; then
-            echo "Dify agent tests were skipped because this workflow run duplicated a successful or newer run."
-            exit 0
-          fi
-
-          if [[ "$TESTS_CHANGED" == 'true' ]]; then
-            if [[ "$RUN_RESULT" == 'success' ]]; then
-              echo "Dify agent tests ran successfully."
-              exit 0
-            fi
-
-            echo "Dify agent tests were required but finished with result: $RUN_RESULT" >&2
-            exit 1
-          fi
-
-          if [[ "$SKIP_RESULT" == 'success' ]]; then
-            echo "Dify agent tests were skipped because no dify-agent-related files changed."
-            exit 0
-          fi
-
-          echo "Dify agent tests were not required, but the skip job finished with result: $SKIP_RESULT" >&2
-          exit 1

.github/workflows/post-merge.yml

@@ -39,6 +39,7 @@ jobs:
               - 'e2e/tsx-register.js'
               - 'package.json'
               - 'pnpm-lock.yaml'
+              - '.nvmrc'
               - '.github/workflows/post-merge.yml'
               - '.github/workflows/web-e2e.yml'
               - '.github/actions/setup-web/**'

.github/workflows/pyrefly-diff.yml

@@ -22,7 +22,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Python & UV
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
 

.github/workflows/pyrefly-type-coverage-comment.yml

@@ -24,7 +24,7 @@ jobs:
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Setup Python & UV
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
 

.github/workflows/pyrefly-type-coverage.yml

@@ -22,7 +22,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Python & UV
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
 

.github/workflows/style.yml

@@ -6,35 +6,6 @@ on:
       base-rev:
         required: true
         type: string
-      classification-succeeded:
-        description: Whether the caller successfully classified the changed files.
-        required: true
-        type: boolean
-      run-python-style:
-        description: Run Python style checks for the changed files.
-        required: true
-        type: boolean
-      run-dify-agent-style:
-        description: Run Dify Agent style checks for the changed files.
-        required: true
-        type: boolean
-      run-web-style:
-        description: Run Web style checks for the changed files.
-        required: true
-        type: boolean
-      run-ts-common-style:
-        description: Run shared TypeScript style checks for the changed files.
-        required: true
-        type: boolean
-      run-superlinter:
-        description: Run SuperLinter for the changed files.
-        required: true
-        type: boolean
-      skip-checks:
-        description: Create the required check runs without repeating previously successful work.
-        required: false
-        type: boolean
-        default: false
 
 permissions:
   checks: write
@@ -44,72 +15,70 @@ permissions:
 jobs:
   python-style:
     name: Python Style
-    if: ${{ !inputs.skip-checks && (!inputs.classification-succeeded || inputs.run-python-style || inputs.run-dify-agent-style) }}
     runs-on: depot-ubuntu-24.04
 
     steps:
-      - name: Verify changed-file classification
-        if: ${{ !inputs.classification-succeeded }}
-        run: |
-          echo "Changed-file classification failed; refusing to skip Python style checks." >&2
-          exit 1
-
       - name: Checkout code
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
           fetch-depth: 0
 
+      - name: Check changed files
+        id: changed-files
+        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        with:
+          files: |
+            api/**
+            scripts/ast_grep_guard.py
+            scripts/check_no_new_getattr.py
+            scripts/check_no_new_controller_sqlalchemy.py
+            scripts/lint_controller_sqlalchemy.py
+            scripts/ast_grep_rules/no_new_getattr.yml
+            scripts/ast_grep_rules/no_new_controller_sqlalchemy.yml
+            .github/workflows/style.yml
+            .github/workflows/main-ci.yml
+
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        if: steps.changed-files.outputs.any_changed == 'true'
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: false
           python-version: '3.12'
-          cache-dependency-glob: |
-            api/uv.lock
-            dify-agent/uv.lock
+          cache-dependency-glob: api/uv.lock
 
       - name: Install dependencies
-        if: inputs.run-python-style
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: uv sync --project api --dev
 
       - name: Run Import Linter
-        if: inputs.run-python-style
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: uv run --directory api --dev lint-imports
 
       - name: Run Response Contract Linter
-        if: inputs.run-python-style
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: uv run --project api --dev python api/dev/lint_response_contracts.py --fail-on-mismatch
 
       - name: Run No New Getattr Guard
-        if: inputs.run-python-style
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: uv run --project api python scripts/check_no_new_getattr.py --base-rev "${{ inputs.base-rev }}"
 
       - name: Run No New Controller SQLAlchemy Guard
-        if: inputs.run-python-style
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: uv run --project api python scripts/check_no_new_controller_sqlalchemy.py --base-rev "${{ inputs.base-rev }}"
 
       - name: Run Type Checks
-        if: inputs.run-python-style
+        if: steps.changed-files.outputs.any_changed == 'true'
         env:
           PYREFLY_OUTPUT_FORMAT: github
         run: make type-check-core
 
-      - name: Run Dify Agent Ruff
-        if: inputs.run-dify-agent-style
-        run: make -C dify-agent check
-
-      - name: Run Dify Agent Type Checks
-        if: inputs.run-dify-agent-style
-        run: make -C dify-agent typecheck
-
       - name: Dotenv check
-        if: inputs.run-python-style
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: uv run --project api dotenv-linter ./api/.env.example ./web/.env.example
 
   web-style:
     name: Web Style
-    if: ${{ !inputs.skip-checks && (!inputs.classification-succeeded || inputs.run-web-style) }}
     runs-on: depot-ubuntu-24.04
     defaults:
       run:
@@ -119,93 +88,131 @@ jobs:
       pull-requests: read
 
     steps:
-      - name: Verify changed-file classification
-        if: ${{ !inputs.classification-succeeded }}
-        working-directory: .
-        run: |
-          echo "Changed-file classification failed; refusing to skip Web style checks." >&2
-          exit 1
-
       - name: Checkout code
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
 
+      - name: Check changed files
+        id: changed-files
+        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        with:
+          files: |
+            web/**
+            e2e/**
+            sdks/nodejs-client/**
+            packages/**
+            package.json
+            pnpm-lock.yaml
+            pnpm-workspace.yaml
+            knip.config.ts
+            scripts/check-web-production-unused-after-knip-fix.mjs
+            .nvmrc
+            .github/workflows/style.yml
+            .github/actions/setup-web/**
+
       - name: Setup web environment
+        if: steps.changed-files.outputs.any_changed == 'true'
         uses: ./.github/actions/setup-web
 
       - name: Web tsslint
+        if: steps.changed-files.outputs.any_changed == 'true'
         env:
           NODE_OPTIONS: --max-old-space-size=4096
         run: vp run lint:tss
 
       - name: Web dead code check
+        if: steps.changed-files.outputs.any_changed == 'true'
         working-directory: .
         run: vp run knip
 
       - name: Web dead code check production
+        if: steps.changed-files.outputs.any_changed == 'true'
         working-directory: .
         run: vp run knip:production
 
       - name: Web production unused declarations check
+        if: steps.changed-files.outputs.any_changed == 'true'
         working-directory: .
         run: vp run knip:production-unused-check
 
   ts-common-style:
     name: TS Common
-    if: ${{ !inputs.skip-checks && (!inputs.classification-succeeded || inputs.run-ts-common-style) }}
     runs-on: depot-ubuntu-24.04-4
     permissions:
       checks: write
       pull-requests: read
 
     steps:
-      - name: Verify changed-file classification
-        if: ${{ !inputs.classification-succeeded }}
-        run: |
-          echo "Changed-file classification failed; refusing to skip TypeScript style checks." >&2
-          exit 1
-
       - name: Checkout code
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           persist-credentials: false
 
+      - name: Check changed files
+        id: changed-files
+        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        with:
+          files: |
+            web/**
+            cli/**
+            e2e/**
+            sdks/nodejs-client/**
+            packages/**
+            package.json
+            pnpm-lock.yaml
+            pnpm-workspace.yaml
+            .nvmrc
+            vite.config.ts
+            lint.config.ts
+            eslint.config.mjs
+            oxlint-suppressions.json
+            eslint-suppressions.json
+            .vscode/**
+            .github/**
+
       - name: Setup web environment
+        if: steps.changed-files.outputs.any_changed == 'true'
         uses: ./.github/actions/setup-web
 
       - name: Static check
+        if: steps.changed-files.outputs.any_changed == 'true'
         run: pnpm -w check
 
   superlinter:
     name: SuperLinter
-    if: ${{ !inputs.skip-checks && (!inputs.classification-succeeded || inputs.run-superlinter) }}
     runs-on: depot-ubuntu-24.04
 
     steps:
-      - name: Verify changed-file classification
-        if: ${{ !inputs.classification-succeeded }}
-        run: |
-          echo "Changed-file classification failed; refusing to skip SuperLinter." >&2
-          exit 1
-
       - name: Checkout code
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
 
+      - name: Check changed files
+        id: changed-files
+        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        with:
+          files: |
+            **.sh
+            **.yaml
+            **.yml
+            **Dockerfile
+            dev/**
+            .editorconfig
+
       - name: Super-linter
         uses: super-linter/super-linter/slim@4ce20838b8ab83717e78138c5b3a1407148e0918 # v8.7.0
+        if: steps.changed-files.outputs.any_changed == 'true'
         env:
           BASH_SEVERITY: warning
           DEFAULT_BRANCH: origin/main
           EDITORCONFIG_FILE_NAME: editorconfig-checker.json
-          ENABLE_GITHUB_PULL_REQUEST_SUMMARY_COMMENT: false
+          FILTER_REGEX_INCLUDE: pnpm-lock.yaml
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           IGNORE_GENERATED_FILES: true
           IGNORE_GITIGNORED_FILES: true
-          VALIDATE_ALL_CODEBASE: false
           VALIDATE_BASH: true
           VALIDATE_BASH_EXEC: true
           # FIXME: temporarily disabled until api-docker.yaml's run script is fixed for shellcheck

.github/workflows/tool-test-sdks.yaml

@@ -31,7 +31,7 @@ jobs:
       - name: Use Node.js
         uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
-          node-version-file: package.json
+          node-version: 22
           cache: ''
           cache-dependency-path: 'pnpm-lock.yaml'
 

.github/workflows/translate-i18n-claude.yml

@@ -8,19 +8,15 @@ on:
   workflow_dispatch:
     inputs:
       files:
-        description: 'Specific files to translate (space-separated, e.g., "app common").
-          Required for full mode; leave empty in incremental mode to use en-US
-          files changed since HEAD~1.'
+        description: 'Specific files to translate (space-separated, e.g., "app common"). Required for full mode; leave empty in incremental mode to use en-US files changed since HEAD~1.'
         required: false
         type: string
       languages:
-        description: 'Specific languages to translate (space-separated, e.g., "zh-Hans
-          ja-JP"). Leave empty for all supported target languages except en-US.'
+        description: 'Specific languages to translate (space-separated, e.g., "zh-Hans ja-JP"). Leave empty for all supported target languages except en-US.'
         required: false
         type: string
       mode:
-        description: 'Sync mode: incremental (compare with previous en-US revision) or
-          full (sync all keys in scope)'
+        description: 'Sync mode: incremental (compare with previous en-US revision) or full (sync all keys in scope)'
         required: false
         default: incremental
         type: choice
@@ -162,7 +158,7 @@ jobs:
 
       - name: Run Claude Code for Translation Sync
         if: steps.context.outputs.CHANGED_FILES != ''
-        uses: anthropics/claude-code-action@833fb0f8c9f6686b33d963a8bae0a94f4936ab2a # v1.0.211
+        uses: anthropics/claude-code-action@c038e4dcdedfbbca18dfb17df35a17e40ded4ddc # v1.0.186
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/vdb-tests-full.yml

@@ -29,14 +29,14 @@ jobs:
           persist-credentials: false
 
       - name: Free Disk Space
-        uses: endersonmenezes/free-disk-space@2a22f8c59cae9cddae7194b33e6b92d023b2b4b8 # v4.0.0
+        uses: endersonmenezes/free-disk-space@7901478139cff6e9d44df5972fd8ab8fcade4db1 # v3.2.2
         with:
           remove_dotnet: true
           remove_haskell: true
           remove_tool_cache: true
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: ${{ matrix.python-version }}

.github/workflows/vdb-tests.yml

@@ -26,14 +26,14 @@ jobs:
           persist-credentials: false
 
       - name: Free Disk Space
-        uses: endersonmenezes/free-disk-space@2a22f8c59cae9cddae7194b33e6b92d023b2b4b8 # v4.0.0
+        uses: endersonmenezes/free-disk-space@7901478139cff6e9d44df5972fd8ab8fcade4db1 # v3.2.2
         with:
           remove_dotnet: true
           remove_haskell: true
           remove_tool_cache: true
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: ${{ matrix.python-version }}

.github/workflows/web-e2e.yml

@@ -12,196 +12,13 @@ permissions:
   contents: read
 
 jobs:
-  core-build:
-    name: Prepare Core E2E Web Build
-    if: ${{ !inputs.run-external-runtime }}
-    runs-on: depot-ubuntu-24.04-4
-    timeout-minutes: 30
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-
-      - name: Setup web dependencies
-        uses: ./.github/actions/setup-web
-
-      - name: Run E2E support unit tests
-        working-directory: ./e2e
-        run: vp run test:unit
-
-      - name: Build production Web app
-        working-directory: ./e2e
-        env:
-          E2E_FORCE_WEB_BUILD: '1'
-        run: vp run e2e:web:build
-
-      - name: Package Web build
-        run: >-
-          tar -cf e2e-web-build.tar -C web
-          .next/BUILD_ID
-          .next/e2e-web-build.sha256
-          .next/standalone
-          .next/static
-
-      - name: Upload Web build
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: core-e2e-web-build
-          path: e2e-web-build.tar
-          if-no-files-found: error
-          overwrite: true
-          retention-days: 7
-
-  chromium-full:
-    name: Chromium Full (${{ matrix.shard }}/3)
-    if: ${{ !inputs.run-external-runtime }}
-    needs: core-build
-    runs-on: ubuntu-24.04
-    timeout-minutes: 45
-    strategy:
-      fail-fast: false
-      matrix:
-        shard: [1, 2, 3]
-    env:
-      E2E_ADMIN_EMAIL: e2e-admin@example.com
-      E2E_ADMIN_NAME: E2E Admin
-      E2E_ADMIN_PASSWORD: E2eAdmin12345
-      E2E_INIT_PASSWORD: E2eInit12345
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-
-      - name: Setup web dependencies
-        uses: ./.github/actions/setup-web
-
-      - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
-        with:
-          enable-cache: true
-          python-version: '3.12'
-          cache-dependency-glob: api/uv.lock
-
-      - name: Install API dependencies
-        run: uv sync --project api --dev
-
-      - name: Download Web build
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: core-e2e-web-build
-
-      - name: Extract Web build
-        run: tar -xf e2e-web-build.tar -C web
-
-      - name: Install Chromium
-        timeout-minutes: 15
-        working-directory: ./e2e
-        run: vp run e2e:install:ci:chromium
-
-      - name: Run Chromium full shard
-        working-directory: ./e2e
-        run: vp run e2e:full -- --shard ${{ matrix.shard }}/3
-
-      - name: Upload Cucumber report
-        if: ${{ !cancelled() }}
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: cucumber-report-chromium-${{ matrix.shard }}
-          path: e2e/cucumber-report
-          if-no-files-found: ignore
-          overwrite: true
-          retention-days: 7
-
-      - name: Upload E2E logs
-        if: ${{ !cancelled() }}
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: e2e-logs-chromium-${{ matrix.shard }}
-          path: e2e/.logs/*.log
-          if-no-files-found: ignore
-          include-hidden-files: true
-          overwrite: true
-          retention-days: 7
-
-  webkit-smoke:
-    name: WebKit Browser Smoke
-    if: ${{ !inputs.run-external-runtime }}
-    needs: core-build
-    runs-on: ubuntu-24.04
-    timeout-minutes: 30
-    env:
-      E2E_ADMIN_EMAIL: e2e-admin@example.com
-      E2E_ADMIN_NAME: E2E Admin
-      E2E_ADMIN_PASSWORD: E2eAdmin12345
-      E2E_BROWSER: webkit
-      E2E_INIT_PASSWORD: E2eInit12345
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-
-      - name: Setup web dependencies
-        uses: ./.github/actions/setup-web
-
-      - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
-        with:
-          enable-cache: true
-          python-version: '3.12'
-          cache-dependency-glob: api/uv.lock
-
-      - name: Install API dependencies
-        run: uv sync --project api --dev
-
-      - name: Download Web build
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: core-e2e-web-build
-
-      - name: Extract Web build
-        run: tar -xf e2e-web-build.tar -C web
-
-      - name: Install WebKit
-        timeout-minutes: 15
-        working-directory: ./e2e
-        run: vp run e2e:install:ci:webkit
-
-      - name: Run WebKit browser smoke
-        working-directory: ./e2e
-        run: vp run e2e:full -- --tags '@browser-smoke'
-
-      - name: Upload Cucumber report
-        if: ${{ !cancelled() }}
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: cucumber-report-webkit
-          path: e2e/cucumber-report
-          if-no-files-found: ignore
-          overwrite: true
-          retention-days: 7
-
-      - name: Upload E2E logs
-        if: ${{ !cancelled() }}
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: e2e-logs-webkit
-          path: e2e/.logs/*.log
-          if-no-files-found: ignore
-          include-hidden-files: true
-          overwrite: true
-          retention-days: 7
-
-  external-runtime:
+  test:
     name: Web Full-Stack E2E
-    if: ${{ inputs.run-external-runtime }}
-    runs-on: ubuntu-24.04
+    runs-on: depot-ubuntu-24.04-4
     timeout-minutes: 120
+    defaults:
+      run:
+        shell: bash
 
     steps:
       - name: Checkout code
@@ -209,11 +26,16 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Switch Ubuntu mirror
+        run: |
+          sudo sed -i 's|http://us-east-1.ec2.archive.ubuntu.com/ubuntu|http://azure.archive.ubuntu.com/ubuntu|g' /etc/apt/sources.list.d/ubuntu.sources
+          sudo apt-get update
+
       - name: Setup web dependencies
         uses: ./.github/actions/setup-web
 
       - name: Setup UV and Python
-        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
           enable-cache: true
           python-version: '3.12'
@@ -224,12 +46,82 @@ jobs:
       - name: Install API dependencies
         run: uv sync --project api --dev
 
-      - name: Install Chromium
+      - name: Run E2E support unit tests
+        if: ${{ !inputs.run-external-runtime }}
+        working-directory: ./e2e
+        run: vp run test:unit
+
+      - name: Install Playwright browsers for core E2E
+        if: ${{ !inputs.run-external-runtime }}
+        timeout-minutes: 15
+        working-directory: ./e2e
+        run: vp run e2e:install:ci
+
+      - name: Install Chromium for external runtime E2E
+        if: ${{ inputs.run-external-runtime }}
         timeout-minutes: 15
         working-directory: ./e2e
         run: vp run e2e:install:ci:chromium
 
+      - name: Run isolated source-api and built-web Cucumber E2E tests
+        if: ${{ !inputs.run-external-runtime }}
+        working-directory: ./e2e
+        env:
+          E2E_ADMIN_EMAIL: e2e-admin@example.com
+          E2E_ADMIN_NAME: E2E Admin
+          E2E_ADMIN_PASSWORD: E2eAdmin12345
+          E2E_FORCE_WEB_BUILD: '1'
+          E2E_INIT_PASSWORD: E2eInit12345
+        run: vp run e2e:full
+
+      - name: Preserve Chromium E2E report and logs
+        if: ${{ !cancelled() && !inputs.run-external-runtime }}
+        run: |
+          if [[ -d e2e/cucumber-report ]]; then
+            mv e2e/cucumber-report e2e/cucumber-report-non-external
+          fi
+          if [[ -d e2e/.logs ]]; then
+            mv e2e/.logs e2e/.logs-non-external
+          fi
+
+      - name: Run WebKit keyboard and browser smoke tests
+        if: ${{ !inputs.run-external-runtime }}
+        working-directory: ./e2e
+        env:
+          E2E_ADMIN_EMAIL: e2e-admin@example.com
+          E2E_ADMIN_NAME: E2E Admin
+          E2E_ADMIN_PASSWORD: E2eAdmin12345
+          E2E_BROWSER: webkit
+          E2E_INIT_PASSWORD: E2eInit12345
+        run: |
+          teardown_webkit_smoke() {
+            local run_status=$?
+            trap - EXIT
+            if ! vp run e2e:middleware:down; then
+              echo "::error title=E2E teardown failed::WebKit smoke middleware did not shut down cleanly."
+              if [[ "$run_status" -eq 0 ]]; then
+                run_status=1
+              fi
+            fi
+            exit "$run_status"
+          }
+
+          trap teardown_webkit_smoke EXIT
+          vp run e2e:middleware:up
+          vp run e2e -- --tags '@browser-smoke'
+
+      - name: Preserve WebKit E2E report and logs
+        if: ${{ !cancelled() && !inputs.run-external-runtime }}
+        run: |
+          if [[ -d e2e/cucumber-report ]]; then
+            mv e2e/cucumber-report e2e/cucumber-report-webkit
+          fi
+          if [[ -d e2e/.logs ]]; then
+            mv e2e/.logs e2e/.logs-webkit
+          fi
+
       - name: Run prepared and external runtime E2E tests
+        if: ${{ inputs.run-external-runtime }}
         working-directory: ./e2e
         env:
           E2E_ADMIN_EMAIL: e2e-admin@example.com
@@ -262,8 +154,10 @@ jobs:
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: cucumber-report
-          path: e2e/cucumber-report
-          overwrite: true
+          path: |
+            e2e/cucumber-report
+            e2e/cucumber-report-non-external
+            e2e/cucumber-report-webkit
           retention-days: 7
 
       - name: Upload E2E logs
@@ -271,17 +165,18 @@ jobs:
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: e2e-logs
-          path: e2e/.logs/*.log
+          path: |
+            e2e/.logs/*.log
+            e2e/.logs-non-external/*.log
+            e2e/.logs-webkit/*.log
           include-hidden-files: true
-          overwrite: true
           retention-days: 7
 
       - name: Upload E2E seed report
-        if: ${{ !cancelled() }}
+        if: ${{ !cancelled() && inputs.run-external-runtime }}
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: e2e-seed-report
           path: e2e/seed-report
           if-no-files-found: ignore
-          overwrite: true
           retention-days: 7

.github/workflows/web-tests.yml

@@ -33,7 +33,7 @@ jobs:
         uses: ./.github/actions/setup-web
 
       - name: Run tests
-        run: vp test run --project unit --reporter=blob --reporter=minimal --shard=${{ matrix.shardIndex }}/${{ matrix.shardTotal }} --coverage
+        run: vp test run --reporter=blob --reporter=minimal --shard=${{ matrix.shardIndex }}/${{ matrix.shardTotal }} --coverage
 
       - name: Upload blob report
         if: ${{ !cancelled() }}
@@ -44,41 +44,6 @@ jobs:
           include-hidden-files: true
           retention-days: 1
 
-  browser-test:
-    name: Web Browser Tests
-    runs-on: ubuntu-24.04
-    timeout-minutes: 20
-    defaults:
-      run:
-        shell: bash
-        working-directory: ./web
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          persist-credentials: false
-
-      - name: Setup web environment
-        uses: ./.github/actions/setup-web
-
-      - name: Install Chromium for Browser Mode
-        timeout-minutes: 15
-        run: vp exec playwright install --with-deps --only-shell chromium
-
-      - name: Run browser tests
-        run: vp test run --project browser --silent=passed-only
-
-      - name: Upload browser failure artifacts
-        if: ${{ failure() && !cancelled() }}
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: browser-test-failures
-          path: web/.vitest-browser/
-          if-no-files-found: ignore
-          include-hidden-files: true
-          retention-days: 7
-
   merge-reports:
     name: Merge Test Reports
     if: ${{ !cancelled() }}
@@ -121,7 +86,7 @@ jobs:
 
   dify-ui-test:
     name: dify-ui Tests
-    runs-on: ubuntu-24.04
+    runs-on: depot-ubuntu-24.04-4
     timeout-minutes: 20
     env:
       CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
@@ -136,6 +101,11 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Switch Ubuntu mirror
+        run: |
+          sudo sed -i 's|http://us-east-1.ec2.archive.ubuntu.com/ubuntu|http://azure.archive.ubuntu.com/ubuntu|g' /etc/apt/sources.list.d/ubuntu.sources
+          sudo apt-get update
+
       - name: Setup web environment
         uses: ./.github/actions/setup-web
 
@@ -146,16 +116,6 @@ jobs:
       - name: Run dify-ui tests
         run: vp test run --project unit --coverage --silent=passed-only
 
-      - name: Upload dify-ui test failure artifacts
-        if: ${{ failure() && !cancelled() }}
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: dify-ui-test-failures
-          path: packages/dify-ui/.vitest-browser/
-          if-no-files-found: ignore
-          include-hidden-files: true
-          retention-days: 7
-
       - name: Report coverage
         if: ${{ env.CODECOV_TOKEN != '' }}
         uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
@@ -167,7 +127,7 @@ jobs:
 
   dify-ui-storybook-test:
     name: dify-ui Storybook Tests
-    runs-on: ubuntu-24.04
+    runs-on: depot-ubuntu-24.04-4
     timeout-minutes: 20
     defaults:
       run:
@@ -180,6 +140,11 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Switch Ubuntu mirror
+        run: |
+          sudo sed -i 's|http://us-east-1.ec2.archive.ubuntu.com/ubuntu|http://azure.archive.ubuntu.com/ubuntu|g' /etc/apt/sources.list.d/ubuntu.sources
+          sudo apt-get update
+
       - name: Setup web environment
         uses: ./.github/actions/setup-web
 
@@ -189,13 +154,3 @@ jobs:
 
       - name: Run dify-ui Storybook tests
         run: vp run test:storybook
-
-      - name: Upload dify-ui Storybook test failure artifacts
-        if: ${{ failure() && !cancelled() }}
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: dify-ui-storybook-test-failures
-          path: packages/dify-ui/.vitest-browser/
-          if-no-files-found: ignore
-          include-hidden-files: true
-          retention-days: 7

.gitignore

@@ -263,7 +263,6 @@ scripts/stress-test/reports/
 .qoder/*
 .context/
 # Vitest local reports
-web/.vitest-browser/
 web/.vitest-reports/
 
 # dify-agent-runtime

.nvmrc

@@ -0,0 +1 @@
+22

.vite-hooks/pre-commit

@@ -5,6 +5,7 @@ files=$(git diff --cached --name-only)
 # check if api or web directory is modified
 
 api_modified=false
+web_modified=false
 skip_web_checks=false
 
 git_path() {
@@ -28,6 +29,10 @@ do
             # set api_modified flag to true
             api_modified=true
             ;;
+        web/*)
+            # set web_modified flag to true
+            web_modified=true
+            ;;
     esac
 done
 

.vscode/settings.example.json

@@ -4,6 +4,7 @@
 
   "tailwindCSS.experimental.configFile": "web/app/styles/globals.css",
 
+  // Format
   "[javascript]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
   "[javascriptreact]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
   "[typescript]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
@@ -24,9 +25,9 @@
   "[handlebars]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
   "editor.formatOnSave": true,
   "editor.formatOnSaveMode": "file",
-  "oxc.disableNestedConfig": true,
-  "oxc.fmt.disableNestedConfig": true,
+  "oxc.fmt.configPath": "./vite.config.ts",
 
+  // Lint fix
   "eslint.useFlatConfig": true,
   "eslint.validate": ["json", "jsonc", "markdown", "yaml", "toml"],
   "editor.codeActionsOnSave": {

AGENTS.md

@@ -7,9 +7,3 @@ Dify is an open-source platform for building LLM applications, agentic workflows
 - Run backend commands through `uv run --project api <command>`.
 - Backend integration tests are CI-only and are not expected to run locally.
 - Keep `docker/.env.example` limited to variables required for a default Docker Compose deployment to start. Put optional and provider-specific settings in the matching `docker/envs/*.env.example` file; `docker/.env` overrides those service-specific env files.
-
-## Frontend Workflow
-
-- For truncated text disclosure and native `title` decisions, follow [Truncated Text Disclosure].
-
-[Truncated Text Disclosure]: web/docs/truncated-text-disclosure.md

README.md

@@ -129,35 +129,83 @@ All of Dify's offerings come with corresponding APIs, so you could effortlessly
 
 Star Dify on GitHub and be instantly notified of new releases.
 
-<img width="1344" height="720" alt="star" src="https://github.com/user-attachments/assets/dcd086d1-af0f-471b-ae52-1ad2fa040595" />
+![star-us](https://github.com/langgenius/dify/assets/13230914/b823edc1-6388-4e25-ad45-2f6b187adbb4)
 
 ## Advanced Setup
 
-For custom configuration, observability, and deployment options, see [Advanced Setup](docs/ADVANCED_SETUP.md).
+### Custom configurations
+
+If you need to customize the configuration, edit `docker/.env`. The essential startup defaults live in [`docker/.env.example`](docker/.env.example), and optional advanced variables are split under `docker/envs/` by theme. After making any changes, re-run `docker compose up -d` from the `docker` directory. You can find the full list of available environment variables [here](https://docs.dify.ai/getting-started/install-self-hosted/environments).
+
+### Metrics Monitoring with Grafana
+
+Import the dashboard to Grafana, using Dify's PostgreSQL database as data source, to monitor metrics in granularity of apps, tenants, messages, and more.
+
+- [Grafana Dashboard by @bowenliang123](https://github.com/bowenliang123/dify-grafana-dashboard)
+
+### Deployment with Kubernetes
+
+If you'd like to configure a highly available setup, there are community-contributed [Helm Charts](https://helm.sh/) and YAML files which allow Dify to be deployed on Kubernetes.
+
+- [Helm Chart by @LeoQuote](https://github.com/douban/charts/tree/master/charts/dify)
+- [Helm Chart by @BorisPolonsky](https://github.com/BorisPolonsky/dify-helm)
+- [Helm Chart by @magicsong](https://github.com/magicsong/ai-charts)
+- [YAML file by @Winson-030](https://github.com/Winson-030/dify-kubernetes)
+- [YAML file by @wyy-holding](https://github.com/wyy-holding/dify-k8s)
+- [🚀 NEW! YAML files (Supports Dify v1.6.0) by @Zhoneym](https://github.com/Zhoneym/DifyAI-Kubernetes)
+
+#### Using Terraform for Deployment
+
+Deploy Dify to Cloud Platform with a single click using [terraform](https://www.terraform.io/)
+
+##### Azure Global
+
+- [Azure Terraform by @nikawang](https://github.com/nikawang/dify-azure-terraform)
+
+##### Google Cloud
+
+- [Google Cloud Terraform by @sotazum](https://github.com/DeNA/dify-google-cloud-terraform)
+
+#### Using AWS CDK for Deployment
+
+Deploy Dify to AWS with [CDK](https://aws.amazon.com/cdk/)
+
+##### AWS
+
+- [AWS CDK by @KevinZhao (EKS based)](https://github.com/aws-samples/solution-for-deploying-dify-on-aws)
+- [AWS CDK by @tmokmss (ECS based)](https://github.com/aws-samples/dify-self-hosted-on-aws)
+
+#### Using Alibaba Cloud Computing Nest
+
+Quickly deploy Dify to Alibaba cloud with [Alibaba Cloud Computing Nest](https://computenest.console.aliyun.com/service/instance/create/default?type=user&ServiceName=Dify%E7%A4%BE%E5%8C%BA%E7%89%88)
+
+#### Using Alibaba Cloud Data Management
+
+One-Click deploy Dify to Alibaba Cloud with [Alibaba Cloud Data Management](https://www.alibabacloud.com/help/en/dms/dify-in-invitational-preview/)
+
+#### Deploy to AKS with Azure Devops Pipeline
+
+One-Click deploy Dify to AKS with [Azure Devops Pipeline Helm Chart by @LeoZhang](https://github.com/Ruiruiz30/Dify-helm-chart-AKS)
 
 ## Contributing
 
-Dify welcomes contributions of all kinds:
+For those who'd like to contribute code, see our [Contribution Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md).
+At the same time, please consider supporting Dify by sharing it on social media and at events and conferences.
 
-- **Code**: Read the [Contribution Guide](CONTRIBUTING.md), then browse [good first issues](https://github.com/langgenius/dify/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22).
-- **Ideas and feedback**: Start or join a [GitHub Discussion](https://github.com/langgenius/dify/discussions).
-- **Translations**: Follow the [internationalization guide](web/i18n-config/README.md) to add or update a locale.
-- **Community**: Share the apps you build, help other users, and spread the word about Dify.
-
-### Contributors
-
-<a href="https://github.com/langgenius/dify/graphs/contributors">
-  <img alt="Dify contributors" src="https://contrib.rocks/image?repo=langgenius/dify" />
-</a>
+> We are looking for contributors to help translate Dify into languages other than Mandarin or English. If you are interested in helping, please see the [i18n README](https://github.com/langgenius/dify/blob/main/web/i18n-config/README.md) for more information, and leave us a comment in the `global-users` channel of our [Discord Community Server](https://discord.gg/8Tpq4AcN9c).
 
 ## Community & contact
 
-Choose the channel that best fits your question:
+- [GitHub Discussion](https://github.com/langgenius/dify/discussions). Best for: sharing feedback and asking questions.
+- [GitHub Issues](https://github.com/langgenius/dify/issues). Best for: bugs you encounter using Dify.AI, and feature proposals. See our [Contribution Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md).
+- [Discord](https://discord.gg/FngNHpbcY7). Best for: sharing your applications and hanging out with the community.
+- [X(Twitter)](https://twitter.com/dify_ai). Best for: sharing your applications and hanging out with the community.
 
-- [GitHub Discussions](https://github.com/langgenius/dify/discussions): Get help, share feedback, and propose ideas.
-- [GitHub Issues](https://github.com/langgenius/dify/issues): Report reproducible bugs and track engineering work. Read the [Contribution Guide](CONTRIBUTING.md) before opening one.
-- [Discord](https://discord.gg/FngNHpbcY7): Chat in real time, share your apps, and connect with other Dify users.
-- [X](https://x.com/dify_ai): Follow Dify for release news and project updates.
+**Contributors**
+
+<a href="https://github.com/langgenius/dify/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=langgenius/dify" />
+</a>
 
 ## Star History
 

api/.env.example

@@ -98,11 +98,9 @@ REDIS_KEEPALIVE=true
 CELERY_BROKER_URL=redis://:difyai123456@localhost:${REDIS_PORT}/1
 CELERY_BACKEND=redis
 
-# Ops trace configuration
-OPS_TRACE_UNIFIED_ENABLED=false
-OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES=780
+# Ops trace retry configuration
+OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES=60
 OPS_TRACE_RETRYABLE_DISPATCH_DELAY_SECONDS=5
-OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS=3900
 
 # Database configuration
 DB_TYPE=postgresql
@@ -222,7 +220,6 @@ SUPABASE_URL=your-server-url
 # CORS configuration
 WEB_API_CORS_ALLOW_ORIGINS=http://localhost:3000,*
 CONSOLE_CORS_ALLOW_ORIGINS=http://localhost:3000,*
-WEBSOCKET_MAX_HTTP_BUFFER_SIZE=10485760
 # When the frontend and backend run on different subdomains, set COOKIE_DOMAIN to the site’s top-level domain (e.g., `example.com`). Leading dots are optional.
 COOKIE_DOMAIN=
 
@@ -491,13 +488,6 @@ SENDGRID_API_KEY=
 # Sentry configuration
 SENTRY_DSN=
 
-# Cloudflare Turnstile server-side verification for Dify Cloud sign-in
-TURNSTILE_SECRET_KEY=
-# Comma-separated parent or exact hostnames, for example: dify.ai,staging.dify.dev
-TURNSTILE_ALLOWED_HOSTNAMES=
-# Enable only after the compatible web client has been fully deployed.
-TURNSTILE_EMAIL_CODE_VERIFY_REQUIRED=false
-
 # DEBUG
 DEBUG=false
 ENABLE_REQUEST_LOGGING=False
@@ -588,7 +578,7 @@ INDEXING_MAX_SEGMENTATION_TOKENS_LENGTH=4000
 
 # Workflow runtime configuration
 WORKFLOW_MAX_EXECUTION_STEPS=500
-WORKFLOW_MAX_EXECUTION_TIME=3600
+WORKFLOW_MAX_EXECUTION_TIME=1200
 WORKFLOW_CALL_MAX_DEPTH=5
 MAX_VARIABLE_SIZE=204800
 # Maximum concurrent node-builder LLM calls per workflow generation request
@@ -633,7 +623,7 @@ WORKFLOW_LOG_CLEANUP_BATCH_SIZE=100
 WORKFLOW_LOG_CLEANUP_SPECIFIC_WORKFLOW_IDS=
 
 # App configuration
-APP_MAX_EXECUTION_TIME=3600
+APP_MAX_EXECUTION_TIME=1200
 APP_DEFAULT_ACTIVE_REQUESTS=0
 APP_MAX_ACTIVE_REQUESTS=0
 
@@ -708,12 +698,11 @@ INNER_API_KEY_FOR_PLUGIN=QaHbTe77CtuXmsfyhR7+vRjI/+XbV1AaFy691iy+kGDv2Jvy0/eAh8Y
 
 # Dify Agent backend
 AGENT_BACKEND_BASE_URL=http://localhost:5050
-# Bearer token sent to the Agent backend control-plane API. Must match DIFY_AGENT_API_TOKEN on the server side.
+# Bearer token sent to the Agent backend /runs API. Must match DIFY_AGENT_API_TOKEN on the server side.
 AGENT_BACKEND_API_TOKEN=dify-agent-run-token-for-dev-only
 AGENT_BACKEND_STREAM_READ_TIMEOUT_SECONDS=30
 AGENT_BACKEND_STREAM_MAX_RECONNECTS=3
-# Client deadline for converting a Binding file to a ToolFile through the Agent backend.
-AGENT_BACKEND_BINDING_FILE_DOWNLOAD_TIMEOUT_SECONDS=240
+AGENT_BACKEND_RUN_TIMEOUT_SECONDS=1200
 
 # KnowledgeFS (Dataset 2.0)
 KNOWLEDGE_FS_ENABLED=false
@@ -740,8 +729,6 @@ RESET_PASSWORD_TOKEN_EXPIRY_MINUTES=5
 EMAIL_REGISTER_TOKEN_EXPIRY_MINUTES=5
 CHANGE_EMAIL_TOKEN_EXPIRY_MINUTES=5
 OWNER_TRANSFER_TOKEN_EXPIRY_MINUTES=5
-EMAIL_CODE_LOGIN_TOKEN_EXPIRY_MINUTES=5
-EMAIL_CODE_LOGIN_MAX_ATTEMPTS=5
 
 CREATE_TIDB_SERVICE_JOB_ENABLED=false
 
@@ -838,12 +825,6 @@ ENABLE_HUMAN_INPUT_TIMEOUT_TASK=true
 # Human input timeout check interval in minutes
 HUMAN_INPUT_TIMEOUT_TASK_INTERVAL=1
 
-# Whether to recover soft-deleted conversation cleanup jobs periodically
-ENABLE_CONVERSATION_CLEANUP_TASK=true
-# Recovery interval in minutes and maximum conversations dispatched per sweep
-CONVERSATION_CLEANUP_TASK_INTERVAL=5
-CONVERSATION_CLEANUP_BATCH_SIZE=100
-
 # Nacos remote settings source HTTP timeouts (seconds).
 # Bound how long requests to the Nacos endpoint wait before failing, so a slow or
 # unresponsive Nacos server cannot stall API startup or token refresh.
@@ -851,6 +832,3 @@ CONVERSATION_CLEANUP_BATCH_SIZE=100
 DIFY_ENV_NACOS_REQUEST_TIMEOUT=10.0
 # Connect timeout for Nacos requests (default: 3.0)
 DIFY_ENV_NACOS_CONNECT_TIMEOUT=3.0
-
-# skill entry
-ENABLE_SKILL=true

api/.importlinter

@@ -15,112 +15,6 @@ root_packages =
     services
 include_external_packages = True
 
-[importlinter:contract:backend-layers]
-name = Backend modules follow the transport, application, domain, and shared-library layers
-type = layers
-layers =
-    controllers
-    services
-    core
-    libs
-# Migration baseline: keep every exception exact. The default unmatched-import
-# error makes this list shrink whenever a legacy dependency is removed.
-unmatched_ignore_imports_alerting = error
-ignore_imports =
-    core.app.app_config.easy_ui_based_app.dataset.manager -> services.dataset_service
-    core.app.apps.advanced_chat.app_generator -> controllers.console.app.workflow
-    core.app.apps.advanced_chat.app_generator -> services.conversation_service
-    core.app.apps.advanced_chat.app_generator -> services.errors.conversation
-    core.app.apps.advanced_chat.app_generator -> services.workflow_draft_variable_service
-    core.app.apps.advanced_chat.app_runner -> services.conversation_variable_updater
-    core.app.apps.agent_app.app_generator -> services.agent.composer_service
-    core.app.apps.agent_app.app_generator -> services.agent.workspace_service
-    core.app.apps.agent_app.app_generator -> services.conversation_service
-    core.app.apps.agent_app.runtime_request_builder -> services.agent.prompt_mentions
-    core.app.apps.agent_app.session_store -> services.agent.workspace_service
-    core.app.apps.agent_chat.app_generator -> services.conversation_service
-    core.app.apps.base_app_generator -> services.workflow_draft_variable_service
-    core.app.apps.chat.app_generator -> services.conversation_service
-    core.app.apps.common.workflow_response_converter -> services.variable_truncator
-    core.app.apps.completion.app_generator -> services.errors.app
-    core.app.apps.completion.app_generator -> services.errors.message
-    core.app.apps.message_based_app_generator -> services.errors.app_model_config
-    core.app.apps.message_based_app_generator -> services.errors.conversation
-    core.app.apps.message_based_app_generator -> services.errors.message
-    core.app.apps.pipeline.pipeline_generator -> services
-    core.app.apps.pipeline.pipeline_generator -> services.dataset_service
-    core.app.apps.pipeline.pipeline_generator -> services.datasource_provider_service
-    core.app.apps.pipeline.pipeline_generator -> services.feature_service
-    core.app.apps.pipeline.pipeline_generator -> services.workflow_draft_variable_service
-    core.app.apps.pipeline.pipeline_runner -> services.dataset_ref_service
-    core.app.apps.workflow.app_generator -> controllers.console.app.workflow
-    core.app.apps.workflow.app_generator -> services.snippet_generate_service
-    core.app.apps.workflow.app_generator -> services.workflow_draft_variable_service
-    core.app.apps.workflow_app_runner -> tasks.mail_human_input_delivery_task
-    core.app.features.annotation_reply.annotation_reply -> services.annotation_service
-    core.app.features.annotation_reply.annotation_reply -> services.dataset_service
-    core.app.llm.quota -> services.credit_pool_service
-    core.app.task_pipeline.message_cycle_manager -> services.account_service
-    core.app.task_pipeline.message_cycle_manager -> services.annotation_service
-    core.app.workflow.layers.persistence -> services.workflow.inspector_events
-    core.datasource.datasource_manager -> services.datasource_provider_service
-    core.helper.credential_utils -> services.enterprise.plugin_manager_service
-    core.helper.credential_utils -> services.system_feature_service
-    core.indexing_runner -> services.vector_space_admission_service
-    core.mcp.auth_client -> services
-    core.provider_manager -> services.credential_permission_service
-    core.provider_manager -> services.credit_pool_service
-    core.provider_manager -> services.feature_service
-    core.rag.datasource.retrieval_service -> services.external_knowledge_service
-    core.rag.index_processor.index_processor -> services.vector_space_admission_service
-    core.rag.index_processor.index_processor_base -> services.file_service
-    core.rag.index_processor.processor.paragraph_index_processor -> services.account_service
-    core.rag.index_processor.processor.paragraph_index_processor -> services.summary_index_service
-    core.rag.index_processor.processor.parent_child_index_processor -> services.account_service
-    core.rag.index_processor.processor.parent_child_index_processor -> services.summary_index_service
-    core.rag.index_processor.processor.qa_index_processor -> services.summary_index_service
-    core.rag.retrieval.dataset_retrieval -> services.external_knowledge_service
-    core.rag.retrieval.dataset_retrieval -> services.feature_service
-    core.rag.summary_index.summary_index -> services.summary_index_service
-    core.rag.summary_index.summary_index -> tasks.generate_summary_index_task
-    core.repositories.sqlalchemy_workflow_node_execution_repository -> services.file_service
-    core.repositories.sqlalchemy_workflow_node_execution_repository -> services.variable_truncator
-    core.tools.tool_manager -> services
-    core.workflow.node_runtime -> services
-    core.workflow.nodes.agent.message_transformer -> services
-    core.workflow.nodes.agent_v2.agent_node -> services.agent.prompt_mentions
-    core.workflow.nodes.agent_v2.agent_node -> services.agent.workspace_service
-    core.workflow.nodes.agent_v2.dify_tools_builder -> services
-    core.workflow.nodes.agent_v2.runtime_feature_manifest -> services.agent.knowledge_datasets
-    core.workflow.nodes.agent_v2.runtime_request_builder -> services.agent.prompt_mentions
-    core.workflow.nodes.agent_v2.runtime_request_builder -> services.skill_management_service
-    core.workflow.nodes.agent_v2.session_store -> services.agent.workspace_service
-    core.workflow.nodes.agent_v2.validators -> services.agent.knowledge_datasets
-    core.workflow.nodes.agent_v2.workspace_retirement_layer -> tasks.collect_agent_resources_task
-    libs.device_flow_security -> controllers.openapi._models
-    libs.device_flow_security -> services.entities.feature_entities
-    libs.device_flow_security -> services.system_feature_service
-    libs.email_i18n -> services.entities.feature_entities
-    libs.email_i18n -> services.system_feature_service
-    libs.external_api -> core
-    libs.external_api -> core.errors.error
-    libs.external_api -> extensions.ext_logging
-    libs.flask_utils -> models
-    libs.helper -> core.app.features.rate_limiting.rate_limit
-    libs.helper -> models
-    libs.helper -> models.model
-    libs.json_in_md_parser -> core.llm_generator.output_parser.errors
-    libs.login -> extensions.ext_login
-    libs.login -> models
-    libs.login -> models.model
-    libs.oauth -> core.helper.http_client_pooling
-    libs.oauth_bearer -> models
-    libs.rsa -> extensions.ext_storage
-    libs.workspace_permission -> services.enterprise.enterprise_service
-    services.account_service -> controllers
-    services.account_service -> controllers.console.error
-    services.app_generate_service -> controllers.console.app.workflow
-
 [importlinter:contract:no-direct-rsa-imports]
 # Note: `libs` itself is deliberately excluded from source_modules -- import-linter's
 # `forbidden` contract cannot check a package against its own descendant (libs.rsa lives
@@ -171,134 +65,6 @@ forbidden_modules =
     sqlalchemy
     werkzeug
 
-[importlinter:contract:init-validation-service-boundary]
-name = Initialization validation application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.init_validation_service
-forbidden_modules =
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:explore-banner-query-service-boundary]
-name = Explore banner query application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.explore_banner_query_service
-forbidden_modules =
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:account-application-boundary]
-name = Account application services and contracts are framework and persistence neutral
-type = forbidden
-source_modules =
-    services.account_access_service
-    services.account_avatar_service
-    services.account_change_email_ports
-    services.account_change_email_service
-    services.account_email_registration_service
-    services.account_deletion_service
-    services.account_deletion_feedback_service
-    services.account_education_service
-    services.account_errors
-    services.account_forgot_password_service
-    services.account_initialization_service
-    services.account_integration_service
-    services.account_login_service
-    services.account_oauth_service
-    services.account_password_service
-    services.account_ports
-    services.account_profile_service
-    services.entities.account_access_entities
-    services.entities.account_entities
-    services.entities.account_login_entities
-    services.entities.account_oauth_entities
-    services.entities.auth_audit_entities
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:app-definition-query-service-boundary]
-name = App definition query application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.app_definition_query_service
-forbidden_modules =
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:app-site-service-boundary]
-name = App site application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.app_site_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:webapp-access-query-service-boundary]
-name = Web app access query application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.webapp_access_query_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    services.enterprise
-    services.feature_service
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:web-app-runtime-query-service-boundary]
-name = Web app runtime query application service does not directly depend on configuration, feature implementation, transport, or ORM modules
-type = forbidden
-source_modules =
-    services.web_app_runtime_query_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    services.feature_service
-    services.feature_service_gateway
-    sqlalchemy
-    werkzeug
-allow_indirect_imports = True
-
 [importlinter:contract:feature-query-service-boundary]
 name = Feature query application service is framework and persistence neutral
 type = forbidden
@@ -313,40 +79,6 @@ forbidden_modules =
     sqlalchemy
     werkzeug
 
-[importlinter:contract:data-source-oauth-service-boundary]
-name = Data source OAuth application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.data_source_oauth_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    httpx
-    libs
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:oauth-server-application-service-boundary]
-name = OAuth server application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.oauth_server_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    httpx
-    libs
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
 [importlinter:contract:workspace-member-query-service-boundary]
 name = Workspace member query application service is framework and persistence neutral
 type = forbidden
@@ -393,141 +125,3 @@ forbidden_modules =
     repositories
     sqlalchemy
     werkzeug
-
-[importlinter:contract:inner-mail-service-boundary]
-name = Inner mail application service is framework and implementation neutral
-type = forbidden
-source_modules =
-    services.inner_mail_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    tasks
-    werkzeug
-
-[importlinter:contract:web-passport-service-boundary]
-name = Web passport application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.web_passport_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:file-grant-service-boundary]
-name = File grant application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.file_grant_service
-    services.entities.file_grant_entities
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:account-activation-service-boundary]
-name = Account activation application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.account_activation_service
-    services.entities.account_activation_entities
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:tag-application-service-boundary]
-name = Tag application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.tag_application_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:recommended-app-query-service-boundary]
-name = Recommended app query application service is framework and persistence neutral
-type = forbidden
-source_modules =
-    services.recommended_app_query_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    services.feature_service
-    services.recommended_app_catalog_gateway
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:recommended-app-catalog-gateway-boundary]
-name = Recommended app catalog gateway does not depend on Flask
-type = forbidden
-source_modules =
-    services.recommended_app_catalog_gateway
-forbidden_modules =
-    flask
-
-[importlinter:contract:billing-application-boundary]
-name = Billing application services and ports are framework and infrastructure neutral
-type = forbidden
-source_modules =
-    services.billing_portal_service
-    services.compliance_download_service
-    services.partner_tenant_binding_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    services.billing_service
-    sqlalchemy
-    werkzeug
-
-[importlinter:contract:workflow-run-archive-application-boundary]
-name = Workflow run archive application service and task domain are framework and persistence neutral
-type = forbidden
-source_modules =
-    services.retention.workflow_run.archive_download_task
-    services.retention.workflow_run.archive_log_service
-forbidden_modules =
-    configs
-    controllers
-    extensions
-    flask
-    models
-    repositories
-    sqlalchemy
-    tasks
-    werkzeug

api/Dockerfile

@@ -33,6 +33,7 @@ RUN uv sync --frozen --no-dev --no-editable
 FROM base AS production
 
 ENV FLASK_APP=app.py
+ENV EDITION=SELF_HOSTED
 ENV DEPLOY_ENV=PRODUCTION
 ENV CONSOLE_API_URL=http://127.0.0.1:5001
 ENV CONSOLE_WEB_URL=http://127.0.0.1:3000
@@ -53,14 +54,15 @@ WORKDIR /app/api
 
 # Create non-root user
 ARG dify_uid=1001
-ARG NODE_PACKAGE_VERSION=24.20.0-1nodesource1
+ARG NODE_MAJOR=22
+ARG NODE_PACKAGE_VERSION=22.21.0-1nodesource1
 ARG NODESOURCE_KEY_FPR=6F71F525282841EEDAF851B42F59B5F99B1BE0B4
 RUN groupadd -r -g ${dify_uid} dify && \
     useradd -r -u ${dify_uid} -g ${dify_uid} -s /bin/bash dify && \
     chown -R dify:dify /app
 
-RUN NODE_MAJOR="${NODE_PACKAGE_VERSION%%.*}" \
-    && apt-get update \
+RUN \
+    apt-get update \
     && apt-get install -y --no-install-recommends \
         ca-certificates \
         curl \

api/README.md

@@ -96,7 +96,7 @@ The scripts resolve paths relative to their location, so you can run them from a
    uv run pytest tests/integration_tests/  # Integration tests
 
    # Code quality
-   ../dev/reformat              # Run all formatters and linters
+   ./dev/reformat               # Run all formatters and linters
    uv run ruff check --fix ./   # Fix linting issues
    uv run ruff format ./        # Format code
    uv run pyrefly check         # Type checking

api/app_factory.py

@@ -14,7 +14,6 @@ from contexts.wrapper import RecyclableContextVar
 from controllers.console.error import UnauthorizedAndForceLogout
 from core.logging.context import init_request_context
 from dify_app import DifyApp
-from enums import DeploymentEdition
 from extensions.ext_socketio import sio
 from services.enterprise.enterprise_service import EnterpriseService
 from services.entities.feature_entities import LicenseStatus
@@ -113,7 +112,7 @@ def create_flask_app_with_configs() -> DifyApp:
         init_request_context()
         RecyclableContextVar.increment_thread_recycles()
 
-        if dify_config.DEPLOYMENT_EDITION == DeploymentEdition.ENTERPRISE:
+        if dify_config.ENTERPRISE_ENABLED:
             surface = _match_license_gated_surface(request.path)
             if surface is not None:
                 try:

api/clients/agent_backend/client.py

@@ -23,7 +23,6 @@ from dify_agent.protocol import (
     CancelRunResponse,
     CreateRunRequest,
     CreateRunResponse,
-    RunCancelledEvent,
     RunEvent,
     RunStatusResponse,
 )
@@ -46,15 +45,6 @@ class AgentBackendRunClient(Protocol):
     def cancel_run(self, run_id: str, request: CancelRunRequest | None = None) -> CancelRunResponse:
         """Request explicit cancellation for one Agent backend run."""
 
-    def cancel_run_and_wait(
-        self,
-        run_id: str,
-        request: CancelRunRequest | None = None,
-        *,
-        after: str | None = None,
-    ) -> RunCancelledEvent:
-        """Request cancellation and wait for runner cleanup to finish."""
-
     def stream_events(
         self,
         run_id: str,
@@ -77,15 +67,6 @@ class _DifyAgentSyncClient(Protocol):
     def cancel_run_sync(self, run_id: str, request: CancelRunRequest | None = None) -> CancelRunResponse:
         """Cancel one run synchronously."""
 
-    def cancel_run_and_wait_sync(
-        self,
-        run_id: str,
-        request: CancelRunRequest | None = None,
-        *,
-        after: str | None = None,
-    ) -> RunCancelledEvent:
-        """Cancel one run and wait for its terminal event synchronously."""
-
     def stream_events_sync(
         self,
         run_id: str,
@@ -111,9 +92,11 @@ class DifyAgentBackendRunClient:
         client: _DifyAgentSyncClient,
         *,
         stream_max_reconnects: int = 3,
+        stream_timeout_seconds: float = 1200,
     ) -> None:
         self.client = client
         self._stream_max_reconnects = stream_max_reconnects
+        self._stream_timeout_seconds = stream_timeout_seconds
 
     def create_run(self, request: CreateRunRequest) -> CreateRunResponse:
         """Create one run through ``POST /runs`` and normalize client exceptions."""
@@ -129,19 +112,6 @@ class DifyAgentBackendRunClient:
         except Exception as exc:
             raise _normalize_dify_agent_error(exc) from exc
 
-    def cancel_run_and_wait(
-        self,
-        run_id: str,
-        request: CancelRunRequest | None = None,
-        *,
-        after: str | None = None,
-    ) -> RunCancelledEvent:
-        """Cancel one run, then wait for the cleanup-complete terminal event."""
-        try:
-            return self.client.cancel_run_and_wait_sync(run_id, request=request, after=after)
-        except Exception as exc:
-            raise _normalize_dify_agent_error(exc) from exc
-
     def stream_events(
         self,
         run_id: str,
@@ -155,6 +125,7 @@ class DifyAgentBackendRunClient:
                 run_id,
                 after=after,
                 max_reconnects=self._stream_max_reconnects,
+                timeout_seconds=self._stream_timeout_seconds,
                 should_stop=should_stop,
             )
         except Exception as exc:

api/clients/agent_backend/errors.py

@@ -8,40 +8,11 @@ classes.
 
 from __future__ import annotations
 
-from http import HTTPStatus
 from typing import Any
 
-from dify_agent.client import DifyAgentHTTPError
 from dify_agent.protocol import RunFailureType
 
 
-def backend_reported_failure(exc: DifyAgentHTTPError) -> bool:
-    """Whether the backend itself reported the failure.
-
-    ``DifyAgentValidationError`` is a ``DifyAgentHTTPError`` that the client also
-    raises when a *successful* response fails DTO validation. Those carry a 2xx
-    status and a Pydantic error list, not a backend-authored error envelope.
-    """
-    return exc.status_code >= HTTPStatus.BAD_REQUEST
-
-
-def backend_error_detail(
-    exc: DifyAgentHTTPError,
-    *,
-    default_code: str = "agent_backend_error",
-) -> tuple[str, str]:
-    """Split an Agent backend HTTP error into the code and message the backend itself sent."""
-    detail = exc.detail
-    if isinstance(detail, dict):
-        code = detail.get("code")
-        message = detail.get("message")
-        return (
-            code if isinstance(code, str) and code else default_code,
-            message if isinstance(message, str) and message else str(exc),
-        )
-    return default_code, str(detail)
-
-
 class AgentBackendError(Exception):
     """Base error for API-side Agent backend integration failures."""
 

api/clients/agent_backend/event_adapter.py

@@ -99,8 +99,6 @@ class AgentBackendRunFailedInternalEvent(AgentBackendInternalEventBase):
     error: str
     error_type: RunFailureType | None = None
     reason: str | None = None
-    session_snapshot: CompositorSessionSnapshot | None = None
-    usage: dict[str, JsonValue] | None = None
 
 
 class AgentBackendRunCancelledInternalEvent(AgentBackendInternalEventBase):
@@ -109,8 +107,6 @@ class AgentBackendRunCancelledInternalEvent(AgentBackendInternalEventBase):
     type: Literal[AgentBackendInternalEventType.RUN_CANCELLED] = AgentBackendInternalEventType.RUN_CANCELLED
     reason: str | None = None
     message: str | None = None
-    session_snapshot: CompositorSessionSnapshot | None = None
-    usage: dict[str, JsonValue] | None = None
 
 
 type AgentBackendInternalEvent = Annotated[
@@ -188,8 +184,6 @@ class AgentBackendRunEventAdapter:
                         error=event.data.error,
                         error_type=event.data.error_type,
                         reason=event.data.reason,
-                        session_snapshot=event.data.session_snapshot,
-                        usage=_agent_run_usage(event.data.usage),
                     )
                 ]
             case RunCancelledEvent():
@@ -199,8 +193,6 @@ class AgentBackendRunEventAdapter:
                         source_event_id=event.id,
                         reason=event.data.reason,
                         message=event.data.message,
-                        session_snapshot=event.data.session_snapshot,
-                        usage=_agent_run_usage(event.data.usage),
                     )
                 ]
         raise TypeError(f"unsupported agent backend run event: {type(event).__name__}")

api/clients/agent_backend/factory.py

@@ -8,25 +8,6 @@ from clients.agent_backend.client import AgentBackendRunClient, DifyAgentBackend
 from clients.agent_backend.fake_client import FakeAgentBackendRunClient, FakeAgentBackendScenario
 
 
-def create_agent_backend_client(
-    *,
-    base_url: str,
-    api_token: str | None = None,
-    stream_timeout: float = 30,
-    timeout: float = 30.0,
-    binding_file_download_timeout: float = 240,
-) -> Client:
-    api_token = api_token.strip() if api_token else None
-    headers = {"Authorization": f"Bearer {api_token}"} if api_token else None
-    return Client(
-        base_url=base_url,
-        stream_timeout=stream_timeout,
-        timeout=timeout,
-        binding_file_download_timeout=binding_file_download_timeout,
-        headers=headers,
-    )
-
-
 def create_agent_backend_run_client(
     *,
     base_url: str | None = None,
@@ -35,17 +16,18 @@ def create_agent_backend_run_client(
     fake_scenario: str | FakeAgentBackendScenario = FakeAgentBackendScenario.SUCCESS,
     stream_read_timeout_seconds: float = 30,
     stream_max_reconnects: int = 3,
+    stream_run_timeout_seconds: float = 1200,
 ) -> AgentBackendRunClient:
     """Create the API-side run client without hiding the ``dify-agent`` protocol."""
     if use_fake:
         return FakeAgentBackendRunClient(scenario=FakeAgentBackendScenario(fake_scenario))
     if base_url is None:
         raise ValueError("base_url is required when creating a real Agent backend client")
+    headers: dict[str, str] = {}
+    if api_token:
+        headers["Authorization"] = f"Bearer {api_token}"
     return DifyAgentBackendRunClient(
-        create_agent_backend_client(
-            base_url=base_url,
-            api_token=api_token,
-            stream_timeout=stream_read_timeout_seconds,
-        ),
+        Client(base_url=base_url, stream_timeout=stream_read_timeout_seconds, headers=headers),
         stream_max_reconnects=stream_max_reconnects,
+        stream_timeout_seconds=stream_run_timeout_seconds,
     )

api/clients/agent_backend/fake_client.py

@@ -18,8 +18,6 @@ from dify_agent.protocol import (
     CreateRunRequest,
     CreateRunResponse,
     DeferredToolCallPayload,
-    RunCancelledEvent,
-    RunCancelledEventData,
     RunEvent,
     RunFailedEvent,
     RunFailedEventData,
@@ -71,28 +69,6 @@ class FakeAgentBackendRunClient:
         del request
         return CancelRunResponse(run_id=run_id, status="cancelled")
 
-    def cancel_run_and_wait(
-        self,
-        run_id: str,
-        request: CancelRunRequest | None = None,
-        *,
-        after: str | None = None,
-    ) -> RunCancelledEvent:
-        """Return a deterministic cleanup-complete cancellation event."""
-        del after
-        request = request or CancelRunRequest()
-        _ = self.cancel_run(run_id, request)
-        return RunCancelledEvent(
-            id="cancel-0",
-            run_id=run_id,
-            created_at=_FIXED_TIME,
-            data=RunCancelledEventData(
-                reason=request.reason,
-                message=request.message,
-                session_snapshot=CompositorSessionSnapshot(layers=[]),
-            ),
-        )
-
     def stream_events(
         self,
         run_id: str,
@@ -157,11 +133,7 @@ class FakeAgentBackendRunClient:
                         id="2-0",
                         run_id=run_id,
                         created_at=_FIXED_TIME,
-                        data=RunFailedEventData(
-                            error="fake failure",
-                            reason="unit_test",
-                            session_snapshot=CompositorSessionSnapshot(layers=[]),
-                        ),
+                        data=RunFailedEventData(error="fake failure", reason="unit_test"),
                     ),
                 )
             case FakeAgentBackendScenario.PAUSED:

api/clients/agent_backend/request_builder.py

@@ -25,9 +25,11 @@ from dify_agent.layers.dify_core_tools import DIFY_CORE_TOOLS_LAYER_TYPE_ID, Dif
 from dify_agent.layers.dify_plugin import (
     DIFY_PLUGIN_LLM_LAYER_TYPE_ID,
     DIFY_PLUGIN_TOOLS_LAYER_TYPE_ID,
+    DifyPluginCredentialValue,
     DifyPluginLLMLayerConfig,
     DifyPluginToolsLayerConfig,
 )
+from dify_agent.layers.drive import DIFY_DRIVE_LAYER_TYPE_ID, DifyDriveLayerConfig
 from dify_agent.layers.execution_context import (
     DIFY_EXECUTION_CONTEXT_LAYER_TYPE_ID,
     DifyExecutionContextLayerConfig,
@@ -55,6 +57,7 @@ AGENT_APP_USER_PROMPT_LAYER_ID = "agent_app_user_prompt"
 DIFY_EXECUTION_CONTEXT_LAYER_ID = "execution_context"
 DIFY_RUNTIME_LAYER_ID = "runtime"
 DIFY_CONFIG_LAYER_ID = "config"
+DIFY_DRIVE_LAYER_ID = "drive"
 DIFY_PLUGIN_TOOLS_LAYER_ID = "tools"
 DIFY_CORE_TOOLS_LAYER_ID = "core_tools"
 DIFY_KNOWLEDGE_BASE_LAYER_ID = "knowledge"
@@ -70,10 +73,24 @@ def _shell_layer_deps() -> dict[str, str]:
     }
 
 
+def _drive_layer_deps() -> dict[str, str]:
+    return {"shell": DIFY_SHELL_LAYER_ID}
+
+
 def _config_layer_deps() -> dict[str, str]:
     return {"shell": DIFY_SHELL_LAYER_ID}
 
 
+def _shell_config_with_drive_ref(
+    shell_config: DifyShellLayerConfig | None,
+    drive_config: DifyDriveLayerConfig | None,
+) -> DifyShellLayerConfig:
+    config = shell_config or DifyShellLayerConfig()
+    if drive_config is None:
+        return config
+    return config.model_copy(update={"agent_stub_drive_ref": drive_config.drive_ref})
+
+
 def _markdown_backtick_fence(text: str) -> str:
     """Choose a fence that will not terminate inside the prompt body."""
     longest_backtick_run = max((len(match.group(0)) for match in re.finditer(r"`+", text)), default=0)
@@ -133,8 +150,8 @@ class AgentBackendModelConfig(BaseModel):
     plugin_id: str
     model_provider: str
     model: str
+    credentials: dict[str, DifyPluginCredentialValue] = Field(default_factory=dict)
     model_settings: dict[str, JsonValue] = Field(default_factory=dict)
-    context_window_tokens: int | None = Field(default=None, gt=0)
 
     model_config: ClassVar[ConfigDict] = ConfigDict(extra="forbid")
 
@@ -142,12 +159,8 @@ class AgentBackendModelConfig(BaseModel):
 # ``DifyPluginLLMLayerConfig.model_settings`` is pydantic_ai's ``ModelSettings``
 # TypedDict (closed: unknown keys are rejected, explicit ``None`` values fail the
 # per-field type checks). Agent Soul model settings carry a wider, nullable shape
-# (``stop`` / ``response_format`` plus null-padded fields, plus arbitrary
-# plugin-declared parameters such as Qwen's ``enable_thinking``), so the layer
-# config only receives the keys the runtime contract accepts directly; anything
-# else is forwarded through ``extra_body``, the TypedDict's own escape hatch for
-# provider-specific parameters (see
-# ``dify_agent.adapters.llm.model._map_model_settings_to_parameters``).
+# (``stop`` / ``response_format`` plus null-padded fields), so the layer config
+# only receives the keys the runtime contract accepts.
 _AGENT_MODEL_SETTINGS_PASSTHROUGH_KEYS = (
     "temperature",
     "top_p",
@@ -155,7 +168,6 @@ _AGENT_MODEL_SETTINGS_PASSTHROUGH_KEYS = (
     "frequency_penalty",
     "max_tokens",
 )
-_AGENT_MODEL_SETTINGS_KNOWN_KEYS = frozenset({*_AGENT_MODEL_SETTINGS_PASSTHROUGH_KEYS, "stop", "response_format"})
 
 
 def _agent_model_settings(settings: Mapping[str, JsonValue]) -> dict[str, JsonValue] | None:
@@ -165,15 +177,6 @@ def _agent_model_settings(settings: Mapping[str, JsonValue]) -> dict[str, JsonVa
     stop = settings.get("stop")
     if isinstance(stop, list) and stop:
         sanitized["stop_sequences"] = stop
-
-    extra_body: dict[str, JsonValue] = {
-        key: value
-        for key, value in settings.items()
-        if key not in _AGENT_MODEL_SETTINGS_KNOWN_KEYS and value is not None
-    }
-    if extra_body:
-        sanitized["extra_body"] = extra_body
-
     return sanitized or None
 
 
@@ -208,6 +211,9 @@ class AgentBackendWorkflowNodeRunInput(BaseModel):
     core_tools: DifyCoreToolsLayerConfig | None = None
     knowledge: DifyKnowledgeBaseLayerConfig | None = None
     config_layer_config: DifyConfigLayerConfig | None = None
+    # Drive Skills & Files declaration (dify.drive) — an index the agent pulls
+    # through the back proxy, never inline content.
+    drive_config: DifyDriveLayerConfig | None = None
     # Human-in-the-loop ask_human deferred tool (dify.ask_human). Present only when
     # the Agent Soul configures human involvement; a deferred call ends the run and
     # the workflow pauses via the existing HITL form mechanism (ENG-635).
@@ -254,6 +260,9 @@ class AgentBackendAgentAppRunInput(BaseModel):
     core_tools: DifyCoreToolsLayerConfig | None = None
     knowledge: DifyKnowledgeBaseLayerConfig | None = None
     config_layer_config: DifyConfigLayerConfig | None = None
+    # Drive Skills & Files declaration (dify.drive) — an index the agent pulls
+    # through the back proxy, never inline content.
+    drive_config: DifyDriveLayerConfig | None = None
     # Human-in-the-loop ask_human deferred tool (dify.ask_human). Present only when
     # the Agent Soul configures human involvement (ENG-635).
     ask_human_config: DifyAskHumanLayerConfig | None = None
@@ -285,7 +294,7 @@ class AgentBackendRunRequestBuilder:
         """Build an Agent App conversation-turn run request.
 
         Layer graph: optional Agent Soul system prompt → user prompt →
-        execution context → optional shell / config / history
+        execution context → optional shell / config / drive / history
         (multi-turn) → LLM → optional plugin-direct tools / core-routed tools /
         knowledge search / ask_human / structured output. Mirrors the
         workflow-node layer ordering minus the workflow-job / previous-node
@@ -323,7 +332,9 @@ class AgentBackendRunRequestBuilder:
             ]
         )
 
-        include_shell = run_input.include_shell or run_input.config_layer_config is not None
+        include_shell = (
+            run_input.include_shell or run_input.config_layer_config is not None or run_input.drive_config is not None
+        )
         if include_shell:
             layers.append(
                 RunLayerSpec(
@@ -333,15 +344,16 @@ class AgentBackendRunRequestBuilder:
                     config=DifyRuntimeLayerConfig(backend_binding_ref=run_input.backend_binding_ref),
                 )
             )
-            # Sandboxed bash workspace (dify.shell). It enters before config so
-            # eager pulls materialize content in the same filesystem used by model commands.
+            # Sandboxed bash workspace (dify.shell). It enters before config/drive
+            # so eager pulls materialize content in the same filesystem used by
+            # model commands.
             layers.append(
                 RunLayerSpec(
                     name=DIFY_SHELL_LAYER_ID,
                     type=DIFY_SHELL_LAYER_TYPE_ID,
                     deps=_shell_layer_deps(),
                     metadata=run_input.metadata,
-                    config=run_input.shell_config or DifyShellLayerConfig(),
+                    config=_shell_config_with_drive_ref(run_input.shell_config, run_input.drive_config),
                 )
             )
 
@@ -356,6 +368,19 @@ class AgentBackendRunRequestBuilder:
                 )
             )
 
+        if run_input.drive_config is not None:
+            # Drive Skills & Files declaration (dify.drive): the catalog plus
+            # prompt-mentioned entries eagerly pulled through the shell layer.
+            layers.append(
+                RunLayerSpec(
+                    name=DIFY_DRIVE_LAYER_ID,
+                    type=DIFY_DRIVE_LAYER_TYPE_ID,
+                    deps=_drive_layer_deps(),
+                    metadata=run_input.metadata,
+                    config=run_input.drive_config,
+                )
+            )
+
         if run_input.include_history:
             layers.append(
                 RunLayerSpec(
@@ -375,8 +400,8 @@ class AgentBackendRunRequestBuilder:
                     plugin_id=run_input.model.plugin_id,
                     model_provider=run_input.model.model_provider,
                     model=run_input.model.model,
+                    credentials=run_input.model.credentials,
                     model_settings=_agent_model_settings(run_input.model.model_settings),
-                    context_window_tokens=run_input.model.context_window_tokens,
                 ),
             )
         )
@@ -457,7 +482,7 @@ class AgentBackendRunRequestBuilder:
         """Build a workflow Agent Node run request without defining another wire schema.
 
         Layer graph mirrors the workflow surface: prompts → execution context →
-        optional shell / config / history → LLM → optional
+        optional shell / config / drive / history → LLM → optional
         plugin-direct tools / core-routed tools / knowledge search /
         ask_human / structured output.
         """
@@ -499,7 +524,9 @@ class AgentBackendRunRequestBuilder:
             ]
         )
 
-        include_shell = run_input.include_shell or run_input.config_layer_config is not None
+        include_shell = (
+            run_input.include_shell or run_input.config_layer_config is not None or run_input.drive_config is not None
+        )
         if include_shell:
             layers.append(
                 RunLayerSpec(
@@ -509,15 +536,16 @@ class AgentBackendRunRequestBuilder:
                     config=DifyRuntimeLayerConfig(backend_binding_ref=run_input.backend_binding_ref),
                 )
             )
-            # Sandboxed bash workspace (dify.shell). It enters before config so
-            # eager pulls materialize content in the same filesystem used by model commands.
+            # Sandboxed bash workspace (dify.shell). It enters before drive so
+            # drive can materialize mentioned targets with `dify-agent drive pull`
+            # in the same shell-visible filesystem used by model commands.
             layers.append(
                 RunLayerSpec(
                     name=DIFY_SHELL_LAYER_ID,
                     type=DIFY_SHELL_LAYER_TYPE_ID,
                     deps=_shell_layer_deps(),
                     metadata=run_input.metadata,
-                    config=run_input.shell_config or DifyShellLayerConfig(),
+                    config=_shell_config_with_drive_ref(run_input.shell_config, run_input.drive_config),
                 )
             )
 
@@ -532,6 +560,19 @@ class AgentBackendRunRequestBuilder:
                 )
             )
 
+        if run_input.drive_config is not None:
+            # Drive Skills & Files declaration (dify.drive): the catalog plus
+            # prompt-mentioned entries eagerly pulled through the shell layer.
+            layers.append(
+                RunLayerSpec(
+                    name=DIFY_DRIVE_LAYER_ID,
+                    type=DIFY_DRIVE_LAYER_TYPE_ID,
+                    deps=_drive_layer_deps(),
+                    metadata=run_input.metadata,
+                    config=run_input.drive_config,
+                )
+            )
+
         if run_input.include_history:
             layers.append(
                 RunLayerSpec(
@@ -552,8 +593,8 @@ class AgentBackendRunRequestBuilder:
                         plugin_id=run_input.model.plugin_id,
                         model_provider=run_input.model.model_provider,
                         model=run_input.model.model,
+                        credentials=run_input.model.credentials,
                         model_settings=_agent_model_settings(run_input.model.model_settings),
-                        context_window_tokens=run_input.model.context_window_tokens,
                     ),
                 ),
             ]

api/commands/__init__.py

@@ -22,12 +22,7 @@ from .plugin import (
     setup_system_trigger_oauth_client,
     transform_datasource_credentials,
 )
-from .rbac import (
-    migrate_dataset_permissions_to_rbac,
-    migrate_member_roles_to_rbac,
-    migrate_only_me_resource_whitelist_scopes_to_automatic_include,
-    migrate_resource_whitelist_scopes_to_automatic_include,
-)
+from .rbac import migrate_dataset_permissions_to_rbac, migrate_member_roles_to_rbac
 from .retention import (
     archive_workflow_runs,
     archive_workflow_runs_plan,
@@ -86,9 +81,7 @@ __all__ = [
     "migrate_dataset_permissions_to_rbac",
     "migrate_knowledge_vector_database",
     "migrate_member_roles_to_rbac",
-    "migrate_only_me_resource_whitelist_scopes_to_automatic_include",
     "migrate_oss",
-    "migrate_resource_whitelist_scopes_to_automatic_include",
     "migration_data_wizard",
     "old_metadata_migration",
     "remove_orphaned_files_on_storage",

api/commands/account.py

@@ -8,7 +8,6 @@ from constants.languages import languages
 from extensions.ext_database import db
 from libs.helper import email as email_validate
 from libs.password import hash_password, password_pattern, valid_password
-from services.account_email import normalize_email
 from services.account_service import AccountService, RegisterService, TenantService
 
 
@@ -21,7 +20,7 @@ def reset_password(email, new_password, password_confirm):
     Reset password of owner account
     Only available in SELF_HOSTED mode
     """
-    if new_password.strip() != password_confirm.strip():
+    if str(new_password).strip() != str(password_confirm).strip():
         click.echo(click.style("Passwords do not match.", fg="red"))
         return
     normalized_email = email.strip().lower()
@@ -34,7 +33,7 @@ def reset_password(email, new_password, password_confirm):
 
     try:
         valid_password(new_password)
-    except ValueError:
+    except:
         click.echo(click.style(f"Invalid password. Must match {password_pattern}", fg="red"))
         return
 
@@ -63,7 +62,7 @@ def reset_email(email, new_email, email_confirm):
     Replace account email
     :return:
     """
-    if new_email.strip() != email_confirm.strip():
+    if str(new_email).strip() != str(email_confirm).strip():
         click.echo(click.style("New emails do not match.", fg="red"))
         return
     normalized_new_email = new_email.strip().lower()
@@ -76,14 +75,13 @@ def reset_email(email, new_email, email_confirm):
 
     try:
         email_validate(normalized_new_email)
-    except ValueError:
+    except:
         click.echo(click.style(f"Invalid email: {new_email}", fg="red"))
         return
 
     with Session(db.engine) as session:
         account = session.merge(account)
         account.email = normalized_new_email
-        account.normalized_email = normalize_email(normalized_new_email)
         session.commit()
     click.echo(click.style("Email updated successfully.", fg="green"))
 

api/commands/data_migrate.py

@@ -7,11 +7,7 @@ from typing import cast
 
 import click
 
-from commands.rbac import (
-    migrate_dataset_permissions_to_rbac,
-    migrate_only_me_resource_whitelist_scopes_to_automatic_include,
-    migrate_resource_whitelist_scopes_to_automatic_include,  # noqa: F401
-)
+from commands.rbac import migrate_dataset_permissions_to_rbac
 from extensions.ext_database import db
 from graphon.model_runtime.entities.model_entities import ModelType
 from services.legacy_model_type_migration import (
@@ -183,4 +179,3 @@ def legacy_model_types(
 
 data_migrate.add_command(legacy_model_types)
 data_migrate.add_command(migrate_dataset_permissions_to_rbac)
-data_migrate.add_command(migrate_only_me_resource_whitelist_scopes_to_automatic_include)

api/commands/rbac.py

@@ -11,11 +11,10 @@ from sqlalchemy.orm import Session
 from configs import dify_config
 from core.db.session_factory import session_factory
 from core.rbac import RBACResourceWhitelistScope
-from models import App, Dataset, DatasetPermission, DatasetPermissionEnum, TenantAccountJoin, TenantAccountRole
+from models import Dataset, DatasetPermission, DatasetPermissionEnum, TenantAccountJoin, TenantAccountRole
 from services.enterprise.rbac_service import ListOption, RBACService, ReplaceMemberBindings, ReplaceUserAccessPolicies
 
 _RBAC_DEFAULT_ACCESS_POLICY_ID = "default"
-_RBAC_RESOURCE_ACCESS_POLICY_BATCH_SIZE = 500
 
 _LEGACY_ROLE_TO_BUILTIN_TAG = {
     TenantAccountRole.OWNER.value: "owner",
@@ -311,499 +310,6 @@ def _emit_dataset_permission_migration_event(payload: dict[str, object]) -> None
     click.echo(json.dumps(payload, sort_keys=True))
 
 
-def _emit_resource_whitelist_scope_migration_event(payload: dict[str, object]) -> None:
-    click.echo(json.dumps(payload, sort_keys=True))
-
-
-def _normalize_rbac_whitelist_scope(scope: object) -> RBACResourceWhitelistScope | None:
-    if scope is None:
-        return None
-    try:
-        return RBACResourceWhitelistScope(str(scope))
-    except ValueError as exc:
-        raise ValueError(f"Unsupported RBAC whitelist scope: {scope}") from exc
-
-
-def _owner_account_id(tenant_id: str, *, session: Session) -> str:
-    account_id = session.scalar(
-        select(TenantAccountJoin.account_id)
-        .where(TenantAccountJoin.tenant_id == tenant_id, TenantAccountJoin.role == TenantAccountRole.OWNER)
-        .order_by(TenantAccountJoin.id.asc())
-        .limit(1)
-    )
-    if not account_id:
-        raise ValueError(f"Workspace owner not found for tenant={tenant_id}")
-    return str(account_id)
-
-
-def _workspace_member_account_id_batches(tenant_id: str, batch_size: int) -> Iterator[list[str]]:
-    last_join_id: str | None = None
-    while True:
-        with session_factory.create_session() as session:
-            stmt = (
-                select(TenantAccountJoin.id, TenantAccountJoin.account_id)
-                .where(TenantAccountJoin.tenant_id == tenant_id)
-                .order_by(TenantAccountJoin.id.asc())
-                .limit(batch_size)
-            )
-            if last_join_id:
-                stmt = stmt.where(TenantAccountJoin.id > last_join_id)
-
-            rows = list(session.execute(stmt).all())
-            if not rows:
-                return
-
-        yield [str(row.account_id) for row in rows]
-        last_join_id = str(rows[-1].id)
-
-
-def _replace_resource_whitelist(
-    resource_type: str,
-    *,
-    tenant_id: str,
-    operator_account_id: str,
-    resource_id: str,
-    automatic_include_workspace_members: bool,
-) -> None:
-    payload = ReplaceMemberBindings(automatic_include_workspace_members=automatic_include_workspace_members)
-    if resource_type == "app":
-        RBACService.AppAccess.replace_whitelist(
-            tenant_id=tenant_id,
-            account_id=operator_account_id,
-            app_id=resource_id,
-            payload=payload,
-        )
-        return
-    RBACService.DatasetAccess.replace_whitelist(
-        tenant_id=tenant_id,
-        account_id=operator_account_id,
-        dataset_id=resource_id,
-        payload=payload,
-    )
-
-
-def _replace_resource_default_access_policies(
-    resource_type: str,
-    *,
-    tenant_id: str,
-    operator_account_id: str,
-    resource_id: str,
-    account_ids: list[str],
-) -> None:
-    if not account_ids:
-        return
-    payload = ReplaceUserAccessPolicies(
-        access_policy_ids=[_RBAC_DEFAULT_ACCESS_POLICY_ID],
-        account_ids=account_ids,
-    )
-    if resource_type == "app":
-        RBACService.AppAccess.replace_user_access_policies(
-            tenant_id=tenant_id,
-            account_id=operator_account_id,
-            app_id=resource_id,
-            target_account_id=None,
-            payload=payload,
-        )
-        return
-    RBACService.DatasetAccess.replace_user_access_policies(
-        tenant_id=tenant_id,
-        account_id=operator_account_id,
-        dataset_id=resource_id,
-        target_account_id=None,
-        payload=payload,
-    )
-
-
-def _resource_legacy_whitelist_config(
-    resource_type: str,
-    *,
-    tenant_id: str,
-    operator_account_id: str,
-    resource_id: str,
-):
-    if resource_type == "app":
-        return RBACService.AppAccess.legacy_whitelist_config(
-            tenant_id=tenant_id,
-            account_id=operator_account_id,
-            app_id=resource_id,
-        )
-    return RBACService.DatasetAccess.legacy_whitelist_config(
-        tenant_id=tenant_id,
-        account_id=operator_account_id,
-        dataset_id=resource_id,
-    )
-
-
-def _iter_rbac_resource_rows(
-    resource_type: str,
-    *,
-    tenant_id: str | None,
-    resource_id: str | None,
-    batch_size: int,
-) -> Iterator[tuple[str, str, str, str | None]]:
-    model = App if resource_type == "app" else Dataset
-    last_resource_id: str | None = None
-    while True:
-        with session_factory.create_session() as session:
-            stmt = select(model.id, model.tenant_id, model.maintainer).order_by(model.id.asc()).limit(batch_size)
-            if tenant_id:
-                stmt = stmt.where(model.tenant_id == tenant_id)
-            if resource_id:
-                stmt = stmt.where(model.id == resource_id)
-            if last_resource_id:
-                stmt = stmt.where(model.id > last_resource_id)
-
-            rows = list(session.execute(stmt).all())
-            if not rows:
-                return
-
-        for row in rows:
-            yield resource_type, str(row.tenant_id), str(row.id), str(row.maintainer) if row.maintainer else None
-
-        last_resource_id = str(rows[-1].id)
-        if resource_id:
-            return
-
-
-def _iter_selected_rbac_resource_rows(
-    resource_type: str,
-    *,
-    tenant_id: str | None,
-    resource_id: str | None,
-    batch_size: int,
-) -> Iterator[tuple[str, str, str, str | None]]:
-    if resource_type in {"app", "all"}:
-        yield from _iter_rbac_resource_rows(
-            "app",
-            tenant_id=tenant_id,
-            resource_id=resource_id if resource_type == "app" else None,
-            batch_size=batch_size,
-        )
-    if resource_type in {"dataset", "all"}:
-        yield from _iter_rbac_resource_rows(
-            "dataset",
-            tenant_id=tenant_id,
-            resource_id=resource_id if resource_type == "dataset" else None,
-            batch_size=batch_size,
-        )
-
-
-@click.command(
-    "rbac-migrate-resource-whitelist-scopes",
-    help=(
-        "Migrate RBAC app/dataset whitelist scope values to automatic_include_workspace_members. "
-        "Old scope all becomes true; specific and only_me become false."
-    ),
-)
-@click.option("--tenant-id", help="Only migrate resources in a single workspace.")
-@click.option(
-    "--resource-type",
-    type=click.Choice(["app", "dataset", "all"]),
-    default="all",
-    show_default=True,
-    help="Resource type to migrate.",
-)
-@click.option("--resource-id", help="Only migrate a single resource. Requires --resource-type app or dataset.")
-@click.option("--batch-size", default=500, show_default=True, type=click.IntRange(min=1))
-@click.option(
-    "--member-batch-size",
-    default=_RBAC_RESOURCE_ACCESS_POLICY_BATCH_SIZE,
-    show_default=True,
-    type=click.IntRange(min=1),
-    help="Workspace members written per default-policy call when migrating old scope all.",
-)
-@click.option(
-    "--dry-run/--apply",
-    default=True,
-    show_default=True,
-    help="Preview the migration without writing RBAC bindings. Use --apply to write changes.",
-)
-def migrate_resource_whitelist_scopes_to_automatic_include(
-    tenant_id: str | None,
-    resource_type: str,
-    resource_id: str | None,
-    batch_size: int,
-    member_batch_size: int,
-    dry_run: bool,
-) -> None:
-    """Backfill RBAC app/dataset automatic workspace-member inclusion from old RBAC scope."""
-    if resource_id and resource_type == "all":
-        raise click.BadParameter("--resource-id requires --resource-type app or dataset", param_hint="--resource-id")
-
-    click.echo(click.style("Starting RBAC resource whitelist scope migration.", fg="green"))
-
-    scanned_count = 0
-    migrated_count = 0
-    member_policy_batch_count = 0
-    owner_account_ids_by_tenant_id: dict[str, str] = {}
-
-    for (
-        current_resource_type,
-        workspace_id,
-        current_resource_id,
-        maintainer_account_id,
-    ) in _iter_selected_rbac_resource_rows(
-        resource_type,
-        tenant_id=tenant_id,
-        resource_id=resource_id,
-        batch_size=batch_size,
-    ):
-        scanned_count += 1
-        with session_factory.create_session() as session:
-            operator_account_id = maintainer_account_id or owner_account_ids_by_tenant_id.get(workspace_id)
-            if not operator_account_id:
-                operator_account_id = _owner_account_id(workspace_id, session=session)
-                owner_account_ids_by_tenant_id[workspace_id] = operator_account_id
-
-        legacy_config = _resource_legacy_whitelist_config(
-            current_resource_type,
-            tenant_id=workspace_id,
-            operator_account_id=operator_account_id,
-            resource_id=current_resource_id,
-        )
-        scope = _normalize_rbac_whitelist_scope(legacy_config.rbac_whitelist_scope)
-        if scope is None:
-            _emit_resource_whitelist_scope_migration_event(
-                {
-                    "event": "resource_whitelist_scope_migration_skipped",
-                    "reason": "missing_legacy_scope",
-                    "dry_run": dry_run,
-                    "tenant_id": workspace_id,
-                    "resource_type": current_resource_type,
-                    "resource_id": current_resource_id,
-                }
-            )
-            continue
-
-        automatic_include_workspace_members = scope is RBACResourceWhitelistScope.ALL
-        if scope is RBACResourceWhitelistScope.SPECIFIC:
-            member_account_ids = sorted(set(legacy_config.account_ids))
-            member_source = "legacy_specific_members"
-        elif scope is RBACResourceWhitelistScope.ONLY_ME:
-            member_account_ids = [maintainer_account_id] if maintainer_account_id else []
-            member_source = "resource_maintainer"
-        else:
-            member_account_ids = []
-            member_source = "workspace_members"
-
-        _emit_resource_whitelist_scope_migration_event(
-            {
-                "event": "resource_whitelist_scope_migration_proposed_change",
-                "dry_run": dry_run,
-                "tenant_id": workspace_id,
-                "operator_account_id": operator_account_id,
-                "resource_type": current_resource_type,
-                "resource_id": current_resource_id,
-                "before": {
-                    "rbac_whitelist_scope": scope.value,
-                    "legacy_account_ids": sorted(set(legacy_config.account_ids)),
-                },
-                "after": {
-                    "automatic_include_workspace_members": automatic_include_workspace_members,
-                    "default_policy_member_source": member_source,
-                    "default_policy_account_ids": member_account_ids,
-                },
-            }
-        )
-
-        if dry_run:
-            continue
-
-        _replace_resource_whitelist(
-            current_resource_type,
-            tenant_id=workspace_id,
-            operator_account_id=operator_account_id,
-            resource_id=current_resource_id,
-            automatic_include_workspace_members=automatic_include_workspace_members,
-        )
-        migrated_count += 1
-
-        if scope is RBACResourceWhitelistScope.ALL:
-            for batch in _workspace_member_account_id_batches(workspace_id, member_batch_size):
-                _replace_resource_default_access_policies(
-                    current_resource_type,
-                    tenant_id=workspace_id,
-                    operator_account_id=operator_account_id,
-                    resource_id=current_resource_id,
-                    account_ids=batch,
-                )
-                member_policy_batch_count += 1
-        else:
-            _replace_resource_default_access_policies(
-                current_resource_type,
-                tenant_id=workspace_id,
-                operator_account_id=operator_account_id,
-                resource_id=current_resource_id,
-                account_ids=member_account_ids,
-            )
-            if member_account_ids:
-                member_policy_batch_count += 1
-
-    if scanned_count == 0:
-        click.echo(click.style("No RBAC resources found for migration.", fg="yellow"))
-        return
-
-    if dry_run:
-        click.echo(
-            click.style(
-                f"Dry run completed. Scanned {scanned_count} RBAC resources. No RBAC bindings were written.",
-                fg="yellow",
-            )
-        )
-    else:
-        click.echo(
-            click.style(
-                "RBAC resource whitelist scope migration completed. "
-                f"Scanned {scanned_count} resources, migrated {migrated_count}, "
-                f"wrote {member_policy_batch_count} default-policy batches.",
-                fg="green",
-            )
-        )
-
-
-@click.command(
-    "rbac-migrate-resource-whitelist-scopes",
-    help=(
-        "Migrate RBAC app/dataset whitelist configs whose old scope is only_me to "
-        "automatic_include_workspace_members=true and sync workspace members into the whitelist."
-    ),
-)
-@click.option("--tenant-id", help="Only migrate resources in a single workspace.")
-@click.option(
-    "--resource-type",
-    type=click.Choice(["app", "dataset", "all"]),
-    default="all",
-    show_default=True,
-    help="Resource type to migrate.",
-)
-@click.option("--resource-id", help="Only migrate a single resource. Requires --resource-type app or dataset.")
-@click.option("--batch-size", default=500, show_default=True, type=click.IntRange(min=1))
-@click.option(
-    "--member-batch-size",
-    default=_RBAC_RESOURCE_ACCESS_POLICY_BATCH_SIZE,
-    show_default=True,
-    type=click.IntRange(min=1),
-    help="Workspace members written per default-policy call.",
-)
-@click.option(
-    "--dry-run/--apply",
-    default=True,
-    show_default=True,
-    help="Preview the migration without writing RBAC bindings. Use --apply to write changes.",
-)
-def migrate_only_me_resource_whitelist_scopes_to_automatic_include(
-    tenant_id: str | None,
-    resource_type: str,
-    resource_id: str | None,
-    batch_size: int,
-    member_batch_size: int,
-    dry_run: bool,
-) -> None:
-    """Backfill automatic workspace-member inclusion for old RBAC only_me resource scopes."""
-    if resource_id and resource_type == "all":
-        raise click.BadParameter("--resource-id requires --resource-type app or dataset", param_hint="--resource-id")
-
-    click.echo(click.style("Starting RBAC only_me resource whitelist scope migration.", fg="green"))
-
-    scanned_count = 0
-    only_me_count = 0
-    migrated_count = 0
-    member_policy_batch_count = 0
-    owner_account_ids_by_tenant_id: dict[str, str] = {}
-
-    for (
-        current_resource_type,
-        workspace_id,
-        current_resource_id,
-        maintainer_account_id,
-    ) in _iter_selected_rbac_resource_rows(
-        resource_type,
-        tenant_id=tenant_id,
-        resource_id=resource_id,
-        batch_size=batch_size,
-    ):
-        scanned_count += 1
-        with session_factory.create_session() as session:
-            operator_account_id = maintainer_account_id or owner_account_ids_by_tenant_id.get(workspace_id)
-            if not operator_account_id:
-                operator_account_id = _owner_account_id(workspace_id, session=session)
-                owner_account_ids_by_tenant_id[workspace_id] = operator_account_id
-
-        legacy_config = _resource_legacy_whitelist_config(
-            current_resource_type,
-            tenant_id=workspace_id,
-            operator_account_id=operator_account_id,
-            resource_id=current_resource_id,
-        )
-        scope = _normalize_rbac_whitelist_scope(legacy_config.rbac_whitelist_scope)
-        if scope is not RBACResourceWhitelistScope.ONLY_ME:
-            continue
-
-        only_me_count += 1
-        _emit_resource_whitelist_scope_migration_event(
-            {
-                "event": "only_me_resource_whitelist_scope_migration_proposed_change",
-                "dry_run": dry_run,
-                "tenant_id": workspace_id,
-                "operator_account_id": operator_account_id,
-                "resource_type": current_resource_type,
-                "resource_id": current_resource_id,
-                "before": {
-                    "rbac_whitelist_scope": scope.value,
-                    "legacy_account_ids": sorted(set(legacy_config.account_ids)),
-                },
-                "after": {
-                    "automatic_include_workspace_members": True,
-                    "default_policy_member_source": "workspace_members",
-                },
-            }
-        )
-
-        if dry_run:
-            continue
-
-        _replace_resource_whitelist(
-            current_resource_type,
-            tenant_id=workspace_id,
-            operator_account_id=operator_account_id,
-            resource_id=current_resource_id,
-            automatic_include_workspace_members=True,
-        )
-        migrated_count += 1
-
-        for batch in _workspace_member_account_id_batches(workspace_id, member_batch_size):
-            _replace_resource_default_access_policies(
-                current_resource_type,
-                tenant_id=workspace_id,
-                operator_account_id=operator_account_id,
-                resource_id=current_resource_id,
-                account_ids=batch,
-            )
-            member_policy_batch_count += 1
-
-    if scanned_count == 0:
-        click.echo(click.style("No RBAC resources found for migration.", fg="yellow"))
-        return
-
-    if dry_run:
-        click.echo(
-            click.style(
-                f"Dry run completed. Scanned {scanned_count} RBAC resources, found {only_me_count} only_me resources. "
-                "No RBAC bindings were written.",
-                fg="yellow",
-            )
-        )
-    else:
-        click.echo(
-            click.style(
-                "RBAC only_me resource whitelist scope migration completed. "
-                f"Scanned {scanned_count} resources, migrated {migrated_count}, "
-                f"wrote {member_policy_batch_count} default-policy batches.",
-                fg="green",
-            )
-        )
-
-
 @click.command(
     "rbac-migrate-dataset-permissions",
     help=(
@@ -893,9 +399,7 @@ def migrate_dataset_permissions_to_rbac(
             )
 
             scanned_count += 1
-            replace_whitelist_payload = ReplaceMemberBindings(
-                automatic_include_workspace_members=scope is RBACResourceWhitelistScope.ALL
-            )
+            replace_whitelist_payload = ReplaceMemberBindings(scope=scope)
             if dry_run:
                 _emit_dataset_permission_migration_event(
                     {

api/commands/retention.py

@@ -10,8 +10,6 @@ import click
 import sqlalchemy as sa
 from sqlalchemy.orm import Session, sessionmaker
 
-from configs import dify_config
-from enums import CloudPlan, DeploymentEdition
 from extensions.ext_database import db
 from libs.datetime_utils import naive_utc_now
 from services.clear_free_plan_tenant_expired_logs import ClearFreePlanTenantExpiredLogs
@@ -128,12 +126,14 @@ def _get_archive_candidate_tenant_ids_by_prefix(
 
 
 def _filter_paid_workflow_archive_tenant_ids(tenant_ids: list[str]) -> tuple[list[str], list[str]]:
+    from configs import dify_config
+    from enums.cloud_plan import CloudPlan
     from services.billing_service import BillingService
 
     tenant_ids = sorted(set(tenant_ids))
     if not tenant_ids:
         return [], []
-    if dify_config.DEPLOYMENT_EDITION != DeploymentEdition.CLOUD:
+    if not dify_config.BILLING_ENABLED:
         return tenant_ids, []
 
     plans = BillingService.get_plan_bulk_with_cache(tenant_ids)
@@ -1462,7 +1462,7 @@ def cleanup_orphaned_draft_variables(
     "--graceful-period",
     default=21,
     show_default=True,
-    help="Graceful period in days after subscription expiration; ignored outside the Cloud edition.",
+    help="Graceful period in days after subscription expiration, will be ignored when billing is disabled.",
 )
 @click.option("--dry-run", is_flag=True, default=False, help="Show messages logs would be cleaned without deleting")
 def clean_expired_messages(
@@ -1514,8 +1514,8 @@ def clean_expired_messages(
                 if from_days_ago <= before_days:
                     raise click.UsageError("--from-days-ago must be greater than --before-days.")
 
-        # Create the policy for the configured deployment edition.
-        # NOTE: graceful_period is ignored outside the Cloud edition.
+        # Create policy based on billing configuration
+        # NOTE: graceful_period will be ignored when billing is disabled.
         policy = create_message_clean_policy(graceful_period_days=graceful_period)
 
         if from_days_ago is not None and before_days is not None:

api/commands/system.py

@@ -6,7 +6,7 @@ from sqlalchemy import delete, select, update
 from sqlalchemy.orm import sessionmaker
 
 from configs import dify_config
-from enums import DeploymentEdition
+from enums.deployment_edition import DeploymentEdition
 from events.app_event import app_was_created
 from extensions.ext_database import db
 from extensions.ext_redis import redis_client

api/configs/app_config.py

@@ -5,6 +5,7 @@ from typing import Any, override
 from pydantic.fields import FieldInfo
 from pydantic_settings import BaseSettings, PydanticBaseSettingsSource, SettingsConfigDict, TomlConfigSettingsSource
 
+from enums.deployment_edition import DeploymentEdition
 from libs.file_utils import search_file_upwards
 
 from .deploy import DeploymentConfig
@@ -116,3 +117,11 @@ class DifyConfig(
                 ),
             ),
         )
+
+    @property
+    def DEPLOYMENT_EDITION(self) -> DeploymentEdition:
+        if self.EDITION == "CLOUD":
+            return DeploymentEdition.CLOUD
+        if self.ENTERPRISE_ENABLED:
+            return DeploymentEdition.ENTERPRISE
+        return DeploymentEdition.COMMUNITY

api/configs/deploy/__init__.py

@@ -1,8 +1,8 @@
+from typing import Literal
+
 from pydantic import Field
 from pydantic_settings import BaseSettings
 
-from enums import DeploymentEdition
-
 
 class DeploymentConfig(BaseSettings):
     """
@@ -25,14 +25,9 @@ class DeploymentConfig(BaseSettings):
         default=False,
     )
 
-    DEPLOYMENT_EDITION: DeploymentEdition = Field(
-        description="Product edition of the application.",
-        default=DeploymentEdition.COMMUNITY,
-    )
-
-    INIT_PASSWORD: str = Field(
-        description="Password required before initializing a self-hosted deployment",
-        default="",
+    EDITION: Literal["SELF_HOSTED", "CLOUD"] = Field(
+        description="Deployment edition of the application (e.g., 'SELF_HOSTED', 'CLOUD')",
+        default="SELF_HOSTED",
     )
 
     DEPLOY_ENV: str = Field(

api/configs/enterprise/__init__.py

@@ -8,6 +8,12 @@ class EnterpriseFeatureConfig(BaseSettings):
     **Before using, please contact business@dify.ai by email to inquire about licensing matters.**
     """
 
+    ENTERPRISE_ENABLED: bool = Field(
+        description="Enable or disable enterprise-level features."
+        "Before using, please contact business@dify.ai by email to inquire about licensing matters.",
+        default=False,
+    )
+
     WEBAPP_PUBLIC_ACCESS_ENABLED: bool = Field(
         description="Whether admins are allowed to set a webapp's access mode to public (anyone with the link, "
         "no auth). Disable in security-sensitive on-prem deployments.",
@@ -53,7 +59,7 @@ class EnterpriseTelemetryConfig(BaseSettings):
     """
 
     ENTERPRISE_TELEMETRY_ENABLED: bool = Field(
-        description="Enable enterprise telemetry collection for enterprise deployments.",
+        description="Enable enterprise telemetry collection (also requires ENTERPRISE_ENABLED=true).",
         default=False,
     )
 
@@ -83,6 +89,11 @@ class EnterpriseTelemetryConfig(BaseSettings):
         default=False,
     )
 
+    ENTERPRISE_SERVICE_NAME: str = Field(
+        description="Service name for OTEL resource.",
+        default="dify",
+    )
+
     ENTERPRISE_OTEL_SAMPLING_RATE: float = Field(
         description="Sampling rate for enterprise traces (0.0 to 1.0, default 1.0 = 100%).",
         default=1.0,

api/configs/extra/__init__.py

@@ -1,10 +1,8 @@
 from configs.extra.agent_backend_config import AgentBackendConfig
 from configs.extra.archive_config import ArchiveStorageConfig
 from configs.extra.knowledge_fs_config import KnowledgeFSConfig
-from configs.extra.logstore_config import LogStoreConfig
 from configs.extra.notion_config import NotionConfig
 from configs.extra.sentry_config import SentryConfig
-from configs.extra.turnstile_config import TurnstileConfig
 
 
 class ExtraServiceConfig(
@@ -12,9 +10,7 @@ class ExtraServiceConfig(
     AgentBackendConfig,
     ArchiveStorageConfig,
     KnowledgeFSConfig,
-    LogStoreConfig,
     NotionConfig,
     SentryConfig,
-    TurnstileConfig,
 ):
     pass

api/configs/extra/agent_backend_config.py

@@ -13,7 +13,7 @@ class AgentBackendConfig(BaseSettings):
     )
 
     AGENT_BACKEND_API_TOKEN: str | None = Field(
-        description="Bearer token for authenticating with the Agent backend control-plane API.",
+        description="Bearer token for authenticating with the Agent backend /runs API.",
         default=None,
     )
 
@@ -37,17 +37,9 @@ class AgentBackendConfig(BaseSettings):
         default=3,
     )
 
-    AGENT_BACKEND_HOME_SNAPSHOT_TIMEOUT_SECONDS: PositiveFloat = Field(
-        description=(
-            "Client timeout for Agent backend calls that may carry a Home Snapshot transfer: "
-            "snapshot capture and delete, and Execution Binding creation that restores one. "
-        ),
-        default=45.0,
-    )
-
-    AGENT_BACKEND_BINDING_FILE_DOWNLOAD_TIMEOUT_SECONDS: PositiveFloat = Field(
-        description="Client timeout for converting a Binding file to a ToolFile through the Agent backend.",
-        default=240,
+    AGENT_BACKEND_RUN_TIMEOUT_SECONDS: PositiveFloat = Field(
+        description="Total deadline for one Agent backend run event stream.",
+        default=1200,
     )
 
     AGENT_SHELL_ENABLED: bool = Field(

api/configs/extra/logstore_config.py

@@ -1,11 +0,0 @@
-from pydantic_settings import BaseSettings
-
-
-class LogStoreConfig(BaseSettings):
-    """Migration controls for repositories backed by Aliyun LogStore."""
-
-    LOGSTORE_DUAL_WRITE_ENABLED: bool = False
-
-    # Keep workflow graphs in LogStore by default. Deployments may disable this
-    # while migrating large graph payloads to another persistence owner.
-    LOGSTORE_ENABLE_PUT_GRAPH_FIELD: bool = True

api/configs/extra/turnstile_config.py

@@ -1,41 +0,0 @@
-from pydantic import Field, SecretStr, field_validator
-from pydantic_settings import BaseSettings
-
-
-class TurnstileConfig(BaseSettings):
-    """Server-side Cloudflare Turnstile settings for Cloud sign-in."""
-
-    TURNSTILE_SECRET_KEY: SecretStr | None = Field(
-        default=None,
-        description="Secret key used to validate Cloudflare Turnstile tokens.",
-    )
-    TURNSTILE_ALLOWED_HOSTNAMES: str = Field(
-        default="",
-        description="Comma-separated parent or exact hostnames accepted from Turnstile.",
-    )
-    TURNSTILE_EMAIL_CODE_VERIFY_REQUIRED: bool = Field(
-        default=False,
-        description=(
-            "Require a separate Turnstile challenge when verifying email login codes on Dify Cloud. "
-            "Enable after the compatible web client has been deployed."
-        ),
-    )
-
-    @field_validator("TURNSTILE_SECRET_KEY", mode="before")
-    @classmethod
-    def normalize_secret_key(cls, value: object) -> object:
-        if isinstance(value, SecretStr):
-            normalized = value.get_secret_value().strip()
-            return SecretStr(normalized) if normalized else None
-        if isinstance(value, str):
-            normalized = value.strip()
-            return normalized or None
-        return value
-
-    @property
-    def TURNSTILE_ALLOWED_HOSTNAME_SET(self) -> frozenset[str]:
-        return frozenset(
-            hostname.strip().lower().strip(".")
-            for hostname in self.TURNSTILE_ALLOWED_HOSTNAMES.split(",")
-            if hostname.strip().strip(".")
-        )

api/configs/feature/__init__.py

@@ -12,7 +12,6 @@ from pydantic import (
     PositiveInt,
     computed_field,
     field_validator,
-    model_validator,
 )
 from pydantic_settings import BaseSettings
 
@@ -84,7 +83,7 @@ class AppExecutionConfig(BaseSettings):
 
     APP_MAX_EXECUTION_TIME: PositiveInt = Field(
         description="Maximum allowed execution time for the application in seconds",
-        default=3600,
+        default=1200,
     )
     APP_DEFAULT_ACTIVE_REQUESTS: NonNegativeInt = Field(
         description="Default number of concurrent active requests per app (0 for unlimited)",
@@ -593,16 +592,6 @@ class HttpConfig(BaseSettings):
     def CONSOLE_CORS_ALLOW_ORIGINS(self) -> list[str]:
         return self.inner_CONSOLE_CORS_ALLOW_ORIGINS.split(",")
 
-    WEBSOCKET_MAX_HTTP_BUFFER_SIZE: PositiveInt = Field(
-        description=(
-            "Maximum Socket.IO / Engine.IO HTTP buffer size in bytes. "
-            "Large workflow collaboration payloads (sync_request graph snapshots) "
-            "exceed the Engine.IO default of 1 MiB and get rejected, which "
-            "disconnects the editor WebSocket. Default is 10 MiB."
-        ),
-        default=10 * 1024 * 1024,
-    )
-
     inner_WEB_API_CORS_ALLOW_ORIGINS: str = Field(
         description="",
         validation_alias=AliasChoices("WEB_API_CORS_ALLOW_ORIGINS"),
@@ -821,6 +810,17 @@ class ModelLoadBalanceConfig(BaseSettings):
     )
 
 
+class BillingConfig(BaseSettings):
+    """
+    Configuration for platform billing features
+    """
+
+    BILLING_ENABLED: bool = Field(
+        description="Enable or disable billing functionality",
+        default=False,
+    )
+
+
 class UpdateConfig(BaseSettings):
     """
     Configuration for application update checks
@@ -900,7 +900,7 @@ class WorkflowConfig(BaseSettings):
 
     WORKFLOW_MAX_EXECUTION_TIME: PositiveInt = Field(
         description="Maximum execution time in seconds for a single workflow",
-        default=3600,
+        default=1200,
     )
 
     WORKFLOW_CALL_MAX_DEPTH: PositiveInt = Field(
@@ -1301,13 +1301,6 @@ class DataSetConfig(BaseSettings):
     )
 
 
-class SkillConfig(BaseSettings):
-    ENABLE_SKILL: bool = Field(
-        description="Enable or disable Skill feature entry points",
-        default=True,
-    )
-
-
 class WorkspaceConfig(BaseSettings):
     """
     Configuration for workspace management
@@ -1342,28 +1335,10 @@ class MultiModalTransferConfig(BaseSettings):
     )
 
 
-class NewAgentBetaConfig(BaseSettings):
-    NEW_AGENT_BETA_ACTIVITY_START_AT: datetime | None = Field(
-        description="New Agent Beta Publish window start in RFC3339 UTC (inclusive)",
-        default=None,
-    )
-    NEW_AGENT_BETA_ACTIVITY_END_AT: datetime | None = Field(
-        description="New Agent Beta Publish window end in RFC3339 UTC (exclusive)",
-        default=None,
-    )
-
-
 class OpsTraceConfig(BaseSettings):
-    OPS_TRACE_UNIFIED_ENABLED: bool = Field(
-        description="Enable unified ops tracing for providers registered in the unified registry.",
-        default=False,
-    )
-
-    # Include scheduling and export grace after the parent workflow's maximum execution time.
-    # Recommended: max_retries >= ceil((WORKFLOW_MAX_EXECUTION_TIME + grace_seconds) / delay_seconds).
     OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES: PositiveInt = Field(
         description="Maximum retry attempts for transient ops trace provider dispatch failures.",
-        default=780,
+        default=60,
     )
 
     OPS_TRACE_RETRYABLE_DISPATCH_DELAY_SECONDS: PositiveInt = Field(
@@ -1371,20 +1346,6 @@ class OpsTraceConfig(BaseSettings):
         default=5,
     )
 
-    OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS: PositiveInt = Field(
-        description="Retention in seconds for unified tracing parent contexts.",
-        default=3900,
-    )
-
-    @model_validator(mode="after")
-    def validate_parent_context_retention(self) -> "OpsTraceConfig":
-        if not self.OPS_TRACE_UNIFIED_ENABLED:
-            return self
-        retry_window = self.OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES * self.OPS_TRACE_RETRYABLE_DISPATCH_DELAY_SECONDS
-        if retry_window > self.OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS:
-            raise ValueError("OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS must cover the retry window")
-        return self
-
 
 class CeleryBeatConfig(BaseSettings):
     CELERY_BEAT_SCHEDULER_TIME: int = Field(
@@ -1394,18 +1355,6 @@ class CeleryBeatConfig(BaseSettings):
 
 
 class CeleryScheduleTasksConfig(BaseSettings):
-    ENABLE_CONVERSATION_CLEANUP_TASK: bool = Field(
-        description="Enable periodic recovery of soft-deleted conversation cleanup",
-        default=True,
-    )
-    CONVERSATION_CLEANUP_TASK_INTERVAL: PositiveInt = Field(
-        description="Soft-deleted conversation cleanup recovery interval in minutes",
-        default=5,
-    )
-    CONVERSATION_CLEANUP_BATCH_SIZE: PositiveInt = Field(
-        description="Maximum soft-deleted conversations dispatched per cleanup sweep",
-        default=100,
-    )
     ENABLE_CLEAN_EMBEDDING_CACHE_TASK: bool = Field(
         description="Enable clean embedding cache task",
         default=False,
@@ -1588,10 +1537,6 @@ class LoginConfig(BaseSettings):
         description="expiry time in minutes for email code login token",
         default=5,
     )
-    EMAIL_CODE_LOGIN_MAX_ATTEMPTS: PositiveInt = Field(
-        description="maximum number of verification attempts for an email code login challenge",
-        default=5,
-    )
     ALLOW_REGISTER: bool = Field(
         description="whether to enable register",
         default=False,
@@ -1676,6 +1621,7 @@ class FeatureConfig(
     # place the configs in alphabet order
     AppExecutionConfig,
     AuthConfig,  # Changed from OAuthConfig to AuthConfig
+    BillingConfig,
     CodeExecutionSandboxConfig,
     CreatorsPlatformConfig,
     TriggerConfig,
@@ -1695,14 +1641,12 @@ class FeatureConfig(
     ModelLoadBalanceConfig,
     ModerationConfig,
     MultiModalTransferConfig,
-    NewAgentBetaConfig,
     OpsTraceConfig,
     PositionConfig,
     RagEtlConfig,
     RepositoryConfig,
     SandboxExpiredRecordsCleanConfig,
     SecurityConfig,
-    SkillConfig,
     TenantIsolatedTaskQueueConfig,
     ToolConfig,
     UpdateConfig,

api/configs/feature/hosted_service/__init__.py

@@ -451,12 +451,6 @@ class HostedFetchAppTemplateConfig(BaseSettings):
         default="https://tmpl.dify.ai",
     )
 
-    HOSTED_FETCH_APP_TEMPLATES_CACHE_TTL: int = Field(
-        description="TTL in seconds for caching remote app template HTTP responses. 0 disables caching.",
-        default=600,
-        ge=0,
-    )
-
 
 class HostedFetchPipelineTemplateConfig(BaseSettings):
     """

api/configs/middleware/__init__.py

@@ -335,6 +335,22 @@ class CeleryConfig(DatabaseConfig):
         return self.CELERY_BROKER_URL.startswith("rediss://") if self.CELERY_BROKER_URL else False
 
 
+class InternalTestConfig(BaseSettings):
+    """
+    Configuration settings for Internal Test
+    """
+
+    AWS_SECRET_ACCESS_KEY: str | None = Field(
+        description="Internal test AWS secret access key",
+        default=None,
+    )
+
+    AWS_ACCESS_KEY_ID: str | None = Field(
+        description="Internal test AWS access key ID",
+        default=None,
+    )
+
+
 class DatasetQueueMonitorConfig(BaseSettings):
     """
     Configuration settings for Dataset Queue Monitor
@@ -400,6 +416,7 @@ class MiddlewareConfig(
     WeaviateConfig,
     ElasticsearchConfig,
     CouchbaseConfig,
+    InternalTestConfig,
     VikingDBConfig,
     UpstashConfig,
     TidbOnQdrantConfig,

api/configs/remote_settings_sources/apollo/client.py

@@ -167,8 +167,8 @@ class ApolloClient:
                 old_value = old_kv.get(key)
                 if old_value is None:
                     self._change_listener("add", namespace, key, new_value)
-        except BaseException:
-            logger.warning("Apollo config change listener failed", exc_info=True)
+        except BaseException as e:
+            logger.warning(str(e))
 
     def _path_checker(self) -> None:
         if not os.path.isdir(self._cache_file_path):
@@ -235,8 +235,8 @@ class ApolloClient:
                     return
             else:
                 logger.warning("Sleep...")
-        except Exception:
-            logger.warning("Apollo long polling failed", exc_info=True)
+        except Exception as e:
+            logger.warning(str(e))
 
     def _get_net_and_set_local(self, namespace: str, n_id: int, call_change: bool = False) -> None:
         namespace_data = self.get_json_from_net(namespace)

api/conftest.py

@@ -33,18 +33,6 @@ ensure_backend_test_environment(_REPO_ROOT)
 
 def pytest_addoption(parser: pytest.Parser) -> None:
     group = parser.getgroup("dify")
-    group.addoption(
-        "--shard-index",
-        type=int,
-        default=1,
-        help="One-based index of the test shard to run.",
-    )
-    group.addoption(
-        "--shard-total",
-        type=int,
-        default=1,
-        help="Total number of test shards.",
-    )
     group.addoption(
         "--start-middleware",
         action="store_true",
@@ -70,33 +58,9 @@ def pytest_addoption(parser: pytest.Parser) -> None:
 
 
 def pytest_configure(config: pytest.Config) -> None:
-    shard_index = config.getoption("shard_index")
-    shard_total = config.getoption("shard_total")
-    if shard_total < 1:
-        raise pytest.UsageError("--shard-total must be at least 1")
-    if not 1 <= shard_index <= shard_total:
-        raise pytest.UsageError("--shard-index must be between 1 and --shard-total")
-
     config.stash[_DIFY_COMPOSE_STACKS_KEY] = []
 
 
-def pytest_collection_modifyitems(config: pytest.Config, items: list[pytest.Item]) -> None:
-    """Select a deterministic, evenly sized slice of collected tests for this shard."""
-    shard_index = config.getoption("shard_index")
-    shard_total = config.getoption("shard_total")
-    if shard_total == 1:
-        return
-
-    selected: list[pytest.Item] = []
-    deselected: list[pytest.Item] = []
-    for item_index, item in enumerate(items):
-        target = selected if item_index % shard_total == shard_index - 1 else deselected
-        target.append(item)
-
-    config.hook.pytest_deselected(items=deselected)
-    items[:] = selected
-
-
 def pytest_sessionstart(session: pytest.Session) -> None:
     config = session.config
     if hasattr(config, "workerinput"):

api/constants/__init__.py

@@ -36,7 +36,6 @@ _UNSTRUCTURED_DOCUMENT_EXTENSION_BASE: frozenset[str] = frozenset(
         "pptx",
         "xml",
         "epub",
-        "odt",
     )
 )
 _DEFAULT_DOCUMENT_EXTENSION_BASE: frozenset[str] = frozenset(
@@ -54,7 +53,6 @@ _DEFAULT_DOCUMENT_EXTENSION_BASE: frozenset[str] = frozenset(
         "csv",
         "vtt",
         "properties",
-        "odt",
     )
 )
 

api/constants/languages.py

@@ -8,7 +8,6 @@ language_timezone_mapping = {
     "de-DE": "Europe/Berlin",
     "ja-JP": "Asia/Tokyo",
     "ko-KR": "Asia/Seoul",
-    "lo-LA": "Asia/Vientiane",
     "ru-RU": "Europe/Moscow",
     "it-IT": "Europe/Rome",
     "uk-UA": "Europe/Kyiv",

api/constants/recommended_apps.json

@@ -166,7 +166,6 @@
                     "categories": ["Workflow"],
                     "copyright": null,
                     "description": "Based on users' choice, retrieve external knowledge to more accurately summarize articles.",
-                    "is_learn_dify": true,
                     "is_listed": true,
                     "position": 5,
                     "privacy_policy": null
@@ -295,7 +294,6 @@
                     "categories": ["Workflow"],
                     "copyright": null,
                     "description": "Basic Workflow Template, a chatbot capable of identifying intents alongside with a knowledge base.",
-                    "is_learn_dify": true,
                     "is_listed": true,
                     "position": 4,
                     "privacy_policy": null
@@ -328,7 +326,6 @@
                     "categories": ["Workflow"],
                     "copyright": null,
                     "description": "Basic Workflow Template, A chatbot with a knowledge base. ",
-                    "is_learn_dify": true,
                     "is_listed": true,
                     "position": 4,
                     "privacy_policy": null

api/constants/tts_auto_play_timeout.py

@@ -0,0 +1,4 @@
+TTS_AUTO_PLAY_TIMEOUT = 5
+
+# sleep 20 ms ( 40ms => 1280 byte audio file,20ms => 640 byte audio file)
+TTS_AUTO_PLAY_YIELD_CPU_TIME = 0.02

api/controllers/common/agent_app_parameters.py

@@ -0,0 +1,60 @@
+from typing import Any
+
+from sqlalchemy import select
+from sqlalchemy.orm import Session
+
+from core.agent.publish_visibility import agent_has_workflow_callable_active_snapshot
+from core.app.apps.agent_app.app_feature_projection import merge_agent_app_features
+from core.app.apps.agent_app.app_variable_projection import agent_app_variables_to_user_input_form
+from core.app.apps.agent_app.errors import AgentAppGeneratorError, AgentAppNotPublishedError
+from models.agent import Agent, AgentConfigSnapshot, AgentStatus
+from models.agent_config_entities import AgentSoulConfig
+from models.model import App, load_annotation_reply_config
+
+
+def get_published_agent_app_feature_dict_and_user_input_form(
+    app_model: App,
+    *,
+    session: Session,
+) -> tuple[dict[str, Any], list[dict[str, Any]]]:
+    """Return public Agent App parameters backed by the published Agent Soul."""
+    app_model_config = app_model.app_model_config_with_session(session=session)
+
+    agent_id = app_model.bound_agent_id
+    if not agent_id:
+        raise AgentAppGeneratorError("Agent App has no bound Agent")
+
+    agent = session.scalar(
+        select(Agent)
+        .where(
+            Agent.tenant_id == app_model.tenant_id,
+            Agent.id == agent_id,
+            Agent.status == AgentStatus.ACTIVE,
+        )
+        .limit(1)
+    )
+    if agent is None:
+        raise AgentAppGeneratorError("Agent App has no bound Agent")
+    if not agent_has_workflow_callable_active_snapshot(session=session, agent=agent):
+        raise AgentAppNotPublishedError("Agent has not been published")
+
+    snapshot = session.scalar(
+        select(AgentConfigSnapshot)
+        .where(
+            AgentConfigSnapshot.tenant_id == app_model.tenant_id,
+            AgentConfigSnapshot.agent_id == agent.id,
+            AgentConfigSnapshot.id == agent.active_config_snapshot_id,
+        )
+        .limit(1)
+    )
+    if snapshot is None:
+        raise AgentAppGeneratorError("Agent published version not found")
+
+    agent_soul = AgentSoulConfig.model_validate(snapshot.config_snapshot_dict)
+    annotation_reply = load_annotation_reply_config(session, app_model.id) if app_model_config else None
+    features_dict = merge_agent_app_features(
+        agent_soul=agent_soul,
+        app_model_config=app_model_config,
+        annotation_reply=annotation_reply,
+    )
+    return features_dict, agent_app_variables_to_user_input_form(agent_soul.app_variables)

api/controllers/common/app_access.py

@@ -17,8 +17,8 @@ if TYPE_CHECKING:
 # the console and OpenAPI app-list endpoints.
 APP_LIST_PERMISSION_KEYS: frozenset[str] = frozenset({"app.preview", "app.acl.preview", "app.full_access"})
 
-# Workspace permission key that lets a caller see apps they maintain when the
-# app whitelist is unrestricted.
+# Workspace permission key that lets a caller see apps they maintain even when
+# those apps are not in their preview whitelist.
 _MANAGE_OWN_APPS_PERMISSION_KEY = "app.create_and_management"
 
 
@@ -33,7 +33,7 @@ class AppAccessFilter:
 
     ``accessible_app_ids`` of ``None`` means the caller can see every app in the
     workspace (unrestricted). Otherwise it is the exact set of app ids the
-    caller may preview; combined with ``can_manage_own_apps`` it can also cover
+    caller may preview; combined with ``can_manage_own_apps`` it also covers
     apps the caller maintains.
     """
 
@@ -100,10 +100,11 @@ def resolve_app_access_filter(
     if getattr(whitelist_scope, "unrestricted", False):
         accessible_app_ids = permission_app_ids
     else:
-        # A restricted app whitelist is the highest-priority visibility gate:
-        # default preview, per-app permission overrides, and own-app management
-        # must not expose apps outside this set.
         accessible_app_ids = set(whitelist_scope.resource_ids)
-        can_manage_own_apps = False
+        if permission_app_ids is not None:
+            accessible_app_ids |= permission_app_ids
+        elif has_default_preview:
+            # Default preview overrides the whitelist restriction.
+            accessible_app_ids = None
 
     return AppAccessFilter(accessible_app_ids=accessible_app_ids, can_manage_own_apps=can_manage_own_apps)

api/controllers/common/controller_schemas.py

@@ -108,55 +108,33 @@ class SavedMessageCreatePayload(BaseModel):
 
 # --- Workflow schemas ---
 
-
-def _workflow_input_file_variant(transfer_method: str, source: str) -> dict[str, object]:
-    return {
-        "type": "object",
-        "properties": {
-            "type": {
-                "description": "File type.",
-                "enum": ["document", "image", "audio", "video", "custom"],
-                "type": "string",
-            },
-            "transfer_method": {
-                "description": (
-                    "Transfer method: `remote_url` for a file URL or persisted uploaded-file reference, "
-                    "`local_file` for an uploaded file."
-                ),
-                "enum": [transfer_method],
-                "type": "string",
-            },
-            "url": {
-                "description": "File URL when `transfer_method` is `remote_url`.",
-                "format": "url",
-                "type": "string",
-            },
-            "remote_url": {
-                "description": "Legacy alias of `url` when `transfer_method` is `remote_url`.",
-                "format": "url",
-                "type": "string",
-            },
-            "upload_file_id": {
-                "description": (
-                    "Uploaded file ID obtained from the [Upload File](/api-reference/files/upload-file) API. "
-                    "Required for `local_file`; also accepted with `remote_url` for compatibility with persisted "
-                    "file references."
-                ),
-                "type": "string",
-            },
-        },
-        "required": ["type", "transfer_method", source],
-    }
-
-
 WORKFLOW_INPUT_FILE_ITEM_SCHEMA: dict[str, object] = {
     "type": "object",
-    "anyOf": [
-        _workflow_input_file_variant("remote_url", "url"),
-        _workflow_input_file_variant("remote_url", "remote_url"),
-        _workflow_input_file_variant("remote_url", "upload_file_id"),
-        _workflow_input_file_variant("local_file", "upload_file_id"),
-    ],
+    "required": ["type", "transfer_method"],
+    "properties": {
+        "type": {
+            "description": "File type.",
+            "enum": ["document", "image", "audio", "video", "custom"],
+            "type": "string",
+        },
+        "transfer_method": {
+            "description": "Transfer method: `remote_url` for file URL, `local_file` for uploaded file.",
+            "enum": ["remote_url", "local_file"],
+            "type": "string",
+        },
+        "url": {
+            "description": "File URL when `transfer_method` is `remote_url`.",
+            "format": "url",
+            "type": "string",
+        },
+        "upload_file_id": {
+            "description": (
+                "Uploaded file ID obtained from the [Upload File](/api-reference/files/upload-file) API when "
+                "`transfer_method` is `local_file`."
+            ),
+            "type": "string",
+        },
+    },
 }
 WORKFLOW_INPUT_FILE_LIST_SCHEMA: dict[str, object] = {
     "anyOf": [{"items": WORKFLOW_INPUT_FILE_ITEM_SCHEMA, "type": "array"}, {"type": "null"}]

api/controllers/common/errors.py

@@ -1,54 +1,18 @@
+from werkzeug.exceptions import HTTPException
+
 from libs.exception import BaseHTTPException
 
 
-class FilenameNotExistsError(BaseHTTPException):
-    error_code = "filename_not_exists_error"
+class FilenameNotExistsError(HTTPException):
     code = 400
     description = "The specified filename does not exist."
 
 
-class RemoteFileUploadError(BaseHTTPException):
-    error_code = "remote_file_upload_error"
+class RemoteFileUploadError(HTTPException):
     code = 400
     description = "Error uploading remote file."
 
 
-class RemoteFileInvalidUrlError(BaseHTTPException):
-    error_code = "remote_file_invalid_url"
-    description = "The remote file URL is invalid."
-    code = 400
-
-
-class RemoteFileUrlBlockedError(BaseHTTPException):
-    error_code = "remote_file_url_blocked"
-    description = "The remote file URL is not allowed."
-    code = 400
-
-
-class RemoteFileNotFoundError(BaseHTTPException):
-    error_code = "remote_file_not_found"
-    description = "The remote file could not be found."
-    code = 404
-
-
-class RemoteFileAccessDeniedError(BaseHTTPException):
-    error_code = "remote_file_access_denied"
-    description = "The remote file cannot be accessed without authorization."
-    code = 400
-
-
-class RemoteFileUnavailableError(BaseHTTPException):
-    error_code = "remote_file_unavailable"
-    description = "The remote file is temporarily unavailable."
-    code = 502
-
-
-class RemoteFileInvalidResponseError(BaseHTTPException):
-    error_code = "remote_file_invalid_response"
-    description = "The remote file server returned an invalid response."
-    code = 502
-
-
 class FileTooLargeError(BaseHTTPException):
     error_code = "file_too_large"
     description = "File size exceeded. {message}"

api/controllers/common/fields.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
-from typing import Annotated, Any, Literal
+from typing import Any, Literal
 
-from pydantic import BaseModel, ConfigDict, Field, RootModel, WithJsonSchema, computed_field
+from pydantic import BaseModel, ConfigDict, Field, RootModel, computed_field
 
 from fields.base import ResponseModel
 from graphon.file import helpers as file_helpers
@@ -10,125 +10,6 @@ from models.model import IconType
 
 type JSONValue = str | int | float | bool | None | dict[str, Any] | list[Any]
 type JSONObject = dict[str, Any]
-URLString = Annotated[str, WithJsonSchema({"format": "url", "type": "string"})]
-UUIDString = Annotated[str, WithJsonSchema({"format": "uuid", "type": "string"})]
-Int64 = Annotated[int, WithJsonSchema({"format": "int64", "type": "integer"})]
-FloatNumber = Annotated[float, WithJsonSchema({"format": "float", "type": "number"})]
-DoubleNumber = Annotated[float, WithJsonSchema({"format": "double", "type": "number"})]
-DecimalString = Annotated[str, WithJsonSchema({"format": "decimal", "type": "string"})]
-
-FeatureToggleObject = Annotated[
-    JSONObject,
-    WithJsonSchema({"type": "object", "properties": {"enabled": {"type": "boolean"}}}),
-]
-TextToSpeechObject = Annotated[
-    JSONObject,
-    WithJsonSchema(
-        {
-            "type": "object",
-            "properties": {
-                "enabled": {"type": "boolean"},
-                "voice": {"type": "string"},
-                "language": {"type": "string"},
-                "autoPlay": {"type": "string"},
-            },
-        }
-    ),
-]
-FileUploadObject = Annotated[
-    JSONObject,
-    WithJsonSchema(
-        {
-            "type": "object",
-            "properties": {
-                "enabled": {"type": "boolean"},
-                "number_limits": {"type": "integer"},
-                "allowed_file_types": {
-                    "type": "array",
-                    "items": {
-                        "type": "string",
-                        "enum": ["document", "image", "audio", "video", "custom"],
-                    },
-                },
-                "allowed_file_extensions": {"type": "array", "items": {"type": "string"}},
-                "allowed_file_upload_methods": {
-                    "type": "array",
-                    "items": {
-                        "type": "string",
-                        "enum": ["remote_url", "local_file"],
-                    },
-                },
-                "image": {
-                    "type": "object",
-                    "properties": {
-                        "enabled": {"type": "boolean"},
-                        "number_limits": {"type": "integer"},
-                        "detail": {"type": "string"},
-                        "transfer_methods": {"type": "array", "items": {"type": "string"}},
-                    },
-                },
-            },
-        }
-    ),
-]
-USER_INPUT_FORM_TYPES = (
-    "text-input",
-    "select",
-    "paragraph",
-    "number",
-    "external_data_tool",
-    "file",
-    "file-list",
-    "checkbox",
-    "json_object",
-)
-USER_INPUT_FORM_ITEM_CONFIG_SCHEMA: dict[str, object] = {
-    "type": "object",
-    "required": ["label", "variable"],
-    "properties": {
-        "variable": {"type": "string"},
-        "label": {"type": "string"},
-        "description": {"type": "string"},
-        "required": {"type": "boolean"},
-        "hide": {"type": "boolean"},
-        # Defaults are typed by the form kind: strings, numbers, booleans,
-        # JSON objects, and file references are all valid public values.
-        "default": {},
-        "type": {"enum": list(USER_INPUT_FORM_TYPES), "type": "string"},
-        "max_length": {"anyOf": [{"type": "integer"}, {"type": "null"}]},
-        "options": {"type": "array", "items": {"type": "string"}},
-        "allowed_file_types": {"anyOf": [{"type": "array", "items": {"type": "string"}}, {"type": "null"}]},
-        "allowed_file_extensions": {"anyOf": [{"type": "array", "items": {"type": "string"}}, {"type": "null"}]},
-        "allowed_file_upload_methods": {"anyOf": [{"type": "array", "items": {"type": "string"}}, {"type": "null"}]},
-        "json_schema": {
-            "anyOf": [
-                {"type": "object", "additionalProperties": True},
-                {"type": "null"},
-            ]
-        },
-        "config": {"type": "object", "additionalProperties": True},
-    },
-}
-UserInputFormList = Annotated[
-    list[JSONObject],
-    WithJsonSchema(
-        {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "oneOf": [
-                    {
-                        "type": "object",
-                        "additionalProperties": False,
-                        "properties": {form_type: USER_INPUT_FORM_ITEM_CONFIG_SCHEMA},
-                        "required": [form_type],
-                    }
-                    for form_type in USER_INPUT_FORM_TYPES
-                ],
-            },
-        }
-    ),
-]
 
 
 class SystemParameters(BaseModel):
@@ -139,200 +20,8 @@ class SystemParameters(BaseModel):
     workflow_file_upload_limit: int
 
 
-class BlockingUsageResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    prompt_tokens: int | None = None
-    prompt_unit_price: DecimalString | None = None
-    prompt_price_unit: DecimalString | None = None
-    prompt_price: DecimalString | None = None
-    completion_tokens: int | None = None
-    completion_unit_price: DecimalString | None = None
-    completion_price_unit: DecimalString | None = None
-    completion_price: DecimalString | None = None
-    total_tokens: int | None = None
-    total_price: DecimalString | None = None
-    currency: str | None = None
-    latency: DoubleNumber | None = None
-
-
-class BlockingRetrieverResourceResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    id: UUIDString | None = None
-    message_id: UUIDString | None = None
-    position: int
-    dataset_id: UUIDString | None = None
-    dataset_name: str | None = None
-    document_id: UUIDString | None = None
-    document_name: str | None = None
-    data_source_type: str | None = None
-    segment_id: UUIDString | None = None
-    score: FloatNumber | None = None
-    hit_count: int | None = None
-    word_count: int | None = None
-    segment_position: int | None = None
-    index_node_hash: str | None = None
-    content: str | None = None
-    summary: str | None = None
-    created_at: Int64 | None = None
-
-
-class BlockingMetadataResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    usage: BlockingUsageResponse | None = None
-    retriever_resources: list[BlockingRetrieverResourceResponse] | None = None
-
-
-class ChatMessageBlockingResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    event: Literal["message"]
-    task_id: UUIDString
-    id: UUIDString
-    message_id: UUIDString
-    conversation_id: UUIDString
-    mode: str
-    answer: str
-    metadata: BlockingMetadataResponse = Field(description="Metadata including usage and retriever resources.")
-    created_at: Int64
-
-
-class PauseReasonResponseBase(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    form_id: UUIDString | None = None
-    node_id: str | None = None
-    node_title: str | None = None
-    form_content: str | None = None
-    inputs: list[JSONObject] = Field(default_factory=list)
-    actions: list[JSONObject] = Field(default_factory=list)
-    display_in_ui: bool | None = None
-    resolved_default_values: dict[str, Any] = Field(default_factory=dict)
-    form_token: str | None = None
-    approval_channels: list[str] = Field(default_factory=list)
-    expiration_time: Int64 | None = None
-    message: str | None = None
-
-
-class ChatPauseReasonResponse(PauseReasonResponseBase):
-    """Public pause reason emitted by a blocking Chatflow execution."""
-
-    TYPE: str
-
-
-class WorkflowPauseReasonResponse(PauseReasonResponseBase):
-    """Public pause reason emitted by a blocking Workflow execution."""
-
-    TYPE: str
-
-
-class ChatPausedBlockingDataResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    id: UUIDString
-    mode: str
-    conversation_id: UUIDString
-    message_id: UUIDString
-    workflow_run_id: UUIDString
-    answer: str
-    metadata: BlockingMetadataResponse = Field(description="Metadata including usage and retriever resources.")
-    created_at: Int64
-    paused_nodes: list[str]
-    reasons: list[ChatPauseReasonResponse]
-    status: Literal["paused"]
-    elapsed_time: FloatNumber
-    total_tokens: int
-    total_steps: int
-
-
-class ChatPausedBlockingResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    event: Literal["workflow_paused"]
-    task_id: UUIDString
-    id: UUIDString
-    message_id: UUIDString
-    conversation_id: UUIDString
-    mode: str
-    answer: str
-    metadata: BlockingMetadataResponse = Field(description="Metadata including usage and retriever resources.")
-    created_at: Int64
-    workflow_run_id: UUIDString
-    data: ChatPausedBlockingDataResponse
-
-
-class ChatBlockingResponse(
-    RootModel[
-        Annotated[
-            ChatMessageBlockingResponse | ChatPausedBlockingResponse,
-            Field(discriminator="event"),
-        ]
-    ]
-):
-    """Blocking chat response for a completed message or paused Chatflow."""
-
-
-class CompletionBlockingResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    event: str
-    task_id: UUIDString
-    id: UUIDString
-    message_id: UUIDString
-    mode: str
-    answer: str
-    metadata: BlockingMetadataResponse = Field(description="Metadata including usage and retriever resources.")
-    created_at: Int64
-
-
-class WorkflowBlockingDataBase(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    id: UUIDString
-    workflow_id: UUIDString
-    outputs: dict[str, Any] | None
-    error: str | None
-    elapsed_time: FloatNumber
-    total_tokens: int
-    total_steps: int
-    created_at: Int64
-    finished_at: Int64 | None
-
-
-class WorkflowFinishedBlockingDataResponse(WorkflowBlockingDataBase):
-    status: Literal["succeeded", "failed", "stopped", "partial-succeeded"]
-
-
-class WorkflowPausedBlockingDataResponse(WorkflowBlockingDataBase):
-    status: Literal["paused"]
-    paused_nodes: list[str]
-    reasons: list[WorkflowPauseReasonResponse]
-
-
-class WorkflowFinishedBlockingResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    task_id: UUIDString
-    workflow_run_id: UUIDString
-    data: WorkflowFinishedBlockingDataResponse
-
-
-class WorkflowPausedBlockingResponse(ResponseModel):
-    model_config = ConfigDict(extra="allow")
-
-    task_id: UUIDString
-    workflow_run_id: UUIDString
-    data: WorkflowPausedBlockingDataResponse
-
-
-class WorkflowBlockingResponse(RootModel[WorkflowFinishedBlockingResponse | WorkflowPausedBlockingResponse]):
-    """Blocking workflow response for a finished or paused execution."""
-
-
 class SimpleResultResponse(ResponseModel):
-    result: str = Field(description="Operation result.")
+    result: str
 
 
 class GeneratedAppResponse(RootModel[JSONValue]):
@@ -437,6 +126,12 @@ class UsageCountResponse(ResponseModel):
     count: int
 
 
+class IndexInfoResponse(ResponseModel):
+    welcome: str
+    api_version: str
+    server_version: str
+
+
 class AvatarUrlResponse(ResponseModel):
     avatar_url: str
 
@@ -469,16 +164,16 @@ class NewAppResponse(ResponseModel):
 class Parameters(BaseModel):
     opening_statement: str | None = None
     suggested_questions: list[str]
-    suggested_questions_after_answer: FeatureToggleObject
-    speech_to_text: FeatureToggleObject
-    text_to_speech: TextToSpeechObject
-    retriever_resource: FeatureToggleObject
-    annotation_reply: FeatureToggleObject
-    more_like_this: FeatureToggleObject
-    user_input_form: UserInputFormList
-    sensitive_word_avoidance: FeatureToggleObject
-    file_upload: FileUploadObject
-    system_parameters: SystemParameters = Field(description="System-level parameter limits.")
+    suggested_questions_after_answer: JSONObject
+    speech_to_text: JSONObject
+    text_to_speech: JSONObject
+    retriever_resource: JSONObject
+    annotation_reply: JSONObject
+    more_like_this: JSONObject
+    user_input_form: list[JSONObject]
+    sensitive_word_avoidance: JSONObject
+    file_upload: JSONObject
+    system_parameters: SystemParameters
 
 
 class Site(BaseModel):
@@ -499,7 +194,7 @@ class Site(BaseModel):
     show_workflow_steps: bool
     use_icon_as_answer_icon: bool
 
-    @computed_field(return_type=URLString | None)  # type: ignore
+    @computed_field(return_type=str | None)  # type: ignore
     @property
     def icon_url(self) -> str | None:
         if self.icon and self.icon_type == IconType.IMAGE:

api/controllers/common/helpers.py

@@ -1,4 +1,39 @@
+import contextlib
+import mimetypes
+import os
+import platform
+import re
 import urllib.parse
+import warnings
+from uuid import uuid4
+
+import httpx
+
+try:
+    import magic
+except ImportError:
+    if platform.system() == "Windows":
+        warnings.warn(
+            "To use python-magic guess MIMETYPE, you need to run `pip install python-magic-bin`", stacklevel=2
+        )
+    elif platform.system() == "Darwin":
+        warnings.warn("To use python-magic guess MIMETYPE, you need to run `brew install libmagic`", stacklevel=2)
+    elif platform.system() == "Linux":
+        warnings.warn(
+            "To use python-magic guess MIMETYPE, you need to run `sudo apt-get install libmagic1`", stacklevel=2
+        )
+    else:
+        warnings.warn("To use python-magic guess MIMETYPE, you need to install `libmagic`", stacklevel=2)
+    magic = None  # type: ignore[assignment]
+
+from pydantic import BaseModel
+
+
+class FileInfo(BaseModel):
+    filename: str
+    extension: str
+    mimetype: str
+    size: int
 
 
 def decode_remote_url(url: str, query_string: bytes | str = b"") -> str:
@@ -10,15 +45,59 @@ def decode_remote_url(url: str, query_string: bytes | str = b"") -> str:
     if not raw_query:
         return decoded_url
 
-    try:
-        has_query = bool(urllib.parse.urlsplit(decoded_url).query)
-    except ValueError:
-        has_query = False
-
     if decoded_url.endswith(("?", "&")):
         separator = ""
-    elif has_query:
+    elif urllib.parse.urlsplit(decoded_url).query:
         separator = "&"
     else:
         separator = "?"
     return f"{decoded_url}{separator}{raw_query}"
+
+
+def guess_file_info_from_response(response: httpx.Response):
+    url = str(response.url)
+    # Try to extract filename from URL
+    parsed_url = urllib.parse.urlparse(url)
+    url_path = parsed_url.path
+    # Decode percent-encoded characters in the path segment
+    filename = urllib.parse.unquote(os.path.basename(url_path))
+
+    # If filename couldn't be extracted, use Content-Disposition header
+    if not filename:
+        content_disposition = response.headers.get("Content-Disposition")
+        if content_disposition:
+            filename_match = re.search(r'filename="?(.+)"?', content_disposition)
+            if filename_match:
+                filename = filename_match.group(1)
+
+    # If still no filename, generate a unique one
+    if not filename:
+        unique_name = str(uuid4())
+        filename = f"{unique_name}"
+
+    # Guess MIME type from filename first, then URL
+    mimetype, _ = mimetypes.guess_type(filename)
+    if mimetype is None:
+        mimetype, _ = mimetypes.guess_type(url)
+    if mimetype is None:
+        # If guessing fails, use Content-Type from response headers
+        mimetype = response.headers.get("Content-Type", "application/octet-stream")
+
+    # Use python-magic to guess MIME type if still unknown or generic
+    if mimetype == "application/octet-stream" and magic is not None:
+        with contextlib.suppress(magic.MagicException):
+            mimetype = magic.from_buffer(response.content[:1024], mime=True)
+
+    extension = os.path.splitext(filename)[1]
+
+    # Ensure filename has an extension
+    if not extension:
+        extension = mimetypes.guess_extension(mimetype) or ".bin"
+        filename = f"{filename}{extension}"
+
+    return FileInfo(
+        filename=filename,
+        extension=extension,
+        mimetype=mimetype,
+        size=int(response.headers.get("Content-Length", -1)),
+    )

api/controllers/common/wraps.py

@@ -152,7 +152,7 @@ def _extract_resource_id(
     if resource_type == RBACResourceScope.APP:
         app_id = matched_args.get("app_id")
         if app_id:
-            return str(app_id)  # pyrefly: ignore[unnecessary-type-conversion]
+            return str(app_id)
 
         agent_id = matched_args.get("agent_id")
         if agent_id:
@@ -161,7 +161,7 @@ def _extract_resource_id(
 
         resource_id = matched_args.get("resource_id")
         if resource_id:
-            return str(resource_id)  # pyrefly: ignore[unnecessary-type-conversion]
+            return str(resource_id)
         raise ValueError("Missing app_id in request path")
 
     if resource_type == RBACResourceScope.DATASET:
@@ -171,11 +171,9 @@ def _extract_resource_id(
 
         pipeline_id = matched_args.get("pipeline_id")
         if pipeline_id:
-            dataset = db.session.scalar(
-                select(Dataset).where(Dataset.pipeline_id == str(pipeline_id), Dataset.tenant_id == tenant_id)
-            )
+            dataset = db.session.scalar(select(Dataset).where(Dataset.pipeline_id == str(pipeline_id)))
             if not dataset:
                 raise NotFound("Dataset not found for pipeline")
-            return str(dataset.id)  # pyrefly: ignore[unnecessary-type-conversion]
+            return str(dataset.id)
         raise ValueError("Missing dataset_id or pipeline_id in request path")
     raise ValueError(f"Unknown resource_type: {resource_type}")

api/controllers/console/__init__.py

@@ -1,11 +1,9 @@
-from http import HTTPStatus
 from importlib import import_module
 
-from flask import Blueprint, current_app, got_request_exception
+from flask import Blueprint
 from flask_restx import Namespace
 
 from libs.external_api import ExternalApi
-from machinery.errors import ActiveWorkspaceRequiredError
 
 bp = Blueprint("console", __name__, url_prefix="/console/api")
 
@@ -16,19 +14,6 @@ api = ExternalApi(
     description="Console management APIs for app configuration, monitoring, and administration",
 )
 
-
-@api.errorhandler(ActiveWorkspaceRequiredError)
-def _handle_active_workspace_required_error(error: ActiveWorkspaceRequiredError):
-    """Map a broken Console admission invariant without exposing internal details."""
-    got_request_exception.send(current_app, exception=error)
-    status = HTTPStatus.INTERNAL_SERVER_ERROR
-    return {
-        "code": error.error_code,
-        "message": status.phrase,
-        "status": status.value,
-    }, status.value
-
-
 console_ns = Namespace("console", description="Console management API operations", path="/")
 
 RESOURCE_MODULES = (
@@ -56,9 +41,10 @@ from . import (
     knowledge_fs_proxy,
     notification,
     onboarding,
+    ping,
     setup,
     spec,
-    system,
+    version,
     workflow_run_archive,
 )
 from .agent import composer as agent_composer
@@ -72,6 +58,7 @@ from .app import (
     agent_app_feature,
     agent_app_sandbox,
     agent_config_inspector,
+    agent_drive_inspector,
     annotation,
     app,
     audio,
@@ -157,7 +144,6 @@ from .workspace import (
     models,
     plugin,
     rbac,
-    skills,
     snippets,
     tool_providers,
     trigger_providers,
@@ -176,6 +162,7 @@ __all__ = [
     "agent_app_sandbox",
     "agent_composer",
     "agent_config_inspector",
+    "agent_drive_inspector",
     "agent_providers",
     "agent_roster",
     "annotation",
@@ -226,6 +213,7 @@ __all__ = [
     "onboarding",
     "ops_trace",
     "parameter",
+    "ping",
     "plugin",
     "rag_pipeline",
     "rag_pipeline_datasets",
@@ -237,18 +225,17 @@ __all__ = [
     "saved_message",
     "setup",
     "site",
-    "skills",
     "snippet_workflow",
     "snippet_workflow_draft_variable",
     "snippets",
     "socketio_workflow",
     "spec",
     "statistic",
-    "system",
     "tags",
     "tool_providers",
     "trial",
     "trigger_providers",
+    "version",
     "website",
     "workflow",
     "workflow_app_log",

api/controllers/console/agent/composer.py

@@ -7,7 +7,7 @@ from werkzeug.exceptions import NotFound
 from controllers.common.schema import query_params_from_model, register_response_schema_models, register_schema_models
 from controllers.common.session import with_session
 from controllers.console import console_ns
-from controllers.console.app.wraps import agent_manage_required_for_agent_app, get_app_model
+from controllers.console.app.wraps import get_app_model
 from controllers.console.wraps import (
     RBACPermission,
     RBACResourceScope,
@@ -182,7 +182,14 @@ class WorkflowAgentComposerValidateApi(Resource):
         AgentComposerService.validate_knowledge_datasets(
             session=session, tenant_id=tenant_id, agent_soul=req_data.agent_soul
         )
-        findings = AgentComposerService.collect_validation_findings(payload=req_data)
+        findings = AgentComposerService.collect_validation_findings(
+            session=session,
+            tenant_id=tenant_id,
+            payload=req_data,
+            agent_id=AgentComposerService.resolve_workflow_node_agent_id(
+                session=session, tenant_id=tenant_id, app_id=app_model.id, node_id=node_id
+            ),
+        )
         return dump_response(AgentComposerValidateResponse, {"result": "success", "errors": [], **findings})
 
 
@@ -277,7 +284,7 @@ class WorkflowAgentComposerSaveToRosterApi(Resource):
 
 def _require_snippet_app_id(*, session: Session, tenant_id: str, snippet_id: UUID) -> str:
     snippet = SnippetService(session=session).get_snippet_by_id(
-        snippet_id=str(snippet_id),  # pyrefly: ignore[unnecessary-type-conversion]
+        snippet_id=str(snippet_id),
         tenant_id=tenant_id,
     )
     if snippet is None:
@@ -406,12 +413,22 @@ class SnippetAgentComposerValidateApi(Resource):
     @with_session(write=False)
     @model_validate(ComposerSavePayload)
     def post(self, req_data: ComposerSavePayload, session: Session, tenant_id: str, snippet_id: UUID, node_id: str):
-        _require_snippet_app_id(session=session, tenant_id=tenant_id, snippet_id=snippet_id)
+        app_id = _require_snippet_app_id(session=session, tenant_id=tenant_id, snippet_id=snippet_id)
         ComposerConfigValidator.validate_publish_payload(req_data)
         AgentComposerService.validate_knowledge_datasets(
             session=session, tenant_id=tenant_id, agent_soul=req_data.agent_soul
         )
-        findings = AgentComposerService.collect_validation_findings(payload=req_data)
+        findings = AgentComposerService.collect_validation_findings(
+            session=session,
+            tenant_id=tenant_id,
+            payload=req_data,
+            agent_id=AgentComposerService.resolve_workflow_node_agent_id(
+                session=session,
+                tenant_id=tenant_id,
+                app_id=app_id,
+                node_id=node_id,
+            ),
+        )
         return dump_response(AgentComposerValidateResponse, {"result": "success", "errors": [], **findings})
 
 
@@ -512,7 +529,6 @@ class AgentComposerApi(Resource):
     @setup_required
     @login_required
     @account_initialization_required
-    @rbac_permission_required(RBACResourceScope.WORKSPACE, RBACPermission.AGENT_MANAGE, resource_required=False)
     @with_current_tenant_id
     @with_session
     def get(self, session: Session, tenant_id: str, agent_id: UUID):
@@ -527,7 +543,8 @@ class AgentComposerApi(Resource):
     @login_required
     @account_initialization_required
     @edit_permission_required
-    @agent_manage_required_for_agent_app(scene=RBACPermission.APP_EDIT)
+    @rbac_permission_required(RBACResourceScope.APP, RBACPermission.APP_EDIT)
+    @rbac_permission_required(RBACResourceScope.WORKSPACE, RBACPermission.AGENT_MANAGE, resource_required=False)
     @with_current_user_id
     @with_current_tenant_id
     @with_session
@@ -563,7 +580,12 @@ class AgentComposerValidateApi(Resource):
         AgentComposerService.validate_knowledge_datasets(
             session=session, tenant_id=tenant_id, agent_soul=req_data.agent_soul
         )
-        findings = AgentComposerService.collect_validation_findings(payload=req_data)
+        findings = AgentComposerService.collect_validation_findings(
+            session=session,
+            tenant_id=tenant_id,
+            payload=req_data,
+            agent_id=str(agent_id),
+        )
         return dump_response(AgentComposerValidateResponse, {"result": "success", "errors": [], **findings})
 
 

api/controllers/console/agent/roster.py

@@ -1,10 +1,9 @@
-from typing import Literal
 from uuid import UUID
 
 from flask import abort, request
 from flask_restx import Resource
 from pydantic import AliasChoices, BaseModel, Field, field_validator
-from sqlalchemy import func, or_, select
+from sqlalchemy import func, select
 from sqlalchemy.orm import Session
 
 from controllers.common.schema import (
@@ -32,7 +31,6 @@ from controllers.console.app.app import (
 from controllers.console.app.app import (
     UpdateAppPayload as GenericUpdateAppPayload,
 )
-from controllers.console.app.wraps import agent_manage_required_for_agent_app
 from controllers.console.wraps import (
     RBACPermission,
     RBACResourceScope,
@@ -78,25 +76,16 @@ from services.agent.observability_service import (
     AgentStatisticsQueryParams,
 )
 from services.agent.roster_service import AgentRosterService
-from services.app_service import AgentAppPublicationCounts, AppListParams, AppService, CreateAppParams
+from services.app_service import AppListParams, AppService, CreateAppParams
 from services.enterprise.enterprise_service import EnterpriseService
 from services.entities.agent_entities import ComposerSavePayload, RosterListQuery
-from services.system_feature_service import SystemFeatureService
-
-AgentPublicationStatus = Literal["published", "drafts"]
+from services.feature_service import FeatureService
 
 
 class AgentInviteOptionsQuery(RosterListQuery):
     app_id: str | None = Field(default=None, description="Workflow app id for in-current-workflow markers")
 
 
-class AgentAppListQuery(AppListQuery):
-    publication_status: AgentPublicationStatus | None = Field(
-        default=None,
-        description="Filter by published or draft Agent configuration status",
-    )
-
-
 class AgentIdPath(BaseModel):
     agent_id: str
 
@@ -310,19 +299,7 @@ class AgentSimpleResultResponse(BaseModel):
     result: str
 
 
-class AgentPublicationCountsResponse(ResponseModel):
-    published: int = Field(
-        ge=0,
-        description="Published Agent Apps in the current list scope, excluding the publication status filter",
-    )
-    drafts: int = Field(
-        ge=0,
-        description="Draft Agent Apps in the current list scope, excluding the publication status filter",
-    )
-
-
 class AgentAppPagination(GenericAppPagination):
-    publication_counts: AgentPublicationCountsResponse
     data: list[AgentAppPartial] = Field(  # type: ignore[assignment]  # pyrefly: ignore[bad-override-mutable-attribute]
         validation_alias=AliasChoices("items", "data")
     )
@@ -337,7 +314,6 @@ register_schema_models(
     AgentBuildDraftCheckoutPayload,
     ComposerSavePayload,
     AgentApiStatusPayload,
-    AgentAppListQuery,
     AgentInviteOptionsQuery,
     AgentLogsQuery,
     AgentStatisticsQuery,
@@ -347,7 +323,6 @@ register_schema_models(
 )
 register_response_schema_models(
     console_ns,
-    AgentPublicationCountsResponse,
     AgentAppPagination,
     AgentApiAccessResponse,
     AgentAppPublishedReferenceResponse,
@@ -388,7 +363,7 @@ def _serialize_agent_app_detail(
     """
 
     app_model = AppService().get_app(app_model, session=session)
-    if SystemFeatureService.is_webapp_auth_enabled():
+    if FeatureService.get_system_features().webapp_auth.enabled:
         app_setting = EnterpriseService.WebAppAuth.get_app_access_mode_by_id(app_id=str(app_model.id))
         app_model.access_mode = app_setting.access_mode  # type: ignore[attr-defined]
 
@@ -433,14 +408,7 @@ def _serialize_agent_app_detail(
     return payload
 
 
-def _serialize_agent_app_pagination(
-    session: Session,
-    app_pagination,
-    *,
-    tenant_id: str,
-    current_user: Account,
-    publication_counts: AgentAppPublicationCounts,
-) -> dict:
+def _serialize_agent_app_pagination(session: Session, app_pagination, *, tenant_id: str, current_user: Account) -> dict:
     """Serialize Agent App lists with roster-shaped items.
 
     Each item starts from the shared App list shape, then drops
@@ -473,17 +441,8 @@ def _serialize_agent_app_pagination(
         account_id=current_user.id,
     )
     payload = AgentAppPagination.model_validate(
-        {
-            "page": app_pagination.page,
-            "limit": app_pagination.per_page,
-            "total": app_pagination.total,
-            "has_more": app_pagination.has_next,
-            "data": app_pagination.items,
-            "publication_counts": {
-                "published": publication_counts.published,
-                "drafts": publication_counts.drafts,
-            },
-        },
+        app_pagination,
+        from_attributes=True,
         context={"session": session},
     ).model_dump(mode="json")
     for item in payload["data"]:
@@ -525,13 +484,12 @@ def _resolve_agent_runtime_app_model(session: Session, *, tenant_id: str, agent_
     return _agent_roster_service(session).get_agent_runtime_app_model(tenant_id=tenant_id, agent_id=str(agent_id))
 
 
-def _agent_api_key_count(session: Session, app_model: App) -> int:
+def _agent_api_key_count(session: Session, app_id: str) -> int:
     return (
         session.scalar(
             select(func.count(ApiToken.id)).where(
-                or_(ApiToken.tenant_id == app_model.tenant_id, ApiToken.tenant_id.is_(None)),
                 ApiToken.type == ApiTokenType.APP,
-                ApiToken.app_id == app_model.id,
+                ApiToken.app_id == app_id,
             )
         )
         or 0
@@ -563,7 +521,7 @@ def _serialize_agent_api_access(session: Session, app_model: App) -> dict:
         meta_endpoint=f"{base_url}/meta",
         api_rpm=app_model.api_rpm or 0,
         api_rph=app_model.api_rph or 0,
-        api_key_count=_agent_api_key_count(session, app_model),
+        api_key_count=_agent_api_key_count(session, str(app_model.id)),
     )
     return response.model_dump(mode="json")
 
@@ -603,7 +561,7 @@ def _query_values(name: str, alias_name: str | None = None) -> list[str]:
 
 @console_ns.route("/agent")
 class AgentAppListApi(Resource):
-    @console_ns.doc(params=query_params_from_model(AgentAppListQuery))
+    @console_ns.doc(params=query_params_from_model(AppListQuery))
     @console_ns.response(200, "Agent app list", console_ns.models[AgentAppPagination.__name__])
     @setup_required
     @login_required
@@ -613,9 +571,7 @@ class AgentAppListApi(Resource):
     @with_current_tenant_id
     @with_session
     def get(self, session: Session, current_tenant_id: str, current_user: Account):
-        args = query_params_from_request(AgentAppListQuery, list_fields=APP_LIST_QUERY_ARRAY_FIELDS)
-        agent_is_published = None if args.publication_status is None else args.publication_status == "published"
-
+        args = query_params_from_request(AppListQuery, list_fields=APP_LIST_QUERY_ARRAY_FIELDS)
         params = AppListParams(
             page=args.page,
             limit=args.limit,
@@ -626,29 +582,11 @@ class AgentAppListApi(Resource):
             creator_ids=args.creator_ids,
             is_created_by_me=args.is_created_by_me,
             status="normal",
-            agent_is_published=agent_is_published,
         )
 
-        app_service = AppService()
-        publication_counts = app_service.get_agent_publication_counts(
-            current_user.id,
-            current_tenant_id,
-            params,
-            session,
-        )
-        app_pagination = app_service.get_paginate_apps(current_user.id, current_tenant_id, params, session)
+        app_pagination = AppService().get_paginate_apps(current_user.id, current_tenant_id, params, session)
         if app_pagination is None:
-            empty = AgentAppPagination(
-                page=args.page,
-                limit=args.limit,
-                total=0,
-                has_more=False,
-                publication_counts=AgentPublicationCountsResponse(
-                    published=publication_counts.published,
-                    drafts=publication_counts.drafts,
-                ),
-                data=[],
-            )
+            empty = AgentAppPagination(page=args.page, limit=args.limit, total=0, has_more=False, data=[])
             return empty.model_dump(mode="json")
 
         return _serialize_agent_app_pagination(
@@ -656,12 +594,10 @@ class AgentAppListApi(Resource):
             app_pagination,
             tenant_id=current_tenant_id,
             current_user=current_user,
-            publication_counts=publication_counts,
         )
 
     @console_ns.expect(console_ns.models[AgentAppCreatePayload.__name__])
     @console_ns.response(201, "Agent app created successfully", console_ns.models[AgentAppDetailWithSite.__name__])
-    @console_ns.response(409, "Agent name already exists")
     @console_ns.response(403, "Insufficient permissions")
     @console_ns.response(400, "Invalid request parameters")
     @setup_required
@@ -694,7 +630,6 @@ class AgentAppApi(Resource):
     @setup_required
     @login_required
     @account_initialization_required
-    @rbac_permission_required(RBACResourceScope.WORKSPACE, RBACPermission.AGENT_MANAGE, resource_required=False)
     @enterprise_license_required
     @with_current_user
     @with_current_tenant_id
@@ -984,7 +919,8 @@ class AgentApiStatusApi(Resource):
     @login_required
     @is_admin_or_owner_required
     @account_initialization_required
-    @agent_manage_required_for_agent_app(scene=RBACPermission.APP_RELEASE_AND_VERSION)
+    @rbac_permission_required(RBACResourceScope.WORKSPACE, RBACPermission.AGENT_MANAGE, resource_required=False)
+    @rbac_permission_required(RBACResourceScope.APP, RBACPermission.APP_RELEASE_AND_VERSION)
     @with_current_tenant_id
     @with_session
     @model_validate(AgentApiStatusPayload)
@@ -1002,9 +938,8 @@ class AgentApiKeyListApi(BaseApiKeyListResource):
     token_prefix = "app-"
 
     @console_ns.response(200, "Agent service API keys", console_ns.models[ApiKeyList.__name__])
-    @agent_manage_required_for_agent_app(scene=RBACPermission.APP_RELEASE_AND_VERSION)
+    @rbac_permission_required(RBACResourceScope.WORKSPACE, RBACPermission.AGENT_MANAGE, resource_required=False)
     @with_current_tenant_id
-    @edit_permission_required
     @with_session(write=False)
     def get(self, session: Session, tenant_id: str, agent_id: UUID) -> dict[str, object]:
         app_model = _resolve_agent_app_model(session, tenant_id=tenant_id, agent_id=agent_id)
@@ -1014,7 +949,8 @@ class AgentApiKeyListApi(BaseApiKeyListResource):
     @console_ns.response(400, "Maximum keys exceeded")
     @with_current_tenant_id
     @edit_permission_required
-    @agent_manage_required_for_agent_app(scene=RBACPermission.APP_RELEASE_AND_VERSION)
+    @rbac_permission_required(RBACResourceScope.WORKSPACE, RBACPermission.AGENT_MANAGE, resource_required=False)
+    @rbac_permission_required(RBACResourceScope.APP, RBACPermission.APP_RELEASE_AND_VERSION)
     @with_session
     def post(self, session: Session, tenant_id: str, agent_id: UUID) -> tuple[dict[str, object], int]:
         app_model = _resolve_agent_app_model(session, tenant_id=tenant_id, agent_id=agent_id)
@@ -1033,7 +969,8 @@ class AgentApiKeyApi(BaseApiKeyResource):
     @console_ns.response(204, "Agent service API key deleted")
     @with_current_user
     @with_current_tenant_id
-    @agent_manage_required_for_agent_app(scene=RBACPermission.APP_RELEASE_AND_VERSION)
+    @rbac_permission_required(RBACResourceScope.WORKSPACE, RBACPermission.AGENT_MANAGE, resource_required=False)
+    @rbac_permission_required(RBACResourceScope.APP, RBACPermission.APP_RELEASE_AND_VERSION)
     @with_session
     def delete(
         self,
@@ -1132,7 +1069,7 @@ class AgentLogMessagesApi(Resource):
             payload = _agent_observability_service(session).list_log_messages(
                 app=app_model,
                 agent_id=str(agent_id),
-                conversation_id=str(conversation_id),  # pyrefly: ignore[unnecessary-type-conversion]
+                conversation_id=str(conversation_id),
                 params=AgentLogQueryParams(
                     page=query.page,
                     limit=query.limit,

api/controllers/console/apikey.py

@@ -1,4 +1,3 @@
-from collections.abc import Iterable, Mapping
 from datetime import datetime
 from uuid import UUID
 
@@ -6,7 +5,7 @@ import flask_restx
 from flask_restx import Resource
 from flask_restx._http import HTTPStatus
 from pydantic import field_validator
-from sqlalchemy import func, or_, select
+from sqlalchemy import delete, func, select
 from sqlalchemy.orm import Session
 from werkzeug.exceptions import Forbidden
 
@@ -41,9 +40,6 @@ class ApiKeyItem(ResponseModel):
     id: str
     type: str
     token: str
-    # Dataset keys only: the knowledge bases this key is bound to. Empty = the key can
-    # access every dataset in the tenant (default). App keys are always empty.
-    dataset_ids: list[str] = []
     last_used_at: int | None = None
     created_at: int | None = None
 
@@ -60,38 +56,6 @@ class ApiKeyList(ResponseModel):
 register_response_schema_models(console_ns, ApiKeyItem, ApiKeyList)
 
 
-def mask_api_token(token: str) -> str:
-    """Mask a secret token for list responses.
-
-    Reveal-once: the full secret is only returned by the create endpoint. List
-    endpoints expose just enough (prefix + last 4) to identify a key, never the
-    full value, so an existing key's secret cannot be retrieved after creation.
-    """
-    if len(token) <= 8:
-        return "***"
-    return f"{token[:5]}...{token[-4:]}"
-
-
-def build_masked_api_key_list(
-    api_tokens: Iterable[ApiToken],
-    bindings_by_token: Mapping[str, list[str]] | None = None,
-) -> ApiKeyList:
-    """Build an ApiKeyList from ORM tokens with their secrets masked.
-
-    ``bindings_by_token`` maps an api_token id to the dataset ids it is bound to
-    (from DatasetApiTokenBinding); tokens absent from the map are unbound (empty =
-    access all). App-key lists omit it entirely.
-    """
-    bindings_by_token = bindings_by_token or {}
-    items: list[ApiKeyItem] = []
-    for api_token in api_tokens:
-        item = ApiKeyItem.model_validate(api_token, from_attributes=True)
-        item.token = mask_api_token(item.token)
-        item.dataset_ids = bindings_by_token.get(str(api_token.id), [])
-        items.append(item)
-    return ApiKeyList(data=items)
-
-
 def _get_resource(resource_id, tenant_id, resource_model, *, session: Session):
     resource = session.execute(
         select(resource_model).filter_by(id=resource_id, tenant_id=tenant_id)
@@ -125,14 +89,10 @@ class BaseApiKeyListResource(Resource):
         _get_resource(resource_id, current_tenant_id, self.resource_model, session=session)
         keys = session.scalars(
             select(ApiToken).where(
-                or_(ApiToken.tenant_id == current_tenant_id, ApiToken.tenant_id.is_(None)),
-                ApiToken.type == self.resource_type,
-                getattr(ApiToken, self.resource_id_field) == resource_id,
+                ApiToken.type == self.resource_type, getattr(ApiToken, self.resource_id_field) == resource_id
             )
         ).all()
-        # App and agent keys keep their existing (unmasked) list behavior; reveal-once
-        # masking is scoped to dataset keys, which build their list in datasets.py.
-        return ApiKeyList(data=[ApiKeyItem.model_validate(key, from_attributes=True) for key in keys])
+        return ApiKeyList.model_validate({"data": keys}, from_attributes=True)
 
     @edit_permission_required
     @with_session
@@ -150,9 +110,7 @@ class BaseApiKeyListResource(Resource):
         current_key_count: int = (
             session.scalar(
                 select(func.count(ApiToken.id)).where(
-                    or_(ApiToken.tenant_id == current_tenant_id, ApiToken.tenant_id.is_(None)),
-                    ApiToken.type == self.resource_type,
-                    getattr(ApiToken, self.resource_id_field) == resource_id,
+                    ApiToken.type == self.resource_type, getattr(ApiToken, self.resource_id_field) == resource_id
                 )
             )
             or 0
@@ -214,7 +172,6 @@ class BaseApiKeyResource(Resource):
         key = session.scalar(
             select(ApiToken)
             .where(
-                or_(ApiToken.tenant_id == current_tenant_id, ApiToken.tenant_id.is_(None)),
                 getattr(ApiToken, self.resource_id_field) == resource_id,
                 ApiToken.type == self.resource_type,
                 ApiToken.id == api_key_id,
@@ -230,7 +187,7 @@ class BaseApiKeyResource(Resource):
         assert key is not None  # nosec - for type checker only
         ApiTokenCache.delete(key.token, key.type)
 
-        session.delete(key)
+        session.execute(delete(ApiToken).where(ApiToken.id == api_key_id))
         session.commit()
 
 
@@ -241,15 +198,13 @@ class AppApiKeyListResource(BaseApiKeyListResource):
     @console_ns.doc(params={"resource_id": "App ID"})
     @console_ns.response(200, "API keys retrieved successfully", console_ns.models[ApiKeyList.__name__])
     @with_current_tenant_id
-    @edit_permission_required
-    @rbac_permission_required(RBACResourceScope.APP, RBACPermission.APP_RELEASE_AND_VERSION)
     @agent_manage_required_for_agent_app
     @with_session(write=False)
     def get(self, session: Session, current_tenant_id: str, resource_id: UUID) -> dict[str, object]:
         """Get all API keys for an app"""
         return dump_response(
             ApiKeyList,
-            self._get_api_key_list(str(resource_id), current_tenant_id, session=session),  # pyrefly: ignore[unnecessary-type-conversion]
+            self._get_api_key_list(str(resource_id), current_tenant_id, session=session),
         )
 
     @console_ns.doc("create_app_api_key")
@@ -266,7 +221,7 @@ class AppApiKeyListResource(BaseApiKeyListResource):
         """Create a new API key for an app"""
         return dump_response(
             ApiKeyItem,
-            self._create_api_key(str(resource_id), current_tenant_id, session=session),  # pyrefly: ignore[unnecessary-type-conversion]
+            self._create_api_key(str(resource_id), current_tenant_id, session=session),
         ), 201
 
     resource_type = ApiTokenType.APP
@@ -296,7 +251,7 @@ class AppApiKeyResource(BaseApiKeyResource):
     ) -> tuple[str, int]:
         """Delete an API key for an app"""
         self._delete_api_key(
-            str(resource_id),  # pyrefly: ignore[unnecessary-type-conversion]
+            str(resource_id),
             str(api_key_id),
             current_tenant_id,
             current_user,
@@ -309,10 +264,6 @@ class AppApiKeyResource(BaseApiKeyResource):
     resource_id_field = "app_id"
 
 
-# Dataset service-API keys are also managed at the workspace level (create with a set of
-# knowledge bases, list, delete) by DatasetApiKeyApi in
-# controllers/console/datasets/datasets.py, using DatasetApiTokenBinding for scoping.
-# The per-dataset routes below remain for callers that key an API token to a single dataset.
 @console_ns.route("/datasets/<uuid:resource_id>/api-keys")
 class DatasetApiKeyListResource(BaseApiKeyListResource):
     @console_ns.doc("get_dataset_api_keys")
@@ -320,14 +271,12 @@ class DatasetApiKeyListResource(BaseApiKeyListResource):
     @console_ns.doc(params={"resource_id": "Dataset ID"})
     @console_ns.response(200, "API keys retrieved successfully", console_ns.models[ApiKeyList.__name__])
     @with_current_tenant_id
-    @edit_permission_required
-    @rbac_permission_required(RBACResourceScope.DATASET, RBACPermission.DATASET_API_KEY_MANAGE)
     @with_session(write=False)
     def get(self, session: Session, current_tenant_id: str, resource_id: UUID) -> dict[str, object]:
         """Get all API keys for a dataset"""
         return dump_response(
             ApiKeyList,
-            self._get_api_key_list(str(resource_id), current_tenant_id, session=session),  # pyrefly: ignore[unnecessary-type-conversion]
+            self._get_api_key_list(str(resource_id), current_tenant_id, session=session),
         )
 
     @console_ns.doc("create_dataset_api_key")
@@ -343,7 +292,7 @@ class DatasetApiKeyListResource(BaseApiKeyListResource):
         """Create a new API key for a dataset"""
         return dump_response(
             ApiKeyItem,
-            self._create_api_key(str(resource_id), current_tenant_id, session=session),  # pyrefly: ignore[unnecessary-type-conversion]
+            self._create_api_key(str(resource_id), current_tenant_id, session=session),
         ), 201
 
     resource_type = ApiTokenType.DATASET
@@ -372,7 +321,7 @@ class DatasetApiKeyResource(BaseApiKeyResource):
     ) -> tuple[str, int]:
         """Delete an API key for a dataset"""
         self._delete_api_key(
-            str(resource_id),  # pyrefly: ignore[unnecessary-type-conversion]
+            str(resource_id),
             str(api_key_id),
             current_tenant_id,
             current_user,

api/controllers/console/app/advanced_prompt_template.py

@@ -1,5 +1,6 @@
 from typing import Any
 
+from flask import request
 from flask_restx import Resource
 from pydantic import BaseModel, Field
 
@@ -9,7 +10,7 @@ from controllers.common.schema import (
     register_response_schema_models,
 )
 from controllers.console import console_ns
-from controllers.console.wraps import account_initialization_required, model_validate, setup_required
+from controllers.console.wraps import account_initialization_required, setup_required
 from fields.base import ResponseModel
 from libs.login import login_required
 from services.advanced_prompt_template_service import AdvancedPromptTemplateArgs, AdvancedPromptTemplateService
@@ -48,12 +49,12 @@ class AdvancedPromptTemplateList(Resource):
     @setup_required
     @login_required
     @account_initialization_required
-    @model_validate(AdvancedPromptTemplateQuery)
-    def get(self, req_data: AdvancedPromptTemplateQuery):
+    def get(self):
+        args = AdvancedPromptTemplateQuery.model_validate(request.args.to_dict(flat=True))
         prompt_args: AdvancedPromptTemplateArgs = {
-            "app_mode": req_data.app_mode,
-            "model_mode": req_data.model_mode,
-            "model_name": req_data.model_name,
-            "has_context": req_data.has_context,
+            "app_mode": args.app_mode,
+            "model_mode": args.model_mode,
+            "model_name": args.model_name,
+            "has_context": args.has_context,
         }
         return AdvancedPromptTemplateService.get_prompt(prompt_args)