Self-host dify
1.19.0Open-source platform for agentic AI workflows and RAG
- Stars
- 161 262
- CPU
- 2 Core
- RAM
- 4 GiB
- Ports
- 80 (HTTP (nginx reverse proxy)), 443 (HTTPS (nginx reverse proxy))
langgenius/dify-apiWhat is dify?
Dify is an open-source LLM application development platform by LangGenius that lets teams build, deploy, and manage AI applications through a visual interface. It provides a workflow studio for designing agentic logic, a knowledge pipeline for RAG with document ingestion and retrieval, autonomous agents with sandboxed tool use, comprehensive model provider support, prompt engineering tools, and LLMOps observability. The Community Edition is self-hosted via Docker Compose with a single command, requiring at least 2 CPU cores and 4 GiB RAM. It uses PostgreSQL, Redis, and Weaviate as default dependencies. An Enterprise edition adds SSO/SAML, RBAC, audit logs, and dedicated support under a commercial license. The source code uses a modified Apache 2.0 license that restricts multi-tenant SaaS use and requires preserving branding.
Should you self-host dify?
dify scores 90/100 on selfhost.directory (how scoring works) and ranks #1 of 7 in AI Workflows. It has 161 262 GitHub stars, +2 975 in the last 30 days.
It shipped 16 stable releases in the past year. The latest, 1.19.0, came out on 4 November 2026. New versions land roughly every 2 weeks.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is llama-swap (72/100, 6 258 stars). dify scores higher overall. See dify vs llama-swap side by side.
Features
- Autonomous Agents
- Backend-as-a-Service APIs
- Comprehensive Model Support
- LLMOps Observability
- MCP (Model Context Protocol) Support
- Multi-format Document Processing
- Plugin Marketplace
- Prompt IDE
- RAG Pipeline
- Third-party Observability Integrations
- Visual Workflow Builder
dify README
How to install dify
Install dify with Docker Compose
cd dify/docker cp .env.example .env docker compose up -d
Requires Docker and Docker Compose v2.24.0+
Install dify with Linux
git clone --branch https://github.com/langgenius/dify.git cd dify/docker cp .env.example .env docker compose up -d
Docker Engine and Docker Compose required
dify releases & version history
AI summary Nested workflow tracing
Dify 1.19.0 brings nested workflow tracing to your observability tools. Follow a workflow into the Workflow Tools it calls, inspect the steps inside each invocation, and keep the LLM context alongside the execution tree.
This release also makes Workflow Tools portable with App packages, adds Skill Hub automation, and makes Agent files easier to upload and preview. The bundled plugin daemon is upgraded to 0.6.14-local.
Release highlights · Upgrade guide · Detailed changes
Release highlights
Nested workflow tracing
See what happens inside a Workflow Tool, all the way down to its LLM calls.
Building on the Console drilldown introduced in 1.18.0, new external traces now include the persisted execution steps inside called Workflow Tools. Child steps appear beneath the Tool span that invoked them, preserving the hierarchy across nested and repeated calls. (#44673)
From the outer workflow to a nested LLM call: the execution tree and formatted messages, together in Langfuse. Screenshot from #44673.
- Follow the hierarchy. Expand called Workflow Tools to see their internal execution steps under the invoking Tool span.
- Understand each invocation. Repeated calls and failures retain their place in the trace.
- Keep the LLM context. Inspect formatted prompts and responses, token usage, and project, trace, and observation links.
Note
Your saved provider settings continue to work. The richer hierarchy applies to new executions; historical traces are not backfilled. Independently nested workflow runs remain separate traces linked by parent identifiers. For rolling deployments, follow the tracing queue transition below.
Take Workflow Tools with your apps
Export an app and bring the workflows behind its Workflow Tools with it. .ifpkg packages include those workflows at their bound versions, including transitive dependencies. Import reuses tools already in the destination workspace and recreates, publishes, and registers missing ones, remapping their references. (#44592)
All Dify app exports now use package format v2, including apps without Workflow Tools. Existing v1 imports and explicit YAML export remain supported. See the upgrade guide before importing new packages into older installations. (#45353)
Upload together. Preview in place.
Select or drop multiple Agent configuration files and upload them in parallel. Successful uploads are bound in one atomic batch, concurrent Composer saves preserve the latest files, and Prompt uploads keep the cursor position while inserting multiple references. (#44947)
Read PDFs inline, inspect source files with syntax highlighting, and see when text has been truncated. Previews cover configured files, Skill members, and working-directory files, with a download action when a PDF cannot be loaded. (#45032, #45045)
See Agent file uploads and previews
Read a PDF directly in the Agent file preview and switch between project files.
Select several files and upload them together.
Inspect source files with syntax highlighting and line numbers.
Developer spotlight
Manage workspace Skills through OpenAPI and difyctl. Find and inspect Skills, export a draft or published version, import local files, and publish a new version from the command line. (#44941)
The six Skill commands
| Command | Capability |
|---|---|
difyctl get skill |
List Skills, with keyword and tag filters. |
difyctl describe skill |
Read details, the draft hash, and latest published version. |
difyctl get skill version |
List published versions. |
difyctl export skill |
Export the draft or a selected published version as ZIP. |
difyctl import skill --files <dir> |
Create a Skill or replace an existing Skill's draft from local files. |
difyctl publish skill |
Publish the draft as a new version. |
These operations require an account caller, the corresponding workspace permissions, and Skills to be enabled. Import does not publish. Importing over an existing Skill is classified as destructive; the operation catalog and CLI help distinguish read, write, and destructive operations. (#44941, #45314, #44587)
Upgrade guide
Important
Read the upgrade guide before deploying. Docker Compose now requires v2.35.0 or later. Preserve existing environment files, upgrade the Dify components together, and use the new tracing queue during rolling deployments. New App packages use format v2 and require a compatible destination importer. The bundled plugin daemon moves to 0.6.14-local.
Compatibility and rollout
- Back up first. Retain the database, vector-store data, uploaded files, Agent snapshot/workspace storage, deployment secrets, and environment files. Use a maintenance window for a single-stack upgrade.
- Upgrade the components together. Use matching
1.19.0API, worker, web, Agent Backend, and Local sandbox images, with plugin daemon0.6.14-local. Keep the existing Local sandbox authentication token and any configuredPASSWORD_PEPPERunchanged. If upgrading from before 1.18.0, also follow the 1.18.0 upgrade guide. - Use Docker Compose 2.35.0 or later. This is the minimum supported version for root
.envoverrides to take precedence when Compose resolves service defaults. Check your installed version withdocker compose version. (#45359) - Keep tracked defaults separate from local overrides. Bundled
docker/envs/**/*.defaultsfiles load automatically. Customize a service through its matching local.envfile, using the override path documented in the defaults file; rootdocker/.envholds deployment inputs and explicit overrides. Preserve existing.envfiles and edit them in place. Review accidentally empty assignments and values pinned by older template copies before upgrading. (#45359, #45376) - Existing
shared.envfiles remain supported. Common API, worker, and Beat customizations now belong indocker/envs/core-services/api-worker.env. Compose still reads legacydocker/envs/core-services/shared.envfirst, thenapi-worker.env, soapi-worker.envwins when both set conflicting values. Rootdocker/.envtakes precedence over both. An unchanged copy ofapi-worker.defaultspreserves existingshared.envcustomizations. See the Docker configuration guide. (#45376) - Separate tracing queues during a rolling upgrade. New tasks default to
OPS_TRACE_QUEUE=ops_trace_v2; API, workers, and Beat must agree. CustomCELERY_QUEUES,CELERY_WORKER_QUEUES, or--queueslists must include the new queue. Keep old tracing workers onops_traceuntil old producers and all their queued, active, reserved, scheduled, and retry work have finished. Do not purge the old queue or ask the new retired handler to export legacy messages. See the tracing rollout guide. (#44673) - Upgrade package destinations before importing new App packages. New app packages always use format v2. Older importers, including builds with the earlier strict v2 rule, may reject them. Version 1 imports remain supported on 1.19.0. Explicit YAML export remains available, but does not carry bundled Workflow Tool dependencies. (#44592, #45353)
Deployment instructions · Docker Compose, source, and difyctl
Docker Compose
Once the 1.19.0 release tag and images are published, stop a single-stack deployment gracefully, switch to the release, retain and review configuration, then pull and start the new images:
cd dify/docker docker compose stop -t -1 git fetch --tags git checkout 1.19.0 # Merge required configuration changes into existing env files here. docker compose pull docker compose up -d
Keep API startup migrations enabled (MIGRATION_ENABLED=true), or apply the full migration chain through your managed migration process before starting new workers. For rolling deployments, follow the separate tracing-queue sequence instead of mixing old and new consumers.
Configure shared plugin credentials, PLUGIN_DAEMON_KEY and PLUGIN_DIFY_INNER_API_KEY, in root docker/.env so the daemon and its clients receive matching values. Ports, volume paths, profiles, and health-check scheduling also remain root configuration inputs. See the Docker configuration guide. (#45359)
Source deployments
Use Python 3.13, Node.js 24.22.1 or later in the 24.x line, and pnpm 12.16.1. pnpm no longer provisions Node.js for the workspace, so install the required Node.js runtime separately. (#44976, #45094)
From the repository root:
uv sync --project api --frozen uv run --directory api flask db upgrade pnpm install --frozen-lockfile
Rebuild the web application and restart API, worker, scheduler, and Agent services from the same release. Refresh the standalone Agent Backend's locked server dependencies when deploying it separately.
difyctl
Install the matching 1.19.0 client and use difyctl help to discover the current server catalog. Refresh installed agent skills with difyctl install skills <dir>. Workflow and Chatflow automation should use the revised stop.run operation; message-based apps use stop.task.
Database migrations and existing data
Upgrading from 1.18.0 applies six migration revisions, ending at 53c10126d551. Apply the complete chain through the normal migration runner.
Operational changes to plan for include:
- Storage-cleanup indexes (
d7e9a1c3f502). Add reference indexes onmessage_files.upload_file_id,workflow_node_execution_offload.file_id, andworkflow_draft_variable_files.upload_file_id. PostgreSQL creates them concurrently, but index construction still scans data and consumes I/O. Online upgrades reuse matching healthy indexes and reject conflicting or invalid definitions. Investigate an interrupted invalid build before retrying; do not drop healthy indexes as routine recovery. (#44982) - Tracing configuration uniqueness (
53c10126d551). Keep one configuration per app/provider and add a unique index. When duplicates exist, the most recently updated row wins, with the ID breaking timestamp ties. Superseded rows are deleted; downgrading the index does not restore them. Retain a database backup. (#44673) - Extraction changes affect newly processed content. Re-import or re-index documents whose stored content was affected by the EPUB, EML, DOCX, CSV, Markdown, or Notion fixes. The repeated-PDF-preview fix prevents new duplicate assets for source uploads; it does not remove duplicates already stored. (#44836, #44953, #44905, #43505, #43434, #45053, #44684)
- Tracing history is not rebuilt. Existing Agent trace-ledger data remains readable, but previously exported traces do not acquire the new nested spans. (#44673)
Detailed changes
New capabilities · tracing, packages, and Skills
Tracing and provider integrations
- Consolidate delivery through the shared provider interface for Langfuse, LangSmith, Opik, Weave, Arize, Phoenix, Aliyun, MLflow, Databricks, and Tencent. Retryable exports resend the same trace unit with deterministic identifiers. (#44673)
- Include called Workflow Tools' persisted execution frames in external exports, under their invoking Tool spans. Independently nested workflow runs remain separate traces linked by parent identifiers. (#44673)
- Keep trace credentials write-only. Blank or omitted secrets preserve stored values; changing a destination host, endpoint, or URL requires entering its secrets again. (#44673)
Portable App packages
- Package the workflows behind called Workflow Tools, including transitive dependencies, with a default maximum of 20 bundled tool workflows. Missing destination tools are recreated and published; existing tools are reused. Creating missing tools requires tool-management permission and sufficient app quota. Packages needing DSL-version confirmation are rejected in this flow, and apps created before an import failure are cleaned up. (#44592)
- Always emit format v2 for App packages, including nested packages and packages without Workflow Tools. This does not change the separate roster-Agent package format. (#45353)
- Workflow and API tool IDs no longer become spurious
langgenius/<uuid>plugin dependencies during export. (#44592)
Skills and OpenAPI
- Export drafts or published Skill versions, import folders, and publish through account-authenticated workspace operations. An import with a Skill ID replaces that Skill's draft; the imported
SKILL.mdname must match. Optionaldraft_hashchecks reject stale replacements, but use second-resolution timestamps and do not detect edits made within the same second. (#44941) - Skill import drops operating-system junk, rejects unsafe or duplicate paths, enforces file/size limits, reuses identical binary assets, and removes assets written by a failed import. Literal dashes inside Skill frontmatter are preserved. (#44941, #43602)
- The operation catalog publishes each operation's effect, and CLI help displays it. Workflow/Chatflow stopping uses stored run ownership and state; unknown runs return
404, and finished or otherwise non-stoppable runs return409. Message-app stopping keeps its task-ID semantics. (#44587, #45314) - Add the experimental
@dify/openapi-content-mapperpackage for typed API calls and query helpers inferred from OpenAPI sources, with reusable schema/input/output types and opt-in contract-compatible type subpaths. This is development groundwork; these changes do not migrate production Console or Marketplace calls away from their existing clients. (#44627, #44915)
Improvements · editing, accessibility, performance, and operations
- Batch Agent file management: multi-select and multi-file drop, parallel uploads, one atomic binding request, retry using cached upload IDs, and protection against stale Composer saves overwriting newly bound files. Existing single-file endpoints remain compatible. (#44947)
- More usable previews: highlighted text, on-demand PDF rendering, stable open previews, and explicit truncated-text notices across Agent files, Skills, and working directories. (#45032, #45045)
- Direction and keyboard support: synchronized locale direction, broader right-to-left layouts, date/time pickers integrated with forms and focus containment, visible labels retained in accessible names, and consistent read-only controls. (#44621, #43869, #44638, #44650, #44593, #44755, #44772, #44589, #45036, #45375)
- Safer editing dialogs: deletion, rename, metadata, annotation, member-role, and plugin-setting dialogs preserve their sessions and drafts, keep pending actions open, and restore focus after completion. Repeated deletion submissions are blocked while a request is pending. (#44618, #44623, #44643, #44646, #44698, #44736, #44743, #44810, #44825, #44788, #44715, #44652, #44838, #44830)
- Clearer feedback: field errors and persistent notices appear near the controls they concern, with shared alert presentation across apps, workflows, knowledge, billing, and Skills. Cloud billing uses localized prompts for retryable and action-specific errors. (#45151, #45264, #45266, #45267, #45268, #45192)
- Accurate Cloud quota displays: distinguish unlimited counts from zero-capacity App Run and trigger quotas, and interpret reset dates as Unix seconds. Pricing display data no longer doubles as live usage limits. (#45117, #45115)
- Lower query overhead: segment pages load child chunks and attachments in batches; new reference indexes support app storage cleanup. (#45050, #44982)
- Connection reuse: Gunicorn's configurable keep-alive defaults to 10 seconds, reducing failures caused by reusing connections after the server's shorter idle window. (#44839)
- Docker configuration: service and provider overrides now reach the relevant containers, database commands, health checks, and WebSocket settings. The generator creates only a missing root
.env, leaving optional overrides under operator control. (#45359, #45376)
Security enhancements
- Workspace controls: enabling or disabling provider models requires an owner or administrator. Email-availability checks require account admission. (64fe95667b, 76979a1e24)
- Request-scoped cookies: pooled SSRF clients retain response cookies only within the current outbound request and its redirects, preventing later requests from inheriting another request's cookies. (#44672)
- Dataset token scope: resource access tokens can list only their explicitly bound active datasets;
include_all=truecannot widen that scope. Legacy workspace Dataset API keys retain tenant-wide behavior without inheriting an injected owner's personal visibility filters. (#44840) - App access settings: importing DSL over an existing app preserves its Web App access mode, and converting an app inherits the source access mode. (#44700, #44857)
- Tracing secrets and egress: configuration reads no longer return saved credentials, destination changes require secret re-entry, and provider traffic uses the shared outbound policy. (#44673)
- Dependency hardening: update Authlib to 1.9.1, require LiteLLM 1.100.4 or later within its supported major version, move Agent Pydantic AI to 2.53.0 and Pillow to 13.0.0, update pypdf to 6.21.4, and refresh Werkzeug, GitPython, and other dependency fixes. The standalone Agent pins filelock 4.2.1; Docker build tooling updates uv to 0.13.4. These source updates do not claim to resolve every finding in external or Enterprise base images. (#44606, #44793, #44868, #44871, #44886, #45041, #45104, #45215, #45259, #45214, #45260)
Bug fixes · workflows, Agents, knowledge, APIs, and the web app
Workflows and execution
- Restore structured-output fallback for models without native support and preserve JSON booleans instead of converting them to strings. (#44962)
- Honor configured file and file-list defaults across Studio, published apps, and API execution. Explicit clearing stays distinct from omission, reset conversations restore defaults, and saving file defaults no longer sends browser Blob objects that cause
415errors. (#44780, #45042) - Preserve numeric zero in required Studio inputs and previews, and preserve both zero and false in opening statements. Non-object file-reference payloads fall back to the original reference instead of failing unexpectedly. (#45005, #44833, #45088)
- Admit streaming Workflow and Chatflow requests only once against app concurrency limits, so a limit of one accepts the single active request. Terminal Chatflow events now stop the execution watchdog and release its retained context. (#45038, #45029)
- Preserve caller identity for scheduled Agent file access, use the UTC clock for the Start node's
sys.timestamp, and order weekly schedule previews by date. Webhook query/form numbers retain integer precision and reject non-finite values. (#44796, #44847, #44718, #44706) - Refresh available workflow nodes when availability changes, retain generated variables when applying a generated prompt, escape variable-search highlighting, and preserve prompt-editor focus when variable metadata refreshes. (#44769, #45274, #44625, #44791)
- Request clear-canvas confirmation only when clearing a previously nonempty saved draft, and wrap long workflow error messages. (#45028, #45106)
Agents, tools, and Skills
- Persist refreshed OAuth credentials and serialize concurrent refreshes across tools and datasources, protecting rotating tokens and concurrent reauthorization. Temporary refresh failures return a temporary-unavailability response instead of incorrectly asking users to repair valid credentials. (#32195)
- Reject late non-terminal events after an Agent stream has completed or been cancelled. Deduplicate plugin JSON output by content rather than formatting, and retain trailing partial action/thought prefixes in ReAct output. (#45080, #45297, #43353)
- Stop serializing the entire prompt history into every Agent LLM gateway response chunk. Preserve request content, tool calls, multimodal content, usage, and quota settlement. (#45137)
- Handle non-recording tracing parents and isolate concurrent Celery tracing contexts. (#44701, #44803, #45049)
- Allow current Qwen flash models in Agent v2 and refresh suggested model patterns. Omit empty optional Agent variable inputs, and accept legacy comma-separated values for multiple-select tool parameters. (#44873, #44748, #45058)
- Restore creator-based Agent edit permissions. Skill and snippet searches treat wildcard characters literally, and imported integration bundles retain their plugin icons. (#45040, #44922, #44708, #45112)
Knowledge and document processing
- Remove index entries written by a document that was deleted during indexing. Partial QA-segment updates preserve an omitted answer and its contribution to counts. (#44364, #44997)
- Include documents missing a metadata key in negative metadata filters, honor explicit
top_k=0, normalize blank legacy retrieval settings on read, and use keyword retrieval for Economy datasets in retrieval previews. (#44753, #42980, #45020, #44895) - Restore Notion page listing and file import, keep failed page loads retryable, and surface Notion database HTTP failures. (#45053, #44893)
- Read EPUB chapters in declared order without extracting archive members to disk; preserve already-decoded EML text; identify DOCX images by relationship type; support numeric CSV column labels; and keep headings inside Markdown code fences intact. (#44836, #44953, #44905, #43505, #43434)
- Reuse extracted PDF image assets for repeated previews of the same source upload. Restore Service API file-document creation/update when tenant context is missing or the original dataset creator has left. (#44684, #44972)
- Include users' own maintained datasets in their lists. (#44795)
APIs, files, and SDKs
- Let MCP Chatflow generation commit its conversation session without a closed-transaction error. API-tool imports ignore non-method Swagger path keys. Suggested-question parsing retains brackets inside quoted questions, and missing citation resources return an empty list. (#44636, #44992, #44916, #43036)
- Normalize remote Content-Type values, preserve detected media types for uploads accepted through “Other File Types,” and apply media-specific limits during remote-upload preflight. (#44677, #41292, #44273)
- Report download HTTP failures instead of passing error pages to the plugin installer. Distinguish Squid-generated denial responses from upstream authentication errors, preserve GitHub import paths containing
blob, and reject incompatible multipart file shapes consistently. (#44333, #44841, #44280, #44903) - The Node.js SDK accepts long knowledge-document text, handles CR/LF/CRLF SSE framing and a leading BOM, and accepts an empty pagination cursor as the first page. (#44679, #44263, #44265)
- The PHP SDK serializes empty app inputs as JSON objects, avoids buffering streaming Workflow and text-to-audio responses, and sends
last_idfor conversation pagination while preserving its public method signature. (#44675, #44271, #44659)
Web app and workspace
- Keep newly created, user-maintained apps visible in Studio and preserve primary navigation across Console routes. Calculate log-period boundaries from the current date. (#44929, #44633, #45360)
- Use navigable links in document menus, open publisher destinations in new tabs, and advance integration-tour steps without reloading the page. (#44694, #44808, #44934, #44944)
- Respect Marketplace availability across template and plugin entry points and render emoji-ID icons in recommended cards. (#45009, #45027, #45066)
- Preserve annotation editor drafts and voice-input focus, and add the Simplified Chinese account-deletion success email template. (#44810, #44825, #45169, #43504)
Environment variables and integration changes
| Setting | Change in 1.19.0 |
|---|---|
OPS_TRACE_QUEUE |
New; defaults to ops_trace_v2. Shared by trace delivery/retries, Agent trace work, payload cleanup, and sandbox metering. API, workers, and Beat must agree. |
OPS_TRACE_EXPORT_MAX_ATTEMPTS |
New; defaults to 6 total attempts for retryable trace exports. |
ENABLE_TRACE_PAYLOAD_SWEEP_TASK |
New; defaults to true, enabling daily cleanup of orphaned new-pipeline trace payloads. |
APP_PACKAGE_MAX_WORKFLOW_TOOLS |
New; defaults to 20 bundled Workflow Tool workflows per App package. |
GUNICORN_KEEP_ALIVE |
New entrypoint setting; defaults to 10 seconds. |
The old OPS_TRACE_UNIFIED_ENABLED, OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES, OPS_TRACE_RETRYABLE_DISPATCH_DELAY_SECONDS, and OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS settings are removed. Existing Agent application-tracing opt-in settings remain supported. (#44673)
For Docker, use envs/core-services/api-worker.defaults as the reference for common API/worker/Beat settings and api-worker.env for new overrides. Existing shared.env remains compatible. Tracked defaults load automatically; root .env and explicit service overrides still take precedence. Review the service-specific references rather than replacing local files with fresh templates. (#45359, #45376)
Endpoint compatibility
- Replace deprecated Console profile-update POST calls to
/account/name,/account/avatar,/account/interface-language,/account/interface-theme, and/account/timezonewithPATCH /console/api/account/profile. Avatar URL reads remain available. (#45015) - Custom clients of
GET /console/api/apps/{app_id}/trace-configmust consumeconfigured_secretsinstead of expecting saved secret values. (#44673) - For Workflow and Chatflow OpenAPI calls, use
POST /openapi/v1/apps/{app_id}/runs/{run_id}:stop(stop.run) andGET /openapi/v1/apps/{app_id}/runs/{run_id}/events(get.run.event). Chat, Agent Chat, and Completion retain the task-ID stop route understop.task. (#44587) - Cloud education verification returns an explicit
status: eligible | not_eligibleresult; only eligible results contain a token. The corresponding internal billing service must support this response contract. (#45165)
Full Changelog: 1.18.0 to the 1.19.0
AI summary Agents route workflows and choose next steps
Dify 1.18.0 brings Agents that route workflows, portable app packages, deeper visibility into nested workflow runs, and the opt-in Agent Knowledge Base experience. OpenAPI and the new difyctl expand how you build and manage apps from the command line.
Important
Read the upgrade guide below before deploying. Upgrade the API, workers, Agent Backend, and Agent runtime images together. Local Agent sandboxes require a non-empty authentication token, and Agent Backend uses a new run protocol. Source installations require Python 3.13. Install the new difyctl client and sign in again. Preserve your existing PASSWORD_PEPPER configuration.
Release highlights
Agents that choose the next step
Let an Agent decide which workflow branch to take. Enable Output Routes, give each route a selection condition, and connect it to the next step—such as resolving a request directly or handing it to a specialist. The read-only switch output exposes the chosen route. (#42599)
Output Routes configuration with two branches in the workflow editor.
Plain Agent v2 nodes also stream text as it is generated. Structured results, routed results, and nodes using default-value error handling remain buffered. (#43986)
Portable apps in one package
Move an app with its supported resources in a single .ifpkg package. Workflow and Chatflow packages carry inline Agents, Skills, and their files; imports recreate those resources in the destination workspace and remap references. File and URL imports support both packages and YAML, and explicit YAML export remains available. (#42066, #42579, #42626, #42863)
Studio's .ifpkg import preview.
See inside nested workflow runs
Open a Workflow Tool invocation from the run history and inspect the child workflow's individual steps. Nested tools now run as child graphs with coordinated pause, resume, stop, and file outputs. Access checks protect the source app's details. (#40277, #42819, #42820, #42821, #42822)
Trace drilldown into a successful Workflow Tool invocation.
Nested usage and step totals can still be approximate, particularly after a pause or stop. Console drilldown and external trace export have different scopes; see the full feature details below.
Agent Knowledge Base · Beta
Create a knowledge space for your agents, add files or connect sources, and inspect document processing, metadata, retrieval traces, and quality evaluations in one place. The new Knowledge Retrieval node and Agent integrations share access-controlled KnowledgeFS spaces. Classic Knowledge remains available. This is an opt-in integration with a separate service and database; see the deployment requirements below. (#44165)
Will soon be available on cloud.dify.ai
Developer spotlight
Build and manage apps with OpenAPI and difyctl. The CLI discovers commands from the server's operation catalog, with searchable help and support for Workflow and Chatflow creation, DSL import/export, settings, environment variables, publishing, and version restoration. Draft hashes protect concurrent edits. (#42487, #42608, #43067)
Install the bundled skill for agents building Dify apps:
difyctl install skills <dir>
The new client requires a fresh sign-in; see the deployment instructions below. (#43819)
Upgrade guide
Compatibility and Rollout
- Back up first. Retain the database, vector-store data, uploaded files, Agent snapshot/workspace storage, and all deployment secrets and env files. Use a maintenance window for a single-stack upgrade.
- Upgrade the Agent components together.
/runsnow accepts composition v2 and rejects v1 requests. Existing session snapshots are converted on read and saved as v2; old runtimes cannot read newly saved v2 snapshots. Direct Agent Backend integrations must update their request format. The old Agent-specific AskHuman tool and deferred resume path are removed: historical Agent forms no longer resume execution, while shared Workflow Human Input nodes remain supported. (#43833) - Retire old workflow consumers before admitting new-version traffic. Let in-flight runs finish, then replace legacy workers/resume consumers so they cannot process the shared queue without the new cancellation guards. Legacy paused task IDs can be recovered from valid saved invocation snapshots within the existing access scope; missing or invalid snapshots require separate recovery. Nested usage totals retain the limitation noted above. (#40277)
- Configure the Local sandbox token before restart. Supply a high-entropy secret through the shared Compose interpolation source. The
1.17.1runtime image does not support the new--require-auth-tokenflag; deploy the matching1.18.0Agent Backend and Local sandbox images. (#44152) - Preserve password hashing configuration. Existing installations without a pepper should leave
PASSWORD_PEPPERempty. Setting a new pepper during the upgrade is not a transparent migration and requires an explicit password-reset plan. Keep any configured pepper unchanged across all instances and restore it with the database. - Review the proxy boundary. Bundled Nginx replaces
X-Forwarded-Forwith its resolved client address, and Compose enables forwarded-header handling. Keep direct API access restricted to trusted callers. If a load balancer or Cloudflare sits before Nginx, configure trusted real-IP handling there; otherwise visitors may share the proxy’s rate-limit bucket. See client IP and trusted proxies. - Enable KnowledgeFS deliberately. Default Compose installations keep it off; local Community Edition development requires the explicit Community development opt-in. Configure its separate database and migrations, Capability v2 public verifier, Dify signing keys, model profile (embedding, reasoning, and rerank), and Workspace cutover gates before enabling traffic. The optional service must pass
/ready, not only/health. Standard Dify API images do not contain the separate KnowledgeFS engine used by the optional engine-worker profile; the published default KnowledgeFS API image is currently amd64 only. Follow the KnowledgeFS deployment and recovery guide.
Deployment instructions · Docker Compose, source, and difyctl
Docker Compose
Once the 1.18.0 release images and tag are published, stop the old stack gracefully, switch to the release, merge the configuration changes above, and pull/start the new stack:
cd dify/docker docker compose stop -t -1 git fetch --tags git checkout 1.18.0 # Merge required configuration changes into existing env files here. docker compose pull docker compose up -d
Keep database migrations enabled (MIGRATION_ENABLED=true) for the API startup, or run them through your managed migration process before starting new workers. The bundled Weaviate update from 1.17.1 is a patch update within 1.39. If coming from a version that still runs Weaviate 1.27, complete the 1.17.1 staged Weaviate upgrade first.
Source Deployments
Use Python 3.13 for the API, Node.js 24.22.1 or later in the 24.x line, and pnpm 12.10.1. Refresh the locked dependencies and apply the database migrations from the repository root:
uv sync --project api --frozen uv run --directory api flask db upgrade pnpm install --frozen-lockfile
Rebuild the web application and restart API, worker, scheduler, and Agent services from the same release. If deploying Agent Backend separately from source, refresh its locked server dependencies as well.
difyctl
Install the matching 1.18.0 client. Its v2 implementation does not reuse v1 login state:
difyctl login --server https://your-dify.example.com
difyctl helpUpdate scripts to the current server-discovered command surface. The old mode-agnostic /openapi/v1/apps/{app_id}:run route is replaced by per-mode operations; use the catalog instead of hard-coded v1 routes. Refresh installed agent skills with difyctl install skills <dir>. (#42487, #42608, #43819)
Existing data that may need recovery
- Published triggers: the draft-sync fix does not repair subscriptions already removed before upgrading. Rebind missing subscriptions and republish affected workflows as needed. (#44068)
- Document extraction: re-import/re-index affected content to apply extraction fixes to existing documents.
- Built-in document metadata: toggling built-in fields rewrites only enabled, non-archived documents whose indexing is complete. Other legacy rows can retain the old format and need a later rewrite when eligible; this release does not include a full backfill. (#44218)
Detailed changes
New features · complete capabilities and availability
Agent Knowledge Base and KnowledgeFS
- Add the Beta knowledge-space experience with local upload preview, connected-source management, document availability and metadata, retrieval history/research, and quality evaluation. Settings control app, Agent, and Service API access. Classic Knowledge remains supported alongside it. (#44165)
- Knowledge Retrieval v2 and Agent knowledge bindings use scoped capabilities; published Explore runs reuse published bindings without requiring ordinary viewers to reconfigure access. (#44165)
- Classic Dataset upgrades have durable checkpoints, availability/metadata reconciliation, retry protection, and recovery through Beat. Run the dedicated upgrade worker with the documented prefork pool and task limits; apply
b9d3f7a5c102before restarting API/workers/Beat. Opting into the service does not automatically migrate all Classic datasets. (#44165)
Portable App Packages
- App exports now default to
.ifpkg, bringing the application configuration and its supported resources into one portable package. Explicit YAML export remains available, and imports accept both formats from files or URLs. (#42066, #42189, #42425, #42552) - Workflow and Chatflow packages include inline Agents, their Skills, and files from each node’s bound configuration snapshot. Imports recreate those Agents in the destination workspace and remap their resources. App icons, Site settings, and node plugin dependencies are included in the export flow. Missing resources are reported during import. (#42579, #42626, #42816, #42863, #42913)
- Agent exports can target a published version. Agent version menus now offer Restore, and pending draft saves finish before restoration so autosave cannot overwrite the restored configuration. Skill duplication and export use the latest saved draft content. (#42485, #42567, #42424, #42502)
Nested Workflow Tools and Trace Drilldown
- Called Workflow Tools run as child graphs under the workflow engine, with coordinated pause, resume, stop, and file outputs. Source graphs are captured before execution, so republishing a tool does not change an in-flight run, including calls inside loops and iterations. (#40277, #42820)
- Workflow, Chatflow, and history views can open a particular tool invocation and navigate its internal execution traces. Access to each source application is required before its details are returned. Human Input forms are tracked by execution identity, including repeated invocations of the same node. (#42819, #42821, #42822)
- Nested Agent logs and usage records retain their source workflow identity and their relationship to the outer run. Nested usage and step totals can still be approximate, particularly after pauses or stops. (#42824, #42820)
Agent Output Routes and Streaming
- Agent v2 nodes can select a workflow branch as part of completing their task. Enable Output Routes, define at least two branches and their selection conditions, and use the read-only
switchoutput to inspect the chosen route. With routing disabled, the normal success outlet remains available. Routed nodes support stopping on error or taking a failure branch; node-level default-value handling is unavailable with routes enabled. (#42599) - Plain Agent v2 nodes stream text as it is generated. Structured or routed results remain buffered, and nodes using default-value error handling stay buffered so the configured fallback can still replace a failed result. (#43986)
Build and Manage Apps with OpenAPI and difyctl
/openapi/v1publishes a server operation catalog. difyctl discovers commands and their input fields from that catalog, provides searchable help, and follows server-provided next steps. Workflow and Chatflow authoring now covers app creation, DSL import/export, settings, environment variables, publishing, and version restoration. Draft hashes protect imports from overwriting concurrent edits. (#42487, #42608, #43067)- The CLI includes a
difyctlskill for agents building Dify apps. Install it withdifyctl install skills <dir>. Device login supports--no-waitand--resume, and folder uploads send one multipart part per file. (#43819, #44356) - Workspace owners can create resource access tokens bound to selected apps or knowledge bases. Tokens work with the supported Service API routes and app operations in difyctl; they do not grant workspace administration. The Settings entry is opt-in through
NEXT_PUBLIC_ENABLE_ACCESS_TOKEN, which defaults tofalse. (#42293, #44422)
Edit Agent Prompts from the Sandbox
dify-agent config prompt pull [--to PATH]andpush [PATH|-]read or replace the raw system prompt, preserving UTF-8, whitespace, and mention markers. Empty text clears it. Only the current account’s writable build draft can be changed; later requests use the saved prompt. (#44561)
Agent Execution Tracing
- Agent apps and Workflow Agent v2 nodes can export their Agent, model, and tool execution trees through the existing tracing providers. Monitoring adds shared tracing configuration, delivery status, retry controls, and links to the trace belonging to the selected execution. Agents referenced by a Workflow inherit the caller’s tracing policy. (#44144, #44186)
- Application tracing is opt-in on both the API and Agent Backend. A separate deployment-wide OTLP trajectory exporter is also available, independently of system tracing. (#42651, #44144)
- Called Workflow Tools’ internal nodes are excluded from external exports because those exports have no viewer identity for source-app access checks. Agents inside those called tools are also excluded from the new execution-tree export for now; authorized Console drilldown remains available. (#42823, #44144)
OpenShell Sandbox Backend and E2B Usage Collection
- Agent execution can use a self-hosted NVIDIA OpenShell gateway with
DIFY_AGENT_RUNTIME_BACKEND=openshell. Each Binding has its own sandbox, with authenticated shell access, Home Snapshots on an operator-managed shared volume, and an optional egress allowlist. OpenShell gateway 0.0.106 or newer and a compatible runtime image are required. (#41076) - OpenShell lease release closes the connection but leaves the sandbox running. There is no automatic idle-stop or sandbox TTL; operators must manage those resources. Multi-tenant deployments require separate OpenShell workspaces and snapshot volumes per tenant. See the OpenShell deployment guide.
- Optional E2B usage collection records provider execution duration and resource sizes through Celery Beat and the
ops_tracequeue. Collection starts from a configured activation time and does not backfill earlier executions. Both the API and Agent Backend metering flags default to off. (#42554)
Cloud Access Controls, Templates, and Archive Management
- Reusable network access groups let supported Cloud deployments share IP rules across apps, with permission checks, effective-policy status, and trusted client-IP previews. Enforcement depends on the Cloud policy service and Gateway; this is not a standalone Community Edition firewall. (#41025, #44464)
- Cloud users can preview and try published Agent templates before importing them. Agent “Create from Template” is hidden in Community and Enterprise editions because its template data source is Cloud-only. (#42837, #44035)
- In Cloud Workflow Log Archives, workspace owners can permanently delete a selected month, with confirmation, progress, and retry. The action removes archived objects and prepared ZIP downloads; live workflow-run records are outside its scope. Failed deletion jobs now enter the retry policy instead of reporting success. (#44052, #44061, #44203)
Improvements · performance, navigation, accessibility, and operations
- Knowledge performance: dataset lists and indexing status use batched queries; segment imports avoid repeated position queries; retrieval and result post-processing reduce repeated lookups. (#42279, #42191, #42233, #42673, #43665)
- Faster loading: translations load by feature, workflow configuration panels load on demand, and chart, music, and SVG previews defer heavier work. Chat history no longer loads saved prompts that are not needed for display. (#42812, #42873, #42874, #42877, #42970, #42840, #42951, #44521)
- Navigation and accessibility: improved command discovery, keyboard navigation, focus return, dialog labels, and responsive layouts across Studio, workflow editing, Knowledge, Agent configuration, and workspace settings. Studio filters survive navigation, timezones are searchable, and workflow image export has a dedicated toolbar action. (#43133, #44330, #44429, #43944, #43662, #44220, #44378, #44492, #44535, #44539, #44548, #44564)
- Floating controls: menus, selectors, popovers, and tooltips now use Base UI positioning directly, with migrated alignment and offset settings throughout the console. (#44588)
- Date, time, and icons: redesigned date/time pickers, native scrolling for time options, and an updated icon picker with image cropping and self-hosted emoji assets. (#43090, #43723, #43007, #42469)
- Localization: Azerbaijani (
az-AZ) joins the supported UI languages, with additional translation and right-to-left layout improvements. (#42291, #43808) - Developer tooling: faster TypeScript checks through tsrs, plus typed Document and CustomizedSnippet models that preserve existing constructors and database defaults. (#44562, #36084, #40818)
- Operations: archive storage supports configurable S3 addressing style; the API image includes its spaCy model so startup does not need to download it; workflow generation logs identify tools omitted from the bounded fallback catalog. (#43066, #43601, #42596)
Security enhancements
- Local sandbox authentication and isolation: enabled Local runtimes reject blank authentication tokens. When path isolation is enabled, a Landlock setup failure aborts the job with exit code
125before executing user code. (#44152) - Password hashing and plugin permissions: optional
PASSWORD_PEPPERadds a server-side secret to account password hashes. Plugin installation defaults to workspace owners and administrators when no explicit policy is stored; existing saved policies remain in effect. Setting, changing, or removing the pepper invalidates existing password hashes. See the upgrade guidance. (ed772cfcf7) - Access boundaries: exact CSRF whitelist matching, stronger dataset operation permissions, workspace-bound tracing service accounts, and protected owner/admin role handling. Re-inviting a removed member restores access without allowing the invitation to be reused after a later removal. (#42118, #42758, #44208, #43118, #43311, #43667)
- Knowledge sharing defaults: in RBAC-enabled deployments, new knowledge bases no longer automatically include every workspace member. (#42430)
- Error and plugin handling: API and webhook failures return fixed public messages instead of internal exception text, and plugin daemon requests use pinned package identifiers. (#43049, #44395, #44396)
- Dependency updates: bundled Weaviate moves from
1.39.2to1.39.13, alongside Next.js and other dependency security updates. The Weaviate change stays within the 1.39 series; the staged minor-version migration described for 1.17.1 still matters when upgrading from older installations. (#44508, #44127, #44148, #44524) - The standalone Agent certifi bundle is updated to
2026.10.19; rebuild Agent images to consume the updated trust bundle. (#44462) - NLTK: NLTK is updated to 3.10.4 for upstream path-handling hardening; this change alone is not a claim that every advisory is resolved. (#44581)
Bug fixes · workflows, Agents, Knowledge, APIs, and the web app
Workflow and Scheduling
- Preserve LLM prompt/model changes during collaboration and synchronize imported graphs correctly. Code generation retains input bindings for surviving parameter names, understands multiline/destructured signatures and Python parameters containing commas, and preserves literal
{{inputs}}text in user code. (#42124, #42817, #44075, #44046, #44337, #43438) - Remove unsupported Chatflow memory settings when pasting into a Workflow and when loading/saving Workflow graphs in the editor. Existing published versions or API-only flows are not rewritten by this editor fix. (#43597, #43752)
- Preserve configured fallback values when Code node outputs are removed, added, or renamed; require confirmation before saving an empty canvas; and retain in-run tool-file access for later nodes. (#42678, #43668, #41300)
- Persist task ownership and stop intent so late writes or a concurrent resume cannot revive a stopped workflow. Failed asynchronous trigger dispatches are recorded as failed in trigger logs, and elapsed time remains consistent across resumptions. (#40277, #43009, #44161)
- Scheduled fire-and-forget dispatch no longer creates a Redis result-backend drainer for every task group, preventing accumulating idle result connections. The same correction covers trigger refresh and pipeline dispatch. (#44551)
- Editing a draft no longer removes published trigger subscriptions. This prevents new damage but does not rebuild relationships already lost before the upgrade. (#44068)
- Save the timezone shown on new schedule nodes, handle daylight-saving transitions in next-run calculation and offset labels, and correct hourly previews at month boundaries. (#43532, #43357, #43627, #43925)
Agents and Skills
- Conversations can continue after cancelled tool calls; replayed tool-call IDs remain stable; parallel tool results stay attached to their own thoughts; and initial event-write failures finalize runs instead of leaving them running. Redis event replay also works with Redis 6. (#41846, #43796, #43843, #43959, #44420)
- E2B uses SDK 2.55.1 with safer retry behavior: resource creation is not replayed after an ambiguous 502, while safe lifecycle operations retain transient-failure recovery. Pauses and Home Snapshots explicitly request full-memory mode. (#43930)
- E2B sandbox acquisition checks that Home and Workspace resources exist, and confirmed-missing Enterprise Home Snapshots count as successful deletion. (#44014, #44085)
- Skill attachments preserve formatted DOCX text, RTF Unicode fallback lengths and binary boundaries, and PPTX presentation order. (#43718, #43789, #43893)
- RTF extraction also combines UTF-16 surrogate pairs before truncation and replaces unmatched surrogates, avoiding UTF-8 encoding failures. (#44565)
Knowledge and Retrieval
- Preserve CSV cell content, Notion mentions/equations, and newlines in recursive splitting. URL imports infer useful file extensions from content type, and unsupported pipeline file types return an explicit error. Re-import affected documents to regenerate content already indexed incorrectly. (#42159, #42171, #44179, #42364, #44012)
- Message citations retain document metadata. Built-in document dates use consistent UTC epoch values while preserving fractional seconds; existing mixed-format metadata is not automatically rewritten. (#41861, #44218)
- Re-enabling segments restores their vectors and refuses segments that have not completed indexing. Hybrid Search retains the reranking setting when saved from either dataset settings or app configuration. (#43865, #44017, #42563)
- Dataset deletion uses bounded cleanup steps with retry-safe progress. Qdrant balances results across keywords, TiDB-on-Qdrant filtering is corrected, Vastbase supports its graph index/BM25 paths, and OceanBase memory-limit discovery no longer depends on row order. (#38519, #44352, #44339, #42922, #42846)
APIs, MCP, and SDKs
- List endpoints calculate
has_morefrom the page size actually served, and message pagination preserves records with tied timestamps. MySQL-specific datasource credential and installed-app ordering issues are corrected. (#41876, #42323, #42531, #44023, #44039, #44029) - MCP discovery follows all tool pages with bounded requests, mixed-type parameters preserve list values, failed SSE connections close before HTTP fallback, and unsupported methods return protocol errors. MCP protocol support includes
2025-11-25. (#43842, #44182, #42761, #44197, #44066) - The Node.js SDK handles workflow text chunks and message replacement, propagates streamed API errors, preserves SSE whitespace, and replaces headers case-insensitively. Write requests avoid automatic replay, and reused upload forms retain the explicitly supplied user. (#44177, #44199, #44083, #44090, #43079, #44120)
- difyctl preserves existing files if Windows replacement fails, surfaces SSE read failures, serializes token/config updates, and accepts BOM-prefixed JSON inputs. The PHP client uses the correct conversation rename endpoint and preserves custom API base-path prefixes with or without a trailing slash. (#43974, #43943, #44329, #44375, #44386, #43075, #44569)
Web App and Workspace
- Numeric zero and JSON object inputs keep their intended values. Browser-autofilled login credentials submit correctly, SSO failures are surfaced, and logout clears session state. (#43243, #42431, #44474, #43076, #43055)
- Log annotations apply to the displayed regenerated answer. Feedback drafts remain available when submission fails, and attachment previews keep their resources for the lifetime of the dialog. (#43238, #43520, #43521)
- Existing knowledge-base Add file pages retain their Knowledge sidebar in both standard and pipeline flows. (#44552)
- Knowledge metadata panels remain scrollable without covering their controls, dataset tag actions do not open the card, and Marketplace details open correctly for self-hosted editions. (#43621, #42269, #42576)
- Email normalization expands to Microsoft, Apple, and Proton addresses while retaining original stored email addresses; case-fallback account lookup works in both directions. (#42112, #42541)
Environment variables · required changes, optional settings, and removals
Required or Changed Behavior
| Setting | Change in 1.18.0 |
|---|---|
DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN |
Required and nonblank for an enabled Local runtime. For Compose, set it in docker/.env, the invoking shell, or --env-file so Agent Backend and shellctl receive the same secret. Setting it only in a service env file is insufficient. |
SHELLCTL_ENABLE_PATH_ISOLATION |
When enabled, Landlock errors stop execution instead of allowing the script to continue. |
PASSWORD_PEPPER |
New, empty by default. Leave it empty on an existing unpeppered installation to preserve logins. For deployments that use it, keep the same secret across API/worker instances and retain it with backups. In Compose, keep it in docker/envs/core-services/api.env so unrelated services do not receive it. |
GRAPH_ENGINE_MAX_WORKERS |
Now the fixed worker count per engine instance; default 10. The old minimum-worker and autoscaling thresholds are removed. |
RESPECT_XFORWARD_HEADERS_ENABLED |
Standalone API default remains false; bundled Compose explicitly enables it for API/WebSocket services behind Nginx. Settings supplied only through shared.env are overridden. Move an intentional override to docker/.env, the invoking shell, or a Compose override. |
OAUTH_TTL_DAYS |
Now read through application settings at startup, including api/.env. Default remains 14, with the existing 1–365 day bounds. |
New Optional Settings
| Area | Settings and defaults |
|---|---|
| Application Agent tracing | API: OPS_AGENT_TRACE_ENABLED=false. Agent Backend: DIFY_AGENT_APPLICATION_TRACING_ENABLED=false. Application policy and provider configuration are also required. ENABLE_APPLICATION_TRACE_RECONCILE_TASK=true controls scheduled reconciliation. |
| Deployment-wide trajectories | DIFY_AGENT_TRAJECTORY_ENABLED=false, DIFY_AGENT_TRAJECTORY_OTLP_TRACES_ENDPOINT, DIFY_AGENT_TRAJECTORY_OTLP_HEADERS, and DIFY_AGENT_TRAJECTORY_SERVICE_NAME; content capture defaults to off and trace context defaults to isolated. |
| E2B usage | API: AGENT_SANDBOX_METERING_ENABLED=false, AGENT_SANDBOX_METERING_PROJECT_ID, AGENT_SANDBOX_METERING_START_AT, AGENT_SANDBOX_METERING_INTERVAL_SECONDS=60. Backend: DIFY_AGENT_SANDBOX_METERING_ENABLED=false, DIFY_AGENT_E2B_PROJECT_ID, plus overlap/full-scan/page limits. |
| OpenShell | Select DIFY_AGENT_RUNTIME_BACKEND=openshell; configure the DIFY_AGENT_OPENSHELL_* gateway, credentials, image, driver/shared-volume, shell token, and optional egress settings in the Agent service env file. |
| Package bounds | SKILL_PACKAGE_MAX_UNCOMPRESSED_BYTES=209715200, SKILL_PACKAGE_MAX_ENTRIES=5000, SKILL_PACKAGE_MAX_SKILL_MD_BYTES=1048576; AGENT_PACKAGE_MAX_BYTES=536870912, AGENT_PACKAGE_MAX_MANIFEST_BYTES=5242880, AGENT_PACKAGE_MAX_ENTRIES=5000. Ordinary app packages retain the 10 MiB DSL limit. |
| KnowledgeFS | KNOWLEDGE_FS_ENABLED=false by default; configure KNOWLEDGE_FS_BASE_URL, Capability v2 signing/verification, and the lifecycle/cutover rollout gates through the dedicated API and KnowledgeFS service env files. KNOWLEDGE_FS_TIMEOUT_SECONDS=10. Do not enable traffic until the separate service is ready. |
| Access-token UI | NEXT_PUBLIC_ENABLE_ACCESS_TOKEN=false controls the owner-only Settings entry. |
| Archive storage | ARCHIVE_STORAGE_ADDRESS_STYLE=path supports path, virtual, and auto addressing for S3-compatible archive storage. |
| Cloud network policies | NETWORK_ACCESS_API_URL, NETWORK_ACCESS_TRUSTED_PROXY_CIDRS, WEBAPP_ACCESS_PREFLIGHT_URL, and WEBAPP_ACCESS_PREFLIGHT_PROXY_SECRET; require the corresponding trusted ingress and Cloud Gateway integration. The preflight secret is server-only. |
Removed Settings and Features
GRAPH_ENGINE_MIN_WORKERS,GRAPH_ENGINE_SCALE_UP_THRESHOLD, andGRAPH_ENGINE_SCALE_DOWN_IDLE_TIMEare no longer used.- The older KnowledgeFS implementation removed in #44163 is superseded by #44165. Do not reuse its
KNOWLEDGE_FS_JWT_SECRETor SSE timeout configuration; the new integration uses Capability v2 signing and public verification material.KNOWLEDGE_FS_ENABLED,KNOWLEDGE_FS_BASE_URL, andKNOWLEDGE_FS_TIMEOUT_SECONDSremain supported by the new configuration. - The Console feedback export endpoint,
GET /console/api/apps/{app_id}/feedbacks/export, is removed. Update integrations that called it directly. (#43751) UV_CACHE_DIRno longer has a baked-in shared default. Keep any deliberate plugin-daemon cache override explicit. (#42481)
Optional/provider-specific settings are documented in the matching files under docker/envs. Preserve existing service env files when upgrading.
Database migrations
Upgrading from 1.17.1 applies 22 schema/data migration revisions and two migration-head merges, ending at b9d3f7a5c102:
| Revision | Purpose |
|---|---|
d8e4a6b1c902 |
Backfill normalized email values for the additional providers without merging accounts or changing their original addresses. |
e7b2a9c4d601 |
Add Agent sandbox usage events and execution accounting. |
a8c9e2f1b704 |
Add resource access tokens and resource bindings. |
f1d3c5b7a902 |
Add workflow archive deletion status. |
c6f4a90d8b31 |
Add nullable workflow task IDs, stop intent, and the task-ID index. |
a8c3e7f4b912 |
Add immediate caller workflow/node identifiers to nested node execution records. |
a17c2980f3e6 |
Add durable application trace runs, invocations, and delivery batches. |
f7e2c9a6d481, d6b9e2f1a407 |
Merge migration branches; no additional schema changes. |
a4e7c2f91b30 |
Add independent KnowledgeFS control-plane tables. |
b7f2a9d41c60 |
Add KnowledgeFS workspace cutover ledger and migration evidence. |
c8e31b7d52a4 |
Add guarded cleanup, cutover evidence, and capability issuance reservations. |
d4f6e8a1c305 |
Add durable KnowledgeFS remote freeze evidence. |
e5a7c9b2d416 |
Add global KnowledgeFS cleanup completion evidence. |
7c1e9a4b2d60 |
Add KnowledgeFS workspace staged uploads. |
9d4e6f8a1b2c |
Add KnowledgeFS space tag bindings. |
4f8b2c7d9e10 |
Add KnowledgeFS icon background. |
f3a8c1d7e920 |
Add KnowledgeFS legacy Dataset upgrade jobs. |
e6b4a2c9d731 |
Limit active KnowledgeFS legacy Dataset upgrades. |
9a4e7d1c2b60 |
Add resource_type to dataset_api_token_bindings. |
b6e2c4d8f1a0 |
Allow namespace capability audits before a KnowledgeFS control space exists. |
3edd6cd27f54 |
Limit active KnowledgeFS legacy Dataset upgrades on MySQL. |
a8c2e6f4b901 |
Track KnowledgeFS upgrade document availability independently of metadata. |
b9d3f7a5c102 |
Persist delivery and execution leases for upgrade document reconciliation. |
The PostgreSQL task-ID index is created concurrently, but still scans workflow_runs and consumes I/O; adding the columns requires a brief schema lock. Existing task IDs need no global backfill. Apply the complete migration chain before starting the new workers. KnowledgeFS has a separate engine database and migration process. A downgrade that would leave KnowledgeFS-only API keys unrestricted is blocked until those keys are revoked through the API; keep backups for rollback.
Full Changelog: 1.17.1...1.18.0
Warning
Self-hosted deployments using the bundled Weaviate must complete a manual, staged upgrade before starting 1.17.1. The bundled Weaviate server moves from 1.27.0 to 1.39.2 — 12 minor versions — and skipping minors is unsupported. Pulling and restarting can silently and permanently break vector search. See Upgrade Guide below. Fresh deployments, external Weaviate, and other vector stores are unaffected.
New Features
Dataset-Scoped Knowledge Base API Keys
- Knowledge base service-API keys were scoped to the whole workspace: one key could read and write every knowledge base in the tenant, so giving an integration access to a single knowledge base meant giving it access to all of them. Keys can now be bound to specific knowledge bases from the knowledge base's API access panel, with a workspace / this-knowledge-base scope selector at creation time. A bound key returns
403for any other dataset — both documents and retrieval — and for endpoints that carry no dataset ID, such as list-all. Existing keys are unbound and keep their workspace-wide behavior, so nothing changes when you upgrade. (#37569)
Keyboard Movement for Workflow Nodes and Comments
- The workflow canvas required a mouse to reposition anything. Nodes, multi-node selections, comment markers, and draft comments can now be moved with the arrow keys — hold Shift for larger steps — including Note, Iteration, and Loop nodes. Continuous movement is committed on key release or blur, so it produces one undo entry rather than one per keypress, and read-only mode, container boundaries, and collaboration updates are all still respected. (#41967)
Marketplace Creator Profiles and Homepage Redesign
- Plugin authors now have public profile pages at
/marketplace/creator/<handle>, listing their creations with a publisher sidebar, reachable from a new Creator Center entry in the sidebar help menu. The marketplace homepage was rebuilt around a hero, a banner carousel, sticky search, catalog tabs, and tag/language filters, with a stacked-and-swipeable mobile layout. Bundles are no longer mixed into plugin categories. (#41538)
Configurable Markdown Form Field Name Length
- The Markdown form field-name limit was hard-coded at 128 characters, with no way to accommodate longer generated field names. It is now configurable through
MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH(Docker) orNEXT_PUBLIC_MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH(direct Web deployments), defaulting to the previous 128. Character validation and prototype-pollution protections are unchanged. (#41697)
Bug Fixes
Knowledge Base
This release fixes a cluster of extraction bugs that changed document content without reporting an error. Re-import affected documents after upgrading; indexed text is not retroactively repaired.
- CSV cells were passed through pandas type inference before indexing. Leading-zero codes became floats (
00123→123.0), empty cells became the literal stringnan, and cells containingNAorNULLbecame missing values. The extractor now reads everything as text and disables missing-value inference; an explicitcsv_argsstill overrides this for callers that want typed parsing. (#41922) - Notion table rows lost or gained columns. Each rich-text segment inside a cell was emitted as its own Markdown column, so any cell with mixed formatting — bold, links, mentions — produced extra columns and corrupted the table, while an empty cell was skipped entirely and shifted the rest of the row left. Cells are now emitted one-per-column with their segments concatenated. (#41993)
- Notion database properties were truncated at the first formatting change.
rich_textandtitleproperties read only their first segment, so a title ofHello worldwithworldin bold was indexed as justHello. All segments are now joined. (#42050) .xlscells containing double quotes corrupted the row. The extractor emits"column":"value"pairs; the.xlsxpath escaped embedded quotes but the legacy.xlspath interpolated them raw, sohe said "hi"became"note":"he said "hi"". Both engines now behave the same for the same content. (#42049)- Any PDF loaded from a URL crashed with a bare
AssertionError. After tenant context was added to the PDF extractor, the code path used byload_from_url— including the built-in web scraper whenever a target returnsContent-Type: application/pdf— asserted on an upload record that URL loads never have. Tenant context is now optional, image extraction is skipped when it is absent, and text extraction works again. (#41950) - The built-in web scraper returned Python data structures instead of page text.
readabilipyhands backplain_textas a list of dicts, which was interpolated straight into the output template, so every scraped page came back as[{'text': '<p>…</p>'}, …]— dict syntax, quotes, and HTML tags included. The items are now flattened into readable text. (#41954) - Partial segment updates wiped attachments. A segment update that omitted
attachment_idswas treated as "replace with nothing", deleting the segment's attachment bindings and multimodal vectors. Attachments are now left alone unlessattachment_idsis explicitly provided; passing[]still clears them. (#41777) - Documents with invalid Markdown image links could stall the indexing queue. Relative, protocol-relative,
data:,ftp:, and malformed image targets were all handed to the remote image fetcher and entered its SSRF retry loop, so a single document with many bad references could hold an indexing worker long enough to back up everything behind it. Non-fetchable targets are now validated and skipped. (#41343) - Deleting content left orphaned files in object storage. Segment deletion, multimodal re-indexing, and batch document deletion each removed the database rows but left the physical attachment objects behind. All three paths now delete the underlying objects after the database commit, with an orphan check so attachments shared by other segments survive. (#41400, #41999, #41256)
- Text file previews were misreported as binary. When the preview byte limit cut through a multi-byte UTF-8 character, strict decoding failed and the whole file was classified as binary — reproducible on a default preview with a single non-ASCII character at the 256 KiB boundary. Previews now keep the longest complete UTF-8 prefix; files with genuinely invalid encoding are still reported as binary. (#41761)
Model Providers
- Upgrades from pre-1.15 no longer leave models unusable, and no longer need a manual command. Installations older than 1.15 still carry legacy model type values (
text-generation,embeddings,reranking) in their provider tables, which makes model-related API requests fail and prevents affected models from loading. Both 1.16.1 and 1.17.0 shipped this as a separateflask data-migrate legacy-model-typesstep that had to be run by hand. It now runs as part offlask db upgrade: legacy values are canonicalized tollm/text-embedding/rerank, legacy-versus-canonical row collisions are resolved deterministically while preserving credential references, and the provider cache namespace is rotated so stale cached credentials cannot shadow the migrated rows. (#41326, fixes #41294) - The built-in file upload data source asked for authorization it does not need. When creating a RAG Pipeline knowledge base, local file upload showed "Please authorize first" and the creation checklist flagged it, because providers that declare no credentials schema never have a stored-credential row and were therefore always reported as unauthorized. Credential-free providers are now marked authorized directly. (#39772)
- Provider-scoped credential validation rules are now applied, and missing tool credentials are surfaced instead of failing opaquely. (#41659, #41726)
Workflow & Triggers
- Human Input forms could finish a workflow while leaving it looking stuck. Since the HITL callback migration in 1.17.0, submitting a form left its approval buttons on screen and the published Web App input blocked, because the engine emitted a generic node-success event without the form-filled or timeout events the response pipeline expects. Those events are now reconstructed, preserving submitted file values, original timeout deadlines, and execution metadata. (#42082)
- Human Input could not be placed inside Iteration or Loop nodes, even though 1.17.0 shipped the runtime support for it — two stale editor guards still blocked selecting, connecting, and pasting the node inside a container. (#40061)
- The Human Input timeout edge could fire the wrong branch. The editor writes the timeout edge as
__timeout, but the backend compared against__timeout__, so at runtime a timeout could take a user-action branch instead of the timeout branch the author drew. (#40746) - A second Human Input pause in the same run could become unresumable. If object storage rejected deleting the previous pause snapshot, the exception aborted the transaction — the run was already persisted as
PAUSED, but its only pause row was the previous, already-resumed one, so the next submission failed withCannot resume an already resumed pause. Snapshot cleanup is now best-effort, with the orphaned object key logged for later cleanup, so the run's durable state stays correct. (#41581) - Workflow-as-Tool only exposed the first End node's outputs. Output declarations are now collected from every End node, with the source node listed for each, one warning per output affected by a duplicate or reserved name, and a fallback to the published schema when live draft metadata is unavailable. (#41517)
- Loop Boolean break conditions never matched. New conditions stored
"true"/"false"as strings rather than booleans. Values are now stored and kept as real booleans, and legacy string values are normalized when rendered. (#41186) - Trigger-entry workflows could still be invoked manually from the Web App, Service API, OpenAPI, and MCP
tools/call— creating workflow runs that could never work. These are now rejected before a run or log is created, with a shared business code across HTTP and MCP JSON-RPC. Real trigger execution, read-only endpoints, and running a historical Start version by ID are unaffected. (#41519) - A single bad LLM node took down the whole editor. A workflow whose LLM node had
model_selectorpersisted asnullrather than omitted crashed Workflow Studio's per-node checklist on load and tripped the page-level error boundary, making the entire canvas unusable rather than flagging one node. (#41707) - Workflows containing legacy Agent nodes could not be published once Agent V2 was enabled, because publish validation could not resolve the legacy validator. They publish again, while legacy Agent nodes stay hidden from the node picker. (#41368)
- Creating a tool from a workflow used the previously published version. The current workflow is now published first — matching what the update path already did — and provider creation stops if that publish fails, instead of silently binding to a stale version. (#41528)
- Undoing the deletion of a webhook trigger node changed its URL. (#42069)
- Document create and update could report "One or more files not found." on MySQL even though the upload had committed. Under MySQL's default
REPEATABLE READ, the request session's read snapshot was pinned before the upload happened in a separate session, so the just-written rows were invisible. All four affected endpoints — create-by-text, create-by-file, update-by-text, update-by-file — now refresh the snapshot before the lookup. PostgreSQL was never affected. (#41840) - Large workflow graphs broke the collaboration socket.
sync_requestpayloads exceeded Engine.IO's 1 MiB default, so the frame was rejected and the editor reconnect-looped. The ceiling is now configurable throughWEBSOCKET_MAX_HTTP_BUFFER_SIZE, default 10 MiB. (#41347) - The Access Point page no longer shows "no published version" guidance when the published-workflow request simply failed, and no longer retries requests that returned
403. (#41572)
Agent & Chat
- Chatflow Agent V2 forgot everything between turns. Sessions are now keyed by
conversation_id, so memory persists across a conversation. A follow-up fixed the related case where publishing a new Agent roster version mid-conversation paired a new configuration with the previous participant and failed generation validation — existing conversations now stay pinned to the version they started on, and only new conversations pick up the current one. (#41871, #42105) - Replies from reasoning models rendered entirely as "thinking". Models such as GLM-5.3 wrap chain-of-thought in
<think>tags, and a tool call frequently interrupts generation before</think>is emitted, leaving the answer nested inside a still-open tag. The dangling tag is now closed when a tool log interrupts the stream, when a new<think>starts after real content, and at stream end — plus the same repair in the Markdown preprocessor so already-stored output renders correctly. (#41764) - Images uploaded to an Agent App were turned into shell download instructions rather than being shown to the model. Vision-capable models now receive them as native multimodal content, detected from the selected credential-bound model schema. The download fallback is preserved for non-image files and for models without vision support, and image URLs and Base64 payloads are redacted from agent backend logs. (#41685)
- Suggested questions could take minutes, or hang. With no dedicated suggested-question model configured, the endpoint fell back to the workspace default — inheriting expensive settings such as
reasoning_effort=high, a 2,560-token output allowance, and the global 600-second plugin timeout, so the browser gave up after 100 seconds while the backend kept working. Output is now capped at 256 tokens, thinking is disabled or set to the lowest supported effort, and a request-scoped 30-second timeout applies. One reported case went from 113–344 seconds to under 3 seconds; an unavailable default model now returns an empty list immediately instead of failing. (#41705) - E2B-backed agent runs failed with
502 binding_create_failed. A stale HTTP/2 connection in the pinned E2B SDK surfaced as an inline chat failure. The SDK is upgraded past the affected transport path, connect/pause/kill/delete-snapshot are retried once on bounded transport failures, and provider capacity exhaustion now returns a429instead of being reported as a create failure. Binding and snapshot creation stay one-shot, so ambiguous results are never silently adopted. (#41623) - Agent Preview reused a session that no longer matched the configuration. Because Preview edits the draft in place, a conversation could keep a session snapshot whose composition layers had since been added, removed, or reordered, and the agent backend rejected it with an internal mismatch error. This now returns
409 agent_session_configuration_changedwith an instruction to start a new conversation; changing configuration values without changing the layer topology still reuses the session. (#41447)
Service API & OpenAPI
- Pagination silently truncated results.
has_morewas computed against the client-requestedlimitwhile the query capped page size at 100, so requestinglimit=200against 150 rows returned 100 rows andhas_more=false— the remaining 50 were unreachable. Segment, dataset, and document list endpoints now computehas_morefrom the effective page size and report that size in the response. (#41776, #41784) - Deleting an MCP provider returned
422. Request parsing had started reading only query arguments onDELETE, while the web client sendsprovider_idin the JSON body; custom-model and credential deletion shared the same contract. The JSON body is now used as a fallback when the query string is empty, so query-parameter deletes keep working too. (#41288) - A standard OpenAPI schema was rejected as
invalid schema: 'env'whenever theX-Request-Envheader was present, because server matching indexed a non-standardenvkey unconditionally. Schemas without the extension now take the intended fallback to the first server URL. (#42025) - The generated Service API contract was realigned with runtime behavior: non-nullable fields no longer carry null defaults, Console-only permission metadata is excluded, error responses the endpoints never return are removed, historical 404/503 declarations are restored, and task-stop request schemas are split so chat/completion and workflow behavior are documented accurately. This changes the exported contract and generated clients, not request handling. (#41248, #41274, #41943)
- Service API rate limit descriptions were corrected. (#41975)
Concurrency & Deadlocks
- Concurrent knowledge retrieval could deadlock. The hit-count update incremented every matched segment in one
UPDATE … WHERE id IN (…), and PostgreSQL gives no guarantee that row locks are taken in the order the IDs were supplied — overlapping concurrent retrievals could acquire locks in different orders and fail withdeadlock_detected. Locks are now taken in a stableORDER BY idbefore incrementing, with up to three retries scoped strictly to deadlock errors. (#41979) - Automatic summary generation could hang a worker indefinitely. Tencent VectorDB rejects booleans in JSON metadata, so the
is_summary: truemarker failed at upsert after summary generation and embedding had already succeeded. The failure path then opened a second database session to record the error on the same row the caller's session still held locked, so each waited on the other and the task occupied a worker slot. The marker is now an integer for Tencent only, and errors are recorded in the caller-owned session. (#41916)
Skills, Plugins & Triggers
- Skill packages built on Windows failed with a misleading error. A
SKILL.mdusing CRLF line endings did not match the frontmatter parser, so the name field came back empty and the import reportedconfig asset name must not be blank. CRLF is now accepted and normalized on import, and__MACOSXmetadata folders in skill archives are tolerated. (#41657, #41757) - Triggers worked in Test Run but never fired in production. Plugin trigger relationships were synchronized from the draft workflow rather than the version being published, so published events found no subscriber and no workflow started. (#41756)
- Lease-based triggers stopped working after about a week. Subscription creation persisted the builder's placeholder
expires_atof-1instead of the real lease returned by the provider, and the refresh scanner skips-1— so providers like Gmailusers.watchsilently expired. The provider-supplied expiry is now stored. (#41773) - Swagger tool authorization survives a page refresh, and SSR now appends
/api/v1when readingMARKETPLACE_API_URL. (#41656, #41824)
Workspace, Accounts & Imports
- Gmail addresses that differ only by dots or a
+aliasregistered as separate accounts. Registration now stores and checks a normalized email — dots stripped,+aliasremoved,googlemail.comfolded togmail.com— across self-registration, OAuth registration, email-code account creation, CLI registration, and new workspace-invite accounts, with a dedicatednormalized_email_already_in_useerror. Existing login and account-update lookups are deliberately unchanged, and existing equivalent accounts are preserved. (#41249) - Transferring workspace ownership left the workspace inconsistent. The outgoing owner was demoted to admin rather than a restricted member, and the stored owner column was not always updated — so checks that read it, including the guard on the transfer endpoint itself, kept resolving the previous owner. Both now move correctly, and a workspace already left inconsistent by an earlier transfer is repaired on the next one, with no migration required. (#41267)
- A quota of zero was displayed as unlimited. Trigger Events and API rate limit now show zero as exhausted rather than unlimited, zero-count quotas appear in the exhausted-quota dialog, and
-1continues to mean unlimited. Annotation batch imports are allowed when the annotation limit is0(unlimited), while positive limits still reject imports that would exceed them. (#41927) - DSL imports showed the wrong warning. Backend-provided warning details — notably tool-authorization warnings raised while creating a recommended app — were discarded and replaced with a generic DSL-version warning. Real warning details are now shown, with the generic message kept as a fallback. (#41502)
- Pending DSL imports could be confirmed by the wrong tenant or account. Ownership is now mandatory and verified before any cached YAML is processed or database state is mutated, and validation errors no longer echo cached input values. (#40107)
- A broken app icon reference broke the page. Missing, malformed, and cross-tenant image icons now fall back to the default icon — silently during DSL import, and at Web App runtime with the invalid reference logged. (#41977)
- Repeated identical
GETfailures no longer stack up toasts: the first error shows immediately and identical errors for the same URL are suppressed for ten seconds, cleared on success. Every non-GETerror, including consecutive failed saves, is still shown. (#42035)
Correctness of Text and Value Parsing
- JSON extraction broke on backticks inside JSON.
parse_json_markdownpicked the first code-fence-like marker anywhere in the text, so a backtick inside a string value —{"code": "use `print` function"}— or in surrounding prose made extraction start mid-string and fail. Extraction is now anchored on the JSON brackets themselves. This parser backs LLM output parsing for the rule-config generator and dataset retrieval metadata, where backticked code inside JSON is common. (#41959) - Variable names with a trailing newline passed validation. Python's
$anchor also matches before a trailing newline, so"name\n"was accepted intouser_input_formdespite the newline being outside the allowed character set. (#42029) - Epoch-0 timestamps are accepted by the localtime conversion tool, and the weekday tool handles string and missing parameters. (#42027, #41952)
Accessibility
The console and web apps received a broad pass targeting the parts that made them unusable without a mouse or a screen reader: form controls got correct labels and programmatically associated validation feedback (#42096); sortable lists and panel/node resizing became keyboard-operable (#41974, #41963); focus is restored to its origin after overlays and comment threads close instead of being dropped to the document (#42068, #41978); page landmarks and heading structure were corrected so screen-reader users can navigate by region (#41938); button-styled navigation kept its link semantics so it still works with middle-click and modifier-click (#41312); decorative content and redundant list semantics were hidden from assistive technology (#42060); and clickable divs were replaced with native buttons in dataset lists (#41319). The apps list, home page, and login/signup flows were each covered as a whole (#41393, #41310, #41301).
Web App & UI
- The settings dialog is centered at all viewport sizes (#42120), invalid-input focus colors are preserved (#42108), Home and Studio route titles are stable (#41654), and the plugin detail drawer no longer traps interaction as a modal (#41473)
- Object editor values are stringified before Monaco creates a model, instead of failing on non-string input (#41719)
- Go to Anything resets its search when dismissed and its autocomplete behavior is consistent (#41976, #41258)
- Lao is available as a display language, and
pt-BRmaps topt_BRfor tool metadata (#41743, #41745) - Registration tracking is consent-safe and retryable, and Web App analytics are separated from console page tracking (#41365, #41251)
- The education plan is no longer advertised outside Dify Cloud (#41898), and Open in Explore is hidden for SSO-restricted apps (#41518)
Security Enhancements
- Agent skills bypassed the SSRF private-network policy. Agent traffic goes through a separate proxy that ignored
SSRF_PROXY_ALLOW_PRIVATE_IPSandSSRF_PROXY_ALLOW_PRIVATE_DOMAINS, so the allowlist you configured for workflows did not constrain the agent runtime. Both proxies now honor the same allowlist. (#41870) - A plugin could exhaust worker memory with one declared number. The blob chunk merger pre-allocated a buffer of the plugin-declared total length before checking it against the file size limit, so a plugin claiming an absurd size crashed the worker with
MemoryError— the 30 MB limit was never consulted. The declared size is now validated first and rejected with the documented size-limit error. (#42021) h2bumped from4.3.0to4.4.1in bothapianddify-agent(#40120, #40119)transformers,unstructured,pypdf,nltk,httpx2,gitpython, andgunicornrefreshed (#42053, #42054, #42011, #42012, #42017, #41607, #41602, #41505)
Performance
- Agent runs no longer fill up Redis. Per-run event streams were appended without any cap: production held 3.89 GB across 3,457 streams — 81% of the affected Redis node — with individual streams reaching 30 MB and 78,000 entries, because every stream event including token-scale text deltas was written unbounded and every write refreshed a three-day TTL. Streams are now capped, consecutive text deltas from the same part are coalesced within a 100 ms / 4,096-character window, the cancellation-intent stream holds one entry, and default retention drops from 3 days to 2 hours. The public Agent event schema and SSE cursor contract are unchanged. (#41566)
- The Web Apps sidebar was repainting every loaded app on every navigation. Moving the list to cursor pagination in 1.17.0 dropped its virtualizer, so every page fetched stayed mounted in the main nav and survived route changes. On a workspace with 427 installed apps, clicking through the top-level nav spent 1,068 ms of 3.06 s compositing across 12,112 paint records — roughly 7.5 fps — with the cost in paint rather than script. The list is virtualized again, now on a single always-virtualized render path. (#41397)
- The Console loaded 0.63 MB of support-widget JavaScript on every startup. The Zendesk SDK is now fetched on the first Contact Us action instead: Home and Apps load with zero Zendesk requests, and the 36 requests / 628 KB are deferred to users who actually open support. (#41653)
- Agent build-draft checks waited on an unrelated request. Two surfaces returned their loading UI before the component owning the build-draft query mounted, so the browser could not start that request — which needs only the agent ID — until the composer request had finished. Both waterfalls are flattened. (#41816)
- Account avatar uploads sent full-resolution images. Cropped static avatars are now downsampled to a 256 px maximum edge before upload, preserving aspect ratio and never upscaling; animated avatars keep the original-file path. (#41655)
Improvements
- Bundled Weaviate server upgraded from
1.27.0to1.39.2, moving the pull from Docker Hub tocr.weaviate.io, the registry Weaviate publishes to directly.1.39ships no breaking changes and is where Weaviate's bug and security backports land — but existing data volumes require a staged manual upgrade, covered in the Upgrade Guide. Dify also now sends anX-Weaviate-Client-Integration: dify/<version>header so Weaviate can attribute traffic to Dify in its server-side telemetry; registration is best-effort and never blocks client initialization. (#38214) - Explicit database sessions across the ORM layer. The legacy
db.sessionproperty wrappers were removed fromApp,Dataset,Document,DocumentSegment,Message,Conversation,Workflow,InstalledApp,ApiToolProvider, and related models, and sessions are now passed in explicitly at every call site. There is no API surface change, but this removes a long-standing class ofDetachedInstanceErrorand cross-request session bleed that produced intermittent, hard-to-reproduce failures under load. - Runtime and toolchain updates — React 19.3 with browser-only rendering (#42093), Next.js 16.3.3 (#41262), Node.js 24 LTS (#41573), pnpm 12.3.4 (#42005), Jotai v3 (#42036), base-ui 1.8.0 (#41820). Node 24 and pnpm 12.3.4 are now required to build the web frontend from source.
- A compact command map makes agents discoverable from Go to Anything (#41226), and app and agent card interactions were reworked (#41449)
- Embedded recommend-banner templates and plugins open in the detail dialog rather than navigating away, and banner logos and template authors are preserved (#42063, #41828, #41980)
- The secret environment variable description was updated (#41309), and tracing configuration boundaries are preserved across app operations (#41403)
Environment Variable Changes
New Variables
| Variable | Default | Description |
|---|---|---|
WEBSOCKET_MAX_HTTP_BUFFER_SIZE |
10485760 |
Socket.IO frame ceiling for the collaboration WebSocket. Raise it if very large workflow graphs still fail to sync. |
WEAVIATE_GRPC_ENDPOINT |
grpc://localhost:50051 |
Newly documented in api/.env.example for source deployments. gRPC has been required since Weaviate 1.27; the example files simply never listed it. The Docker value (grpc://weaviate:50051) is unchanged. |
EXPOSE_WEAVIATE_GRPC_PORT |
50051 |
Publishes Weaviate's gRPC port in the middleware-only stack. |
EXPOSE_LOCAL_SANDBOX_PORT |
5004 |
Publishes the local sandbox in the middleware-only stack, so a locally-run agent backend can reach it. |
DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN |
(empty) | shellctl auth token for the middleware-only local sandbox. |
MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH |
128 |
Markdown form field-name length limit, previously hard-coded. |
NEXT_PUBLIC_ENABLE_AGENT_V2_IN_CHATFLOW |
false |
Feature gate for the Agent V2 node in Chatflow apps. Off by default. |
DIFY_AGENT_RUN_EVENT_STREAM_MAX_LENGTH |
5000 |
Maximum entries retained per Agent run event stream. |
DIFY_AGENT_STREAM_TEXT_DELTA_COALESCING_ENABLED |
true |
Merge consecutive Agent text deltas before writing them to Redis. |
DIFY_AGENT_STREAM_TEXT_DELTA_FLUSH_INTERVAL_MS |
100 |
Coalescing flush window. |
DIFY_AGENT_STREAM_TEXT_DELTA_MAX_CHARS |
4096 |
Coalescing size cap. |
Modified (default values)
DIFY_AGENT_RUN_RETENTION_SECONDS:259200(3 days) →7200(2 hours)
Important
Agent run records and event streams now expire after 2 hours instead of 3 days. This is part of the fix for unbounded Redis growth (#41566). If you rely on inspecting Agent run events for longer than that, set DIFY_AGENT_RUN_RETENTION_SECONDS explicitly in your env file before upgrading.
No environment variables were removed in this release.
Docker Compose Changes
- Weaviate image and registry:
semitechnologies/weaviate:1.27.0→cr.weaviate.io/semitechnologies/weaviate:1.39.2indocker-compose.yaml,docker-compose-template.yaml, anddocker-compose.middleware.yaml. This is not a drop-in change for existing data — see the Upgrade Guide. docker-compose.middleware.yaml: adds thelocal_sandboxservice (present in the main Compose file since 1.16.1) with thedify_agent_local_sandbox_homeanddify_agent_local_sandbox_workspacevolumes, and publishes Weaviate's gRPC port50051.- Image tags updated to
1.17.1.
Database Migrations
This release includes 3 new migrations, all applied by flask db upgrade:
2026_08_25_1200-9b7c6d5e4f3a_add_normalized_email_to_accounts.py— Adds an indexedaccounts.normalized_emailcolumn and backfills it, normalizing Gmail and Googlemail addresses. Deliberately not unique: existing installations may already hold equivalent accounts, and those records are preserved while new collisions are prevented.2026_08_27_1200-5578e028b2f2_migrate_legacy_model_types.py— Data migration canonicalizing legacy model types acrossprovider_models,provider_model_credentials,tenant_default_models,provider_model_settings, andload_balancing_model_configs, deduplicating colliding rows. This replaces the manualflask data-migrate legacy-model-typesstep from 1.16.1 and 1.17.0.2026_08_29_1200-c3f1a9b2e6d4_add_dataset_api_token_bindings.py— Creates thedataset_api_token_bindingsmany-to-many table backing dataset-scoped API keys. Both foreign keys cascade on delete.
No manual backfill command is required.
Caution
Migration 5578e028b2f2 is not reversible — its downgrade() is intentionally a no-op, because rows written after the enum rename cannot be distinguished from rows it rewrote. Back up your database before upgrading.
Upgrade Guide
Bundled Weaviate Server Upgrade
Warning
Staged manual upgrade required for existing bundled-Weaviate deployments
This release moves the bundled Weaviate server from 1.27.0 to 1.39.2. Weaviate neither tests nor supports skipping minor versions, and any release may carry an on-disk migration that expects the previous version to have run at least once. An existing data volume cannot cross 12 minors in one step.
Do not pull 1.17.1 and restart. Step the volume through every minor release in order, landing on the latest patch of each, with a graceful stop at every rung.
Follow the runbook: Weaviate Server Upgrade Path
This applies only if you run the bundled Weaviate with existing data. Check with:
grep -E '^VECTOR_STORE=' docker/.envFresh deployments start on 1.39.2 with an empty volume and need nothing. External Weaviate servers and other vector stores are unaffected.
The runbook is the source of truth for the image ladder, per-rung verification commands, backup, and rollback. In outline, the procedure is:
- Stop Dify's request and worker services, and keep them stopped until the final rung passes.
- Back up the Weaviate volume.
- Step through all 13 rungs —
1.27→1.28→ … →1.38→ finally exactly1.39.2, the version this release pins — verifying after each one. - Revert your temporary image edits, then continue with the normal upgrade steps below.
Two failure modes are worth knowing before you start:
- A hard kill silently and permanently destroys vector recall. Weaviate holds its HNSW index in memory and persists it through a commit log;
docker kill,docker rm -f, an OOM kill, or a stop that exceeds Docker's grace period can leave that log incomplete. Measured on1.39.2, after a hard kill the object count, object listing, BM25 search, and fetch-by-ID all looked healthy whilenear_vectorcould reach only 680 of 700 objects. Nothing is logged, and it does not heal — the only repair is re-indexing the knowledge base. Always stop withdocker compose stop -t -1 weaviate. - Queries fail for several seconds after every restart.
/v1/metaanswers about 2s after start, but collections mount 4–9s later from1.31onward. Inside that window/v1/objectsreturns404and GraphQL returns422 no graphql provider present … no schema is present. Alarming mid-upgrade, and a false alarm — wait, or poll until a real collection query succeeds rather than trusting/v1/meta.
Collection layout does not change, so no re-indexing is required. Dify still stores each dataset as Vector_index_<dataset_id>_Node with a self-provided named vector default and the server-default cosine metric. The Python weaviate-client needs no attention either: 1.17.0 and 1.17.1 both pin 4.22.0, which works against every server version on the ladder.
Running a Weaviate server older than 1.27.0, or still on client v3? Start with the Weaviate v4 migration guide, then return to the upgrade path above.
Legacy Model Types Now Migrate Automatically
Important
The manual flask data-migrate legacy-model-types step documented in the 1.16.1 and 1.17.0 upgrade guides is no longer needed. Migration 5578e028b2f2 performs the same canonicalization as part of flask db upgrade (#41326).
If you already ran the manual command, the migration is a no-op for those rows. If you never ran it — and your deployment was upgraded from a version earlier than 1.15.0 — this release repairs the affected rows for you. After upgrading, verify that your model providers list their models and that previously failing models can be loaded and invoked.
Back up the database first. This migration is not reversible.
Docker Compose (Recommended)
Complete the Weaviate upgrade above first if it applies to you.
cd docker
docker compose down
git fetch --tags
git checkout 1.17.1
docker compose pull
docker compose up -dThe database migrations run automatically on startup.
Important
Review the env changes above and re-apply your local customizations before bringing the stack up — in particular the reduced DIFY_AGENT_RUN_RETENTION_SECONDS default (3 days → 2 hours).
Source Code
git fetch --tags
git checkout 1.17.1
cd api
uv sync
uv run flask db upgradeRebuild and restart the Web frontend, then restart the API server and Worker. Node.js 24 LTS and pnpm 12.3.4 are now required for the web build.
Post-Upgrade Verification
- Run a test retrieval against a knowledge base. Getting chunks back confirms the vector index survived, which an object count alone does not tell you.
- Confirm your model providers still list their models (see Legacy Model Types above).
- Open a large workflow in the editor and confirm it no longer reconnect-loops.
- Re-import any CSV, Excel, Notion, or web-scraped documents ingested on an earlier version — the extraction fixes in this release do not repair already-indexed text.
What's Changed
- fix(api): align Service API OpenAPI contract by @hyoban in #41248
- fix(web): restore AI credits icon by @lyzno1 in #41257
- fix(agent-v2): refine access card interactions by @lyzno1 in #41254
- fix(web): align goto anything autocomplete behavior by @lyzno1 in #41258
- refactor(ci): trim redundant autofix work by @lyzno1 in #41259
- fix(web): upgrade Next.js to 16.3.3 by @lyzno1 in #41262
- feat(cli): add a compact command map for agent discovery by @samzong in #41226
- fix(api): enforce RBAC permission on agent app detail GET endpoint (#41264) by @agarwalpranav0711 in #41265
- fix: separate WebApp analytics from console page tracking by @iamjoel in #41251
- refactor(web): migrate document metadata input by @lyzno1 in #41276
- refactor(web): migrate dataset settings input by @lyzno1 in #41277
- refactor(web): migrate external knowledge input by @lyzno1 in #41278
- feat: go to anything check enable skill by @fatelei in #41281
- fix(api): restore Service API OpenAPI semantics by @hyoban in #41274
- fix(api): clean multimodal attachments in batch deletion by @hieheihei in #41256
- fix(rag-pipeline): mark credential-free datasources as authorized by @ccl125 in #39772
- refactor(api): extract console app site command boundary by @hjlarry in #41216
- refactor(api): standardize compliance downloads by @hjlarry in #41057
- fix(api): honor DELETE JSON body in model_validate by @leilei3167 in #41288
- chore(web): remove retired forum entry by @hjlarry in #41289
- fix(human-input): align backend timeout handle with frontend DSL by @Taranum01 in #40746
- fix(api): attribute Skill Builder credit usage by @linw1995 in #41290
- fix(auth): normalize Gmail registration emails by @linw1995 in #41249
- feat: optimize resource access config logic by @WTW0313 in #41164
- chore(i18n): sync translations with en-US by @github-actions[bot] in #41291
- refactor(api): thin OAuth controllers and extract application services by @41tair in #40692
- test(e2e): stabilize Agent access toggles by @lyzno1 in #41282
- fix: improve login and signup accessibility by @iamjoel in #41301
- feat: add command cli to migration rbac scope to automatic_include_workspace_members by @fatelei in #41304
- fix: update secret environment variable description by @zhangx1n in #41309
- fix(web): preserve link semantics in button-styled navigation by @lyzno1 in #41312
- fix(api): enforce RBAC permission on agent composer GET endpoint (#41324) by @agarwalpranav0711 in #41325
- fix(api): migrate legacy model types during upgrade by @laipz8200 in #41326
- fix(web): align model provider access permissions by @hjlarry in #41329
- refactor: remove unused workflow run export endpoint by @hjlarry in #41335
- refactor(web): migrate metadata inputs by @lyzno1 in #41339
- refactor(api): extract workflow run archive application service by @hjlarry in #41253
- refactor(api): extract workflow statistic query service by @hjlarry in #41271
- chore(deps): bump h2 from 4.3.0 to 4.4.1 in /api by @dependabot[bot] in #40120
- refactor(api): remove unused workflow archived logs endpoint by @hjlarry in #41345
- chore: remove permission check by @fatelei in #41349
- refactor(web): migrate workflow variable inputs by @lyzno1 in #41340
- refactor(web): migrate tracing inputs by @lyzno1 in #41341
- fix(web): route Agent V2 documentation links correctly by @lyzno1 in #41353
- fix(api): ignore broken pipe during app stop checks 🤖🤖🤖 by @QuantumGhost in #41356
- fix(web): use management provider list for MCP integrations by @hjlarry in #41360
- fix: improve home page accessibility by @iamjoel in #41310
- test: migrate Service API dataset segment sessions and ORM models to SQLite by @asukaminato0721 in #40517
- test: migrate explore installed app sessions and ORM models to SQLite by @asukaminato0721 in #40525
- test: migrate agent observability sessions and ORM models to SQLite by @asukaminato0721 in #40588
- test: migrate knowledge file access sessions and ORM models to SQLite by @asukaminato0721 in #40596
- fix: allow publishing workflows with legacy Agent nodes by @iamjoel in #41368
- test(e2e): wait for apps console readiness by @lyzno1 in #41357
- chore: add permission check back by @fatelei in #41369
- fix(web): refine agent configure section states by @lyzno1 in #41371
- chore(web): remove Agentation devtool by @lyzno1 in #41372
- fix(workflow): correct loop boolean break condition values by @HelloSrauker in #41186
- feat: track inline agent and preview mode events by @iamjoel in #41373
- fix: align documentation links with stable anchors by @lyzno1 in #41384
- feat: new user add automatic add to app / dataset whitelist by @fatelei in #41363
- revert(web): restore Agentation devtool by @lyzno1 in #41387
- fix(api): raise Socket.IO max_http_buffer_size for large workflows by @leilei3167 in #41347
- test: migrate human input sessions and ORM models to SQLite by @asukaminato0721 in #40597
- test: migrate agent service sessions and ORM models to SQLite by @asukaminato0721 in #40598
- perf(web): virtualize the Web Apps sidebar list again by @BenjaminX in #41397
- fix(api): preserve tracing configuration boundaries by @laipz8200 in #41403
- fix(ui): keep scroll area focus indicator visible by @lyzno1 in #41404
- refactor(web): simplify pricing components by @lyzno1 in #41416
- docs: correct UUIDv7 helper docstring by @huyua9 in #41419
- refactor(models): pass session into PipelineCustomizedTemplate.created_user_name by @a-yeyang in #41394
- refactor(models): pass session into ChildChunk accessors by @keith991001 in #41370
- fix: protect workspace owners in resource access by @WTW0313 in #41423
- fix(web): block resource access for Agent apps by @WTW0313 in #41424
- ci: run the dify-agent test suite by @alanhuangyoo in #41327
- feat: hide skill_entry when use has no skill.view permission by @fatelei in #41429
- fix(web): align web app sidebar spacing by @lyzno1 in #41425
- fix(web): prevent tool card footer clipping by @Jingyi-Dify in #41430
- fix(ci): correct difyctl release and e2e workflow gates by @GareArc in #41355
- fix: improve accessibility across the apps list by @iamjoel in #41393
- fix(web): give the favicon a single owner in root metadata by @BenjaminX in #41433
- fix(agent): add roster publication status contract by @lyzno1 in #41435
- fix(web): align agent roster card interactions by @lyzno1 in #41436
- fix: avoid duplicate error toast when applying agent build drafts by @iamjoel in #41442
- feat(web): enhance app and agent card interactions by @lyzno1 in #41449
- refactor(models): pass session into WorkflowAppLog accessors by @keith991001 in #41440
- test: centralize account and feature config overrides by @asukaminato0721 in #40864
- refactor(service_api): dep-inject payloads with @model_validate by @ShousenZHANG in #41374
- test: centralize controller and storage config overrides by @asukaminato0721 in #40867
- refactor(controllers/console): dep-inject workflow payloads with @model_validate by @Terminator666666 in #41244
- chore: remove unnecessary type conversions by @lin597410-design in #41454
- test: centralize core and service config overrides by @asukaminato0721 in #40868
- test: migrate application DSL sessions and ORM models to SQLite by @asukaminato0721 in #40554
- test: enforce centralized config overrides by @asukaminato0721 in #40869
- refactor(models): pass session into Workflow accessors by @jjj-n in #41464
- refactor: pass db.session explicitly in instruction_modify_workflow (#37403) by @weike-zhang in #40827
- refactor(service_api): dep-inject app payloads with @model_validate by @ShousenZHANG in #41491
- fix(web): improve a11y of dataset clickable divs with native buttons by @LuckTerence in #41319
- refactor(service_api): dep-inject dataset payloads with @model_validate by @ShousenZHANG in #41490
- revert(web): revert dataset button a11y changes by @lyzno1 in #41493
- refactor(console): dep-inject account payloads with @model_validate by @ShousenZHANG in #41500
- refactor(web): dep-inject payloads with @model_validate by @ShousenZHANG in #41501
- fix(e2e): target agent roster list items by @lyzno1 in #41453
- fix(web): refine agent dialog form sessions by @lyzno1 in #41492
- chore(deps): bump anthropics/claude-code-action from 1.0.199 to 1.0.210 in the github-actions-dependencies group by @dependabot[bot] in #41504
- fix(web): unify tool plugin selection state by @lyzno1 in #41470
- fix(agent): reject incompatible session snapshots by @zyssyz123 in #41447
- fix(web): show DSL import warning details by @hjlarry in #41502
- fix(api): keep workspace owner consistent on ownership transfer by @GareArc in #41267
- feat: use app.acl.access_point_manage to control access point page access by @fatelei in #41462
- refactor(api): extract email registration application service by @41tair in #41108
- fix(web): make registration tracking consent-safe and retryable by @CodingOnStar in #41365
- fix(rbac): grant agent access to all legacy roles by @WTW0313 in #41511
- refactor(api): decouple onboarding and notification services by @41tair in #40759
- fix(web): make plugin detail drawer non-modal by @lyzno1 in #41473
- fix(web): preserve plugin footer text layout by @Jingyi-Dify in #41514
- test: migrate advanced chat generator sessions and ORM models to SQLite by @asukaminato0721 in #40585
- test: migrate console dataset sessions and ORM models to SQLite by @asukaminato0721 in #40521
- test: migrate audit findings sessions and ORM models to SQLite by @asukaminato0721 in #40551
- test: migrate model and agent sessions to SQLite by @asukaminato0721 in #40087
- fix: stabilize node block selectors and restore start tabs by @iamjoel in #41523
- fix: prevent the exit versions button from shrinking by @iamjoel in #41527
- fix(web): align tool plugin card layout by @Jingyi-Dify in #41525
- fix: hide chat features drawer while opener dialog is active by @iamjoel in #41530
- fix(workflow): allow human input in iteration and loop by @laipz8200 in #40061
- chore(dify-agent): make local dev work with defaults out of the box by @wylswz in #41533
- fix(workflow): block manual runs for trigger workflows by @zyssyz123 in #41519
- fix(web): reset test-email sender state when reopening the modal by @GareArc in #41515
- docs(frontend): clarify transient state ownership by @lyzno1 in #41541
- fix(web): hide Open in Explore for SSO-restricted apps by @GareArc in #41518
- refactor(workflow): migrate schedule cron input by @lyzno1 in #41550
- refactor(workflow): migrate email subject input by @lyzno1 in #41551
- refactor(plugins): migrate credential rename input by @lyzno1 in #41552
- refactor(web): align skills card semantics by @lyzno1 in #41559
- fix(plugin): prevent install dialog error overflow by @lyzno1 in #41561
- chore: Revert "feat: use app.acl.access_point_manage to control access point page access" by @iamjoel in #41563
- chore(deps): upgrade workspace dependencies by @lyzno1 in #41564
- refactor(console): dep-inject model provider payloads with @model_validate by @ShousenZHANG in #41539
- refactor(service_api): dep-inject query params with @model_validate by @ShousenZHANG in #41562
- chore: enforce titles on CSS-truncated elements by @iamjoel in #41438
- fix(agent): bound Redis run event streams by @zyssyz123 in #41566
- refactor(models): pass session into DocumentSegment and AppDatasetJoin accessors by @elyar1124 in #41568
- refactor(models): remove legacy db.session property wrappers on Dataset by @keith991001 in #41569
- fix: handle published workflow request failures in access points by @iamjoel in #41572
- chore: upgrade Node.js runtime to 24 LTS by @lyzno1 in #41573
- fix(web): publish workflow before creating tool by @QuantumGhost in #41528
- fix(web): merge workflow tool outputs from all End nodes by @QuantumGhost in #41517
- test: migrate agent-v2 workflow sessions and ORM models to SQLite by @asukaminato0721 in #40514
- test: migrate workspace member sessions and ORM models to SQLite by @asukaminato0721 in #40523
- test: migrate dataset retrieval sessions and ORM models to SQLite by @asukaminato0721 in #40548
- test: migrate dataset download sessions and ORM models to SQLite by @asukaminato0721 in #40630
- refactor(api): decouple system features and web adapters by @41tair in #40772
- fix(web): announce agent draft status by @lyzno1 in #41595
- ci(e2e): shard pull request browser tests by @lyzno1 in #41596
- chore(deps-dev): bump nltk from 3.10.0 to 3.10.3 in /api by @dependabot[bot] in #41602
- refactor(web): migrate external API selection input by @lyzno1 in #41610
- refactor(web): migrate dataset settings name input by @lyzno1 in #41611
- refactor(web): migrate webhook table input by @lyzno1 in #41612
- fix(rbac): let agent.manage operate every agent page by @GareArc in #41583
- chore(deps): bump pypdf from 6.15.0 to 6.16.1 in /api by @dependabot[bot] in #41607
- refactor(service_api): dep-inject segment payloads with @model_validate by @ShousenZHANG in #41571
- refactor(web): migrate access point mutations by @lyzno1 in #41614
- refactor(inner_api): dep-inject request payloads with @model_validate by @ShousenZHANG in #41575
- docs(e2e): refine Playwright and Cucumber skill guidance by @lyzno1 in #41617
- fix: improve snippets list accessibility by @iamjoel in #41579
- fix(api): tolerate workflow pause snapshot cleanup failure by @QuantumGhost in #41581
- refactor(web): migrate console reset password inputs by @lyzno1 in #41632
- refactor(web): migrate webapp reset password inputs by @lyzno1 in #41633
- refactor(web): migrate webapp email code inputs by @lyzno1 in #41634
- feat: app access point permission by @WTW0313 in #41631
- refactor(api): require active workspace in request context by @hjlarry in #41280
- chore(deps): bump pypdf from 6.14.2 to 6.16.1 in /dify-agent by @dependabot[bot] in #41604
- perf(web): downsample static account avatars by @lyzno1 in #41655
- fix(web): stabilize Home and Studio route titles by @lyzno1 in #41654
- fix: preserve Swagger tool authorization after refresh by @iamjoel in #41656
- fix(dify-agent): harden E2B binding lifecycle by @zhaohao1004 in #41623
- fix: validate rule for provider scoped credentials by @wylswz in #41659
- fix(web): align avatar file extension with output type by @lyzno1 in #41662
- feat: allow knowledge base API keys to be scoped to a single dataset by @ForeignKeyCN in #37569
- perf(web): load Zendesk on support intent by @lyzno1 in #41653
- chore(i18n): sync translations with en-US by @github-actions[bot] in #41669
- chore(deps): bump transformers from 5.6.2 to 5.10.1 in /dify-agent by @dependabot[bot] in #41608
- chore: Site to typebase by @asukaminato0721 in #35632
- refactor(api): extract forgot password application service by @41tair in #41111
- refactor(console,web): dep-inject query params with @model_validate by @ShousenZHANG in #41646
- chore(deps): bump transformers from 5.5.0 to 5.10.1 in /api by @dependabot[bot] in #41609
- chore(dify-ui): migrate class merging to cn by @hyoban in #41693
- docs(web): clarify browser mode focus test boundary by @lyzno1 in #41692
- feat(web): make markdown form field name length configurable by @WTW0313 in #41697
- refactor(web): migrate legacy form controls to Dify UI by @lyzno1 in #41682
- refactor(service-api): inject file upload service by @hjlarry in #41585
- refactor(service_api): dep-inject the dataset create payload with @model_validate by @ShousenZHANG in #41651
- refactor(web): inject file upload service by @hjlarry in #41586
- refactor(console): inject file service by @hjlarry in #41603
- refactor(openapi): inject file upload service by @hjlarry in #41606
- fix(api): bound suggested question generation latency by @zyssyz123 in #41705
- refactor(api): centralize remote file handling by @hjlarry in #41627
- refactor(api): extract account login service and consolidate adapters by @41tair in #41184
- fix(web): guard LLM node model_selector against persisted null by @BenjaminX in #41707
- fix(web): align workspace switcher states and semantics by @Jingyi-Dify in #41713
- chore(web): canonicalize Tailwind classes by @hyoban in #41718
- fix(web): stringify object editor values before Monaco createModel by @kabishou11 in #41719
- chore(web): prune unused i18n keys by @hyoban in #41725
- test(web): remove workspace switcher browser test by @lyzno1 in #41728
- chore(i18n): sync translations with en-US by @github-actions[bot] in #41733
- refactor(api): decouple console OAuth flow from legacy account services by @41tair in #41188
- fix(agent): surface missing tool credentials by @zyssyz123 in #41726
- chore(dify-ui): enable purity lint in tests by @lyzno1 in #41736
- chore: remove redundant aria-label attributes by @iamjoel in #41724
- refactor(web): migrate runtime variable inputs by @lyzno1 in #41739
- fix(web): map pt-BR to pt_BR for tool metadata by @hjlarry in #41745
- refactor(web): align account preference requests with API contracts by @hjlarry in #41748
- refactor(models): remove legacy db.session property wrappers on Document by @keith991001 in #41721
- refactor(query): migrate imperative APIs to query semantics by @lyzno1 in #41746
- fix(binding-files): keep UTF-8 text preview when max_bytes splits a character by @Souravrajvi0 in #41761
- refactor: pass notification language explicitly by @hjlarry in #41770
- feat: app deployment v2 by @WTW0313 in #41444
- chore(web): enforce query options lint by @lyzno1 in #41754
- chore: run dify-agent typecheck in python-style by @wylswz in #41701
- refactor(models): use sa.false()/sa.true() for boolean server defaults by @Souravrajvi0 in #41762
- ci: parallelize change detection and gate style jobs by @41tair in #41678
- fix(api): support Lao as a display language by @hjlarry in #41743
- refactor: make explore localization request-driven by @hjlarry in #41798
- chore: correct ARIA roles and preserve control interactions by @iamjoel in #41738
- fix(ci): avoid npm bootstrap in web setup by @lyzno1 in #41804
- test: split skill detail page suite by @lyzno1 in #41799
- chore(deps-dev): bump mkdocs-material from 9.7.6 to 9.7.7 in /dify-agent by @dependabot[bot] in #41767
- docs(api): Fix reformat script path in api/README.md by @jrlprost in #41658
- fix(api): correct dataset and document list has_more pagination by @kabishou11 in #41784
- fix(skills): tolerate __MACOSX metadata folder when importing a Skill package by @chelsealong in #41757
- fix: close unclosed think tags around agent tool calls by @Souravrajvi0 in #41764
- fix(api): persist plugin trigger subscription expires_at from provider by @kabishou11 in #41773
- fix(api): keep segment attachments when attachment_ids omitted by @kabishou11 in #41777
- refactor(web): migrate runtime app inputs by @lyzno1 in #41806
- refactor(api): move OpenAPI account access behind application services by @41tair in #41308
- fix(web): use stable error boundary retry by @lyzno1 in #41811
- fix(web): allow CookieYes consent logging by @lyzno1 in #41812
- fix(api): correct Service API segments has_more pagination by @kabishou11 in #41776
- feat(web): add marketplace creator profiles and homepage redesign by @CodingOnStar in #41538
- refactor(api): extract console workflow run application service by @hjlarry in #41336
- fix(api): skip invalid markdown image URLs by @euxx in #41343
- fix(trigger): sync plugin relationships on publish by @ayush-singh-0601 in #41756
- docs(dify-ui): document combobox chip keyboard hints by @lyzno1 in #41815
- chore(i18n): sync translations with en-US by @github-actions[bot] in #41817
- perf(agent-v2): flatten build draft request waterfalls by @lyzno1 in #41816
- test: migrate core agent runner sessions and ORM models to SQLite by @asukaminato0721 in #40508
- chore: bump base-ui to 1.8.0 by @lyzno1 in #41820
- refactor(api): extract app statistic queries from console controllers by @hjlarry in #41557
- fix(api): enforce admin and RBAC permissions on model provider model credential GET endpoint (#41599) by @agarwalpranav0711 in #41600
- refactor(dify-ui): adopt ID-backed combobox items by @lyzno1 in #41821
- chore: use semantic tags for interactive elements by @iamjoel in #41813
- refactor(api): isolate workflow app log queries by @hjlarry in #41509
- fix(web): append /api/v1 when SSR reads MARKETPLACE_API_URL by @CodingOnStar in #41824
- docs(web): align PreviewCard disclosure guidance by @lyzno1 in #41827
- fix(button): align loading accessibility contract by @lyzno1 in #41823
- test: migrate application generation sessions and ORM models to SQLite by @asukaminato0721 in #40509
- fix: align select and autocomplete collection contracts by @lyzno1 in #41829
- fix: preserve generated API contracts during local development by @hyoban in #41834
- fix(select): isolate trigger states and unavailable package selection by @lyzno1 in #41843
- refactor(models): pass session into tool provider accessors by @a-yeyang in #41830
- refactor(models): pass session into AppAnnotationHitHistory accessors by @a-yeyang in #41832
- refactor(web): dep-inject the passport query with @model_validate by @ShousenZHANG in #41845
- docs: clarify frontend guidance ownership and dependencies by @lyzno1 in #41848
- refactor(console): decouple app tracing configuration by @hjlarry in #41576
- fix(web): open embedded recommend banner plugins in the detail dialog by @CodingOnStar in #41828
- refactor(api): extract human input file upload persistence by @hjlarry in #41716
- chore(deps): bump anthropics/claude-code-action from 1.0.211 to 1.0.216 in the github-actions-dependencies group by @dependabot[bot] in #41892
- refactor(models): remove legacy db.session properties from Conversation by @Kiveiru3 in #41847
- chore: remove unnecessary str() calls in annotation tasks by @XiaoSong1223 in #41878
- refactor(web): migrate workflow error default inputs by @lyzno1 in #41900
- refactor(web): migrate loop variable constant inputs by @lyzno1 in #41901
- fix(agent): send uploaded images as native multimodal input by @kenwoodjw in #41685
- chore(deps-dev): bump the dev group in /api with 48 updates by @dependabot[bot] in #41896
- feat(rbac): agent RBAC/ACL scenes and resource-locator check bundles by @GareArc in #41768
- refactor(models): pass session into AppAnnotationSetting.collection_binding_detail by @however-yir in #41885
- refactor(models): remove legacy db.session wrappers on Message feedback/annotation accessors by @however-yir in #41883
- refactor(inner_api): dep-inject workspace payloads with @model_validate by @ShousenZHANG in #41540
- refactor(controllers): inject message request models by @Kiveiru3 in #41884
- refactor(models): remove legacy db.session property wrappers on DocumentSegment and DatasetQuery by @keith991001 in #41794
- refactor(models): remove remaining legacy db.session property wrappers on Dataset by @keith991001 in #41647
- chore(i18n): sync translations with en-US by @github-actions[bot] in #41904
- refactor(models): pass session into CustomizedSnippet accessors by @anneheartrecord in #40379
- refactor(controllers): adopt with_session in web saved_message by @yuki-uix in #41859
- fix(web): use default Code Inspector integration by @lyzno1 in #41903
- refactor(web): move app quota refresh out of provider context by @lyzno1 in #41906
- refactor(web): remove provider plan query flags by @lyzno1 in #41908
- fix(ssrf): apply private allowlist to agent_ssrf_proxy by @kabishou11 in #41870
- refactor(web): remove legacy enableBilling consumers by @lyzno1 in #41913
- refactor(api): remove legacy billing enabled state by @lyzno1 in #41917
- fix(api): fix tencent summary vector deadlock by @FFXN in #41916
- refactor(service-api): extract file preview application service by @hjlarry in #41732
- refactor(models): pass session into ApiToolProvider.user accessor by @however-yir in #41882
- refactor(models): remove the last standalone legacy db.session properties on Dataset by @keith991001 in #41911
- refactor(models): remove legacy db.session wrappers on Message accessors by @however-yir in #41886
- fix(dx): repair and restage Python files in pre-commit by @lyzno1 in #41877
- fix(api): reject ownerless pending DSL imports by @WH-2099 in #40107
- refactor(web): retire provider context plan state by @lyzno1 in #41925
- refactor: preserve exception context when re-raising in except blocks by @zrh805 in #40432
- refactor(models): pass session into InstalledApp.tenant accessor by @ShawYann in #41831
- refactor: add missing @OverRide decorators to console controller classes by @citizen204 in #37113
- style(api): remove unnecessary type conversions in services, repositories and tests by @Java123456com in #41856
- refactor(web): remove obsolete agent v2 scaffolding and editor state by @lyzno1 in #41931
- fix(billing): align zero and unlimited quota semantics by @lyzno1 in #41927
- fix(dataset_service): refresh session snapshot before UploadFile lookup by @Taranum01 in #41840
- fix(vdb-weaviate): backward-compatible cleanup + preserve positional alignment by @Taranum01 in #41915
- refactor(api): extract upload file delivery service by @hjlarry in #41772
- refactor(console): unify environment-aware oRPC clients and query policies by @lyzno1 in #41932
- refactor(api): extract tool file download service by @hjlarry in #41790
- refactor(web): move provider feature flags to query consumers by @lyzno1 in #41937
- refactor(web): move model lists out of provider context by @lyzno1 in #41939
- fix(agent): persist Chatflow Agent V2 memory by conversation_id by @kabishou11 in #41871
- refactor(api): extract plugin file upload application service by @hjlarry in #41808
- fix(api): align service api schemas with runtime behavior by @hyoban in #41943
- refactor(web): retire provider context by @lyzno1 in #41944
- fix: correct page landmarks and document layout rules by @iamjoel in #41938
- fix(api): enforce RBAC permission on MCP tool provider GET endpoint (#41547) by @agarwalpranav0711 in #41548
- refactor(api): trim workspace features response contract by @lyzno1 in #41948
- refactor(models): remove the legacy db.session wrappers on App by @ShousenZHANG in #41942
- refactor(models): remove four unread legacy db.session wrappers by @ShousenZHANG in #41964
- fix: make panel and node resizing keyboard accessible by @iamjoel in #41963
- refactor(web): isolate pricing modal state and lifecycle by @lyzno1 in #41960
- fix(dataset): delete segment attachment blobs from storage by @CoralGarden52 in #41400
- fix(api): anchor JSON extraction on brackets in parse_json_markdown by @Harsh23Kashyap in #41959
- feat: support keyboard movement for workflow nodes and comments by @iamjoel in #41967
- fix(i18n): sync agent access point copy by @WTW0313 in #41969
- fix(rag): preserve CSV cell text during knowledge import by @Souravrajvi0 in #41922
- fix(api): handle string and missing params in weekday time tool by @Harsh23Kashyap in #41952
- refactor(models): pass session into WorkflowNodeExecutionModel accessors by @keith991001 in #41968
- fix(api): correct service api rate limit descriptions by @hyoban in #41975
- fix(api): accept CRLF SKILL.md when importing skill zips by @leilei3167 in #41657
- fix(web): reset goto anything search after dialog closes by @lyzno1 in #41976
- fix: restore comment marker focus after closing threads by @iamjoel in #41978
- test: migrate provider core entity sessions and ORM models to SQLite by @asukaminato0721 in #40532
- test: migrate console dataset document sessions and ORM models to SQLite by @asukaminato0721 in #40522
- test: migrate workspace snippet sessions and ORM models to SQLite by @asukaminato0721 in #40524
- test: migrate segment service sessions and ORM models to SQLite by @asukaminato0721 in #40535
- fix(api): flatten readabilipy plain_text items in web reader tool by @Harsh23Kashyap in #41954
- fix(web): keep recommend banner logos intact and show template authors by @CodingOnStar in #41980
- fix(api): resolve aliases in remote settings sources by @GYJ99 in #41463
- fix(api): allow PDF extraction from URLs without an upload file by @Harsh23Kashyap in #41950
- docs(CODEOWNERS): Assign domain owners for backend test paths by @laipz8200 in #42007
- fix(dataset): clean multimodal attachments during reindex by @CoralGarden52 in #41999
- chore(deps): upgrade pnpm to 12.3.4 and Vite+ to 0.3.1 by @lyzno1 in #42005
- fix: dataset hitcount deadlock by @FFXN in #41979
- fix(api): fall back to first server URL when X-Request-Env is set but servers lack env key by @Harsh23Kashyap in #42025
- fix: validate declared blob size before allocating buffer in chunk merger by @Harsh23Kashyap in #42021
- fix(api): reject trailing newlines in user_input_form variable names by @Harsh23Kashyap in #42029
- fix(api): handle invalid app icon references by @linw1995 in #41977
- fix: keep Notion table cell rich text segments in one Markdown column by @Harsh23Kashyap in #41993
- chore(deps): upgrade jotai to v3 and jotai-scope by @lyzno1 in #42036
- fix(api): accept valid epoch-0 timestamps in localtime conversion tool by @Harsh23Kashyap in #42027
- fix: deduplicate repeated GET request error notifications by @iamjoel in #42035
- chore(deps): bump gitpython from 3.1.58 to 3.1.59 in /api by @dependabot[bot] in #42017
- fix(console): stop advertising the education plan outside Dify Cloud by @lin-snow in #41898
- refactor(models): remove the unread App.author_name db.session wrapper by @ShousenZHANG in #41983
- refactor(models): remove the App.bound_agent_id and App.is_agent wrappers by @ShousenZHANG in #41998
- refactor(api): remove InstalledApp implicit-session accessor by @nehal-a2z in #42000
- refactor(controllers/console): inject saved-message query with @model_validate by @wr-Jiao in #41819
- fix: escape double quotes in .xls cell values like the .xlsx path by @Harsh23Kashyap in #42049
- chore(lint): share and tighten JSX accessibility rules by @lyzno1 in #42045
- fix: join all rich_text/title segments in Notion database extraction by @Harsh23Kashyap in #42050
- refactor(web): migrate workflow numeric configuration inputs by @lyzno1 in #42052
- fix: make sortable lists keyboard accessible by @iamjoel in #41974
- chore(deps): bump transformers from 5.6.2 to 5.16.1 in /dify-agent by @wylswz in #42054
- test: reclassify response filter regressions by @asukaminato0721 in #40706
- chore(lint): tighten inline disable enforcement by @hyoban in #42058
- test: migrate workflow node execution task sessions and ORM models to SQLite by @asukaminato0721 in #40571
- fix(web): hide decorative content and redundant list semantics by @iamjoel in #42060
- feat: add agent resource permissions by @WTW0313 in #41940
- chore(lint): respect gitignore in ESLint flat config by @hyoban in https://github.com/langgenius/dify/pull/42065
- chore(deps): bump unstructured from 0.21.5 to 0.27.5 in /api by @wylswz in https://github.com/langgenius/dify/pull/42053
- test: migrate console app response sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40562
- test: migrate console workflow sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40563
- chore(deps): bump h2 from 4.3.0 to 4.4.1 in /dify-agent by @dependabot[bot] in https://github.com/langgenius/dify/pull/40119
- chore: example to add Mapped by @asukaminato0721 in https://github.com/langgenius/dify/pull/40374
- chore(i18n): sync translations with en-US by @github-actions[bot] in https://github.com/langgenius/dify/pull/42064
- fix: fix undo delete operation for webhook trigger node lead the url … by @fatelei in https://github.com/langgenius/dify/pull/42069
- chore(deps): bump httpx2 from 2.5.0 to 2.12.0 in /dify-agent by @dependabot[bot] in https://github.com/langgenius/dify/pull/42011
- chore(deps): bump httpx2 from 2.5.0 to 2.12.0 in /api by @dependabot[bot] in https://github.com/langgenius/dify/pull/42012
- fix(web): open embedded recommend banner templates in the detail dialog by @CodingOnStar in https://github.com/langgenius/dify/pull/42063
- chore(deps): bump the storage group across 1 directory with 4 updates by @dependabot[bot] in https://github.com/langgenius/dify/pull/41893
- chore(release): Upgrade self-hosted Weaviate to 1.39 by @dudanogueira in https://github.com/langgenius/dify/pull/38214
- fix(web): restore focus after closing overlays by @iamjoel in https://github.com/langgenius/dify/pull/42068
- chore(deps): bump gunicorn from 26.1.0 to 26.2.0 in /api in the flask group across 1 directory by @dependabot[bot] in https://github.com/langgenius/dify/pull/41505
- refactor(web): migrate conversation variable inputs by @lyzno1 in https://github.com/langgenius/dify/pull/42070
- refactor(api): migrate remaining RESTX models to Pydantic by @asukaminato0721 in https://github.com/langgenius/dify/pull/40399
- chore(deps): bump unstructured from 0.21.5 to 0.24.0 in /dify-agent by @dependabot[bot] in https://github.com/langgenius/dify/pull/41765
- fix(web): align card tag masks with design tokens by @lyzno1 in https://github.com/langgenius/dify/pull/42074
- chore(deps): bump the google group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/langgenius/dify/pull/41121
- chore: fit the app canvas when create from DSL and preview by @iamjoel in https://github.com/langgenius/dify/pull/42073
- fix: prevent note bold shortcut from toggling the sidebar by @iamjoel in https://github.com/langgenius/dify/pull/42078
- fix(ci): refresh E2E runtime path filters by @lyzno1 in https://github.com/langgenius/dify/pull/42079
- test: split CodeNode validation from sandbox coverage by @asukaminato0721 in https://github.com/langgenius/dify/pull/40707
- feat(nuqs-jotai): bridge nuqs URL state into Jotai by @hyoban in https://github.com/langgenius/dify/pull/42086
- refactor(api): remove legacy end user type fallback by @EvanYao826 in https://github.com/langgenius/dify/pull/39662
- chore(codeowners): assign dify-agent to Yanli by @laipz8200 in https://github.com/langgenius/dify/pull/42091
- docs(api): fix working directory instructions for running tests by @Babulubobo in https://github.com/langgenius/dify/pull/42085
- fix(web): prefetch skill feature flag for initial navigation by @kabishou11 in https://github.com/langgenius/dify/pull/41731
- fix(web): stabilize install footer and shortcut initial rendering by @hyoban in https://github.com/langgenius/dify/pull/42088
- chore(web): upgrade React to 19.3 and adopt browser-only rendering by @lyzno1 in https://github.com/langgenius/dify/pull/42093
- fix(web): restore content-sized search shortcut keycap by @lyzno1 in https://github.com/langgenius/dify/pull/42097
- fix: fix agent.id mismatch lead permission keys are empty by @fatelei in https://github.com/langgenius/dify/pull/42095
- fix(web): remove local search delay and clean up component lifecycles by @lyzno1 in https://github.com/langgenius/dify/pull/42102
- test: migrate summary index sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40505
- test: migrate console dataset metadata sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40520
- test: migrate custom tool provider ORM model to real entity by @asukaminato0721 in https://github.com/langgenius/dify/pull/40653
- test: migrate agent workspace and publishing sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40506
- test: migrate Service API app sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40558
- test: migrate RAG retrieval sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40512
- test: move mocked model and tool cases to unit tests by @asukaminato0721 in https://github.com/langgenius/dify/pull/40708
- fix(dify-ui): preserve invalid focus colors and remove shadow transitions by @lyzno1 in https://github.com/langgenius/dify/pull/42108
- fix(agent): pin chatflow participant versions across config updates by @zyssyz123 in https://github.com/langgenius/dify/pull/42105
- fix(api): restore Human Input completion events by @QuantumGhost in https://github.com/langgenius/dify/pull/42082
- fix(web): preserve web apps navigation focus and disclosure semantics by @lyzno1 in https://github.com/langgenius/dify/pull/42113
- fix(ui): let collapsible consumers own trigger styling by @lyzno1 in https://github.com/langgenius/dify/pull/42116
- fix(web): correct form labels, validation feedback, and keyboard navigation by @iamjoel in https://github.com/langgenius/dify/pull/42096
- fix(web): center settings dialog across viewport sizes by @hyoban in https://github.com/langgenius/dify/pull/42120
- fix(web): delegate overlay initial focus to popup owners by @lyzno1 in https://github.com/langgenius/dify/pull/42121
- chore: bump version to 1.17.1 by @wylswz in https://github.com/langgenius/dify/pull/42129
New Contributors
- @ccl125 made their first contribution in #39772
- @HelloSrauker made their first contribution in #41186
- @huyua9 made their first contribution in #41419
- @keith991001 made their first contribution in #41370
- @alanhuangyoo made their first contribution in #41327
- @ShousenZHANG made their first contribution in #41374
- @Terminator666666 made their first contribution in #41244
- @lin597410-design made their first contribution in #41454
- @jjj-n made their first contribution in #41464
- @LuckTerence made their first contribution in #41319
- @elyar1124 made their first contribution in #41568
- @kabishou11 made their first contribution in #41719
- @jrlprost made their first contribution in #41658
- @ayush-singh-0601 made their first contribution in #41756
- @Kiveiru3 made their first contribution in #41847
- @XiaoSong1223 made their first contribution in #41878
- @however-yir made their first contribution in #41885
- @anneheartrecord made their first contribution in #40379
- @yuki-uix made their first contribution in #41859
- @ShawYann made their first contribution in #41831
- @Java123456com made their first contribution in #41856
- @GYJ99 made their first contribution in #41463
- @nehal-a2z made their first contribution in #42000
- @wr-Jiao made their first contribution in #41819
- @dudanogueira made their first contribution in https://github.com/langgenius/dify/pull/38214
- @Babulubobo made their first contribution in https://github.com/langgenius/dify/pull/42085
Full Changelog: 1.17.0...1.17.1
AI summary Agent sandbox, snapshots, and reusable skill management added
New Features
Agent: E2B Sandbox, Home Snapshots, and Skill Management
- E2B sandbox backend: agent shell/code execution can now run on E2B cloud sandboxes in addition to the local sandbox. Select the backend with
DIFY_AGENT_RUNTIME_BACKEND; a newdocker-compose.e2b.yamlships the E2B stack, E2B traffic is authenticated, and the E2B template is synced on release (#39480, #39705, #39873, #39996, #40858, #40871, #40891, #40892). - Build-time Home Snapshots: when an agent build is applied (published), the agent's sandbox home directory — installed packages, prepared files, working state — is captured and subsequent runs of the published agent restore their home directory from that snapshot, so the agent starts from the exact filesystem state it had at build time. (#39702, #40876, #40996).
- Workspace-level Skill management: Skills are reusable, versioned capabilities packaged with code and tool definitions that agents can discover and invoke. A new workspace-level skills manager with draft → publish → version lifecycle ships alongside a web UI (skill listing, builder panel, file editor). (#39675, #39798, #39799, #41180).
- Context-aware history compaction: long agent conversations no longer blow past the model's context window — Dify resolves each model's effective window and tiers compaction (clear old tool results first, then summarize older history) so runs stay within budget without losing recent context (#40872).
Reusable LLM Environment Variables in Workflows
- Define a shared provider/model/mode/parameter configuration once (e.g.
for_summarize,for_research) and reference it from any LLM node. Coordinated model changes now happen in one place instead of drifting node-by-node, and the references survive DSL import/export, snippets, RAG pipelines, and collaborative editing (#39125).
Human Input in Loops and Iterations
- Human-in-the-loop forms now work inside Loop and Iteration nodes, pausing and resuming correctly across page refreshes for both debug and installed apps — enabling review/approval steps within repeated work (#39243).
Provider-Neutral Unified Tracing
- Opt-in unified tracing (
OPS_TRACE_UNIFIED_ENABLED) assembles the full parent-child span tree (workflows, chatflows, messages, nodes, loops, iterations, nested workflows) once in core and delegates only transport to lightweight adapters. Phoenix and LangSmith adapters ship first; disabled by default and fully backward compatible (#39451). - New GenAI spans surface LLM TTFT, agent ReAct steps, tool calls, and failed LLM nodes for deeper observability (#39339).
Cloudflare Turnstile (CAPTCHA) Support
- Optional Turnstile challenge on sign-in and email-code login to protect authentication endpoints from abuse, with configurable site/secret keys and allowed hostnames (#40494).
Azure Key Vault / Pluggable KMS
- Introduces a KMS provider abstraction with Azure Key Vault support for key provisioning, encryption, and decryption, plus key rotation configuration — a step toward externally-managed encryption keys (#39933).
TiDB Vector Full-Text & Hybrid Search
- TiDB Vector deployments can now enable full-text and hybrid retrieval (
TIDB_VECTOR_ENABLE_FULLTEXT_SEARCH, default off), using a multilingual full-text index alongside vector search (#38112).
Broader Model & File Handling
- LLM nodes and agents can now pass image files directly to multimodal models, and non-vision attachments are no longer silently dropped from agent chats (#39848, #40179).
- New multimodal retrieval guidance helps users pick embedding models correctly for image-bearing knowledge bases (#40566).
- Audio ASR now accepts
audio/x-m4a, and audio MIME types are validated more accurately (#40776, #41043).
Go to Anything (⌘K / Ctrl+K)
- Press ⌘K (Ctrl+K on Windows/Linux) anywhere in the console to open the command palette and jump to apps, agents, skills, knowledge bases, plugins, or workflow nodes, or trigger quick actions via slash commands. New in this release: agents and skills are searchable, and the icon-command system was refactored across all domains for consistency (#40620, #40621, #40646–#40649, #41160).
Other Additions
- ODT (OpenDocument Text) document extraction support (#39973).
- New
date/date-pickerparameter type for tool plugins (#36163). - Lao (lo-LA) language support (#39474).
- Automatic cleanup task for old conversations (
ENABLE_CONVERSATION_CLEANUP_TASK) to bound data growth (#40889-era). - Marketplace embedded directly into integration categories for smoother tool/plugin discovery (#40744).
Improvements
Accessibility (large a11y pass)
- A very large set of changes makes the console keyboard- and screen-reader-friendly: real
<button>semantics for dozens of interactive controls, accessible names for icon-only actions (copy, close, delete, menus), primary headings on auth/install pages, keyboard-accessible member/tool selectors, and correct ARIA states (#40192–#40377 and many others).
Workflow Authoring
- The workflow generator now prefers already-installed and configured tools when suggesting nodes, so builders reach for the tools they actually have (#40611, #39850).
Workflow & Runtime Stability
- Reproducible web workflow runs, preserved canvas state after history updates, no more refresh render loops, and SSE streams now end cleanly on terminal events (#40010, #40489, #41105, #40042).
stopis now honored between non-streaming nodes and paused workflows clear stale cancellation signals correctly (#41090, #40905, #40972).APP_MAX_EXECUTION_TIMEandWORKFLOW_MAX_EXECUTION_TIMEdefaults raised from 1200s → 3600s to accommodate longer-running workflows.
Internal Quality
- Large migration of unit tests to real ORM models / SQLite sessions for more reliable coverage, plus stronger typing across migrated tests (many #38xxx–#39xxx). No user-facing behavior change.
Security Enhancements
- Authentication hardening: Turnstile challenge on login/email-code flows, hardened email-code verification with attempt limits and token expiry (
EMAIL_CODE_LOGIN_MAX_ATTEMPTS,EMAIL_CODE_LOGIN_TOKEN_EXPIRY_MINUTES), suspended-email-domain handling, and short-lived agent authorization tokens (#40494, #40960, #41004, #40884). - Access-control / ownership scoping: dataset, document, RAG, conversation, workspace-credential, and OAuth-client resources are now consistently bound to their owners and app scope, closing several unauthorized-access paths (#40989, #40888, #40790, #40745, #40893, #40786, and related).
- SSRF & outbound hardening: outbound HTTP connect phases are bounded (5s), agent/binding download and run timeouts are configurable, and the SSRF-blocked error message now points to the correct issue (#40807, #41027, #40605).
Bug Fixes (selected)
- Prevent dropped
workflow_startedevents in Redis Streams and dropped/duplicated runs from superseded executions (#40964, #40699). - Normalize workflow timestamps to naive UTC and preserve run snapshots/history for failed, cancelled, and interrupted runs (#40947, #40876, #40972).
- Prevent cross-tab chat conversation switching and stop dropping non-vision attachments in agent chat (#40709, #40179).
- Correct Qwen/VL system-message ordering by merging system messages first (#39136).
- Fix Elasticsearch-JA adapter
document_idmapping andVectorType(#40400); avoid empty Bedrock schema fields (#40443). - Use dynamic DNS resolution for all nginx upstreams (#39155); preserve UTF-8 byte size for text uploads (#40034).
- Numerous webapp/UI fixes: restore email-code and password form submissions, mobile sign-in overflow, toast stacking, model selector spacing (#40227, #40222, #40921, #40970, #8d612895).
Environment Variable Changes
Added
Agent runtime / sandbox (docker/envs/core-services/dify-agent.env.example)
DIFY_AGENT_RUNTIME_BACKEND,DIFY_AGENT_RUN_TIMEOUT_SECONDS,DIFY_AGENT_SANDBOX_FILES_BASE_URL,DIFY_AGENT_STUB_UPLOAD_FILE_SIZE_LIMIT,DIFY_AGENT_BINDING_FILE_DOWNLOAD_COMMAND_TIMEOUT_SECONDS- E2B:
DIFY_AGENT_E2B_API_KEY,DIFY_AGENT_E2B_TEMPLATE,DIFY_AGENT_E2B_SHELLCTL_PORT,DIFY_AGENT_E2B_ACTIVE_TIMEOUT_SECONDS - Local sandbox:
DIFY_AGENT_LOCAL_SANDBOX_ENDPOINT,DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN - Outbound HTTP tuning:
DIFY_AGENT_OUTBOUND_HTTP_CONNECT_TIMEOUT,DIFY_AGENT_OUTBOUND_HTTP_READ_TIMEOUT,DIFY_AGENT_OUTBOUND_HTTP_WRITE_TIMEOUT,DIFY_AGENT_OUTBOUND_HTTP_POOL_TIMEOUT,DIFY_AGENT_OUTBOUND_HTTP_KEEPALIVE_EXPIRY,DIFY_AGENT_OUTBOUND_HTTP_MAX_CONNECTIONS,DIFY_AGENT_OUTBOUND_HTTP_MAX_KEEPALIVE_CONNECTIONS AGENT_BACKEND_BINDING_FILE_DOWNLOAD_TIMEOUT_SECONDS,AGENT_BACKEND_HOME_SNAPSHOT_TIMEOUT_SECONDS(api/.env.example)
Auth / security
TURNSTILE_SITE_KEY,TURNSTILE_SECRET_KEY,TURNSTILE_ALLOWED_HOSTNAMES,TURNSTILE_EMAIL_CODE_VERIFY_REQUIREDEMAIL_CODE_LOGIN_MAX_ATTEMPTS,EMAIL_CODE_LOGIN_TOKEN_EXPIRY_MINUTESKEY_PROVIDER_TYPE,AZURE_KEYVAULT_VAULT_URL,AZURE_KEYVAULT_KEY_SIZE,AZURE_KEYVAULT_ROTATION_INTERVAL_DAYS
Knowledge / retrieval
TIDB_VECTOR_ENABLE_FULLTEXT_SEARCH,TIDB_ON_QDRANT_ESTIMATED_STORAGE_LIMITS_MB,KNOWLEDGE_UPLOAD_FILE_SIZE_LIMIT_FOR_PAID_PLAN
Tracing / observability
OPS_TRACE_UNIFIED_ENABLED,OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS
Misc
ENABLE_CONVERSATION_CLEANUP_TASK,CONVERSATION_CLEANUP_TASK_INTERVAL,CONVERSATION_CLEANUP_BATCH_SIZEUPLOAD_SKILL_FILE_SIZE_LIMIT,PLUGIN_MAX_FILE_SIZE,MARKDOWN_FORM_FIELD_NAME_EXTRA_CHARSDEPLOYMENT_EDITION(replacesEDITION, see below)
Removed
EDITION→ renamed toDEPLOYMENT_EDITIONENTERPRISE_ENABLED(enterprise gating consolidated)AGENT_BACKEND_RUN_TIMEOUT_SECONDS→ replaced byDIFY_AGENT_RUN_TIMEOUT_SECONDSDIFY_AGENT_SHELLCTL_AUTH_TOKEN,DIFY_AGENT_SHELLCTL_ENTRYPOINT(agent runtime reworked)
Modified (default values)
APP_MAX_EXECUTION_TIME:1200→3600WORKFLOW_MAX_EXECUTION_TIME:1200→3600OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES:60→780GRAPH_ENGINE_SCALE_UP_THRESHOLD:3→0
Docker Compose
docker/docker-compose.yaml— modifieddocker/docker-compose.middleware.yaml— modifieddocker/docker-compose.e2b.yaml— new (E2B agent sandbox stack)
Database Migrations
This release includes new migrations (community-edition relevant):
add_workflow_version_number— workflow version numbering (deployment v2)add_oauth_provider_app_auto_authorize— silent OAuth authorization flagadd_conversation_cleanup_index— supports the conversation cleanup taskadd_workspace_skill_management— workspace-level Skill management (draft/version/publish lifecycle)add_agent_home_snapshot_ledger,make_home_snapshot_references_nullable— agent build-time Home Snapshot ledger and nullable snapshot referencesreplace_agent_runtime_sessions_with_*,remove_agent_drive,clean_legacy_agent_soul_files,simplify_agent_v2_output_contract— new agent runtime
No manual backfill command is required for these migrations. Run flask db upgrade as part of the upgrade.
Upgrade Guide
Model Type Migration
Important
One-time legacy model type migration for self-hosted upgrades
If this deployment was upgraded from a Dify version earlier than 1.15.0 and this migration has not already been applied, run it after upgrading.
This migration is not included in flask db upgrade. Without it, legacy model records can cause model-related API requests to fail with errors, preventing affected models from being loaded or used.
Back up the database before applying the migration. The command runs in dry-run mode by default; review the output before rerunning it with --apply. The migration is idempotent and can be safely rerun.
Docker Compose
Run from the docker directory.
# Apply after reviewing the dry-run output docker compose exec -T api flask data-migrate legacy-model-types --apply \ > legacy-model-types-apply.jsonl
Source Code Deployment
Run from the repository root after completing flask db upgrade.
# Apply after reviewing the dry-run output uv run --project api flask data-migrate legacy-model-types --apply \ > legacy-model-types-apply.jsonl
After applying the migration, run the dry-run command again. If it reports no additional row updates or deletions, restart the relevant services and verify that existing models can be loaded and invoked successfully.
Important
- This release includes new database migrations — run them as part of the upgrade.
- Environment variables changed substantially (many added, edition variable renamed
EDITION→DEPLOYMENT_EDITION, several defaults changed). Review the Environment Variable Changes section and update your.envaccordingly. In particular, renameEDITIONtoDEPLOYMENT_EDITIONif you set it. - Docker Compose configuration changed and a new
docker-compose.e2b.yamlwas added. If you maintain a customizeddocker-compose.yaml, re-apply local customizations carefully. - The migration
add_conversation_cleanup_indexbuilds index on existing data, which could take longer to execute if theconversationstable is big.
Docker Compose Deployments
- Back up your customized compose and env files:
cd docker cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak cp .env .env.$(date +%s).bak 2>/dev/null || true
- Get the latest code:
git fetch --tags git checkout main # or the target release tag once cut - Stop services (from the
dockerdirectory):docker compose down
- Back up data:
tar -cvf volumes-$(date +%s).tgz volumes - Review env changes and re-apply local customizations (remember
EDITION→DEPLOYMENT_EDITION). - Upgrade:
docker compose up -d
Source Code Deployments
- Stop the API server, Worker, and Web frontend.
- Get the latest code:
git fetch --tags git checkout main # or the target release tag once cut - Update Python dependencies:
cd api uv sync - Run migrations:
uv run flask db upgrade
- Rebuild/restart the Web frontend, then restart the API server and Worker.
What's Changed
- test: use SQLite sessions in services plugin by @asukaminato0721 in #39084
- test: separate human input unit and database paths by @escape0707 in #39655
- test: use SQLite sessions in services core by @asukaminato0721 in #39088
- test: use SQLite sessions in controllers service api by @asukaminato0721 in #39098
- test: use SQLite sessions in services core by @asukaminato0721 in #39090
- test: move message cleanup coverage to unit tests by @asukaminato0721 in #38932
- test: use sqlite3 session in test_plugin_service by @asukaminato0721 in #38727
- test: use sqlite3 session in test_wraps by @asukaminato0721 in #38770
- test: use SQLite sessions in commands by @asukaminato0721 in #39080
- test: move data source controller coverage to unit tests by @asukaminato0721 in #38924
- fix: prevent Safari from clipping the settings close button by @iamjoel in #39664
- fix: prevent the model selector footer from covering options by @iamjoel in #39668
- test: move OAuth server service coverage to unit tests by @asukaminato0721 in #38931
- fix: validate plugin installation scope by @lyzno1 in #39669
- chore: improve archived logs hint in logs list page by @hjlarry in #39659
- test: use SQLite sessions in core app by @asukaminato0721 in #39099
- test: use SQLite sessions in core datasource by @asukaminato0721 in #39104
- test: use SQLite in LangSmith traces by @asukaminato0721 in #38986
- test: move workflow app service coverage to unit tests by @asukaminato0721 in #38946
- chore(docker): remove redundant feature preview env by @laipz8200 in #39035
- test: use SQLite in Aliyun trace utilities by @asukaminato0721 in #38983
- test: use SQLite sessions in services retention by @asukaminato0721 in #39074
- test: use SQLite sessions in core rag by @asukaminato0721 in #39105
- fix: reject trailing newlines in alphanumeric() validator (#39666) by @Harsh23Kashyap in #39667
- test: use SQLite sessions in core app apps by @asukaminato0721 in #39103
- chore(i18n): sync translations with en-US by @github-actions[bot] in #39671
- test: use sqlite3 session in test_agent_app_feature_service by @asukaminato0721 in #38724
- test: use sqlite3 session in test_web_login by @asukaminato0721 in #38725
- fix: improve unconfigured agent guidance by @iamjoel in #39676
- fix: populate completion_params from model schema defaults in Agent node by @rkfshakti in #39590
- ci: wait for KnowledgeFS before deployment by @JohnJyong in #39677
- chore: bump nltk from 3.9.4 to 3.10.0 in /api by @dependabot[bot] in #39503
- feat: add missing plugin installation to agent DSL imports by @iamjoel in #39680
- ci: replace custom noqa markers with guard ignores by @escape0707 in #39679
- ci: enforce strict checks for unit tests by @escape0707 in #39682
- refactor(web): derive workspace billing from current workspace by @lyzno1 in #39674
- feat: label agent conversation reset action on hover by @iamjoel in #39691
- chore(deps): bump gitpython from 3.1.54 to 3.1.57 in /api by @wylswz in #39684
- refactor: introduce agent working environment architecture by @BeautyyuYanli in #39480
- test(e2e): align Agent tool credential states by @lyzno1 in #39698
- test: enforce strict typing in migrated unit tests by @escape0707 in #39689
- test: share unbound unit test sessions by @escape0707 in #39690
- refactor(e2e): unify seeded runtime orchestration by @lyzno1 in #39700
- chore(deps): bump starlette, soupsieve, cryptography for CVE fixes by @GareArc in #39716
- feat(agent): make home snapshots optional and use backend defaults by @BeautyyuYanli in #39702
- chore: add E2B sync and tini supervision by @BeautyyuYanli in #39705
- chore(deps): bump wandb 0.28.0 -> 0.28.1 for CVE fix attempt by @GareArc in #39718
- fix(web): gate plugin auth permission hint by @hjlarry in #39721
- refactor(web): remove workflow node useBoolean usage by @lyzno1 in #39729
- test: use sqlite3 session in test_workflow_pause_events by @asukaminato0721 in #38688
- test: use sqlite3 session in test_human_input_timeout_tasks by @asukaminato0721 in #38703
- test: use sqlite3 session in test_metadata_bug_complete by @asukaminato0721 in #38721
- test: use sqlite3 session in test_sqlalchemy_workflow_execution_repository by @asukaminato0721 in #38761
- test: use sqlite3 session in test_session by @asukaminato0721 in #38772
- test: use SQLite sessions in core tools by @asukaminato0721 in #39107
- test: use SQLite sessions in libs by @asukaminato0721 in #39089
- test: use SQLite sessions in core rag by @asukaminato0721 in #39106
- refactor(web): consolidate settings state in URL by @lyzno1 in #39740
- fix: handle unconfigured LLM workflow streams by @linw1995 in #39741
- fix: avoid returning unused vectors in TiDB on Qdrant search by @hjlarry in #39744
- fix: display workflow run errors in the result panel by @iamjoel in #39746
- refactor(web): clarify education state ownership by @lyzno1 in #39748
- fix(web): force render dialog backdrop and use dialog description in education verify modal by @lyzno1 in #39749
- test: move service dataset controller coverage to unit tests by @asukaminato0721 in #38941
- test: use SQLite sessions in core app by @asukaminato0721 in #39100
- fix(docker): mount shared storage volume in api_websocket by @dparkmit24 in #39424
- test: use SQLite in Tencent traces by @asukaminato0721 in #38988
- fix(web): show API errors when agent publishing fails by @iamjoel in #39756
- chore: paginate installed apps by @hjlarry in #39739
- test: migrate account service tests to shared SQLite by @escape0707 in #39758
- chore: canonicalize Tailwind classes by @hyoban in #39762
- fix: fix hardcode /home/dify by @fatelei in #39767
- fix(matrixone): generate ids for every document by @csurong in #39734
- fix: refactor account about dialog ownership by @lyzno1 in #39765
- fix(plugin): preserve credentials during local replacement by @zyssyz123 in #39764
- fix(socketio): omit socket_timeout from RedisManager pub/sub options by @sergioperezcheco in #39587
- fix: allow an empty Agent tools selection by @zyz619963502zyz in #39695
- fix(api): delete custom models stored with legacy model_type values by @Souravrajvi0 in #39708
- fix(web): constrain slash picker triggers by @lyzno1 in #39768
- test: use SQLite sessions in services tools by @asukaminato0721 in #39063
- test: use SQLite sessions in services data_migration by @asukaminato0721 in #39065
- test: use SQLite sessions in rag pipeline transform by @asukaminato0721 in #39050
- test: use sqlite3 session in test_completion_completion_app_generator by @asukaminato0721 in #38723
- test: use SQLite sessions in core repositories by @asukaminato0721 in #39067
- test: use SQLite sessions in core repositories by @asukaminato0721 in #39073
- test: use SQLite sessions in services workflow by @asukaminato0721 in #39091
- test: use SQLite sessions in core rag by @asukaminato0721 in #39092
- test: use SQLite sessions in controllers console app by @asukaminato0721 in #39095
- test: use SQLite sessions in controllers console app by @asukaminato0721 in #39097
- test: use SQLite sessions in core app apps by @asukaminato0721 in #39101
- test: use SQLite sessions in core app apps by @asukaminato0721 in #39102
- fix(api): prevent HITL pause from aborting workflow resume by @Success6666 in #39485
- fix: open inline agent editor from checklist warnings by @iamjoel in #39781
- test: use SQLite in Langfuse traces by @asukaminato0721 in #38985
- test: use SQLite in Opik traces by @asukaminato0721 in #38987
- test: use SQLite sessions in core tools by @asukaminato0721 in #39094
- test: move RAG pipeline import coverage to unit tests by @asukaminato0721 in #38938
- test: use sqlite3 session in test_billing by @asukaminato0721 in #38722
- test: use sqlite3 session in test_factory by @asukaminato0721 in #38731
- test: use sqlite3 session in test_trial by @asukaminato0721 in #38732
- test: use sqlite3 session in test_workflow_node_execution_truncation by @asukaminato0721 in #38734
- test: use SQLite sessions in tasks by @asukaminato0721 in #39076
- fix(workflow): provide default values for AgentNodeData fields (#39743) by @loulanyue in #39754
- refactor(web): localize model load balancing modal state by @lyzno1 in #39789
- fix(chat): derive themes per chat root by @lyzno1 in #39790
- refactor(web): localize dataset external API state by @lyzno1 in #39791
- refactor(web): remove app log drawer context by @lyzno1 in #39792
- refactor(web): internalize trigger limit modal state by @lyzno1 in #39794
- refactor(web): localize retrieval method query by @lyzno1 in #39795
- refactor(web): remove configuration mitt context by @lyzno1 in #39796
- fix(web): isolate MCP card action overlays by @Jingyi-Dify in #39797
- feat: add upload size guidance and validation for agent files and skills by @iamjoel in #39798
- refactor(web): remove dead dataset operator context state by @lyzno1 in #39800
- refactor(web): remove stale header maximize state by @lyzno1 in #39801
- refactor(web): narrow app list context by @lyzno1 in #39802
- fix(ui): align select trigger focus ring by @lyzno1 in #39804
- feat: make skill package upload size limit configurable by @linw1995 in #39799
- test: use SQLite sessions in app DSL service tests by @escape0707 in #39803
- test: use caplog for telemetry error logging by @EvanYao826 in #39722
- refactor(dify-ui): govern public component APIs by @lyzno1 in #39806
- feat: change api/v1/plugins/download to api/v1/plugins/download-url by @fatelei in #39811
- refactor(web): align Base UI composition contracts by @lyzno1 in #39820
- docs: remove trailing whitespace in docker/README.md by @xiaoyaoqilan in #39808
- chore(api): consolidate chained .where() calls into single calls by @MannXo in #39819
- test: exercise credential visibility with SQLite by @escape0707 in #39827
- fix: refresh mcp server code by app id by @zhangx1n in #39828
- docs: fix typos in api comments and prompt example by @iridescentWen in #39838
- fix(api): silence opentelemetry.context error reports to Sentry on cloud by @MRZHUH in #39841
- fix(workflow): remap snippet references by @JzoNgKVO in #39843
- feat: prioritize configured tools in the agent prompt picker by @iamjoel in #39850
- fix(web): skip auth validation for local file datasource by @hjlarry in #39856
- fix(web): hide prompt log action in agent v2 logs by @lyzno1 in #39858
- refactor(ui): simplify scroll area API by @lyzno1 in #39857
- test: use SQLite sessions in services agent by @asukaminato0721 in #39054
- test: use SQLite sessions in core rag by @asukaminato0721 in #39055
- test: use SQLite sessions in core ops by @asukaminato0721 in #39062
- test: use SQLite sessions in core tools by @asukaminato0721 in #39068
- test: use SQLite sessions in core llm_generator by @asukaminato0721 in #39070
- test: use SQLite sessions in core repositories by @asukaminato0721 in #39078
- test: use SQLite sessions in core callback_handler by @asukaminato0721 in #39081
- test: use SQLite sessions in core workflow by @asukaminato0721 in #39086
- test: use SQLite sessions in services workflow by @asukaminato0721 in #39087
- fix(rag): add bounded timeout to Firecrawl extractor requests by @superdiaodiao in #39831
- fix(rag): add bounded timeout to Notion extractor requests by @superdiaodiao in #39833
- fix(auth): add bounded timeout to WaterCrawl credential validation by @superdiaodiao in #39824
- fix(web): align secondary sidebar help trigger by @lyzno1 in #39862
- fix(api): scope segment batch deletes by @WH-2099 in #38217
- chore(api): fix typos in config description and comment by @zyz619963502zyz in #39870
- fix(api): bound billing service HTTP timeouts (#39874) by @Harsh23Kashyap in #39875
- refactor(web): align Base UI state consumers by @lyzno1 in #39864
- fix(api): prevent cookies from shadowing admin API keys by @kenwoodjw in #39872
- fix(matrixone): apply score threshold to vector search by @csurong in #39784
- fix(api): bound JinaReader and adaptive-crawl HTTP timeouts (#39859) by @Harsh23Kashyap in #39860
- fix(api): make SSRF-blocked error message actionable by @Taranum01 in #39867
- test(web): remove Base UI component mocks by @lyzno1 in #39877
- perf(dataset): fix N+1 database insert bottleneck in Notion sync by @HassanRady in #39899
- fix(vdb-oceanbase): reject trailing newlines in metadata-key and document-id validators (#39884) by @Harsh23Kashyap in #39901
- feat(workflow): support human input in loop and iteration by @laipz8200 in #39243
- chore(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in #39909
- chore: pass session explicitly in ApiModeration by @HandSonic in #39885
- fix(web): clarify member permission exception copy by @WTW0313 in #39917
- chore: keep dify-agent env same with dify by @fatelei in #39918
- fix(api): stop echoing the raw api_key in the 403 error message (#39888) by @Harsh23Kashyap in #39902
- fix(dify-agent): stabilize E2B config materialization by @zhaohao1004 in #39873
- chore: bump pyrefly version by @asukaminato0721 in #39876
- feat: pass image file to llm by @fatelei in #39848
- fix: keep colons in HTTP node form body values on migration by @weijun-xia in #38861
- fix(dify-agent): atomically finalize run terminals by @zhaohao1004 in #39929
- fix(web): improve home accessibility by @lyzno1 in #39938
- fix(web): remove Web Apps loading skeleton by @lyzno1 in #39939
- test: use SQLite sessions in web controller fixtures by @asukaminato0721 in #39052
- test: use SQLite sessions in rag pipeline dsl by @asukaminato0721 in #39053
- test: use SQLite sessions in controllers service api by @asukaminato0721 in #39059
- test: use SQLite sessions in controllers console explore by @asukaminato0721 in #39064
- test: use SQLite sessions in core test_provider_manager.py by @asukaminato0721 in #39071
- test: use SQLite sessions in core app apps by @asukaminato0721 in #39079
- fix(web): improve main navigation responsiveness and tour focus by @lyzno1 in #39940
- perf(web): streaming ssr for home page by @lyzno1 in #39922
- fix(api): bump OpenTelemetry to stop duplicate Flask context detach by @GareArc in #39921
- fix(api): validate installation scope for cached marketplace packages by @GareArc in #39935
- feat(api): isolate credentials from local packages by @linw1995 in #39957
- chore(deps): bump cryptography from 49.0.0 to 50.0.0 in /dify-agent by @dependabot[bot] in #39958
- fix(dify-agent): keep tmux server alive without sessions by @BeautyyuYanli in #39943
- fix(dify-agent): make run cancellation route-independent by @BeautyyuYanli in #39942
- chore(deps): bump aiohttp from 3.14.1 to 3.14.3 in /api by @dependabot[bot] in #39959
- fix(vdb): bound the TiDB Cloud API timeouts by @he-yufeng in #39953
- chore(deps): bump the vdb group with 9 updates by @dependabot[bot] in #39911
- refactor(workflow): move AgentNode events out of graphon by @laipz8200 in #39845
- chore(web): upgrade Next.js to 16.3 by @lyzno1 in #39962
- fix(api): allow external knowledge base creation under enterprise RBAC by @GareArc in #39930
- fix(dify-ui): improve select and status dot accessibility by @lyzno1 in #39971
- chore(docker): move optional settings to service envs by @laipz8200 in #39970
- feat(workflow): support LLM environment variables by @laipz8200 in #39125
- fix: align build and preview chat layouts by @iamjoel in #39980
- fix(workflow): avoid app context dependency in parallel iteration by @hjlarry in #39983
- fix(api): surface system quota exhaustion without fallback by @linw1995 in #39986
- fix(ui): align button spacing with design by @lyzno1 in #39990
- test: use sqlite3 session in test_if_else by @asukaminato0721 in #38753
- test: use sqlite3 session in test_qa_index_processor by @asukaminato0721 in #38765
- chore(api): remove unreachable match suppressions by @nightcityblade in #39949
- feat(agent): separate CLI file URL audiences by @BeautyyuYanli in #39952
- fix(agent): expose feedback in agent logs by @zyssyz123 in #39994
- fix(e2e): configure sandbox-reachable API URL by @lyzno1 in #40005
- refactor(api): extract workspace list into layered application service by @41tair in #39822
- fix(web): preserve feedback state on submission failure by @lyzno1 in #40004
- test: use SQLite in Arize Phoenix traces by @asukaminato0721 in #38984
- chore(deps): upgrade Base UI to 1.7.0 by @lyzno1 in #40006
- fix(ci): harden Playwright browser installs by @lyzno1 in #40009
- fix(ci): make web workflows reproducible by @lyzno1 in #40010
- chore: add copy action to workflow log errors by @iamjoel in #40011
- refactor(web): simplify tag selector trigger by @lyzno1 in #40014
- refactor(web): remove duplicate dataset title update by @lyzno1 in #40023
- fix(web): remove misleading ARIA states by @lyzno1 in #40015
- refactor(web): align query client ownership by @lyzno1 in #40024
- refactor(web): derive system feature enums from schemas by @lyzno1 in #40030
- test: use sqlite3 session in test_credit_pool_service by @asukaminato0721 in #38694
- test: use sqlite3 session in test_agent_config_service by @asukaminato0721 in #38764
- fix(web): improve debug plugin copy accessibility by @linw1995 in #40035
- test: use real ORM models in RAG indexing tests by @asukaminato0721 in #40017
- fix(dify-agent): wait for E2B shellctl readiness by @BeautyyuYanli in #39996
- fix(web): refresh model provider plugins after updates by @Jingyi-Dify in #40002
- fix(web): redirect legacy plugin fallbacks by @Jingyi-Dify in #40051
- refactor(api): extract workspace member listing into layered service by @escape0707 in #39974
- fix: make document retry batches consistent by @csurong in #39978
- fix: preserve UTF-8 byte size for text uploads by @pineapple880066 in #40034
- chore: more upload file size for paid user by @hjlarry in #39967
- fix(api): allow account avatars across workspaces by @CodeWarriors0 in #40055
- test: use SQLite sessions in core tools by @asukaminato0721 in #39108
- test: use real ORM models in workflow repository tests by @asukaminato0721 in #40019
- test: use SQLite sessions in services core by @asukaminato0721 in #39058
- fix: offset legacy app error toasts below model controls by @iamjoel in #40040
- test: use real ORM models in dataset service tests by @asukaminato0721 in #40018
- fix: hide log detail actions for legacy app logs by @iamjoel in #40057
- test: use real ORM models in app and API tests by @asukaminato0721 in #40020
- test: use SQLite sessions in core app apps by @asukaminato0721 in #39083
- test: move webhook service coverage to unit tests by @asukaminato0721 in #38945
- test: use SQLite sessions in clean dataset by @asukaminato0721 in #39051
- refactor(system-features): derive nullable SSO protocol by @lyzno1 in #40063
- test: use SQLite sessions in core entities by @asukaminato0721 in #39056
- test: use SQLite sessions in controllers console auth by @asukaminato0721 in #39060
- test: use SQLite sessions in commands by @asukaminato0721 in #39082
- test: use SQLite sessions in controllers console app by @asukaminato0721 in #39096
- fix(web): improve markdown form rendering by @WTW0313 in #40070
- test: use SQLite sessions in core repositories by @asukaminato0721 in #39061
- feat(trace-aliyun): GenAI spans for LLM TTFT, agent ReAct, tools, and failed LLM nodes by @123liuziming in #39339
- chore: upgrade workspace dependencies by @lyzno1 in #40069
- fix(e2e): align marketplace plugin download URL by @lyzno1 in #40075
- fix(web): only open slash variable picker when / is typed (#39755) by @Souravrajvi0 in #39761
- chore: format GitHub metadata with Oxfmt by @lyzno1 in #40073
- fix: get role and list role need filter billing permission key by @fatelei in #38218
- fix(web): register audio listeners on real media events by @eldardada in #37841
- feat: Add Lao (lo-LA) language support #39489 by @bounkirdni-2025 in #39474
- feat: support TiDB Vector full-text and hybrid search by @bkidy in #38112
- chore(web): remove obsolete PWA assets by @lyzno1 in #40082
- fix: report unavailable agent tools in publish and workflow checks by @iamjoel in #40077
- chore(i18n): sync translations with en-US by @github-actions[bot] in #40096
- chore: remove obsolete development docs by @lyzno1 in #40098
- test: use sqlite3 session in test_external_dataset_service by @asukaminato0721 in #38696
- test: use SQLite sessions in datasource files by @asukaminato0721 in #39048
- fix(ci): switch Playwright jobs to Azure Ubuntu mirror by @lyzno1 in #40100
- revert(web): remove redundant slash picker intent tracking by @lyzno1 in #40103
- fix(dify-agent): end SSE streams on terminal events by @BeautyyuYanli in #40042
- fix(dify-agent): align agent and shell execution limits by @BeautyyuYanli in #40043
- fix: gate Agent access until first publish by @zyssyz123 in #40105
- feat: support azure keyvault by @wylswz in #39933
- refactor(api): decouple console queries through application services by @41tair in #40031
- test(e2e): align duplicate Agent publish state by @lyzno1 in #40108
- feat: optimize integrations initial loading by @Jingyi-Dify in #40118
- refactor(web): modernize Studio app list data flow by @lyzno1 in #40109
- feat: make the console license expiry badge optional by @GareArc in #39972
- chore: improve current workspace summary by @hjlarry in #40121
- fix(web): enforce frame ancestors on protected routes by @lyzno1 in #40124
- test: use sqlite sessions at generation boundaries by @asukaminato0721 in #40095
- test: migrate document indexing task sessions to SQLite by @asukaminato0721 in #40092
- test: migrate console app sessions to SQLite by @asukaminato0721 in #40081
- refactor(api): move license expiry notice flag onto license detail by @GareArc in #40128
- fix(web): scope hidden outlines to focus-visible by @lyzno1 in #40130
- refactor(web): simplify billing portal link by @lyzno1 in #40131
- docs: Fixes Star History chart by @Mubelotix in #40115
- refactor(web): localize education status query by @lyzno1 in #40132
- chore: bump plugin daemon image by @hjlarry in #40134
- refactor(dify-agent): make config pulls direct and remove gRPC by @BeautyyuYanli in #40044
- chore: use multi-arch plugin daemon image tag by @hjlarry in #40139
- chore(web): add dedicated home loading boundary by @lyzno1 in #40135
- perf(web): prefetch app links on intent by @lyzno1 in #40133
- fix: show inline agent build draft change details by @iamjoel in #40140
- chore: dep inject for model in notification dismiss by @likalikali in #40146
- fix(api): scope temporary capabilities to owners by @WH-2099 in #39863
- chore(web): remove unreachable explore sidebar by @lyzno1 in #40136
- fix: improve readability of DSL import warnings by @iamjoel in #40148
- chore(i18n): sync translations with en-US by @github-actions[bot] in #40150
- feat: support accessibility checks in CI by @iamjoel in #40137
- feat(dify-agent): propagate run limit error types by @BeautyyuYanli in #40116
- chore: dep inject for model in datasets document and web human input … by @likalikali in #40151
- chore: dep inject for model in oauth server by @likalikali in #40147
- chore: dep inject for model in api based extension by @likalikali in #40154
- chore: dep inject for model in website crawl api by @likalikali in #40156
- chore: dep inject for model in tags, mcp server, and data source auth by @likalikali in #40159
- chore: dep inject for model in workflow run archive download by @likalikali in #40157
- chore: dep inject for model in onboarding step by step tour by @likalikali in #40155
- chore: dep inject for model in workspace snippets, load balancing, and endpoint by @likalikali in #40161
- chore: dep inject for model in agent app sandbox upload by @likalikali in #40153
- refactor(dify-agent): download Binding files through Agent Stub by @BeautyyuYanli in #40143
- revert(web): use suspense boundary in home page by @lyzno1 in #40167
- chore: dep inject for model in explore apis by @likalikali in #40160
- chore: dep inject for model in explore workflow run by @likalikali in #40158
- refactor: replace manual model_validate with @model_validate decorator in app controllers by @likalikali in #40170
- fix(agent-v2): accept composer UI ids on manual metadata filter conditions by @chelsealong in #40171
- refactor(api): decouple setup and spec endpoints by @41tair in #40104
- test: move RAG pipeline workflow coverage to unit tests by @asukaminato0721 in #38937
- chore: Remove redundant dataset context string conversions by @medisean in #40189
- fix(workflow): fall back when default socket is unavailable by @hjlarry in #40191
- refactor: replace manual model_validate with @model_validate in agent controllers by @likalikali in #40233
- refactor: replace manual model_validate with @model_validate in workspace plugin/tool controllers by @likalikali in #40238
- refactor: replace manual model_validate with @model_validate in auth/billing/tag controllers by @likalikali in #40240
- refactor: replace manual model_validate with @model_validate in explore/snippets controllers by @likalikali in #40241
- refactor: replace manual model_validate with @model_validate in app core controllers by @likalikali in #40234
- refactor: replace manual model_validate with @model_validate in app workflow controllers by @likalikali in #40235
- refactor: replace manual model_validate with @model_validate in rag_pipeline controllers by @likalikali in #40237
- refactor: replace manual model_validate with @model_validate in workspace remaining controllers by @likalikali in #40239
- refactor: replace manual model_validate with @model_validate in datasets controllers by @likalikali in #40236
- fix(agent): preserve plugin-declared model parameters through Agent Soul by @chelsealong in #40163
- fix(web): hide credential icons from assistive tech by @lyzno1 in #40376
- fix(web): associate app deletion confirmation label by @lyzno1 in #40375
- fix(web): remove workflow output title tab stop by @lyzno1 in #40377
- test: Type test by @asukaminato0721 in #40371
- refactor(web): unify infinite scroll sentinels by @lyzno1 in #40188
- fix(web): use primary headings on auth pages by @lyzno1 in #40192
- fix(web): use a primary heading on the install page by @lyzno1 in #40194
- fix(web): use a button for the webapp fallback action by @lyzno1 in #40197
- fix(web): use a button for unauthorized logout by @lyzno1 in #40198
- feat(api): cache remote recommended app template fetches by @Souravrajvi0 in #40176
- fix(web): name chat settings triggers by @lyzno1 in #40341
- fix(web): use button for tool detail toggle by @lyzno1 in #40349
- fix(web): hide citation measurement items from assistive tech by @lyzno1 in #40203
- fix(web): name chat history controls by @lyzno1 in #40344
- fix(web): name workflow debug actions by @lyzno1 in #40273
- fix(web): restore webapp password form submission by @lyzno1 in #40222
- fix(web): use button for chat variable panel close by @lyzno1 in #40333
- fix(web): make the human input expander a button by @lyzno1 in #40202
- fix(web): make the member selector keyboard accessible by @lyzno1 in #40209
- fix(web): make the scroll-to-node action a button by @lyzno1 in #40214
- fix(web): restore webapp email code form submission by @lyzno1 in #40227
- fix(web): restore the signup email focus order by @lyzno1 in #40230
- fix(web): expose the voice recording timer by @lyzno1 in #40205
- fix(web): name conversation menu triggers by @lyzno1 in #40253
- refactor(web): keep copy id events on the button by @lyzno1 in #40247
- fix(web): name dataset configuration actions by @lyzno1 in #40254
- fix(web): name annotation configuration action by @lyzno1 in #40255
- fix(web): make dataset sidebar menu items buttons by @lyzno1 in #40248
- fix(web): name annotation reply actions by @lyzno1 in #40270
- fix(web): name saved item actions by @lyzno1 in #40256
- fix(web): name workflow version history action by @lyzno1 in #40276
- fix(web): name snippet stop action by @lyzno1 in #40278
- fix(web): expose debug toolbar semantics by @lyzno1 in #40258
- fix(web): name human input delete action by @lyzno1 in #40293
- fix(web): name image previewer actions by @lyzno1 in #40283
- fix(web): expose workflow parallel toggle state by @lyzno1 in #40282
- fix(web): name variable inspect close actions by @lyzno1 in #40289
- fix(web): name agent log navigation menu by @lyzno1 in #40286
- fix(web): name code generator action by @lyzno1 in #40324
- fix(web): name external retrieval close action by @lyzno1 in #40317
- fix(web): name human input preview close by @lyzno1 in #40321
- fix(web): expose SVG preview toggle state by @lyzno1 in #40332
- fix(web): name prompt generator action by @lyzno1 in #40328
- refactor(web): rely on QR panel containment by @lyzno1 in #40352
- fix(web): name assigner add operation by @lyzno1 in #40337
- fix(web): use buttons for plugin type switch by @lyzno1 in #40353
- fix(web): use buttons for pricing categories by @lyzno1 in #40360
- fix(web): use button for provider tool item by @lyzno1 in #40362
- refactor(web): rely on preview dialog containment by @lyzno1 in #40363
- fix(web): use button for publisher access by @lyzno1 in #40361
- fix(web): use primary headings on password reset pages by @lyzno1 in #40193
- fix(web): make the citation toggle a button by @lyzno1 in #40204
- fix(web): name the snippet info menu trigger by @lyzno1 in #40251
- fix(web): name the plugin debug trigger by @lyzno1 in #40252
- chore: example to rm db.session by @asukaminato0721 in #40370
- fix(web): name generated result copy action by @lyzno1 in #40259
- fix(web): make verification back actions keyboard accessible by @lyzno1 in #40196
- fix(web): name OAuth redirect copy action by @lyzno1 in #40303
- fix(web): name plugin item actions by @lyzno1 in #40261
- fix(web): name plugin detail close action by @lyzno1 in #40264
- fix(web): name external API panel close by @lyzno1 in #40309
- fix(web): name external API modal close by @lyzno1 in #40313
- chore(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in #40391
- fix(api): end_date filter in feedback export excludes the entire end date by @agarwalpranav0711 in #40114
- fix: catch ValueError instead of bare except in account CLI commands by @chelsealong in #40356
- fix(web): name MCP header fields by @lyzno1 in #40299
- fix(web): make tool category filters keyboard accessible by @lyzno1 in #40243
- fix(web): use buttons for version filters by @lyzno1 in #40357
- chore(deps): bump pymdown-extensions from 11.0 to 11.0.1 in /dify-agent by @dependabot[bot] in #40183
- chore(deps): bump gitpython from 3.1.57 to 3.1.58 in /api by @dependabot[bot] in #40184
- fix(web): allow unlimited text input in trial apps by @hjlarry in #40403
- fix(web): expose chat variable tips state by @lyzno1 in #40334
- docs(web): add Next.js agent rules by @lyzno1 in #40398
- chore: tighten education verification and pause discount access by @iamjoel in #40402
- fix(web): name MCP header delete actions by @lyzno1 in #40300
- fix(web): name external API card actions by @lyzno1 in #40304
- fix(web): name secret key delete action by @lyzno1 in #40297
- fix(web): use button for workflow debug close by @lyzno1 in #40274
- fix(web): name endpoint card actions by @lyzno1 in #40260
- fix(web): make suggested questions native buttons by @lyzno1 in #40200
- refactor(web): migrate webapp password fields to dify ui by @lyzno1 in #40223
- fix(web): name the webapp password visibility action by @lyzno1 in #40225
- refactor(api): extract explore banner query service by @hjlarry in #40053
- test: migrate RAG index sessions to SQLite by @asukaminato0721 in #40080
- refactor(api): merge ping and version endpoints into system by @41tair in #40058
- test: migrate core app sessions to SQLite by @asukaminato0721 in #40084
- feat: add tool plugin param type date and date-picker by @zyqzyq in #36163
- fix: widen agent orchestration chat on large displays by @iamjoel in #40433
- chore(i18n): sync translations with en-US by @github-actions[bot] in #40435
- docs(web): clarify ref mutation ownership by @lyzno1 in #40426
- fix(web): keep shared ref updates out of render by @lyzno1 in #40427
- refactor(workflow): align standalone node execution layers by @linw1995 in #40447
- fix(web): keep workflow ref updates out of render by @lyzno1 in https://github.com/langgenius/dify/pull/40428
- chore: suppress pyrefly necessary conversions by @tusharmotwani1718 in https://github.com/langgenius/dify/pull/40444
- fix(docker): use dynamic DNS resolution for all nginx upstreams by @kanson1996 in https://github.com/langgenius/dify/pull/39155
- fix(web): keep agent ref updates out of render by @lyzno1 in https://github.com/langgenius/dify/pull/40429
- fix: _multiple_retrieve_thread not fail fast by @fatelei in https://github.com/langgenius/dify/pull/40466
- test: use sqlite sessions in rag pipeline coverage by @asukaminato0721 in https://github.com/langgenius/dify/pull/40093
- test: migrate dataset indexing task sessions to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40091
- test: migrate app service sessions to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40088
- fix: split sandbox files into saved and temporary tabs by @iamjoel in https://github.com/langgenius/dify/pull/40478
- test: migrate core RAG sessions to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40085
- test: migrate retention and task sessions to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40090
- fix: show a persistent toast for agent run timeouts by @iamjoel in https://github.com/langgenius/dify/pull/40486
- fix(web): preserve workflow canvas after history updates by @lyzno1 in https://github.com/langgenius/dify/pull/40489
- refactor(api): consolidate deployment edition handling by @41tair in https://github.com/langgenius/dify/pull/40142
- refactor(web): read app profile from query cache by @lyzno1 in https://github.com/langgenius/dify/pull/40467
- chore: bump cryptography, pypdf, h2 for CVE fixes by @wylswz in https://github.com/langgenius/dify/pull/40409
- fix(web): make legacy Home redirect permanent by @lyzno1 in https://github.com/langgenius/dify/pull/40492
- fix: add zh_Hans labels for builtin Audio provider and its tools by @zrh805 in https://github.com/langgenius/dify/pull/40408
- test: migrate controller sessions to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40083
- refactor(web): read dataset profile from query cache by @lyzno1 in https://github.com/langgenius/dify/pull/40468
- test: migrate snippet and vector sessions to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40089
- refactor(web): read workflow profile from query cache by @lyzno1 in https://github.com/langgenius/dify/pull/40469
- fix: improve agent working directory tab labels and tooltips by @iamjoel in https://github.com/langgenius/dify/pull/40496
- refactor(web): move education verification to dedicated routes by @lyzno1 in https://github.com/langgenius/dify/pull/40493
- refactor(web): read account profile from query cache by @lyzno1 in https://github.com/langgenius/dify/pull/40470
- chore: increase nofile ulimit for qdrant container by @typenoob in https://github.com/langgenius/dify/pull/40480
- refactor(web): read plugin profile from query cache by @lyzno1 in https://github.com/langgenius/dify/pull/40471
- refactor(web): align education autocomplete async behavior by @lyzno1 in https://github.com/langgenius/dify/pull/40500
- fix(api): bind dataset operations to owners by @WH-2099 in https://github.com/langgenius/dify/pull/40149
- feat: app deployment v2 by @WTW0313 in https://github.com/langgenius/dify/pull/39829
- refactor(web): sync amplitude from profile query by @lyzno1 in https://github.com/langgenius/dify/pull/40472
- refactor(web): sync zendesk from profile query by @lyzno1 in https://github.com/langgenius/dify/pull/40473
- feat: add trunstile by @zyssyz123 in https://github.com/langgenius/dify/pull/40494
- chore(i18n): sync translations with en-US by @github-actions[bot] in https://github.com/langgenius/dify/pull/40546
- fix(web): improve app deployment v2 accessibility by @WTW0313 in https://github.com/langgenius/dify/pull/40550
- refactor(web): remove profile bootstrap atom layer by @lyzno1 in https://github.com/langgenius/dify/pull/40474
- fix(agent-v2): stop dropping non-vision attachments from agent chat by @chelsealong in https://github.com/langgenius/dify/pull/40179
- feat(web): add multimodal retrieval guidance for Knowledge embedding models by @CyberPU2099 in https://github.com/langgenius/dify/pull/40566
- chore: add Docker configuration for the Turnstile site key by @iamjoel in https://github.com/langgenius/dify/pull/40569
- fix(api): bind remaining RAG resources to owners by @WH-2099 in https://github.com/langgenius/dify/pull/40503
- fix: restrict app deploy to explicit enterprise permission by @zhangx1n in https://github.com/langgenius/dify/pull/40564
- test: migrate agent app sandbox sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40568
- fix(web): restore app deletion autofill and knowledge scope label by @crazywoola in https://github.com/langgenius/dify/pull/40583
- fix(web): render workspace plan badge during SSR by @lyzno1 in https://github.com/langgenius/dify/pull/40581
- chore(i18n): sync translations with en-US by @github-actions[bot] in https://github.com/langgenius/dify/pull/40573
- test(web): remove brittle publisher lock test by @lyzno1 in https://github.com/langgenius/dify/pull/40592
- refactor(api): extract init validation into layered application service by @41tair in https://github.com/langgenius/dify/pull/40046
- refactor(web): remove deprecated deployments pages by @WTW0313 in https://github.com/langgenius/dify/pull/40593
- fix: fix create dataset with document miss rbac operation by @fatelei in https://github.com/langgenius/dify/pull/40599
- fix(rbac): grant member policies when a dataset is opened to the work… by @BenjaminX in https://github.com/langgenius/dify/pull/39735
- fix: enforce API key list permissions by @WH-2099 in https://github.com/langgenius/dify/pull/40516
- fix: meter hosted LLM invocations by @linw1995 in https://github.com/langgenius/dify/pull/40589
- feat(ui): add icon button primitive by @lyzno1 in https://github.com/langgenius/dify/pull/40616
- refactor(ui): adopt icon button in close controls by @lyzno1 in https://github.com/langgenius/dify/pull/40617
- refactor(web): migrate shared icon commands by @lyzno1 in https://github.com/langgenius/dify/pull/40620
- refactor(web): migrate domain icon commands by @lyzno1 in https://github.com/langgenius/dify/pull/40621
- feat(ui): expose base toggle composition by @lyzno1 in https://github.com/langgenius/dify/pull/40622
- test: migrate API workflow pause ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40669
- fix: hide knowledge retrieval from Agent V2 configuration by @iamjoel in https://github.com/langgenius/dify/pull/40679
- test: migrate residual ORM model stand-ins to real mappings by @asukaminato0721 in https://github.com/langgenius/dify/pull/40666
- test: migrate residual dataset and archive ORM models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40668
- test: migrate residual session factories to shared SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40665
- test: migrate workflow variable ORM model to real entity by @asukaminato0721 in https://github.com/langgenius/dify/pull/40664
- fix(ops): keep the path of self-hosted LangSmith and Weave endpoints by @GareArc in https://github.com/langgenius/dify/pull/40584
- fix: update Agent advanced settings copy by @iamjoel in https://github.com/langgenius/dify/pull/40682
- fix(ci): always report required style checks by @lyzno1 in https://github.com/langgenius/dify/pull/40684
- fix(e2e): skip hidden Agent knowledge E2E scenarios by @iamjoel in https://github.com/langgenius/dify/pull/40691
- test: migrate OpenTelemetry ORM identities to real models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40663
- test: migrate RAG dataset ORM contracts to real models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40662
- test: migrate residual controller ORM identities to real models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40661
- test: migrate reranker upload-file sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40659
- test: migrate app runner transaction sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40660
- test: migrate workflow tool-file ORM model to real entity by @asukaminato0721 in https://github.com/langgenius/dify/pull/40658
- test: migrate workflow node trace ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40657
- test: migrate conversation lifecycle sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40656
- fix(api): decouple response listeners from execution lifecycle by @zyssyz123 in https://github.com/langgenius/dify/pull/39813
- fix(agent): propagate resource collection failures by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40697
- fix(ci): prevent false failures from superseded runs by @lyzno1 in https://github.com/langgenius/dify/pull/40699
- refactor: resolve summary models through manager by @linw1995 in https://github.com/langgenius/dify/pull/40696
- chore: remove scope selection from the agent environment editor by @iamjoel in https://github.com/langgenius/dify/pull/40701
- refactor(web): migrate semantic icon controls by @lyzno1 in https://github.com/langgenius/dify/pull/40624
- refactor(web): migrate app icon commands by @lyzno1 in https://github.com/langgenius/dify/pull/40646
- refactor(web): migrate dataset icon commands by @lyzno1 in https://github.com/langgenius/dify/pull/40647
- refactor(web): migrate plugin icon commands by @lyzno1 in https://github.com/langgenius/dify/pull/40648
- refactor(web): migrate workflow icon commands by @lyzno1 in https://github.com/langgenius/dify/pull/40649
- refactor(web): migrate help menu icon trigger by @lyzno1 in https://github.com/langgenius/dify/pull/40650
- refactor(web): remove legacy action button references by @lyzno1 in https://github.com/langgenius/dify/pull/40651
- refactor(web): migrate app card icon controls by @lyzno1 in https://github.com/langgenius/dify/pull/40652
- fix(agent): normalize plugin provider identities by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40619
- fix: prevent cross-tab chat conversation switching by @iamjoel in https://github.com/langgenius/dify/pull/40709
- fix(dify-ui): refine pagination navigation semantics by @lyzno1 in https://github.com/langgenius/dify/pull/40723
- refactor(ui): enforce single-choice segmented controls by @lyzno1 in https://github.com/langgenius/dify/pull/40726
- refactor: generalize hosted model quota lifecycle by @linw1995 in https://github.com/langgenius/dify/pull/40722
- fix(agent): meter internal LLM calls through API by @zyssyz123 in https://github.com/langgenius/dify/pull/40613
- fix(api): chain original exception in 13 except blocks per PEP 3134 by @Harsh23Kashyap in https://github.com/langgenius/dify/pull/40738
- fix(api): remove unsafe Bedrock test endpoint by @WH-2099 in https://github.com/langgenius/dify/pull/40742
- refactor(web): clarify model selector trigger ownership by @lyzno1 in https://github.com/langgenius/dify/pull/40732
- chore(deps): bump wandb to 0.28.2 (go-git, grpc, x/text, Go stdlib CVEs) by @GareArc in https://github.com/langgenius/dify/pull/40753
- feat(web): embed marketplace in integration categories by @Jingyi-Dify in https://github.com/langgenius/dify/pull/40744
- refactor: resolve completion model via manager by @linw1995 in https://github.com/langgenius/dify/pull/40756
- fix: add semantic document titles across pages by @iamjoel in https://github.com/langgenius/dify/pull/40396
- docs(web): consolidate maintainer guidance by @lyzno1 in https://github.com/langgenius/dify/pull/40758
- fix(api): enforce edit and RBAC permissions on dataset API key GET endpoint (#40740) by @agarwalpranav0711 in https://github.com/langgenius/dify/pull/40743
- fix(agent): authenticate agent control plane by @WH-2099 in https://github.com/langgenius/dify/pull/40737
- chore: upgrade Vite+ to 0.2.9 by @lyzno1 in https://github.com/langgenius/dify/pull/40762
- fix(web): skip lifecycle scripts in Docker install by @lyzno1 in https://github.com/langgenius/dify/pull/40763
- test: migrate app service accounts and commit failures to real ORM by @asukaminato0721 in https://github.com/langgenius/dify/pull/40655
- test: migrate annotation controller ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40643
- test: migrate load balancing account ORM model to real entity by @asukaminato0721 in https://github.com/langgenius/dify/pull/40644
- test: migrate expired log workflow ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40645
- test: migrate agent drive end-user ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40654
- test: migrate trace workflow run ORM model to real entity by @asukaminato0721 in https://github.com/langgenius/dify/pull/40642
- test: migrate OpenAPI and tool-file ORM entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40637
- test: migrate web controller identity ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40639
- feat(workflow-generator): prefer installed tools by @crazywoola in https://github.com/langgenius/dify/pull/40611
- test: migrate workflow event ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40634
- chore: update workspace dependencies by @lyzno1 in https://github.com/langgenius/dify/pull/40764
- chore(deps): bump pydantic-ai-slim from 1.102.0 to 1.106.0 in /dify-agent by @dependabot[bot] in https://github.com/langgenius/dify/pull/40736
- chore: reopen the education application flow by @iamjoel in https://github.com/langgenius/dify/pull/40760
- fix(dify-agent): clarify shell working spaces by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40623
- fix: handle long text URLs in webscraper by @linw1995 in https://github.com/langgenius/dify/pull/40757
- fix: preserve file preview content type by @myshkin451 in https://github.com/langgenius/dify/pull/37211
- fix(dify-ui): refine segmented control focus feedback by @lyzno1 in https://github.com/langgenius/dify/pull/40769
- feat(dify-agent): expand and enforce agent run limits by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40641
- test: migrate account tenant ORM stand-ins to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40627
- test: migrate residual namespace ORM entities to real models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40633
- test: migrate controller identity ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40626
- test: migrate workflow tool users to SQLite ORM models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40628
- test: migrate RAG residual entities to real ORM models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40629
- fix(agent): return conflict for duplicate creation by @zyssyz123 in https://github.com/langgenius/dify/pull/40771
- fix: preserve successful last run status after page restore by @iamjoel in https://github.com/langgenius/dify/pull/40775
- fix(ci): align staged checks with Vite+ by @lyzno1 in https://github.com/langgenius/dify/pull/40774
- refactor(api): extract installed app definition queries by @hjlarry in https://github.com/langgenius/dify/pull/40462
- refactor(api): reuse app definition queries in web and service APIs by @hjlarry in https://github.com/langgenius/dify/pull/40463
- refactor(api): reuse app definition queries for app parameters by @hjlarry in https://github.com/langgenius/dify/pull/40465
- refactor(api): reuse app definition queries for service API info by @hjlarry in https://github.com/langgenius/dify/pull/40476
- fix(api): enforce RAG draft variable access boundaries by @WH-2099 in https://github.com/langgenius/dify/pull/40745
- fix: show accurate copy for agent run limit errors by @iamjoel in https://github.com/langgenius/dify/pull/40784
- feat(oauth): drive silent authorization from oauth_provider_apps.auto_authorize by @lin-snow in https://github.com/langgenius/dify/pull/40783
- fix(api): protect custom OAuth client deletion by @WH-2099 in https://github.com/langgenius/dify/pull/40786
- chore: dep inject for model in dataset document actions by @ddddajie in https://github.com/langgenius/dify/pull/40787
- fix(api): point SSRF-blocked error message at the correct dify issue by @chelsealong in https://github.com/langgenius/dify/pull/40605
- test(api): make session decorator path assertion platform-agnostic by @AlexMultiAgent in https://github.com/langgenius/dify/pull/39895
- refactor: add Mapped type annotations to model fields (#40373) by @mahbubsouad in https://github.com/langgenius/dify/pull/40380
- fix(api): protect workspace credential mutations by @WH-2099 in https://github.com/langgenius/dify/pull/40790
- fix(api): protect agent sandbox reads by @WH-2099 in https://github.com/langgenius/dify/pull/40794
- fix: reclaim conversation resources on deletion by @zyssyz123 in https://github.com/langgenius/dify/pull/40792
- fix: replace bare except with except Exception in core agent, storage and vector backends by @TrueFurina in https://github.com/langgenius/dify/pull/40801
- refactor(controllers/web): dep-inject payloads with @model_validate by @a-yeyang in https://github.com/langgenius/dify/pull/40796
- fix: narrow bare except in storage exists() to ClientError by @zrh805 in https://github.com/langgenius/dify/pull/40420
- fix(extension): chain original exception in APIBasedExtensionRequestor per PEP 3134 by @Harsh23Kashyap in https://github.com/langgenius/dify/pull/40810
- test: migrate residual user ORM stand-ins to real models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40625
- test: migrate file controller ORM models to real entities by @asukaminato0721 in https://github.com/langgenius/dify/pull/40632
- test: migrate agent surface sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40602
- test: migrate annotation security sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40604
- test: migrate RAG processor residuals to SQLite ORM models by @asukaminato0721 in https://github.com/langgenius/dify/pull/40608
- docs: fix pipeline_generator docstrings to reference pipeline instead of app_model by @mesrop2008 in https://github.com/langgenius/dify/pull/40813
- test: migrate agent controller sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40600
- test: migrate residual controller sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40606
- fix(api): support audio/x-m4a for ASR by @CodeMak1r-zy in https://github.com/langgenius/dify/pull/40776
- fix(web): align combobox interaction semantics by @lyzno1 in https://github.com/langgenius/dify/pull/40826
- feat(plugin-auth): visibility picker for OAuth credentials by @ForeignKeyCN in https://github.com/langgenius/dify/pull/39840
- chore(deps): bump the github-actions-dependencies group with 2 updates by @dependabot[bot] in https://github.com/langgenius/dify/pull/40834
- refactor(controllers/web): dep-inject login and forgot-password payloads (#36659) by @weike-zhang in https://github.com/langgenius/dify/pull/40856
- feat(ci): sync E2B template on release tag push by @MRZHUH in https://github.com/langgenius/dify/pull/40858
- fix(web): let multimodal guidance height fit content by @CyberPU2099 in https://github.com/langgenius/dify/pull/40846
- fix(web): update agent model request limit copy by @lyzno1 in https://github.com/langgenius/dify/pull/40863
- test(e2e): align agent model selector locators by @lyzno1 in https://github.com/langgenius/dify/pull/40862
- fix(workflow): preserve historical Agent node compatibility by @zyssyz123 in https://github.com/langgenius/dify/pull/40859
- fix(dify-agent): require E2B traffic authentication by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40871
- feat: create accounts with client IP by @linw1995 in https://github.com/langgenius/dify/pull/40875
- feat(dify-agent): add context-aware history compaction by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40872
- fix(dify-agent): preserve snapshots for failed and cancelled runs by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40876
- feat: dispatch New Agent Beta eligibility checks by @hjlarry in https://github.com/langgenius/dify/pull/40725
- fix(dify-agent): enforce short-lived Agent Stub authorization by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40884
- feat(dify-agent): enforce signed upload size limits by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40883
- test: migrate console conversation sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40528
- test: migrate controller auth wrapper sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40529
- test: migrate console app MCP sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40526
- test: migrate console workflow controller sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40527
- test: migrate Service API dataset document sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40519
- test: migrate Service API dataset metadata sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40518
- test: migrate RAG pipeline sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40511
- test: migrate RAG indexing sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40513
- test: isolate config inputs from process environment by @asukaminato0721 in https://github.com/langgenius/dify/pull/40847
- fix: suggest deepseek-v4-flash for Agent mode by @BlessedWithLuck1105 in https://github.com/langgenius/dify/pull/40852
- refactor(dify-ui): expose autocomplete popup anatomy by @lyzno1 in https://github.com/langgenius/dify/pull/40895
- feat(dify-ui): add input group composition by @lyzno1 in https://github.com/langgenius/dify/pull/40890
- fix(api): repair two malformed logger format strings by @amogh-nagri-11 in https://github.com/langgenius/dify/pull/40901
- fix(api): clear stale cancellation signals when resuming a paused workflow by @mesrop2008 in https://github.com/langgenius/dify/pull/40905
- fix(ci): use default Ubuntu mirror for Playwright by @lyzno1 in https://github.com/langgenius/dify/pull/40909
- fix(dify-agent): use E2B traffic access header by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40891
- fix(dify-agent): isolate cancellation intent observer by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40896
- chore(dify-agent): disable Landlock for E2B templates by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40892
- fix(api): bound connect phase to 5.0s in two api/core/ outbound timeouts by @Harsh23Kashyap in https://github.com/langgenius/dify/pull/40807
- refactor(web): standardize app log search inputs by @lyzno1 in https://github.com/langgenius/dify/pull/40912
- refactor(web): standardize dataset search inputs by @lyzno1 in https://github.com/langgenius/dify/pull/40913
- refactor(web): standardize label search inputs by @lyzno1 in https://github.com/langgenius/dify/pull/40914
- test(dify-ui): stabilize dropdown menu story by @lyzno1 in https://github.com/langgenius/dify/pull/40916
- fix: accept legacy plugin daemon list responses by @Zenine in https://github.com/langgenius/dify/pull/38265
- refactor(api): decouple data source API key auth flow by @41tair in https://github.com/langgenius/dify/pull/40452
- refactor(api): extract account activation application service by @41tair in https://github.com/langgenius/dify/pull/40421
- fix: preserve Agent tool-generated file outputs by @zyssyz123 in https://github.com/langgenius/dify/pull/40917
- refactor(web): compose search prefixes with input group by @lyzno1 in https://github.com/langgenius/dify/pull/40922
- chore(deps): bump sqlparse from 0.5.4 to 0.6.0 in /api by @dependabot[bot] in https://github.com/langgenius/dify/pull/40904
- refactor(models): dep-inject Session on remaining @Property accessors by @a-yeyang in https://github.com/langgenius/dify/pull/40797
- refactor(web): migrate retry units to number field by @lyzno1 in https://github.com/langgenius/dify/pull/40923
- refactor(web): migrate clearable search inputs by @lyzno1 in https://github.com/langgenius/dify/pull/40924
- refactor(web): remove legacy tag component by @lyzno1 in https://github.com/langgenius/dify/pull/40928
- fix(ci): align Oxlint suppression formatting by @lyzno1 in https://github.com/langgenius/dify/pull/40934
- refactor(web): remove legacy embedded API docs by @lyzno1 in https://github.com/langgenius/dify/pull/40929
- test: use typed config overrides in service coverage by @asukaminato0721 in https://github.com/langgenius/dify/pull/40848
- test: keep integration config overrides typed by @asukaminato0721 in https://github.com/langgenius/dify/pull/40850
- test: centralize enterprise config overrides by @asukaminato0721 in https://github.com/langgenius/dify/pull/40853
- test: scope plugin and datasource config overrides by @asukaminato0721 in https://github.com/langgenius/dify/pull/40854
- test: eliminate remaining whole config mocks by @asukaminato0721 in https://github.com/langgenius/dify/pull/40855
- test: migrate app model sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40530
- test: migrate residual model sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40531
- test: migrate service boundary sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40533
- test: migrate telemetry and core entity ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40574
- test: migrate residual service and task ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40576
- test: migrate residual controller sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40579
- test: migrate agent runtime sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40587
- test: migrate app runtime sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40590
- fix(web): gate system features requests by connection by @lyzno1 in https://github.com/langgenius/dify/pull/40939
- test: migrate dataset service sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40534
- fix(agent): retain usage for incomplete runs by @zyssyz123 in https://github.com/langgenius/dify/pull/40937
- chore(web): align browser support targets by @lyzno1 in https://github.com/langgenius/dify/pull/40938
- fix(web): remove only-me resource access option by @WTW0313 in https://github.com/langgenius/dify/pull/40956
- refactor: clean away unnecessary-type-conversion (bool/str no-op wrappers) by @akamabu in https://github.com/langgenius/dify/pull/40822
- fix: refine access point copy and remove undeploy state warning by @RiskeyL in https://github.com/langgenius/dify/pull/40886
- refactor(web): simplify debounced filter state by @lyzno1 in https://github.com/langgenius/dify/pull/40951
- refactor(web): compose reset password fields by @lyzno1 in https://github.com/langgenius/dify/pull/40952
- refactor(web): migrate HTTP timeout inputs by @lyzno1 in https://github.com/langgenius/dify/pull/40953
- refactor(agent): remove Agent Drive by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40887
- fix(api): enforce edit and RBAC permissions on model provider credential GET endpoints (#40899) by @agarwalpranav0711 in https://github.com/langgenius/dify/pull/40900
- fix(auth): harden email code login verification by @zyssyz123 in https://github.com/langgenius/dify/pull/40960
- refactor(api): reuse app definition queries for service API site by @hjlarry in https://github.com/langgenius/dify/pull/40795
- fix(agent): resolve suggested questions from runtime config by @zyssyz123 in https://github.com/langgenius/dify/pull/40963
- fix(ui): stabilize toast stack interactions by @lyzno1 in https://github.com/langgenius/dify/pull/40970
- refactor(api): extract web app access queries by @hjlarry in https://github.com/langgenius/dify/pull/40482
- refactor(api): snapshot explore banner feature flag by @hjlarry in https://github.com/langgenius/dify/pull/40555
- fix(dify-agent): persist interrupted run history by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40972
- perf(dify-agent): parallelize Agent Stub config pulls by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40973
- fix(web): prevent workflow errors after app deletion by @lyzno1 in https://github.com/langgenius/dify/pull/40977
- fix(ui): align toast swipe direction with viewport by @lyzno1 in https://github.com/langgenius/dify/pull/40980
- refactor(api): reuse web app access queries for permissions by @hjlarry in https://github.com/langgenius/dify/pull/40984
- fix(ci): run Playwright E2E on GitHub Ubuntu by @WH-2099 in https://github.com/langgenius/dify/pull/40986
- fix(logstore): normalize workflow timestamps to naive UTC by @amogh-nagri-11 in https://github.com/langgenius/dify/pull/40947
- fix(api): enforce dataset document ownership by @linw1995 in https://github.com/langgenius/dify/pull/40989
- refactor(web): migrate signup email field by @lyzno1 in https://github.com/langgenius/dify/pull/40990
- refactor(web): migrate signup password fields by @lyzno1 in https://github.com/langgenius/dify/pull/40991
- fix(web): redirect after deleting an agent by @lyzno1 in https://github.com/langgenius/dify/pull/40994
- ci(web): run browser tests on GitHub Ubuntu by @lyzno1 in https://github.com/langgenius/dify/pull/40995
- refactor(api): add account profile application service by @41tair in https://github.com/langgenius/dify/pull/40436
- refactor(api): extract web app runtime bootstrap by @hjlarry in https://github.com/langgenius/dify/pull/40949
- test: migrate document service sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40536
- test: migrate Explore controller sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40537
- test: migrate media and execution service sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40552
- test: migrate snippet service ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40567
- refactor(web): migrate install account fields by @lyzno1 in https://github.com/langgenius/dify/pull/40992
- refactor: consolidate frontend browser test infrastructure by @lyzno1 in https://github.com/langgenius/dify/pull/40997
- fix(web): clarify agent deletion consequences by @lyzno1 in https://github.com/langgenius/dify/pull/41002
- chore: inline custom ESLint rules by @hyoban in https://github.com/langgenius/dify/pull/41008
- fix(billing): remove misleading tax assurance by @lyzno1 in https://github.com/langgenius/dify/pull/41009
- fix(snippets): implement delete for published snippet workflow versions by @chelsealong in https://github.com/langgenius/dify/pull/41003
- fix(agent): complete ownership-aware deletion lifecycle by @BeautyyuYanli in https://github.com/langgenius/dify/pull/40888
- fix(api): handle suspended email domains by @linw1995 in https://github.com/langgenius/dify/pull/41004
- refactor(api): extract recommended app query service by @hjlarry in https://github.com/langgenius/dify/pull/40207
- fix(snippet): support snippet history version export by @FFXN in https://github.com/langgenius/dify/pull/41012
- fix(api): enforce admin and RBAC permissions on tool OAuth custom client GET endpoint (#40944) by @agarwalpranav0711 in https://github.com/langgenius/dify/pull/40945
- fix(dify-agent): adjust local sandbox home paths by @BeautyyuYanli in https://github.com/langgenius/dify/pull/41021
- fix(dify-agent): add reliable shellctl stdio mode by @BeautyyuYanli in https://github.com/langgenius/dify/pull/39997
- refactor(dify-agent): use Workspace as shell temp space by @BeautyyuYanli in https://github.com/langgenius/dify/pull/41023
- fix(agent): clean legacy Agent Soul files by @BeautyyuYanli in https://github.com/langgenius/dify/pull/41024
- fix(api): add missing admin and RBAC permission decorators to model credentials GET endpoints by @FasihUrRahman in https://github.com/langgenius/dify/pull/40962
- refactor(api): decouple console tag management by @fszcd in https://github.com/langgenius/dify/pull/40843
- refactor(api): isolate trial app usage writes by @hjlarry in https://github.com/langgenius/dify/pull/40208
- refactor(api): decouple recommended app runtime admission by @hjlarry in https://github.com/langgenius/dify/pull/40257
- refactor(api): replace legacy recommended app retrieval stack by @hjlarry in https://github.com/langgenius/dify/pull/40395
- feat: support ODT document extraction by @Zenine in https://github.com/langgenius/dify/pull/39973
- test: centralize typed runtime config overrides by @asukaminato0721 in https://github.com/langgenius/dify/pull/40857
- refactor(web): migrate conversation rename input by @lyzno1 in https://github.com/langgenius/dify/pull/41028
- refactor(web): migrate document rename input by @lyzno1 in https://github.com/langgenius/dify/pull/41029
- refactor(web): migrate empty dataset input by @lyzno1 in https://github.com/langgenius/dify/pull/41030
- fix: add MESSAGE_TRACE task on chat pipline error events by @hyhyf in https://github.com/langgenius/dify/pull/39129
- chore(deps): bump google-cloud-aiplatform from 1.160.0 to 1.164.0 in /api in the google group across 1 directory by @dependabot[bot] in https://github.com/langgenius/dify/pull/39249
- chore(deps): bump the storage group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/langgenius/dify/pull/40393
- fix: when rbac enabled is true, not check_dataset_permission by @fatelei in https://github.com/langgenius/dify/pull/41022
- fix(agent): align Binding file upload timeouts by @zhaohao1004 in https://github.com/langgenius/dify/pull/41027
- fix(api): enforce app-scoped access on indirect resources by @WH-2099 in https://github.com/langgenius/dify/pull/40893
- fix(web): route enterprise documentation links by @hyoban in https://github.com/langgenius/dify/pull/40957
- fix(api): enforce edit and RBAC permissions on datasource credential …fix(api): enforce edit and RBAC permissions on datasource credential GET endpoint (#41040) by @agarwalpranav0711 in https://github.com/langgenius/dify/pull/41041
- fix(plugin): protect endpoint listings by @WH-2099 in https://github.com/langgenius/dify/pull/40897
- docs(dify-ui): establish documentation hierarchy by @lyzno1 in https://github.com/langgenius/dify/pull/41044
- refactor(dify-ui): expose slider anatomy by @lyzno1 in https://github.com/langgenius/dify/pull/41045
- fix(api): prevent dropped workflow_started events in Redis Streams by @zl86790 in https://github.com/langgenius/dify/pull/40964
- refactor(api): move account access behind application services by @41tair in https://github.com/langgenius/dify/pull/40437
- test: migrate annotation sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40504
- test: add tmp_path type by @asukaminato0721 in https://github.com/langgenius/dify/pull/40724
- test: migrate vector space admission sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40640
- test: migrate Agent App session store to SQLite ORM by @asukaminato0721 in https://github.com/langgenius/dify/pull/40638
- test: migrate remaining controller sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40538
- test: migrate console app sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40559
- fix: merge system messages and place them first to comply with Qwen/v… by @potoior in https://github.com/langgenius/dify/pull/39136
- test: migrate auth and access controller ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40572
- refactor(web): migrate human input timeout field by @lyzno1 in https://github.com/langgenius/dify/pull/41050
- refactor(web): migrate subscription confirmation input by @lyzno1 in https://github.com/langgenius/dify/pull/41051
- refactor(web): migrate external API input fields by @lyzno1 in https://github.com/langgenius/dify/pull/41052
- test: migrate console agent skill ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40570
- test: migrate console dataset segment sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40515
- test: migrate residual app generator ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40580
- refactor(api): move account lifecycle into application services by @41tair in https://github.com/langgenius/dify/pull/40438
- docs: add Sealos deployment option by @yangchuansheng in https://github.com/langgenius/dify/pull/41026
- refactor(api): extract change email state machine by @41tair in https://github.com/langgenius/dify/pull/40439
- refactor(api): finish account controller application boundary by @41tair in https://github.com/langgenius/dify/pull/40440
- fix(web): prevent Safari clipping tour recovery prompt by @lyzno1 in https://github.com/langgenius/dify/pull/41060
- fix: add missing metrics back and enhance typing by @wylswz in https://github.com/langgenius/dify/pull/40935
- refactor(dify-ui): compose dialog close controls by @lyzno1 in https://github.com/langgenius/dify/pull/41064
- fix(vdb): add document_id keyword mapping and fix VectorType in elasticsearch-ja adapter by @loulanyue in https://github.com/langgenius/dify/pull/40400
- fix(web): prevent signin page content from overflowing on mobile by @gegemeimingzi in https://github.com/langgenius/dify/pull/40921
- feat: Enterprise Home Snapshot — runtime endpoints and dify-agent adapter by @GareArc in https://github.com/langgenius/dify/pull/40996
- fix(api): attach exc_info=True to logger.warning sites that drop the traceback by @mesrop2008 in https://github.com/langgenius/dify/pull/41068
- feat(trace): add provider-neutral unified tracing by @Blackoutta in https://github.com/langgenius/dify/pull/39451
- refactor(agent): simplify Agent v2 output contract by @BeautyyuYanli in https://github.com/langgenius/dify/pull/41062
- refactor(dify-ui): simplify popover content API by @lyzno1 in https://github.com/langgenius/dify/pull/41069
- fix(api): enforce admin and RBAC permissions on data source integrates GET endpoint (#41079) by @agarwalpranav0711 in https://github.com/langgenius/dify/pull/41080
- refactor(dify-ui): simplify overlay content APIs by @lyzno1 in https://github.com/langgenius/dify/pull/41098
- fix(api): enforce admin and RBAC permissions on default model and provider models GET endpoints (#41099) by @agarwalpranav0711 in https://github.com/langgenius/dify/pull/41100
- refactor(dify-ui): rename radio family entrypoint by @lyzno1 in https://github.com/langgenius/dify/pull/41104
- fix(agent-v2): prevent workflow refresh render loop by @lyzno1 in https://github.com/langgenius/dify/pull/41105
- docs: fix dead anchors in localized READMEs and stale dify-agent link by @simpleqt in https://github.com/langgenius/dify/pull/41101
- refactor(api): standardize console billing portal errors by @hjlarry in https://github.com/langgenius/dify/pull/41055
- fix(agent): avoid empty Bedrock schema fields by @ump45nose in https://github.com/langgenius/dify/pull/40443
- refactor(api): standardize session factory wiring by @hjlarry in https://github.com/langgenius/dify/pull/41085
- fix(workflow): honor stop between non-streaming nodes by @leilei3167 in https://github.com/langgenius/dify/pull/41090
- refactor(web): use shared session factory for JWT decoding by @XIIRUAN in https://github.com/langgenius/dify/pull/41007
- chore(deps): bump the github-actions-dependencies group with 4 updates by @dependabot[bot] in https://github.com/langgenius/dify/pull/41120
- refactor: pass session to workflow comment account accessors by @ddddajie in https://github.com/langgenius/dify/pull/41117
- chore(deps): bump gunicorn from 26.0.0 to 26.1.0 in /api in the flask group by @dependabot[bot] in https://github.com/langgenius/dify/pull/41118
- fix: fall back to the batch API when the global plugin manifest is empty by @BenjaminX in https://github.com/langgenius/dify/pull/41107
- fix(tts): propagate and validate actual audio MIME by @AsperforMias in https://github.com/langgenius/dify/pull/41043
- fix: stabilize the agent tool picker placement by @iamjoel in https://github.com/langgenius/dify/pull/41132
- test: migrate trigger and webhook sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40594
- refactor(web): migrate duplicate app input form by @lyzno1 in https://github.com/langgenius/dify/pull/41127
- refactor(web): migrate pipeline template input form by @lyzno1 in https://github.com/langgenius/dify/pull/41128
- refactor(web): migrate pipeline publishing input form by @lyzno1 in https://github.com/langgenius/dify/pull/41129
- chore: Replace star image with new asset link by @crazywoola in https://github.com/langgenius/dify/pull/41136
- feat: support agent skill by @fatelei in https://github.com/langgenius/dify/pull/39675
- fix: fix upload for plugin by @FFXN in https://github.com/langgenius/dify/pull/41133
- fix(api): scope hosted credits by tenant plan by @linw1995 in https://github.com/langgenius/dify/pull/41131
- fix: show checklist errors for inline agents without models by @iamjoel in https://github.com/langgenius/dify/pull/41146
- chore(deps): upgrade pnpm workspace dependencies by @lyzno1 in https://github.com/langgenius/dify/pull/41138
- fix(web): align agent v2 monitoring copy by @lyzno1 in https://github.com/langgenius/dify/pull/41150
- fix: align duplicate agent name behavior with agent forms by @iamjoel in https://github.com/langgenius/dify/pull/41156
- chore: show full agent save time on hover by @iamjoel in https://github.com/langgenius/dify/pull/41148
- fix(agent): allow saving model-less inline Agent drafts by @zyssyz123 in https://github.com/langgenius/dify/pull/41147
- chore(api): enforce backend layer boundaries by @laipz8200 in https://github.com/langgenius/dify/pull/41159
- fix(web): align agent v2 monitoring translations by @lyzno1 in https://github.com/langgenius/dify/pull/41161
- fix: keep home intro without banner by @lyzno1 in https://github.com/langgenius/dify/pull/41155
- fix: preserve agent task editor focus when inserting commands by @iamjoel in https://github.com/langgenius/dify/pull/41166
- feat(web): enhance Go to Anything navigation and discovery by @crazywoola in https://github.com/langgenius/dify/pull/41160
- ci: add HITL IM test environment deployment by @QuantumGhost in https://github.com/langgenius/dify/pull/41171
- fix(api): respect configured model params in prompt generator by @GareArc in https://github.com/langgenius/dify/pull/41165
- fix: align main navigation card grids by @lyzno1 in https://github.com/langgenius/dify/pull/41167
- test: remove obsolete integration coverage by @asukaminato0721 in https://github.com/langgenius/dify/pull/40704
- fix(api): attach exc_info=True to 11 logger.debug/info('...: %s', str(e)) sites — sibling of #41066 (DEBUG/INFO level) by @Harsh23Kashyap in https://github.com/langgenius/dify/pull/41077
- chore(i18n): sync translations with en-US by @github-actions[bot] in https://github.com/langgenius/dify/pull/41173
- fix: keep pagination skeletons in app grid by @lyzno1 in https://github.com/langgenius/dify/pull/41175
- fix: refine agent configuration copy by @iamjoel in https://github.com/langgenius/dify/pull/41177
- fix: avoid copy-sensitive agent file toast assertion by @iamjoel in https://github.com/langgenius/dify/pull/41179
- fix: failed e2e test in agent caused by changed copywriting by @iamjoel in https://github.com/langgenius/dify/pull/41187
- fix(web): restore model selector popup spacing by @lyzno1 in https://github.com/langgenius/dify/pull/41190
- fix(web): refresh model provider version after update by @Jingyi-Dify in https://github.com/langgenius/dify/pull/41212
- chore(deps): bump boto3 from 1.43.71 to 1.43.76 in /api in the storage group by @dependabot[bot] in https://github.com/langgenius/dify/pull/41126
- refactor(api): complete account education boundary by @hjlarry in https://github.com/langgenius/dify/pull/41153
- fix(skills): align management UI accessibility and localization by @zxhlyh in https://github.com/langgenius/dify/pull/41180
- fix(model): re-sign bare/backticked tool file URLs in answer by @Taranum01 in https://github.com/langgenius/dify/pull/40799
- fix(types): replace any[] with ThoughtItem[] for agent_thoughts by @3ni8ma in https://github.com/langgenius/dify/pull/41141
- fix: address Agent UX feedback by @iamjoel in https://github.com/langgenius/dify/pull/41219
- perf(api): batch recommended app catalog lookups by @SCW5370 in https://github.com/langgenius/dify/pull/41218
- fix: enforce read-only agent resources in build mode by @iamjoel in https://github.com/langgenius/dify/pull/41220
- perf(agent): polling interval tuning by @wylswz in https://github.com/langgenius/dify/pull/41221
- perf(agent): exponential backoff in polling to prevent forking storm by @wylswz in https://github.com/langgenius/dify/pull/41222
- fix(docker): harden agent compose configuration by @BeautyyuYanli in https://github.com/langgenius/dify/pull/41065
- fix(web): stop digits rendering in the emoji font by @shaba in https://github.com/langgenius/dify/pull/41201
- test(cli): tsconfig gap by @GareArc in https://github.com/langgenius/dify/pull/41224
- fix: allow OAuth trigger builder verification without credentials by @hjlarry in https://github.com/langgenius/dify/pull/39199
- fix(cli): declare write effect for import and context-switch commands by @samzong in https://github.com/langgenius/dify/pull/41225
- feat(api): support New Agent Beta for inline Workflow agents by @hjlarry in https://github.com/langgenius/dify/pull/41215
- fix: fix skill display name rename conflict by @fatelei in https://github.com/langgenius/dify/pull/41229
- test(vdb): use real ORM models in provider tests by @asukaminato0721 in https://github.com/langgenius/dify/pull/40687
- test: move pure integration cases to unit tests by @asukaminato0721 in https://github.com/langgenius/dify/pull/40705
- test: centralize app and account config overrides by @asukaminato0721 in https://github.com/langgenius/dify/pull/40860
- test: migrate step-by-step tour sessions to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40636
- test: migrate RAG variable controller sessions and ORM models to SQLite by @asukaminato0721 in https://github.com/langgenius/dify/pull/40609
- fix(api): enforce APP_EDIT RBAC permission on MCP server refresh endpoint by @loulanyue in https://github.com/langgenius/dify/pull/41235
- fix: prevent sidebar footer actions from triggering hover preview by @iamjoel in https://github.com/langgenius/dify/pull/41230
- fix(skills): align Japanese Skills page title by @zxhlyh in https://github.com/langgenius/dify/pull/41242
- fix: show a not-allowed cursor for the prompt editor in build mode by @iamjoel in https://github.com/langgenius/dify/pull/41243
- feat: add skill enable feature switch by @fatelei in https://github.com/langgenius/dify/pull/41246
- fix(ui): add tabs panel focus treatment by @lyzno1 in https://github.com/langgenius/dify/pull/41231
- refactor(web): migrate pipeline DSL import form by @lyzno1 in https://github.com/langgenius/dify/pull/41232
- refactor(web): migrate dataset rename form by @lyzno1 in https://github.com/langgenius/dify/pull/41233
- feat(api): track credit usage contexts by @linw1995 in https://github.com/langgenius/dify/pull/41181
- feat: hide add library skill in agent ui by @fatelei in https://github.com/langgenius/dify/pull/41250
- chore: bump version to 1.17.0 by @wylswz in https://github.com/langgenius/dify/pull/41247
New Contributors
- @zyz619963502zyz made their first contribution in #39695
- @Souravrajvi0 made their first contribution in #39708
- @Success6666 made their first contribution in #39485
- @loulanyue made their first contribution in #39754
- @xiaoyaoqilan made their first contribution in #39808
- @MannXo made their first contribution in #39819
- @iridescentWen made their first contribution in #39838
- @superdiaodiao made their first contribution in #39831
- @HassanRady made their first contribution in #39899
- @HandSonic made their first contribution in #39885
- @pineapple880066 made their first contribution in #40034
- @CodeWarriors0 made their first contribution in #40055
- @123liuziming made their first contribution in #39339
- @eldardada made their first contribution in #37841
- @bounkirdni-2025 made their first contribution in #39474
- @bkidy made their first contribution in #38112
- @Mubelotix made their first contribution in #40115
- @chelsealong made their first contribution in #40171
- @medisean made their first contribution in #40189
- @zyqzyq made their first contribution in #36163
- @tusharmotwani1718 made their first contribution in https://github.com/langgenius/dify/pull/40444
- @kanson1996 made their first contribution in https://github.com/langgenius/dify/pull/39155
- @zrh805 made their first contribution in https://github.com/langgenius/dify/pull/40408
- @typenoob made their first contribution in https://github.com/langgenius/dify/pull/40480
- @ddddajie made their first contribution in https://github.com/langgenius/dify/pull/40787
- @AlexMultiAgent made their first contribution in https://github.com/langgenius/dify/pull/39895
- @mahbubsouad made their first contribution in https://github.com/langgenius/dify/pull/40380
- @TrueFurina made their first contribution in https://github.com/langgenius/dify/pull/40801
- @a-yeyang made their first contribution in https://github.com/langgenius/dify/pull/40796
- @mesrop2008 made their first contribution in https://github.com/langgenius/dify/pull/40813
- @CodeMak1r-zy made their first contribution in https://github.com/langgenius/dify/pull/40776
- @weike-zhang made their first contribution in https://github.com/langgenius/dify/pull/40856
- @BlessedWithLuck1105 made their first contribution in https://github.com/langgenius/dify/pull/40852
- @amogh-nagri-11 made their first contribution in https://github.com/langgenius/dify/pull/40901
- @Zenine made their first contribution in https://github.com/langgenius/dify/pull/38265
- @akamabu made their first contribution in https://github.com/langgenius/dify/pull/40822
- @FasihUrRahman made their first contribution in https://github.com/langgenius/dify/pull/40962
- @fszcd made their first contribution in https://github.com/langgenius/dify/pull/40843
- @hyhyf made their first contribution in https://github.com/langgenius/dify/pull/39129
- @zl86790 made their first contribution in https://github.com/langgenius/dify/pull/40964
- @potoior made their first contribution in https://github.com/langgenius/dify/pull/39136
- @yangchuansheng made their first contribution in https://github.com/langgenius/dify/pull/41026
- @gegemeimingzi made their first contribution in https://github.com/langgenius/dify/pull/40921
- @simpleqt made their first contribution in https://github.com/langgenius/dify/pull/41101
- @ump45nose made their first contribution in https://github.com/langgenius/dify/pull/40443
- @leilei3167 made their first contribution in https://github.com/langgenius/dify/pull/41090
- @XIIRUAN made their first contribution in https://github.com/langgenius/dify/pull/41007
- @3ni8ma made their first contribution in https://github.com/langgenius/dify/pull/41141
- @SCW5370 made their first contribution in https://github.com/langgenius/dify/pull/41218
- @shaba made their first contribution in https://github.com/langgenius/dify/pull/41201
Full Changelog: 1.16.1...1.17.0
What's Changed
New Features
Tool Multi-Select Input
- Workflow tool nodes now support multi-select dropdown inputs, allowing users to choose multiple values from a predefined list when configuring tool parameters. (#39346)
Workflow Node Locator
- You can now click a node_id in workflow run logs or error messages to locate and highlight the corresponding node in the workflow editor canvas. (#38187)
Workflow Block Selector Improvements
- The block selector panel now features improved keyboard navigation, category previews, and a more intuitive search experience when adding nodes to workflows. (#39212)
Export Agent DSL from Sidebar
- Agent apps can now be exported as DSL YAML directly from the app sidebar menu, making it easy to back up or version-control agent configurations. (#39299)
Knowledge Tracing
- Added more observability traces to knowledge/RAG document processing operations, improving visibility into indexing pipelines. (#38959)
Bug Fixes
Workflow & Collaboration
- Fixed hidden-tab collaboration leader saving stale drafts when the tab is inactive (#38997)
- Fixed unsaved edits being dropped when collaboration never connects (#39579)
- Preserved latest collaboration session after reconnection (#39646)
- Fixed false draft save error during Strict Mode initialization (#39353)
- Show persistent error notification when workflow draft save fails (#39293)
- Wait for workflow worker threads to finish before Celery tasks complete, preventing orphaned executions (#39614)
- Lazy-load Loro collaboration runtime to reduce initial bundle size (#39631)
- Don't open node settings panel when clicking a node in comment mode (#39500)
- Don't close active comment panel when a different comment is resolved (#39491)
RAG & Knowledge
- Fixed document cleaner stripping valid characters ï (U+00EF), ¿ (U+00BF), ¾ (U+00BE) (#39215)
- Preserved spaces during recursive text splitting (#39498)
- Used
flush()instead ofcommit()in dataset service to preserve caller transaction boundaries (#39223) - Sent valid body in external knowledge validation probe (#39410)
Agent
- Fixed agent preview: start new Preview conversations without inheriting an old ID (#39463)
- Fixed agent chat input being replaced when conversation history updates (#39289)
- Preserved complete model usage pricing in agent logs (#39201)
- Show workflow node runs in agent execution logs (#39471)
- Include workflow runs in agent monitoring stats (#39354)
- Block unpublished agents from being used in workflows (#39532)
- Prevent agent preview actions from being clipped (#39510)
- Prevent build reset from clearing preview chat history (#39490)
- Fixed agent build draft UI flashing during apply (#39642)
Web App & UI
- Fixed webapp JWT expiration time being incorrectly set (#39537)
- Fixed TTS playback in Safari and Firefox (#39444)
- Fixed clipboard writes failing in embedded apps (#39511)
- Fixed text generation web app showing infinite loading after timeout (#39268)
- Fixed chat not passing document if model doesn't support vision (#39461)
- Stopped chunk length/overlap inputs collapsing to unusable width in narrow containers (#39600)
- Fixed search hotkey hydration mismatch (#39574)
- Improved DSL import/export dialog states (#39432, #39409)
- Fixed basePath doubling in auth refresh redirects (#39273)
- Show unavailable state for disabled Web Apps (#39392)
- Fixed permission selector semantics (#39269)
- Fixed customization page horizontal overflow (#39557)
API & Backend
- Fixed MCP tool
output_schemabeing treated as required when it's optional (#39453) - Honored array-element limit and byte budget for
list[File]in VariableTruncator (#39220) - Prevented identity logging deadlock (#39449)
- Rejected
host:port-shapedPLUGIN_REMOTE_INSTALL_PORTvalues with an actionable hint (#39329) - Fixed
PaginatedResult.pagesreturning 1 instead of 0 for empty result sets (#39229) - Used resource tenant for draft variable files (#39307)
- Scoped HITL snapshot message lookup to utilize database index (#39351)
- Returned 400 instead of 500 when
filefield is missing from audio-to-text endpoints (#39303, #39322) - Fixed tool_meta missing
tool_provider_typeduring tool execution (#39513) - Applied configured timeout to enterprise inner API requests (#39335)
- Returned disabled auto-upgrade settings when strategy is missing (#39494)
- Enforced tool provider type contracts (#39380)
- Fixed WaterCrawl website crawler handling non-JSON error responses (#37514)
- Fixed can't create chat app when tenant default model schema errors (#39266)
Security Enhancements
- The Agent local sandbox now runs behind a dedicated Squid forward proxy with strict ACL rules, preventing the sandbox from reaching internal services directly. Only the
/files/endpoint on the API and/agent-stub/on agent_backend are permitted, both protected with short-lived access tokens. This significantly reduces the blast radius of arbitrary code execution in the agent sandbox. (#39544) - Communication between the Dify API and the agent backend now uses token-based authentication via
DIFY_AGENT_API_TOKEN/AGENT_BACKEND_API_TOKEN, hardening the internal service boundary. (#39622) - Switched Jinja2 template rendering to use
SandboxedEnvironment, preventing template injection attacks in workflow code nodes (#39609) - Patched React Server Components DoS vulnerability (#39539)
- Used
re.fullmatchin email validator to reject trailing newlines, preventing bypass attacks (#39320) - Validated account status before accepting workspace invitations (#39438)
Performance
- Lightweight recent apps endpoint — New
GET /console/api/apps/recentendpoint reduces the home page "Continue Work" section latency by ~69% (3.2× faster), cutting SQL queries from 19+ to 1 projection SELECT and response size by ~50% (#39625) - Lazy-load Home creation modals — Deferred loading of creation modal code until interaction, reducing initial JavaScript bundle (#39634)
Improvements
- Made agent composer save and publish state consistent (#39637)
- Simplified Dify logo theming (#39580)
- Improved workflow block selector UI (#39377)
- Improved web accessibility semantics (#39505)
- Nodes are no longer draggable when previewing a workflow (#39131)
- Display non-LLM settings in integration tool details (#39295)
Environment Variable Changes
New Variables
| Variable | Default | Description |
|---|---|---|
DIFY_AGENT_API_TOKEN |
dify-agent-run-token-for-dev-only |
Shared bearer token for API → agent_backend authentication. Change this in production. |
AGENT_BACKEND_API_TOKEN |
dify-agent-run-token-for-dev-only |
Same token on the agent backend side. Must match DIFY_AGENT_API_TOKEN. |
PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED |
true |
Set to false if plugins are installed externally and the cache cannot be invalidated. |
Important
DIFY_AGENT_API_TOKEN is a new required variable for secure communication between the Dify API and agent backend. The default value (dify-agent-run-token-for-dev-only) is insecure and must be replaced in production. Generate one with:
python -c 'import secrets; print(secrets.token_urlsafe(32))'Set the same value as AGENT_BACKEND_API_TOKEN on the agent backend side.
Docker Compose Changes
- Agent sandbox network isolation:
local_sandboxis moved off thedefaultnetwork to dedicatedagent_sandbox_network+local_sandbox_proxy_network. A newagent_ssrf_proxyservice (Squid) is added. - Bearer auth:
AGENT_BACKEND_API_TOKEN/DIFY_AGENT_API_TOKENare now passed toapi,worker, andagent_backendservices. - Image tags updated to
1.16.1.
Database Migrations
This release includes 4 new migrations:
2026_07_15_1600-3c9f8e2a1d7b_add_workflow_run_archive_bundle_cursor_indexes.py— Add indexes toworkflow_run_archive_bundles(concurrent on PostgreSQL)2026_06_29_1200-b8c9d0e1f2a3_add_step_by_step_tour_state.py— Createaccount_step_by_step_tour_statestable2026_07_22_1500-d2825e7b9c10_scope_agent_debug_conversations.py— Adddraft_typecolumn toagent_debug_conversationsand update unique constraint2026_07_23_1200-6f5a9c2d8e1b_add_telemetry_fields_to_dify_setups.py— Add telemetry fields (instance_id,install_reported_at,last_heartbeat_at) todify_setups
All migrations are additive (new tables, columns, indexes) and are safe to run without downtime.
Upgrade Guide
Model Type Migration
Important
One-time legacy model type migration for self-hosted upgrades
If this deployment was upgraded from a Dify version earlier than 1.15.0 and this migration has not already been applied, run it after upgrading.
This migration is not included in flask db upgrade. Without it, legacy model records can cause model-related API requests to fail with errors, preventing affected models from being loaded or used.
Back up the database before applying the migration. The command runs in dry-run mode by default; review the output before rerunning it with --apply. The migration is idempotent and can be safely rerun.
Docker Compose
Run from the docker directory.
# Apply after reviewing the dry-run output docker compose exec -T api flask data-migrate legacy-model-types --apply \ > legacy-model-types-apply.jsonl
Source Code Deployment
Run from the repository root after completing flask db upgrade.
# Apply after reviewing the dry-run output uv run --project api flask data-migrate legacy-model-types --apply \ > legacy-model-types-apply.jsonl
After applying the migration, run the dry-run command again. If it reports no additional row updates or deletions, restart the relevant services and verify that existing models can be loaded and invoked successfully.
Docker Compose (Recommended)
cd docker
docker compose down
git pull origin main
docker compose pull
docker compose up -dThe database migrations will run automatically on startup.
Important
Review the new DIFY_AGENT_API_TOKEN variable in .env. The default value is insecure — generate a secure token for production:
python -c 'import secrets; print(secrets.token_urlsafe(32))'Source Code
git pull origin main
cd api
flask db upgradeWhat's Changed
- refactor(web): use generated dataset card queries by @lyzno1 in #39203
- refactor(web): use generated OAuth query options by @lyzno1 in #39204
- refactor(web): align integrations sidebar components by @lyzno1 in #39202
- feat(workflow): improve block selector navigation and previews by @lyzno1 in #39212
- fix(dataset_service): use flush() instead of commit() to preserve caller transaction by @sergioperezcheco in #39223
- ci: route default Depot jobs to 4-core runners by @lyzno1 in #39277
- chore: the node should not draggable when preview a workflow by @hjlarry in #39131
- test(web): align test state boundaries by @lyzno1 in #39239
- refactor(web): avoid setState in website crawler effects by @wanxiankai in #39237
- fix: text generation web app keeps loading after timeout by @iamjoel in #39268
- refactor(web): avoid direct setState in effect in jina reader crawler (#25194) by @pepepeboom in #39216
- fix(web): restore permission selector semantics by @lyzno1 in #39269
- chore: bump the github-actions-dependencies group with 5 updates by @dependabot[bot] in #39247
- fix: can't create chat app when get tenant default model schema error by @hjlarry in #39266
- fix: prevent hidden-tab collaboration leader from saving stale drafts by @Kevin9703 in #38997
- fix(api, web): scope trial app file uploads to the app tenant by @linw1995 in #39149
- refactor: use catalog for workflow archive maintenance by @zhaohao1004 in #39001
- fix(agent): preserve complete model usage pricing by @zyssyz123 in #39201
- feat(web): add webapp access control to agent access point by @GareArc in #39285
- fix: the input of agent chat would be replaced if conversation history updated by @iamjoel in #39289
- feat(dataset): proxy KnowledgeFS Console requests by @hyoban in #39158
- docs: refine frontend testing guidance by @lyzno1 in #39290
- chore(deps): update pnpm and workspace dependencies by @lyzno1 in #39292
- fix: show persistent error when workflow draft save fails by @iamjoel in #39293
- feat(web): add step-by-step tour shell by @Jingyi-Dify in #38785
- chore: display non-LLM settings in integration tool details by @iamjoel in #39295
- chore(i18n): sync translations with en-US by @github-actions[bot] in #39296
- revert(ci): restore default Depot runners by @lyzno1 in #39297
- test: use SQLite sessions in unit misc by @asukaminato0721 in #39123
- test: use SQLite sessions in unit misc by @asukaminato0721 in #39121
- test: use SQLite sessions in unit misc by @asukaminato0721 in #39122
- feat: support export agent dsl in sidebar by @iamjoel in #39299
- fix(web): stop doubling basePath in auth refresh redirects by @sergioperezcheco in #39273
- chore: when dataset permission is not all team, update rbac config to… by @fatelei in #39227
- refactor(web): remove basePath from hydration boundary by @lyzno1 in #39308
- ci: simplify test workflow execution by @WH-2099 in #39318
- test: use SQLite sessions in unit misc by @asukaminato0721 in #39120
- fix(api): use resource tenant for draft variable files by @linw1995 in #39307
- fix(configs): reject host:port-shaped PLUGIN_REMOTE_INSTALL_PORT with actionable hint by @sergioperezcheco in #39329
- fix: return 400 instead of 500 when file field is missing in audio-to-text endpoints (#39303) by @rkfshakti in #39322
- test: use SQLite sessions in unit misc by @asukaminato0721 in #39119
- test: use SQLite sessions in services workflow by @asukaminato0721 in #39116
- fix(api): keep workflow log archives owner-admin only by @lyzno1 in #39338
- fix(web): restore billing access boundary by @lyzno1 in #39343
- fix(api): return 400 instead of 500 when 'file' is missing from trial-app audio-to-text by @Harsh23Kashyap in #39305
- refactor(web): remove permission catalog service hooks by @lyzno1 in #39342
- fix(watercrawl): handle non-json error responses by @luochen211 in #37514
- fix(dev): use gevent WebSocket server for local API by @hjlarry in #39349
- fix: not support jump to detail in marketplace by @iamjoel in #39347
- fix(workflow): avoid false draft save error during Strict Mode initia… by @hjlarry in #39353
- test: use sqlite3 session in test_account_service by @asukaminato0721 in #38751
- test: use SQLite sessions in services workflow by @asukaminato0721 in #39115
- test: use SQLite sessions in unit misc by @asukaminato0721 in #39118
- test: use sqlite3 session in test_built_in_retrieval by @asukaminato0721 in #38735
- test: use sqlite3 session in test_based_generate_task_pipeline by @asukaminato0721 in #38738
- test: use sqlite3 session in test_conversation_service by @asukaminato0721 in #38774
- test: move API token service coverage to unit tests by @asukaminato0721 in #38918
- test: use sqlite3 session in test_accounts by @asukaminato0721 in #38752
- test: move app import API coverage to unit tests by @asukaminato0721 in #38920
- test: use sqlite3 session in test_database_retrieval by @asukaminato0721 in #38743
- test: use sqlite3 session in test_agent_app_parameters by @asukaminato0721 in #38759
- test: use sqlite3 session in test_workspace_account by @asukaminato0721 in #38757
- test: use sqlite3 session in test_tool_file_manager by @asukaminato0721 in #38771
- test: move human input delivery coverage to unit tests by @asukaminato0721 in #38926
- test: use sqlite3 session in test_build_from_mapping by @asukaminato0721 in #38769
- test: add SQLite session fixture for providers by @asukaminato0721 in #38982
- fix(agent): include workflow runs in monitoring stats by @zyssyz123 in #39354
- feat(webapp-access): add WEBAPP_PUBLIC_ACCESS_ENABLED toggle by @GareArc in #38567
- fix(api): scope HITL snapshot message lookup to utilize db index by @QuantumGhost in #39351
- fix: update the agent roster documentation link by @iamjoel in #39368
- chore(i18n): sync translations with en-US by @github-actions[bot] in #39362
- refactor(web): improve workflow block selector by @lyzno1 in #39377
- fix(api): PaginatedResult.pages should be 0 for an empty result set by @lntutor in #39229
- feat: add WebSocket support to dev proxy with cookie rewriting by @WTW0313 in #39370
- fix: enforce tool provider type contracts by @lyzno1 in #39380
- chore(deps): upgrade Next.js to 16.2.11 by @lyzno1 in #39384
- test: use SQLite sessions in services misc by @asukaminato0721 in #39114
- test: use SQLite sessions in services enterprise by @asukaminato0721 in #39113
- test: use SQLite sessions in services core by @asukaminato0721 in #39111
- test: use SQLite sessions in core workflow by @asukaminato0721 in #39109
- test: use sqlite3 session in test_auth_wraps by @asukaminato0721 in #38760
- docs: note minimum Docker Compose version by @zcxGGmu in #39374
- test: use sqlite3 session in test_human_input_forms by @asukaminato0721 in #38777
- test: move console OAuth coverage to unit tests by @asukaminato0721 in #38923
- fix: apply configured timeout to enterprise inner API requests by @GareArc in #39335
- fix(web): show unavailable state for disabled Web Apps by @lyzno1 in #39392
- fix(datasets): update empty state handling and permissions messaging by @WTW0313 in #39360
- chore: bump pyasn1 from 0.6.3 to 0.6.4 in /api by @dependabot[bot] in #39390
- chore: bump setuptools from 82.0.1 to 83.0.0 in /dify-agent by @dependabot[bot] in #39387
- chore: bump gitpython from 3.1.50 to 3.1.52 in /api by @dependabot[bot] in #39389
- chore: bump google.golang.org/grpc from 1.82.0 to 1.82.1 in /dify-agent-runtime by @dependabot[bot] in #39386
- chore: bump pyasn1 from 0.6.3 to 0.6.4 in /dify-agent by @dependabot[bot] in #39388
- test: use sqlite3 session in test_clear_free_plan_tenant_expired_logs by @asukaminato0721 in #38693
- chore: bump pillow from 12.2.0 to 12.3.0 in /dify-agent by @dependabot[bot] in #39328
- test: use sqlite3 session in test_workflow by @asukaminato0721 in #38686
- test: use SQLite sessions in service API fixtures by @asukaminato0721 in #38784
- test: use sqlite3 session in test_export_service by @asukaminato0721 in #38718
- test: use sqlite3 session in test_generator_api_missing by @asukaminato0721 in #38719
- test: use sqlite3 session in test_app_runner_conversation_variables by @asukaminato0721 in #38687
- test: use sqlite3 session in test_model_config_api by @asukaminato0721 in #38675
- fix(e2e): align fixtures with generated contracts by @lyzno1 in #39394
- chore: clean up CODEOWNERS by @lyzno1 in #39398
- fix(oauth): reauth after accepting invitation by @linw1995 in #39366
- fix(ci): avoid duplicate post-merge e2e runs by @lyzno1 in #39401
- test: use sqlite3 session in test_base_app_runner by @asukaminato0721 in #38740
- fix(api,billing): invalidate vector space cache after cleanup by @linw1995 in #39404
- test(e2e): validate generated console contracts by @lyzno1 in #39400
- chore: Update permission tip across i18n locales by @WTW0313 in #39406
- test: use sqlite3 session in test_reset_encrypt_key_pair by @asukaminato0721 in #38673
- test: use sqlite3 session in test_rag_pipeline_workflow by @asukaminato0721 in #38676
- fix(agent): isolate build and preview chat conversations by @zyssyz123 in #39405
- test: use sqlite3 session in test_snippet_workflow by @asukaminato0721 in #38677
- test: use sqlite3 session in test_snippet_workflow_draft_variable by @asukaminato0721 in #38678
- fix(web): improve DSL export feedback by @lyzno1 in #39409
- test: use sqlite3 session in test_app_import_api by @asukaminato0721 in #38674
- test: use sqlite3 session in test_tags by @asukaminato0721 in #38679
- test: use sqlite3 session in test_init_validate by @asukaminato0721 in #38680
- test: use sqlite3 session in test_plugin_wraps by @asukaminato0721 in #38681
- test: use sqlite3 session in test_runtime_credentials by @asukaminato0721 in #38682
- test: use sqlite3 session in test_workflow_events_openapi by @asukaminato0721 in #38683
- feat(dataset): add New Knowledge list and empty state by @hyoban in #39300
- fix: prevent RBAC role names overflowing settings panel by @balancetheworld in #39412
- fix(agent): refresh stale inline preview drafts by @zyssyz123 in #39415
- feat: support tool multi-select input by @hjlarry in #39346
- fix(dify-ui): preserve link semantics in button story by @lyzno1 in #39430
- feat(dataset): expose New RAG KnowledgeFS contracts by @hyoban in #39314
- fix(web): improve import DSL dialog states by @lyzno1 in #39432
- feat: gate cloud analytics behind cookie consent by @CodingOnStar in #39408
- fix(api): send valid body in external knowledge validation probe by @dparkmit24 in #39410
- test: move password reset coverage to unit tests by @asukaminato0721 in #38936
- test: use sqlite3 session in test_conversation by @asukaminato0721 in #38684
- test: use sqlite3 session in test_hitl_service_api by @asukaminato0721 in #38685
- test: use sqlite3 session in test_async_workflow_service by @asukaminato0721 in #38692
- chore(api): cloud use presigned download url on api site by @linw1995 in #39436
- fix(workflow): hide Agent V2 in chatflow by @lyzno1 in #39439
- fix(auth): validate account before accepting invitations by @zyssyz123 in #39438
- fix: use re.fullmatch in email validator to reject trailing newlines (#39234) by @rkfshakti in #39320
- chore: improve lambda plugin runtime error display by @hjlarry in #39437
- fix(web): support TTS playback in Safari and Firefox by @euxx in #39444
- feat(dataset): add New Knowledge creation flow by @hyoban in #39315
- feat: gate agent management behind the agent.manage permission by @GareArc in #39330
- fix(api): prevent identity logging deadlock by @hjlarry in #39449
- fix(web): echo OAuth state on authorize redirect by @samzong in #39459
- fix(agent): start new Preview conversations without an ID by @zyssyz123 in #39463
- fix: chat not pass doc if not support vision by @iamjoel in #39461
- chore: avoid duplicate token counting during dataset indexing by @41tair in #39466
- feat(dataset): add source connections by @hyoban in #39319
- fix(agent): show workflow node runs in logs by @zyssyz123 in #39471
- feat(web): locate workflow nodes by node_id in the workflow editor by @ruanimal in #38187
- feat(dataset): add website crawl preview by @hyoban in #39324
- feat(oauth): expose stable account id on provider account endpoint by @samzong in #39470
- feat: knowledge add more trace by @fatelei in #38959
- chore: support preview mode if not in community version by @iamjoel in #39399
- test: use sqlite3 session in test_base_trace_instance by @asukaminato0721 in #38744
- fix(web): adapt workflow agent logs by @lyzno1 in #39488
- fix: prevent build reset from clearing preview chat by @iamjoel in #39490
- fix(web): simplify agent configure mode state by @lyzno1 in #39492
- fix: don't close the active comment panel when a different comment is resolved by @dparkmit24 in #39491
- fix: return disabled auto-upgrade settings when strategy is missing by @hjlarry in #39494
- fix: smooth the preview-to-build transition by @iamjoel in #39495
- fix(api): make the 10-minute email IP first-strike window take effect by @he-yufeng in #39479
- feat(dataset): add crawl source selection by @hyoban in #39325
- refactor: centralize deployment edition in system features by @lyzno1 in #39454
- fix: download skill files through authenticated API requests by @iamjoel in #39499
- fix: don't open the node settings panel when clicking a node in comment mode by @dparkmit24 in #39500
- fix: audio config ui problem by @iamjoel in #39504
- chore: add deploy-knowledge.yml by @JohnJyong in #39509
- fix: prevent agent preview actions from being clipped by @iamjoel in #39510
- chore(web): improve web accessibility semantics by @linw1995 in #39505
- fix(web): allow clipboard writes in embedded apps by @WTW0313 in #39511
- fix(web): hydrate workspace permissions before navigation render by @lyzno1 in #39524
- chore: add web shell code owners by @lyzno1 in #39526
- fix: include CSRF token when fetching skill file content by @iamjoel in #39527
- fix(agent-v2): link API reference to agent guide by @lyzno1 in #39534
- test(e2e): wait for app list before menu interaction by @lyzno1 in #39538
- fix(agent): block unpublished agents in workflows by @zyssyz123 in #39532
- fix: fix when tool execute in progress tool_meta miss tool_provider_type by @fatelei in #39513
- feat(dataset): add document processing tasks by @hyoban in #39326
- test: use caplog in ext login tests by @EvanYao826 in #39542
- fix(web): patch React Server Components DoS by @lyzno1 in #39539
- feat(dataset): add document detail by @hyoban in #39361
- refactor(web): remove obsolete route prefix handler by @lyzno1 in #39545
- refactor: remove backend-only system feature fields by @lyzno1 in #39543
- fix(web): prevent customization horizontal overflow by @Jingyi-Dify in #39557
- test: use sqlite3 session in test_datasource_provider_service by @asukaminato0721 in #38695
- test: use sqlite3 session in test_human_input_service by @asukaminato0721 in #38697
- refactor(web): migrate vector space billing query to contract client by @EvanYao826 in #39558
- test: use sqlite3 session in test_webhook_service by @asukaminato0721 in #38699
- test: use sqlite3 session in test_workflow_execute_task by @asukaminato0721 in #38704
- test: use sqlite3 session in test_easy_ui_message_end_files by @asukaminato0721 in #38706
- test: use sqlite3 session in test_wraps by @asukaminato0721 in #38716
- test: use sqlite3 session in test_metadata_nullable_bug by @asukaminato0721 in #38717
- test: use sqlite3 session in test_llm_quota by @asukaminato0721 in #38720
- test: use sqlite3 session in test_encrypter by @asukaminato0721 in #38726
- test: use sqlite3 session in test_workflow_node_execution_offload by @asukaminato0721 in #38728
- test: use sqlite3 session in test_pipeline_template_base by @asukaminato0721 in #38730
- chore: Grammar fix in VDB provider README ("a importable") by @SpiliosDimakopoulos in #39577
- chore: Broken docker-compose.yaml link in Hindi README (missing slash) by @SpiliosDimakopoulos in #39576
- docs: fix typos in ValueSourceType docstring by @SpiliosDimakopoulos in #39573
- chore(agent): update && simplify readme by @wylswz in #39584
- refactor(agents): simplify repository context by @lyzno1 in #39583
- docs: Broken Grafana link in Turkish README (placeholder text instead of URL) by @SpiliosDimakopoulos in #39575
- fix(dify-ui): honor instant popup transitions by @lyzno1 in #39572
- fix(web): prevent search hotkey hydration mismatch by @lyzno1 in #39574
- refactor: move trial app capability out of system features by @lyzno1 in #39562
- refactor(workflow): remove hook barrel exports by @lyzno1 in #39588
- fix(workflow): stop dropping unsaved edits when collaboration never c… by @BenjaminX in #39579
- test: use sqlite3 session in test_snippet by @asukaminato0721 in #38691
- test: use sqlite3 session in test_message_service by @asukaminato0721 in #38698
- fix(web): stop chunk length/overlap inputs collapsing to an unusable width in narrow containers by @dparkmit24 in #39600
- feat: add CE telemetry report by @FFXN in #39452
- fix(api): honor array-element limit and byte budget for list[File] in VariableTruncator (#39218) by @Taranum01 in #39220
- fix: The expiration time for web app login to JWT is incorrectly set. by @FFXN in #39537
- fix(rag): stop the document cleaner from stripping valid characters ï, ¿, ¾ by @winklemad in #39215
- refactor(web): simplify Dify logo theming by @lyzno1 in #39580
- feat(api): expose app mode in webapp site response by @linw1995 in #39607
- fix: preserve spaces during recursive text splitting by @CYJ1226 in #39498
- chore: bump pypdf from 6.10.2 to 6.14.2 in /dify-agent by @dependabot[bot] in #39502
- fix(agent): expose publish state from composer by @zyssyz123 in #39615
- chore(deps): bump the github-actions-dependencies group with 6 updates by @dependabot[bot] in #39603
- feat(inner_api): add endpoint to invalidate plugin model providers cache by @GareArc in #39468
- fix: align workspace card plan ownership by @lyzno1 in #39616
- feat: add amptitude to new agent by @iamjoel in #39608
- fix: use jinja sandbox by @wylswz in #39609
- feat(agent): add a squid proxy for agent sandbox by @wylswz in #39544
- fix(web): stop reporting workspace status by @lyzno1 in #39626
- fix(workflow): lazy-load Loro collaboration runtime by @lyzno1 in #39631
- fix(api): wait for workflow worker cleanup before task completion by @linw1995 in #39614
- perf(web): lazy-load Home creation modals by @lyzno1 in #39634
- perf: add lightweight recent apps endpoint by @hjlarry in #39625
- test: use pristine file-backed SQLite fixtures by @escape0707 in #39624
- test: use sqlite3 session in test_workflow_run_service by @asukaminato0721 in #38701
- test: use sqlite3 session in test_draft_var_loader_simple by @asukaminato0721 in #38702
- test: use sqlite3 session in test_utils by @asukaminato0721 in #38729
- test: use sqlite3 session in test_workflow_comment_service by @asukaminato0721 in #38700
- test: use sqlite3 session in test_llm_generator_missing by @asukaminato0721 in #38742
- fix: gate service API, MCP and trigger surfaces on enterprise license by @GareArc in #39635
- feat: add bearer auth to agent backend by @wylswz in #39622
- refactor: make agent composer save and publish state consistent by @iamjoel in #39637
- chore: bump gitpython from 3.1.52 to 3.1.54 in /api by @dependabot[bot] in #39619
- test: use sqlite3 session in test_api by @asukaminato0721 in #38733
- chore(deps): bump golang.org/x/net from 0.53.0 to 0.55.0 in /dify-agent-runtime by @dependabot[bot] in #39025
- test: use sqlite3 session in test_extract_thread_messages by @asukaminato0721 in #38739
- chore: bump pymdown-extensions from 10.21.2 to 11.0 in /dify-agent by @dependabot[bot] in #39618
- test: use SQLite sessions in rag retrieval by @asukaminato0721 in #39049
- chore(deps): bump the storage group across 1 directory with 3 updates by @dependabot[bot] in #39604
- fix: prevent the agent build draft UI from flashing during apply by @iamjoel in #39642
- test: use SQLite sessions in services core by @asukaminato0721 in #39057
- test: use SQLite sessions in core memory by @asukaminato0721 in #39066
- fix(ui): unify combobox trigger focus rings by @lyzno1 in #39643
- test: use SQLite sessions in controllers service api by @asukaminato0721 in #39069
- chore: update workspace dependencies by @lyzno1 in #39641
- fix(workflow): preserve latest collaboration session by @lyzno1 in #39646
- test: use SQLite sessions in core ops by @asukaminato0721 in #39072
- test: use SQLite sessions in core app by @asukaminato0721 in #39075
- test: use SQLite sessions in core tools by @asukaminato0721 in #39077
- fix(web): align tour trigger DOM order by @lyzno1 in #39654
- fix(workflow): align block icon vector sizes by @Jingyi-Dify in #39657
- fix(cli): decouple release script tests from the live compat window by @GareArc in #39658
- feat(plugin): allow disabling the tenant plugin model providers cache by @GareArc in #39632
- chore: bump version to 1.16.1 by @wylswz in #39653
- fix: fix mcp output_schema is optional by @fatelei in #39453
New Contributors
- @wanxiankai made their first contribution in #39237
- @pepepeboom made their first contribution in #39216
- @rkfshakti made their first contribution in #39322
- @lntutor made their first contribution in #39229
- @zcxGGmu made their first contribution in #39374
- @dparkmit24 made their first contribution in #39410
- @samzong made their first contribution in #39459
- @SpiliosDimakopoulos made their first contribution in #39577
- @Taranum01 made their first contribution in #39220
- @winklemad made their first contribution in #39215
- @CYJ1226 made their first contribution in #39498
Full Changelog: 1.16.0...1.16.1
@ Every self-hosted release, weekly
One Monday email with the week's stable releases across the directory.
FAQ
How do I create a backup before upgrading Dify?
Copy the entire dify directory to a timestamped backup folder: cp -r dify "dify.bak.$(date +%Y%m%d%H%M%S)"
What should I do if git clone fails with 'Remote branch null not found'?
The GitHub API rate limit caused the version lookup to fail. Clone with an explicit version number from the Dify releases page instead.
How do I install an older version of Dify?
Use the --branch flag with git clone to specify a version, e.g., git clone --branch 0.15.3 https://github.com/langgenius/dify.git
More in AI Workflows
duragraphDuraGraph is a self-hosted, open-source control plane for durable AI agent workflows. It uses event sourcing and CQRS to make every run replayable and crash-safe.
EigentOpen-source desktop app to run single agents or multi-agent workforces; self-host the FastAPI backend with Docker and use any cloud or local model.
ENZOENZO is a self-hosted AI workspace for 300+ models using your own API keys. Includes self-drafting agents, research, code generation, music player, encrypted vault.
Evo AIOpen-source, self-hosted workbench for building AI agents: LLM, A2A, sequential, parallel, task and LangGraph workflow types with MCP tools and encrypted API keys.
giselleGiselle is a self-hosted, open-source AI agent studio for building visual workflows with drag-and-drop, supporting multiple LLM providers and GitHub integration.
HiClawA self-hosted, open-source multi-agent platform where a Manager agent runs Worker agents in Matrix rooms, with gateway-held credentials and Docker or Helm installs.
InvokeAISelf-hosted, open-source AI image generation studio with a layered Unified Canvas, node-based workflows, ControlNet, and broad local model support from SD 1.5 to Flux.
keepOpen-source, self-hosted AIOps and alert management platform: deduplication, correlation, enrichment, YAML workflow automation and 110+ monitoring integrations.
KestraSelf-hosted, open-source (Apache-2.0) engine that schedules and chains data, AI and infrastructure jobs from YAML or a visual editor, with 2,200+ plugins.
langflowLangflow is a self-hosted, open-source low-code platform for building AI agents and RAG workflows with a visual drag-and-drop interface.
LangGraph-GUILangGraph-GUI is a self-hosted, open-source visual editor for LangGraph workflows. It supports local LLMs via Ollama and deploys via Docker Compose or Kubernetes.
llama-swapSelf-hosted model swapping proxy for running multiple AI models locally. Swaps between llama.cpp, vllm, stable-diffusion.cpp on demand via OpenAI/Anthropic endpoints.







0 comments