@theia/terminal 1.70.0-next.71 → 1.70.0

package/src/node/shell-integrations/bash/command-block-support.bash

@@ -0,0 +1,195 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Rebranded functions/vars from `__jetbrains_intellij_*` to `__theia_*`.
+# - Removed the feature gate (`INTELLIJ_TERMINAL_COMMAND_BLOCKS_REWORKED`) so the integration always loads.
+# - Switched OSC protocol from JetBrains `OSC 1341;...` to Theia `OSC 133;...` and changed `command_started` payload
+#   to emit only the encoded command (no `command=` key); `command_finished` no longer reports exit code/current directory.
+# - Improved command capture for `command_started`: reads the full command line from `history 1`
+#   (strips the history line number with sed) so that pipes, redirects and compound commands are
+#   captured as typed; falls back to `BASH_COMMAND` if history is unavailable.
+#
+# Source:
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/bash/command-block-support-reworked.bash
+# *****************************************************************************
+
+__theia_encode_slow() {
+  local out=''
+  # Use LC_CTYPE=C to process text byte-by-byte and
+  # LC_COLLATE=C to compare byte-for-byte. Ensure that
+  # LC_ALL and LANG are not set so they don't interfere.
+  builtin local i hexch LC_CTYPE=C LC_COLLATE=C LC_ALL= LANG=
+  builtin local value="$1"
+  for ((i = 1; i <= ${#value}; ++i)); do
+    builtin printf -v hexch "%02X" "'$value[i]"
+    out+="$hexch"
+  done
+  builtin printf "%s" "$out"
+}
+
+# Util method. Serializes string so that it could be safely passed to the escape sequence payload.
+__theia_encode() {
+  builtin local value="$1"
+  if builtin command -v od > /dev/null && builtin command -v tr > /dev/null; then
+    builtin printf "%s" "$value" | builtin command od -An -tx1 -v | builtin command tr -d "[:space:]"
+  else
+    __theia_encode_slow "$value"
+  fi
+}
+
+# Should be executed before command start
+__theia_command_preexec() {
+  __theia_command_running="1"
+  __theia_should_update_prompt="1"
+
+  builtin local entered_command
+  entered_command="$(history 1 | sed 's/^ *[0-9]\+ *//')" || entered_command="${BASH_COMMAND:-}"
+  builtin printf '\e]133;command_started;%s\a' "$(__theia_encode "$entered_command")"
+  # Restore the original prompt, our integration will be injected back after command execution in `__theia_update_prompt`.
+  PS1="$__theia_original_ps1"
+}
+
+# Should be executed before printing of the prompt (for example, after command execution)
+__theia_command_precmd() {
+  builtin local LAST_EXIT_CODE="$?"
+
+  if [[ -z "$__theia_initialized" ]]; then
+    __theia_install_debug_trap
+    __theia_initialized="1"
+    builtin printf '\e]133;initialized\a'
+  elif [[ -n "$__theia_command_running" ]]; then
+    builtin printf '\e]133;command_finished\a'
+  fi
+
+  if [ -n "$__theia_should_update_prompt" ]; then
+    __theia_update_prompt
+  fi
+
+  __theia_should_update_prompt=""
+  __theia_command_running=""
+}
+
+__theia_update_prompt() {
+  if [[ "$__theia_custom_ps1" == "" || "$__theia_custom_ps1" != "$PS1" ]]; then
+    # Save the original prompt
+    __theia_original_ps1="$PS1"
+    __theia_custom_ps1="\[$(__theia_prompt_started)\]$PS1\[$(__theia_prompt_finished)\]"
+    PS1="$__theia_custom_ps1"
+  fi
+}
+
+__theia_prompt_started() {
+  builtin printf '\e]133;prompt_started\a'
+}
+
+__theia_prompt_finished() {
+  builtin printf '\e]133;prompt_finished\a'
+}
+
+__theia_install_debug_trap() {
+  __theia_original_debug_trap="$(__theia_get_debug_trap)"
+  trap '__theia_debug_trap "$_"' DEBUG
+}
+
+# Our debug trap is wrapping the original one.
+# We execute our preexec function if conditions are met,
+# but always execute the original trap after that (if any).
+__theia_debug_trap() {
+  if __theia_is_prompt_command_contains "${BASH_COMMAND:-}"; then
+    # We are executing something inside the PROMPT_COMMAND.
+    # It is not the user command, so we need to skip it.
+    # But we need to ensure that prompt will be updated.
+    # It is important in the case of Ctrl+C in the prompt when there is no running command:
+    # in the next precmd we need to update the prompt without sending the command started event.
+    __theia_should_update_prompt="1"
+    __theia_run_original_debug_trap
+    return
+  fi
+
+  # This function is executed in a DEBUG trap, so it can be called multiple times when command is started.
+  # But we need to handle only first call.
+  if [[ -n "$__theia_command_running" ]]; then
+    __theia_run_original_debug_trap
+    return
+  fi
+
+  # Execute our preexec function before the original one.
+  __theia_command_preexec
+
+  __theia_run_original_debug_trap
+}
+
+__theia_run_original_debug_trap() {
+  if [[ -n "$__theia_original_debug_trap" && "$__theia_original_debug_trap" != "-" ]]; then
+    builtin eval "${__theia_original_debug_trap}"
+  fi
+}
+
+# Returns the code that should be executed in the DEBUG trap.
+# 'trap -p DEBUG' outputs a shell command in the format `trap -- '<shell_code>' DEBUG`.
+# The shell code can contain quotes, spaces and line breaks.
+# To get the shell code, we need to parse this string into an array and then get the 2nd item.
+# We have to use `eval` to preserve quoting.
+__theia_get_debug_trap() {
+	builtin local -a values
+	builtin eval "values=($(trap -p "DEBUG"))"
+	builtin printf '%s' "${values[2]:-}"
+}
+
+__theia_trim_whitespaces() {
+  builtin local text="$1"
+  text="${text#"${text%%[![:space:]]*}"}"   # Remove leading whitespace characters
+  text="${text%"${text##*[![:space:]]}"}"   # Remove trailing whitespace characters
+  builtin printf '%s' "$text"
+}
+
+# Checks if first argument value contains in the PROMPT_COMMAND variable.
+__theia_is_prompt_command_contains() {
+  builtin local IFS=$'\n;'
+  builtin local prompt_command_array
+  builtin read -rd '' -a prompt_command_array <<< "${PROMPT_COMMAND[*]:-}"
+
+  builtin local text_to_find="$(__theia_trim_whitespaces "$1")"
+
+  builtin local command
+  for command in "${prompt_command_array[@]:-}"; do
+    command="$(__theia_trim_whitespaces "$command")"
+    if [[ "$command" == "$text_to_find" ]]; then
+      return 0
+    fi
+  done
+
+  return 1
+}
+
+# Inspired by https://unix.stackexchange.com/questions/460651/is-prompt-command-a-colon-separated-list/672843#672843
+__theia_append_to_prompt_command() {
+    local separator=$'\n'
+    if [[ ${#PROMPT_COMMAND[@]} -gt 1 ]]; then
+    	PROMPT_COMMAND+=("$1")
+    else
+    	PROMPT_COMMAND="${PROMPT_COMMAND:+$PROMPT_COMMAND${separator}}${1}"
+    fi
+}
+
+
+__theia_original_ps1=""
+__theia_custom_ps1=""
+
+__theia_command_running="1"
+__theia_should_update_prompt="1"
+
+__theia_append_to_prompt_command "__theia_command_precmd"

package/src/node/shell-integrations/zsh/command-block-support.zsh

@@ -0,0 +1,103 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Renamed functions/vars from `__jetbrains_intellij_*` to `__theia_*`.
+# - Removed gating/early-returns for `INTELLIJ_TERMINAL_COMMAND_BLOCKS_REWORKED` and `P9K_VERSION` (integration always loads).
+# - Switched OSC protocol payloads from JetBrains `OSC 1341;...` to Theia `OSC 133;...` and changed `command_started`
+#   format to send only the encoded command (no `command=...` key).
+# - Dropped `command_finished` + `current_directory` reporting and removed alias reporting (`aliases_received`).
+#
+# Source:
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/zsh/command-block-support-reworked.zsh
+# *****************************************************************************
+
+# Disable standard shell integration when Powerlevel10k is detected.
+# P10k's rendering pipeline interferes with external OSC 133 injections.
+# We mirror the behavior of IntelliJ/JetBrains by disabling the external
+# script and deferring to P10k's internal integration.
+#
+# Tracked by JetBrains:
+# https://youtrack.jetbrains.com/issue/IJPL-178955
+[ -n "${P9K_VERSION:-}" ] && builtin return 0
+
+__theia_encode_slow() {
+  local out=''
+  # Use LC_CTYPE=C to process text byte-by-byte and
+  # LC_COLLATE=C to compare byte-for-byte. Ensure that
+  # LC_ALL and LANG are not set so they don't interfere.
+  builtin local i hexch LC_CTYPE=C LC_COLLATE=C LC_ALL= LANG=
+  builtin local value="$1"
+  for ((i = 1; i <= ${#value}; ++i)); do
+    builtin printf -v hexch "%02X" "'$value[i]"
+    out+="$hexch"
+  done
+  builtin print -r "$out"
+}
+
+# Encodes the string passed as the first parameter to hex.
+__theia_encode() {
+  builtin local value="$1"
+  if builtin whence od > /dev/null && builtin whence sed > /dev/null && builtin whence tr > /dev/null; then
+    builtin printf "%s" "$value" | builtin command od -v -A n -t x1 | builtin command sed 's/ *//g' | builtin command tr -d '\n'
+  else
+    __theia_encode_slow "$value"
+  fi
+}
+
+__theia_command_preexec() {
+  builtin local entered_command="$1"
+  builtin printf '\e]133;command_started;%s\a' "$(__theia_encode "$entered_command")"
+  __theia_command_running="1"
+  # Restore the original prompt, our integration will be injected back after command execution in `__theia_update_prompt`.
+  PS1="$__theia_original_ps1"
+}
+
+__theia_command_precmd() {
+  # Should be always the first line in the function!
+  builtin local LAST_EXIT_CODE="$?"
+
+  if [[ -z "${__theia_initialized-}" ]]; then
+    # As `precmd` is executed before each prompt, for the first time it is called after
+    # all rc files have been processed and before the first prompt is displayed.
+    # So, here it finishes the initialization block, not a user command.
+    __theia_initialized=1
+    builtin printf '\e]133;initialized\a'
+    __theia_update_prompt
+    builtin return
+  fi
+  if [ -n "$__theia_command_running" ]; then
+    __theia_update_prompt
+    __theia_command_running=""
+  fi
+}
+
+__theia_update_prompt() {
+  # Save the original prompt
+  __theia_original_ps1="$PS1"
+  PS1="%{$(__theia_prompt_started)%}$PS1%{$(__theia_prompt_finished)%}"
+}
+
+__theia_prompt_started() {
+  builtin printf '\e]133;prompt_started\a'
+}
+
+__theia_prompt_finished() {
+  builtin printf '\e]133;prompt_finished\a'
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec __theia_command_preexec
+add-zsh-hook precmd __theia_command_precmd

package/src/node/shell-integrations/zsh/zdotdir/.zlogin

@@ -0,0 +1,45 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Rebranded variables from `JETBRAINS_INTELLIJ_*` to `THEIA_*`.
+# - Removed optional debug logging controlled by `JETBRAINS_INTELLIJ_TERMINAL_DEBUG_LOG_LEVEL`.
+#
+# Source:
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/zsh/zdotdir/.zlogin
+# *****************************************************************************
+
+# See doc in .zshenv for how Theia injects itself into Zsh startup process.
+
+# Actually, this file is not expected to be be read, as ZDOTDIR is restored to its
+# original value in the Theia's .zshrc and Theia always starts Zsh in an interactive
+# mode, a behavior that, according to the documentation, cannot be modified afterward:
+#
+# INTERACTIVE shell state option (https://zsh.sourceforge.io/Doc/Release/Options.html)
+#  "The value of this option can only be changed via flags supplied at invocation of
+#  the shell. It cannot be changed once zsh is running."
+#
+# However, just in case, let's take a safety net and proxy .zlogin.
+
+if [[ -n "${THEIA_ORIGINAL_ZDOTDIR-}" ]]; then
+  ZDOTDIR="$THEIA_ORIGINAL_ZDOTDIR"
+  builtin unset 'THEIA_ORIGINAL_ZDOTDIR'
+else
+  # defaults ZDOTDIR to HOME
+  builtin unset 'ZDOTDIR'
+fi
+
+THEIA_ORIGINAL_FILENAME_TO_SOURCE='.zlogin'
+builtin source "$THEIA_ZSH_DIR/zdotdir/source-original.zsh"

package/src/node/shell-integrations/zsh/zdotdir/.zprofile

@@ -0,0 +1,27 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Rebranded variables from `JETBRAINS_INTELLIJ_*` to `THEIA_*`.
+# - Removed optional debug logging controlled by `JETBRAINS_INTELLIJ_TERMINAL_DEBUG_LOG_LEVEL`.
+#
+# Source:
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/zsh/zdotdir/.zprofile
+# *****************************************************************************
+
+# See doc in .zshenv for how Theia injects itself into Zsh startup process.
+
+THEIA_ORIGINAL_FILENAME_TO_SOURCE='.zprofile'
+builtin source "$THEIA_ZSH_DIR/zdotdir/source-original.zsh"

package/src/node/shell-integrations/zsh/zdotdir/.zshenv

@@ -0,0 +1,56 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Rebranded variables from `JETBRAINS_INTELLIJ_*` to `THEIA_*`.
+# - Removed optional debug logging controlled by `JETBRAINS_INTELLIJ_TERMINAL_DEBUG_LOG_LEVEL`.
+#
+# Source:
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/zsh/zdotdir/.zshenv
+# *****************************************************************************
+
+# This is an entry point of Theia Zsh shell integration.
+# The goal is to source `zsh-integration.zsh` file after sourcing the user's ~/.zshrc.
+# This ensures that Theia's `precmd` hook is appended last to the `precmd_functions`
+# array and therefore executed last. This allows control over the PS1 environment
+# variable from the `precmd` hook even if other `precmd` hooks are also modifying it.
+
+# According to http://zsh.sourceforge.net/Doc/Release/Files.html, zsh startup configuration files are read in this order:
+# 1. /etc/zshenv
+# 2. $ZDOTDIR/.zshenv
+# 3. /etc/zprofile (if shell is login)
+# 4. $ZDOTDIR/.zprofile (if shell is login)
+# 5. /etc/zshrc (if shell is interactive)
+# 6. $ZDOTDIR/.zshrc (if shell is interactive)
+# 7. /etc/zlogin (if shell is login)
+# 8. $ZDOTDIR/.zlogin (if shell is login)
+#
+# If ZDOTDIR is unset, HOME is used instead.
+
+# Theia launches zsh with a custom ZDOTDIR pointing to the parent directory of this file
+# in order to source `zsh-integration.zsh` from the custom .zshrc.
+# However, using a custom ZDOTDIR prevents the user's configuration files
+# (~/.zshenv, ~/.zprofile, ~/.zshrc, ~/.zlogin) from being read.
+# To address this, each user's configuration file is sourced manually from its custom counterpart.
+
+# This file is read, because Theia launches zsh with custom ZDOTDIR.
+
+# Implementation notes on safe shell scripting:
+# * Use `builtin` prefix to avoid accidentally calling user-defined functions / aliases.
+# * Use ${var-default} or ${var:-default} to not fail in configurations with `setopt nounset`.
+# * Use "${var}" to preserve whitespaces, ${var} will be split into words in configurations with `setopt sh_word_split`.
+
+THEIA_ORIGINAL_FILENAME_TO_SOURCE='.zshenv'
+builtin source "$THEIA_ZSH_DIR/zdotdir/source-original.zsh"

package/src/node/shell-integrations/zsh/zdotdir/.zshrc

@@ -0,0 +1,46 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Rebranded variables from `JETBRAINS_INTELLIJ_*` to `THEIA_*`.
+# - Removed optional debug logging controlled by `JETBRAINS_INTELLIJ_TERMINAL_DEBUG_LOG_LEVEL`.
+#
+# Source:
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/zsh/zdotdir/.zshrc
+# *****************************************************************************
+
+# See doc in .zshenv for how Theia injects itself into Zsh startup process.
+
+# HISTFILE is set to `${ZDOTDIR:-$HOME}/.zsh_history` in /etc/zshrc when ZDOTDIR
+# pointed to an internal Theia directory, so the HISTFILE variable is set incorrectly.
+# Correct it before sourcing the original .zshrc as user configuration may depend on it.
+HISTFILE="${THEIA_ORIGINAL_ZDOTDIR:-$HOME}/.zsh_history"
+
+THEIA_ORIGINAL_FILENAME_TO_SOURCE='.zshrc'
+builtin source "$THEIA_ZSH_DIR/zdotdir/source-original.zsh"
+
+# Restore original ZDOTDIR. Once ZDOTDIR is restored, further user configuration files are
+# sourced normally by Zsh. At this point, only .zlogin remains, so it's read directly by Zsh.
+if [[ -n "${THEIA_ORIGINAL_ZDOTDIR-}" ]]; then
+  ZDOTDIR="$THEIA_ORIGINAL_ZDOTDIR"
+  builtin unset 'THEIA_ORIGINAL_ZDOTDIR'
+else
+  # defaults ZDOTDIR to HOME
+  builtin unset 'ZDOTDIR'
+fi
+
+if [[ -f "${THEIA_ZSH_DIR}/zsh-integration.zsh" ]]; then
+  builtin source "${THEIA_ZSH_DIR}/zsh-integration.zsh"
+fi

package/src/node/shell-integrations/zsh/zdotdir/source-original.zsh

@@ -0,0 +1,61 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Rebranded variables from `JETBRAINS_INTELLIJ_*` to `THEIA_*`.
+# - Removed optional debug logging controlled by `JETBRAINS_INTELLIJ_TERMINAL_DEBUG_LOG_LEVEL`.
+#
+# Source:
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/zsh/zdotdir/source-original.zsh
+# *****************************************************************************
+
+# This is a helper script for loading Zsh user configuration files in the global scope.
+# How to use it: 
+# 1. Set THEIA_ORIGINAL_FILENAME_TO_SOURCE to the name of the configuration file to load.
+# 2. Source this script to load the file in the global Zsh scope.
+
+# We are in the global scope => prefix variables with `THEIA_`.
+
+THEIA_ORIGINAL_FILE="${THEIA_ORIGINAL_ZDOTDIR:-$HOME}/$THEIA_ORIGINAL_FILENAME_TO_SOURCE"
+
+if [[ -f "$THEIA_ORIGINAL_FILE" ]]; then
+  # prevent recursion, just in case
+  if [[ "$ZDOTDIR" != "${THEIA_ORIGINAL_ZDOTDIR:-$HOME}" ]]; then
+    THEIA_ZDOTDIR_COPY="$ZDOTDIR"
+
+    # Correct ZDOTDIR before sourcing the user's file as it might rely on the value of ZDOTDIR.
+    if [[ -n "$THEIA_ORIGINAL_ZDOTDIR" ]]; then
+      ZDOTDIR="$THEIA_ORIGINAL_ZDOTDIR"
+    else
+      builtin unset ZDOTDIR # defaults ZDOTDIR to HOME
+    fi
+
+    builtin source "$THEIA_ORIGINAL_FILE"
+
+    # ZDOTDIR might be changed by the user config
+    if [[ -n "$ZDOTDIR" ]]; then
+      THEIA_ORIGINAL_ZDOTDIR="$ZDOTDIR"
+    else
+      builtin unset THEIA_ORIGINAL_ZDOTDIR
+    fi
+
+    # Set back to the Theia location to continue injecting Theia shell integration.
+    ZDOTDIR="$THEIA_ZDOTDIR_COPY"
+  fi
+fi
+
+builtin unset THEIA_ORIGINAL_FILE
+builtin unset THEIA_ZDOTDIR_COPY
+builtin unset THEIA_ORIGINAL_FILENAME_TO_SOURCE

package/src/node/shell-integrations/zsh/zsh-integration.zsh

@@ -0,0 +1,28 @@
+# *****************************************************************************
+# Copyright (C) 2000-2025 JetBrains s.r.o.
+# Modifications (C) 2025 EclipseSource GmbH and others.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# Modifications:
+# - Adapted directory variable: `JETBRAINS_INTELLIJ_ZSH_DIR` -> `THEIA_ZSH_DIR`.
+# - Removed IntelliJ session bootstrap (JEDITERM_SOURCE and `_INTELLIJ_FORCE_SET_*` / `_INTELLIJ_FORCE_PREPEND_*` handling,
+#   plus the one-time `precmd_functions` hook injection).
+# - Removed legacy command block support handling.
+#
+# Source: 
+# https://github.com/JetBrains/intellij-community/blob/8d02751ced444e5b70784fe0a757f960fe495a67/plugins/terminal/resources/shell-integrations/zsh/zsh-integration.zsh
+# *****************************************************************************
+
+builtin local command_block_support="${THEIA_ZSH_DIR}/command-block-support.zsh"
+[ -r "$command_block_support" ] && builtin source "$command_block_support"
+builtin unset THEIA_ZSH_DIR

package/src/node/shell-process.ts

@@ -37,6 +37,12 @@ export interface ShellProcessOptions {
     env?: { [key: string]: string | null },
     strictEnv?: boolean,
     isPseudo?: boolean,
+    /**
+     * Whether to inject shell integration scripts for command tracking.
+     * When enabled, shell integration scripts are injected to emit OSC 133 sequences.
+     * @default false
+     */
+    enableShellIntegration?: boolean;
 }
 
 export function getRootPath(rootURI?: string): string {

package/src/node/terminal-backend-module.ts

@@ -26,6 +26,7 @@ import { ShellTerminalServer } from '../node/shell-terminal-server';
 import { TerminalWatcher } from '../common/terminal-watcher';
 import { MessagingService } from '@theia/core/lib/node/messaging/messaging-service';
 import { bindTerminalPreferences } from '../common/terminal-preferences';
+import { ShellIntegrationInjector } from './shell-integration-injector';
 
 export function bindTerminalServer(bind: interfaces.Bind, { path, identifier, constructor }: {
     path: string,
@@ -57,11 +58,18 @@ export default new ContainerModule(bind => {
     bind(MessagingService.Contribution).to(TerminalBackendContribution).inSingletonScope();
 
     bind(ShellProcess).toSelf().inTransientScope();
+    bind(ShellIntegrationInjector).toSelf().inSingletonScope();
     bind(ShellProcessFactory).toFactory(ctx =>
         (options: ShellProcessOptions) => {
             const child = new Container({ defaultScope: 'Singleton' });
             child.parent = ctx.container;
-            child.bind(ShellProcessOptions).toConstantValue(options);
+
+            // inject shell integration scripts and env vars only if the terminal command history is enabled
+            const injectedOptions = (options.enableShellIntegration ?? false)
+                ? ctx.container.get(ShellIntegrationInjector).injectShellIntegration(options)
+                : options;
+
+            child.bind(ShellProcessOptions).toConstantValue(injectedOptions);
             return child.get(ShellProcess);
         }
     );